java

Java bindings for libpd

This document only discusses Java code in the libpd repository. This document presents a brief overview of the Java classes in the core libpd repository. Detailed documentation can be found in the javadoc comments in the code. Further documentation of Eclipse and Android-specific issues can be found in the wiki of the pd-for-android repository.

• java.org.puredata.core.PdBase The basic Java wrapper for libpd, providing thread synchronization and conversion of datatypes between C and Java.

• java.org.puredata.core.PdReceiver Interface for objects that receive messages from Pd. In order to receive messages from Pd, register a receiver instance with PdBase and subscribe to symbols in Pd. See the code for further documentation.

• java.org.puredata.core.utils.PdDispatcher Utility class that implements the PdReceiver interface and automatically handles subscriptions and dispatches messages according to the symbol they were sent to. Note that PdBase will dispatch messages on whichever thread its audio processing methods are invoked on. If you need to make sure that messages are dispatched on the main thread, you can use the PdUiDispatcher class that's included in pd-for-android.

• java.org.puredata.core.PdListener Interface for receiving messages from PdDispatcher instances.

• java.org.puredata.core.PdMidiReceiver Receiver interface for MIDI events sent from Pd. Register an instance of PdMidiReceiver with PdBase in order to receive MIDI events from Pd.

• java.org.puredata.core.utils.IoUtils Utility class that provides some commonly used I/O functionality.