README
1liblo perl binding
2==================
3
4Perl binding for the liblo library.
5
6LibLO library version 0.23 or higher is required.
7http://liblo.sourceforge.net/
8
9Pkg-config version 0.11 or higher is required:
10http://pkgconfig.freedesktop.org/
11
12
13INSTALLATION
14------------
15
16 I use Module::Build to build and install the module.
17 To install this module type the following:
18
19 perl Build.PL
20 ./Build
21 ./Build test
22
23 And then as root:
24
25 ./Build install
26
27
28API Overview
29------------
30
31 Items marked * have not been implemented in this release.
32
33 Net::LibLO::Address
34 - new(url)
35 - new(host, port)
36 - get_hostname
37 - get_port
38 - get_url
39 - errno
40 - errstr
41 - DESTROY
42
43 Net::LibLO::Message
44 - new
45 - new(typespec, args)
46 - add_int32
47 - add_float
48 - add_string
49 - add_double
50 - add_symbol
51 - add_char
52 - add_true
53 - add_false
54 - add_nil
55 - add_infinitum
56 - length
57 - pretty_print
58 * - serialise
59 - get_source
60 - DESTROY
61
62 Net::LibLO::Bundle
63 - new
64 - new(sec, frac)
65 - add_message(path, message)
66 - add_message(path, typespec, args )
67 - length
68 * - serialise
69 - DESTROY
70
71 Net::LibLO( port_string )
72 - new([port], [protocol])
73 - send(dest, bundle)
74 - send(dest, path, message)
75 - send(dest, path, typespec, @params)
76 * - send_timestamped( dest, timetag, path, message )
77 * - send_timestamped( dest, timetag, path, typespec, @params )
78 - recv
79 - recv_noblock( [timeout] )
80 - add_method( path, typespec, handler, userdata )
81 * - del_method( path, typespec )
82 - get_port
83 - get_url
84 * - events_pending
85 * - next_event_delay
86 - DESTROY
87
88
89 handler( serv, mesg, path, typespec, userdata, @params )
90
91
92KNOWN BUGS
93----------
94
95 - Not all OSC types are supported
96 - You cannot remove methods
97 - Possible memory leaks when freeing Net::LibLO objects
98
99
100AUTHOR
101------
102
103 Nicholas J. Humfrey, njh@aelius.com
104
105
106COPYRIGHT
107---------
108
109 Copyright (C) 2005 Nicholas J. Humfrey
110
111 This program is free software; you can redistribute it and/or modify
112 it under the terms of the GNU General Public License as published by
113 the Free Software Foundation; either version 2 of the License, or
114 (at your option) any later version.
115
116 This program is distributed in the hope that it will be useful,
117 but WITHOUT ANY WARRANTY; without even the implied warranty of
118 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
119 GNU General Public License for more details.
120