Typedefs | |
typedef long double | lo_hires |
Type used to represent numerical values in conversions between OSC types. | |
Functions | |
int | lo_send_message (lo_address targ, const char *path, lo_message msg) |
send a lo_message object to target targ | |
lo_message | lo_message_new () |
Create a new lo_message object. | |
void | lo_message_free (lo_message m) |
Free memory allocated by lo_message_new and any subsequent lo_message_add*() calls. | |
void | lo_message_add_int32 (lo_message m, int32_t a) |
Append a data item and typechar of the specified type to a message. | |
void | lo_message_add_float (lo_message m, float a) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_string (lo_message m, char *a) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_blob (lo_message m, lo_blob a) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_int64 (lo_message m, int64_t a) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_timetag (lo_message m, lo_timetag a) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_double (lo_message m, double a) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_symbol (lo_message m, char *a) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_char (lo_message m, char a) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_midi (lo_message m, uint8_t a[4]) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_true (lo_message m) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_false (lo_message m) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_nil (lo_message m) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
void | lo_message_add_infinitum (lo_message m) |
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details. | |
size_t | lo_message_length (lo_message m, const char *path) |
Return the length of a message in bytes. | |
void * | lo_message_serialise (lo_message m, const char *path, size_t *size) |
Serialise the message object to an area of memory and return a pointer to the serialised form. | |
int | lo_is_numerical_type (lo_type a) |
return true if the type specified has a numerical value, such as LO_INT32, LO_FLOAT etc. | |
int | lo_is_string_type (lo_type a) |
return true if the type specified has a textual value, such as LO_STRING or LO_SYMBOL. | |
int | lo_coerce (lo_type type_to, lo_arg *to, lo_type type_from, lo_arg *from) |
attempt to convert one OSC type to another. | |
lo_hires | lo_hires_val (lo_type type, lo_arg *p) |
return the numerical value of the given argument with the maximum native system precision. | |
size_t | lo_arg_size (lo_type type, void *data) |
Return the storage size, in bytes, of the given argument. | |
void | lo_arg_host_endian (lo_type type, void *data) |
Convert the speficed argument to host endianness where neccesary. | |
lo_server | lo_server_new (const char *port, lo_err_handler err_h) |
Create a new server instance. | |
lo_server | lo_server_new_with_proto (const char *port, int proto, lo_err_handler err_h) |
Create a new server instance, specifying protocol. | |
void | lo_server_free (lo_server s) |
Free up memory used by the lo_server object. | |
int | lo_server_recv_noblock (lo_server s, int timeout) |
Look for an OSC message waiting to be received. | |
int | lo_server_recv (lo_server s) |
Block, waiting for an OSC message to be received. | |
lo_method | lo_server_add_method (lo_server s, const char *path, const char *typespec, lo_method_handler h, void *user_data) |
Add an OSC method to the specifed server. | |
int | lo_server_get_socket_fd (lo_server s) |
Return the file descriptor of the server socket. | |
int | lo_server_get_port (lo_server s) |
Return the port number that the server has bound to. | |
char * | lo_server_get_url (lo_server s) |
Return an OSC URL that can be used to contact the server. | |
char * | lo_url_get_protocol (const char *url) |
Return the protocol portion of an OSC URL, eg. udp, tcp. | |
char * | lo_url_get_hostname (const char *url) |
Return the hostname portion of an OSC URL. | |
char * | lo_url_get_port (const char *url) |
Return the port portion of an OSC URL. | |
char * | lo_url_get_path (const char *url) |
Return the path portion of an OSC URL. | |
int | lo_strsize (const char *s) |
A function to calculate the amount of OSC message space required by a C char *. | |
uint32_t | lo_blobsize (lo_blob b) |
A function to calculate the amount of OSC message space required by a lo_blob object. | |
int | lo_send_internal (lo_address t, const char *file, const int line, const char *path, const char *types,...) |
the real send function (don't call directly) |
|
Type used to represent numerical values in conversions between OSC types.
|
|
Convert the speficed argument to host endianness where neccesary.
|
|
Return the storage size, in bytes, of the given argument.
|
|
A function to calculate the amount of OSC message space required by a lo_blob object. Returns the storage size in bytes, will always be a multiple of four. |
|
attempt to convert one OSC type to another. Numerical types (eg LO_INT32, LO_FLOAT etc.) may be converted to other numerical types and string types (LO_STRING and LO_SYMBOL) may be converted to the other type. This is done automatically if a received message matches the path, but not the exact types, and is coercible (ie. all numerical types in numerical positions). On failure no translation occurs and false is returned.
|
|
return the numerical value of the given argument with the maximum native system precision.
|
|
return true if the type specified has a numerical value, such as LO_INT32, LO_FLOAT etc.
|
|
return true if the type specified has a textual value, such as LO_STRING or LO_SYMBOL.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. The data will be added in OSC byteorder (bigendian).
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Append a data item and typechar of the specified type to a message. See lo_message_add_int32() for details.
|
|
Free memory allocated by lo_message_new and any subsequent lo_message_add*() calls.
|
|
Return the length of a message in bytes.
|
|
Create a new lo_message object.
|
|
Serialise the message object to an area of memory and return a pointer to the serialised form.
|
|
the real send function (don't call directly)
|
|
send a lo_message object to target targ This is slightly more efficient than lo_send if you want to send a lot of similar messages. The messages are constructed with the lo_message_new() and lo_message_add*() functions. |
|
Add an OSC method to the specifed server.
|
|
Free up memory used by the lo_server object.
|
|
Return the port number that the server has bound to. Useful when NULL is passed for the port number and you wish to know how to address the server. |
|
Return the file descriptor of the server socket. If the server protocol supports exposing the server's underlying receive mechanism for monitoring with select() or poll(), this function returns the file descriptor needed, otherwise, it returns -1. |
|
Return an OSC URL that can be used to contact the server. The return value should bee free()'d when it is no longer needed. |
|
Create a new server instance. lo_servers block until they receive OSC messages. if you want non-blocking behaviour see the lo_server_thread_* functions.
|
|
Create a new server instance, specifying protocol. lo_servers block until they receive OSC messages. if you want non-blocking behaviour see the lo_server_thread_* functions.
|
|
Block, waiting for an OSC message to be received. The return value is the number of bytes in the received message. The message will be dispatched to a matching method if one is found. |
|
Look for an OSC message waiting to be received.
|
|
A function to calculate the amount of OSC message space required by a C char *. Returns the storage size in bytes, will always be a multiple of four. |
|
Return the hostname portion of an OSC URL. The return value should bee free()'d when it is no longer needed. |
|
Return the path portion of an OSC URL. The return value should bee free()'d when it is no longer needed. |
|
Return the port portion of an OSC URL. The return value should bee free()'d when it is no longer needed. |
|
Return the protocol portion of an OSC URL, eg. udp, tcp. This library uses OSC URLs of the form: osc.prot://hostname:port/path if the prot part is missing, UDP is assumed. The return value should bee free()'d when it is no longer needed. |