liblo  0.29
lo_serverthread.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2014 Steve Harris et al. (see AUTHORS)
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public License
6  * as published by the Free Software Foundation; either version 2.1
7  * of the License, or (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU Lesser General Public License for more details.
13  *
14  * $Id$
15  */
16 
17 #ifndef LO_SERVERTHREAD_H
18 #define LO_SERVERTHREAD_H
19 
20 #ifdef __cplusplus
21 extern "C" {
22 #endif
23 
45 
63 lo_server_thread lo_server_thread_new_multicast(const char *group, const char *port,
64  lo_err_handler err_h);
65 
82 lo_server_thread lo_server_thread_new_with_proto(const char *port, int proto,
83  lo_err_handler err_h);
84 
96  lo_err_handler err_h);
97 
104 
120  const char *typespec, lo_method_handler h,
121  const void *user_data);
122 
131 void lo_server_thread_del_method(lo_server_thread st, const char *path,
132  const char *typespec);
133 
143 
159  void *user_data);
160 
168 
176 
181 
188 
196 
200 
201 void lo_server_thread_set_error_context(lo_server_thread st, void *user_data);
202 
205 
206 #ifdef __cplusplus
207 }
208 #endif
209 
210 #endif
char * lo_server_thread_get_url(lo_server_thread st)
Return a URL describing the address of the server thread.
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_set_callbacks(lo_server_thread st, lo_server_thread_init_callback init, lo_server_thread_cleanup_callback cleanup, void *user_data)
Set an init and/or a cleanup function to the specifed server thread.
int lo_server_thread_start(lo_server_thread st)
Start the server thread.
lo_server_thread lo_server_thread_new_from_url(const char *url, lo_err_handler err_h)
Create a new server thread, taking port and the optional multicast group IP from an URL string.
lo_method lo_server_thread_add_method(lo_server_thread st, const char *path, const char *typespec, lo_method_handler h, const void *user_data)
Add an OSC method to the specifed server thread.
int(* lo_method_handler)(const char *path, const char *types, lo_arg **argv, int argc, lo_message msg, void *user_data)
A callback function to receive notification of matching message arriving in the server or server thre...
Definition: lo_types.h:134
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_server lo_server_thread_get_server(lo_server_thread st)
Return the lo_server for a lo_server_thread.
lo_server_thread lo_server_thread_new_with_proto(const char *port, int proto, lo_err_handler err_h)
Create a new server thread to handle incoming OSC messages, specifying protocol.
void * lo_server_thread
An object representing a thread containing an OSC server.
Definition: lo_types.h:92
lo_server_thread lo_server_thread_new_multicast(const char *group, const char *port, lo_err_handler err_h)
Create a new server thread to handle incoming OSC messages, and join a UDP multicast group.
void(* lo_server_thread_cleanup_callback)(lo_server_thread s, void *user_data)
A callback function to perform cleanup when the server thread is started.
Definition: lo_types.h:192
void(* lo_err_handler)(int num, const char *msg, const char *where)
A callback function to receive notification of an error in a server or server thread.
Definition: lo_types.h:105
int lo_server_thread_stop(lo_server_thread st)
Stop the server thread.
int lo_server_thread_del_lo_method(lo_server_thread st, lo_method m)
Delete an OSC method from the specified server thread.
void * lo_server
An object representing an instance of an OSC server.
Definition: lo_types.h:85
int lo_server_thread_get_port(lo_server_thread st)
Return the port number that the server thread has bound to.
int(* lo_server_thread_init_callback)(lo_server_thread s, void *user_data)
A callback function to perform initialization when the server thread is started.
Definition: lo_types.h:179
void lo_server_thread_pp(lo_server_thread st)
Pretty-print a lo_server_thread object.
void lo_server_thread_free(lo_server_thread st)
Free memory taken by a server thread.
void * lo_method
An object representing an method on a server.
Definition: lo_types.h:77
void lo_server_thread_del_method(lo_server_thread st, const char *path, const char *typespec)
Delete an OSC method from the specifed server thread.