NAME

LibLO::Client - Perl client bindings for liblo high-level API

SYNOPSIS

  use LibLO::Client;

  my $lo = new LibLO::Client( 'osc.udp://localhost:4444/' );
  
  my $lo = new LibLO::Client( 'localhost', 4444 );

  $lo->send( "/foo/bar", "Tsfi", "hello", 0.1f, 23 );

  my $message = new LibLO::Message();
  $message->add_string( "Hello World" );
  $lo->send_message( "/foo/bar", $message );

DESCRIPTION

LibLO::Client provides methods for sending messages to a server process.

METHODS

new( url )

Create a Client object from an OSC URL.

new( host, port )

Create a Client object from a specified host address and port.

send( path, types, ... )

Send an OSC message without having to create a LibLO::Message object.

path the OSC path the message will be delivered to.

types The types of the data items in the message.

i 32 bit signed integer.

f 32 bit IEEE-754 float.

s A string

d 64 bit IEEE-754 double.

S A symbol - used in systems which distinguish strings and symbols.

c A single 8bit charater

T Symbol representing the value True.

F Symbol representing the value False.

N Symbol representing the value Nil.

I Symbol representing the value Infinitum.

... The data values to be transmitted. The types of the arguments passed here must agree with the types specified in the type parameter.

Returns -1 if there was an error.

send_message( path, message )

Send a LibLO::Message object to the specified path.

Returns -1 if there was an error.

errno()

Return the error number for the last error.

errstr()

Return the error string for the last error.

SEE ALSO

LibLO

LibLO::Message

http://plugin.org.uk/liblo/

AUTHOR

Nicholas J. Humfrey, njh@aelius.com

COPYRIGHT AND LICENSE

Copyright (C) 2005 Nicholas J. Humfrey

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.