Data Structures | |
struct | lo_timetag |
A structure to store OSC TimeTag values. More... | |
union | lo_arg |
Union used to read values from incoming messages. More... | |
Defines | |
#define | LO_TT_IMMEDIATE ((lo_timetag){0U,0U}) |
Enumerations | |
enum | lo_type { LO_INT32 = 'i', LO_FLOAT = 'f', LO_STRING = 's', LO_BLOB = 'b', LO_INT64 = 'h', LO_TIMETAG = 't', LO_DOUBLE = 'd', LO_SYMBOL = 'S', LO_CHAR = 'c', LO_MIDI = 'm', LO_TRUE = 'T', LO_FALSE = 'F', LO_NIL = 'N', LO_INFINITUM = 'I' } |
An enumeration of the OSC types liblo can send and receive. More... | |
Functions | |
lo_address | lo_address_new (const char *host, const char *port) |
Declare an OSC destination, given IP address and port number. | |
lo_address | lo_address_new_from_url (const char *url) |
Create a lo_address object from an OSC URL. | |
void | lo_address_free (lo_address t) |
Free the memory used by the lo_address object. | |
int | lo_send (lo_address targ, const char *path, const char *type,...) |
Send a OSC formatted message to the address specified. | |
int | lo_send_timestamped (lo_address targ, lo_timetag ts, const char *path, const char *type,...) |
Send a OSC formatted message to the address specified, scheduled to be dispatch at some time in the future. | |
int | lo_address_errno (lo_address a) |
Return the error number from the last failed lo_send or lo_address_new call. | |
const char * | lo_address_errstr (lo_address a) |
Return the error string from the last failed lo_send or lo_address_new call. | |
lo_server_thread | lo_server_thread_new (const char *port, lo_err_handler err_h) |
Create a new server thread to handle incoming OSC messages. | |
void | lo_server_thread_free (lo_server_thread st) |
Free memory taken by a server thread. | |
lo_method | lo_server_thread_add_method (lo_server_thread st, const char *path, const char *typespec, lo_method_handler h, void *user_data) |
Add an OSC method to the specifed server thread. | |
void | lo_server_thread_start (lo_server_thread st) |
Start the server thread. | |
void | lo_server_thread_stop (lo_server_thread st) |
Stop the server thread. | |
int | lo_server_thread_get_port (lo_server_thread st) |
Return the port number that the server thread has bound to. | |
char * | lo_server_thread_get_url (lo_server_thread st) |
Return a URL describing the address of the server thread. | |
int | lo_server_thread_events_pending (lo_server_thread st) |
Return true if there are scheduled events (eg. from bundles) waiting to be dispatched by the thread. | |
lo_blob | lo_blob_new (int32_t size, void *data) |
Create a new OSC blob type. | |
void | lo_blob_free (lo_blob b) |
Free the memory taken by a blob. | |
uint32_t | lo_blob_datasize (lo_blob b) |
Return the ammount of valid data in a lo blob object. | |
void * | lo_blob_dataptr (lo_blob b) |
Return a pointer to the start of the blob data to allow contents to be changed. |
|
|
|
An enumeration of the OSC types liblo can send and receive. The value of the enumeration is the typechar used to tag messages and to specify arguemnts with lo_send().
|
|
Return the error number from the last failed lo_send or lo_address_new call.
|
|
Return the error string from the last failed lo_send or lo_address_new call.
|
|
Free the memory used by the lo_address object.
|
|
Declare an OSC destination, given IP address and port number.
Note: if you wish to receive replies from the target of this address, you must first create a lo_server_thread or lo_server object which will receive the replies. The last lo_server(_thread) object creted will be the receiver. |
|
Create a lo_address object from an OSC URL. example: osc.udp://localhost:4444/my/path/ |
|
Return a pointer to the start of the blob data to allow contents to be changed.
|
|
Return the ammount of valid data in a lo blob object. If you want to know the storage size, use lo_arg_size(). |
|
Free the memory taken by a blob.
|
|
Create a new OSC blob type.
|
|
Send a OSC formatted message to the address specified.
lo_send(t, "/foo/bar", "ff", 0.1f, 23.0f); returns -1 on failure. |
|
Send a OSC formatted message to the address specified, scheduled to be dispatch at some time in the future.
lo_timetag now; lo_timetag_now(&now); lo_send(t, now, "/foo/bar", "ff", 0.1f, 23.0f); on success returns the number of bytes sent, returns -1 on failure. |
|
Add an OSC method to the specifed server thread.
|
|
Return true if there are scheduled events (eg. from bundles) waiting to be dispatched by the thread.
|
|
Free memory taken by a server thread. Frees the memory, and, if currently running will stop the associated thread. |
|
Return the port number that the server thread has bound to.
|
|
Return a URL describing the address of the server thread. Return value must be free()'d to reclaim memory. |
|
Create a new server thread to handle incoming OSC messages. Server threads take care of the message reception and dispatch by transparently creating a systme thread to handle incoming messages. Use this if you do not want to handle the threading yourself.
|
|
Start the server thread.
|
|
Stop the server thread.
|