JUCE
|
A class for receiving OSC data. More...
Classes | |
class | Listener |
A class for receiving OSC data from an OSCReceiver. More... | |
class | ListenerWithOSCAddress |
A class for receiving only those OSC messages from an OSCReceiver that match a given OSC address. More... | |
struct | MessageLoopCallback |
Use this struct as the template parameter for Listener and ListenerWithOSCAddress to receive incoming OSC data on the message thread. More... | |
struct | RealtimeCallback |
Use this struct as the template parameter for Listener and ListenerWithOSCAddress to receive incoming OSC data immediately after it arrives, called directly on the network thread that listens to incoming OSC traffic. More... | |
Public Types | |
typedef void(* | FormatErrorHandler) (const char *data, int dataSize) |
An error handler function for OSC format errors that can be called by the OSCReceiver. More... | |
Public Member Functions | |
OSCReceiver () | |
Constructs a new OSCReceiver. More... | |
~OSCReceiver () | |
Destructor. More... | |
bool | connect (int portNumber) |
Connects to the specified UDP port using a datagram socket, and starts listening to OSC packets arriving on this port. More... | |
bool | disconnect () |
Disconnects from the currently used UDP port. More... | |
void | addListener (Listener< MessageLoopCallback > *listenerToAdd) |
Adds a listener that listens to OSC messages and bundles. More... | |
void | addListener (Listener< RealtimeCallback > *listenerToAdd) |
Adds a listener that listens to OSC messages and bundles. More... | |
void | addListener (ListenerWithOSCAddress< MessageLoopCallback > *listenerToAdd, OSCAddress addressToMatch) |
Adds a filtered listener that listens to OSC messages matching the address used to register the listener here. More... | |
void | addListener (ListenerWithOSCAddress< RealtimeCallback > *listenerToAdd, OSCAddress addressToMatch) |
Adds a filtered listener that listens to OSC messages matching the address used to register the listener here. More... | |
void | removeListener (Listener< MessageLoopCallback > *listenerToRemove) |
Removes a previously-registered listener. More... | |
void | removeListener (Listener< RealtimeCallback > *listenerToRemove) |
Removes a previously-registered listener. More... | |
void | removeListener (ListenerWithOSCAddress< MessageLoopCallback > *listenerToRemove) |
Removes a previously-registered listener. More... | |
void | removeListener (ListenerWithOSCAddress< RealtimeCallback > *listenerToRemove) |
Removes a previously-registered listener. More... | |
void | registerFormatErrorHandler (FormatErrorHandler handler) |
Installs a custom error handler which is called in case the receiver encounters a stream it cannot parse as an OSC bundle or OSC message. More... | |
A class for receiving OSC data.
An OSCReceiver object allows you to receive OSC bundles and messages. It can connect to a network port, receive incoming OSC packets from the network via UDP, parse them, and forward the included OSCMessage and OSCBundle objects to its listeners.
typedef void(* juce::OSCReceiver::FormatErrorHandler) (const char *data, int dataSize) |
An error handler function for OSC format errors that can be called by the OSCReceiver.
The arguments passed are the pointer to and the data of the buffer that the OSCReceiver has failed to parse.
juce::OSCReceiver::OSCReceiver | ( | ) |
Constructs a new OSCReceiver.
juce::OSCReceiver::~OSCReceiver | ( | ) |
Destructor.
bool juce::OSCReceiver::connect | ( | int | portNumber | ) |
Connects to the specified UDP port using a datagram socket, and starts listening to OSC packets arriving on this port.
bool juce::OSCReceiver::disconnect | ( | ) |
Disconnects from the currently used UDP port.
void juce::OSCReceiver::addListener | ( | Listener< MessageLoopCallback > * | listenerToAdd | ) |
Adds a listener that listens to OSC messages and bundles.
This listener will be called on the application's message loop.
void juce::OSCReceiver::addListener | ( | Listener< RealtimeCallback > * | listenerToAdd | ) |
Adds a listener that listens to OSC messages and bundles.
This listener will be called in real-time directly on the network thread that receives OSC data.
void juce::OSCReceiver::addListener | ( | ListenerWithOSCAddress< MessageLoopCallback > * | listenerToAdd, |
OSCAddress | addressToMatch | ||
) |
Adds a filtered listener that listens to OSC messages matching the address used to register the listener here.
The listener will be called on the application's message loop.
void juce::OSCReceiver::addListener | ( | ListenerWithOSCAddress< RealtimeCallback > * | listenerToAdd, |
OSCAddress | addressToMatch | ||
) |
Adds a filtered listener that listens to OSC messages matching the address used to register the listener here.
The listener will be called on the application's message loop.
void juce::OSCReceiver::removeListener | ( | Listener< MessageLoopCallback > * | listenerToRemove | ) |
Removes a previously-registered listener.
void juce::OSCReceiver::removeListener | ( | Listener< RealtimeCallback > * | listenerToRemove | ) |
Removes a previously-registered listener.
void juce::OSCReceiver::removeListener | ( | ListenerWithOSCAddress< MessageLoopCallback > * | listenerToRemove | ) |
Removes a previously-registered listener.
void juce::OSCReceiver::removeListener | ( | ListenerWithOSCAddress< RealtimeCallback > * | listenerToRemove | ) |
Removes a previously-registered listener.
void juce::OSCReceiver::registerFormatErrorHandler | ( | FormatErrorHandler | handler | ) |
Installs a custom error handler which is called in case the receiver encounters a stream it cannot parse as an OSC bundle or OSC message.
By default (i.e. if you never use this method), in case of a parsing error nothing happens and the invalid packet is simply discarded.