/* This file is part of Ingen. Copyright (C) 2006 Dave Robillard.
*
* Ingen is free software; you can redistribute it and/or modify it under the
* terms of the GNU General Public License as published by the Free Software
* Foundation; either version 2 of the License, or (at your option) any later
* version.
*
* Ingen is distributed in the hope that it will be useful, but WITHOUT ANY
* WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU General Public License for details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#include "OSCClientSender.h"
#include
#include
#include
#include "ObjectStore.h"
#include "NodeFactory.h"
#include "util.h"
#include "Patch.h"
#include "Node.h"
#include "Plugin.h"
#include "TypedPort.h"
#include "Connection.h"
#include "AudioDriver.h"
#include "interface/ClientInterface.h"
#include "Responder.h"
#include "raul/AtomLiblo.h"
using std::cout; using std::cerr; using std::endl;
namespace Ingen {
void
OSCClientSender::bundle_begin()
{
// FIXME
}
void
OSCClientSender::bundle_end()
{
// FIXME
}
void
OSCClientSender::transfer_begin()
{
//_transfer = lo_bundle_new(LO_TT_IMMEDIATE);
}
void
OSCClientSender::transfer_end()
{
/*assert(_transfer);
lo_send_bundle(_address, _transfer);
lo_bundle_free(_transfer);
_transfer = NULL;*/
}
/*! \page client_osc_namespace Client OSC Namespace Documentation
*
* NOTE: this comment doesn't really apply any longer.. sort of.
* but maybe it still should.. maybe. so it remains...
*
* These are all the messages sent from the engine to the client.
* Communication takes place over two distinct bands: control band and
* notification band.
* The control band is where clients send commands, and receive a simple
* response, either OK or an error.
* All notifications of engine state (ie new nodes) are sent over the
* notification band which is seperate from the control band. The
* reasoning behind this is that many clients may be connected at the same
* time - a client may receive notifications that are not a direct consequence
* of some message it sent.
* The notification band can be thought of as a stream of events representing
* the changing engine state. For example, It is possible for a client to send
* commands and receive aknowledgements, and not listen to the notification band
* at all; or (in the near future anyway) for a client to use UDP for the control
* band (for speed), and TCP for the notification band (for reliability and
* order guarantees).
* \n\n
*/
/** \page client_osc_namespace
* \b /om/response - Respond to a user command
* \arg \b response-id (int) - Request ID this is a response to
* \arg \b success (boolean int) - Whether response is affirmative or an error
* \arg \b message (string) - Error message (natural language text)
*
\n \n
*/
void
OSCClientSender::response(int32_t id, bool success, string msg)
{
if (!_enabled)
return;
if (lo_send(_address, "/om/response", "iis", id, success ? 1 : 0, msg.c_str()) < 0) {
cerr << "Unable to send response " << id << "! ("
<< lo_address_errstr(_address) << ")" << endl;
}
}
/** \page client_osc_namespace
* \n
* Notification Band
*/
/** \page client_osc_namespace
* \b /om/error - Notification that an error has occurred
* \arg \b message (string) - Error message (natural language text)
*
* \li This is for notification of errors that aren't a direct response to a
* user command, ie "unexpected" errors.
\n \n
*/
void
OSCClientSender::error(string msg)
{
if (!_enabled)
return;
lo_send(_address, "/om/error", "s", msg.c_str());
}
/** \page client_osc_namespace
* \b /om/num_plugins
* \arg \b num (int) - Number of plugins engine has loaded
* \li This is sent before sending the list of plugins, so the client is aware
* of how many plugins (/om/plugin messages) to expect.
\n \n
*/
/** \page client_osc_namespace
* \b /om/num_plugins
* \arg \b num (int) - Number of plugins engine has loaded
* \li This is sent before sending the list of plugins, so the client is aware
* of how many plugins (/om/plugin messages) to expect.
\n \n
*/
void
OSCClientSender::num_plugins(uint32_t num)
{
if (!_enabled)
return;
lo_message m = lo_message_new();
lo_message_add_int32(m, num);
lo_send_message(_address, "/om/num_plugins", m);
}
/** \page client_osc_namespace
* \b /om/plugin - Notification of the existance of a plugin
* \arg \b type (string) - Type if plugin ("LADSPA", "DSSI", or "Internal")
* \arg \b uri (string) - URI of the plugin (see engine namespace documentation) \n
* \arg \b lib-name (string) - Name of shared library plugin resides in (ie "cmt.so")
* \arg \b plug-label (string) - Label of the plugin (ie "dahdsr_iaoa")
* \arg \b name (string) - Descriptive human-readable name of plugin (ie "ADSR Envelope")
*
\n \n
*/
/*
void
OSCClientSender::plugins()
{
Engine::instance().node_factory()->lock_plugin_list();
const list& plugs = Engine::instance().node_factory()->plugins();
const Plugin* plugin;
lo_timetag tt;
lo_timetag_now(&tt);
lo_bundle b = lo_bundle_new(tt);
lo_message m = lo_message_new();
list msgs;
lo_message_add_int32(m, plugs.size());
lo_bundle_add_message(b, "/om/num_plugins", m);
msgs.push_back(m);
for (list::const_iterator j = plugs.begin(); j != plugs.end(); ++j) {
plugin = (*j);
m = lo_message_new();
lo_message_add_string(m, plugin->type_string());
lo_message_add_string(m, plugin->uri().c_str());
lo_message_add_string(m, plugin->plug_label().c_str());
lo_message_add_string(m, plugin->name().c_str());
lo_bundle_add_message(b, "/om/plugin", m);
msgs.push_back(m);
if (lo_bundle_length(b) > 1024) {
lo_send_bundle(_address, b);
lo_bundle_free(b);
b = lo_bundle_new(tt);
}
}
if (lo_bundle_length(b) > 0) {
lo_send_bundle(_address, b);
lo_bundle_free(b);
} else {
lo_bundle_free(b);
}
for (list::const_iterator i = msgs.begin(); i != msgs.end(); ++i)
lo_message_free(*i);
Engine::instance().node_factory()->unlock_plugin_list();
}
*/
/** \page client_osc_namespace
* \b /om/new_node - Notification of a new node's creation.
* \arg \b plug-uri (string) - URI of the plugin new node is an instance of
* \arg \b path (string) - Path of the new node
* \arg \b polyphonic (integer-boolean) - Node is polyphonic (1 = yes, 0 = no)
* \arg \b num-ports (integer) - Number of ports (number of new_port messages to expect)
* \li New nodes are sent as a bundle. The first message in the bundle will be
* this one (/om/new_node), followed by a series of /om/new_port commands,
* followed by /om/new_node_end.
\n \n
*/
void OSCClientSender::new_node(string plugin_uri,
string node_path,
bool is_polyphonic,
uint32_t num_ports)
{
if (!_enabled)
return;
//cerr << "Sending node " << node_path << endl;
lo_send(_address, "/om/new_node", "ssii", plugin_uri.c_str(),
node_path.c_str(), is_polyphonic ? 1 : 0, num_ports);
#if 0
/*
lo_timetag tt;
lo_timetag_now(&tt);
lo_bundle b = lo_bundle_new(tt);
lo_message m = lo_message_new();
list msgs;
lo_message_add_string(m, plugin_type.c_str());
lo_message_add_string(m, plugin_uri.c_str());
lo_message_add_string(m, node_path.c_str());
lo_message_add_int32(m, is_polyphonic ? 1 : 0);
lo_message_add_int32(m, num_ports);
lo_bundle_add_message(b, "/om/new_node", m);
msgs.push_back(m);
*/
/*
const Array& ports = node->ports();
Port* port;
PortInfo* info;
for (size_t j=0; j < ports.size(); ++j) {
port = ports.at(j);
info = port->port_info();
assert(port != NULL);
assert(info != NULL);
m = lo_message_new();
lo_message_add_string(m, port->path().c_str());
lo_message_add_string(m, info->type_string().c_str());
lo_message_add_string(m, info->direction_string().c_str());
lo_message_add_string(m, info->hint_string().c_str());
lo_message_add_float(m, info->default_val());
lo_message_add_float(m, info->min_val());
lo_message_add_float(m, info->max_val());
lo_bundle_add_message(b, "/om/new_port", m);
msgs.push_back(m);
// If the bundle is getting very large, send it and start
// a new one
if (lo_bundle_length(b) > 1024) {
lo_send_bundle(_address, b);
lo_bundle_free(b);
b = lo_bundle_new(tt);
}
}
*/
/*m = lo_message_new();
//lo_bundle_add_message(b, "/om/new_node_end", m);
//msgs.push_back(m);
lo_send_bundle(_address, b);
lo_bundle_free(b);
for (list::const_iterator i = msgs.begin(); i != msgs.end(); ++i)
lo_message_free(*i);
usleep(100);
*/
/*
const map& data = node->metadata();
// Send node metadata
for (map::const_iterator i = data.begin(); i != data.end(); ++i)
metadata_update(node->path(), (*i).first, (*i).second);
// Send port metadata
for (size_t j=0; j < ports.size(); ++j) {
port = ports.at(j);
const map& data = port->metadata();
for (map::const_iterator i = data.begin(); i != data.end(); ++i)
metadata_update(port->path(), (*i).first, (*i).second);
}
// Send control values
for (size_t i=0; i < node->ports().size(); ++i) {
TypedPort* port = (TypedPort*)node->ports().at(i);
if (port->port_info()->is_input() && port->port_info()->is_control())
control_change(port->path(), port->buffer(0)->value_at(0));
}
*/
#endif
}
/** \page client_osc_namespace
* \b /om/new_port - Notification of a new port's creation.
* \arg \b path (string) - Path of new port
* \arg \b data-type (string) - Type of port (CONTROL or AUDIO)
* \arg \b direction ("is-output") (integer) - Direction of data flow (Input = 0, Output = 1)
*
* \li Note that in the event of loading a patch, this message could be
* followed immediately by a control change, meaning the default-value is
* not actually the current value of the port.
* \li The minimum and maximum values are suggestions only, they are not
* enforced in any way, and going outside them is perfectly fine. Also note
* that the port ranges in om_gtk are not these ones! Those ranges are set
* as metadata.
\n \n
*/
void
OSCClientSender::new_port(string path,
string data_type,
bool is_output)
{
if (!_enabled)
return;
//PortInfo* info = port->port_info();
lo_send(_address, "/om/new_port", "ssi", path.c_str(), data_type.c_str(), is_output);
// Send metadata
/*const map& data = port->metadata();
for (map::const_iterator i = data.begin(); i != data.end(); ++i)
metadata_update(port->path(), (*i).first, (*i).second);*/
}
/** \page client_osc_namespace
* \b /om/destroyed - Notification an object has been destroyed
* \arg \b path (string) - Path of object (which no longer exists)
\n \n
*/
void
OSCClientSender::object_destroyed(string path)
{
if (!_enabled)
return;
assert(path != "/");
lo_send(_address, "/om/destroyed", "s", path.c_str());
}
/** \page client_osc_namespace
* \b /om/patch_cleared - Notification a patch has been cleared (all children destroyed)
* \arg \b path (string) - Path of patch (which is now empty)
\n \n
*/
void
OSCClientSender::patch_cleared(string patch_path)
{
if (!_enabled)
return;
lo_send(_address, "/om/patch_cleared", "s", patch_path.c_str());
}
/** \page client_osc_namespace
* \b /om/patch_enabled - Notification a patch's DSP processing has been enabled.
* \arg \b path (string) - Path of enabled patch
\n \n
*/
void
OSCClientSender::patch_enabled(string patch_path)
{
if (!_enabled)
return;
lo_send(_address, "/om/patch_enabled", "s", patch_path.c_str());
}
/** \page client_osc_namespace
* \b /om/patch_disabled - Notification a patch's DSP processing has been disabled.
* \arg \b path (string) - Path of disabled patch
\n \n
*/
void
OSCClientSender::patch_disabled(string patch_path)
{
if (!_enabled)
return;
lo_send(_address, "/om/patch_disabled", "s", patch_path.c_str());
}
/** \page client_osc_namespace
* \b /om/new_connection - Notification a new connection has been made.
* \arg \b src-path (string) - Path of the source port
* \arg \b dst-path (string) - Path of the destination port
\n \n
*/
void
OSCClientSender::connection(string src_port_path, string dst_port_path)
{
if (!_enabled)
return;
lo_send(_address, "/om/new_connection", "ss", src_port_path.c_str(), dst_port_path.c_str());
}
/** \page client_osc_namespace
* \b /om/disconnection - Notification a connection has been unmade.
* \arg \b src-path (string) - Path of the source port
* \arg \b dst-path (string) - Path of the destination port
\n \n
*/
void
OSCClientSender::disconnection(string src_port_path, string dst_port_path)
{
if (!_enabled)
return;
lo_send(_address, "/om/disconnection", "ss", src_port_path.c_str(), dst_port_path.c_str());
}
/** \page client_osc_namespace
* \b /om/metadata/update - Notification of a piece of metadata.
* \arg \b path (string) - Path of the object associated with metadata (can be a node, patch, or port)
* \arg \b key (string)
* \arg \b value (string)
\n \n
*/
void
OSCClientSender::metadata_update(string path, string key, Atom value)
{
if (!_enabled)
return;
lo_message m = lo_message_new();
lo_message_add_string(m, path.c_str());
lo_message_add_string(m, key.c_str());
AtomLiblo::lo_message_add_atom(m, value);
lo_send_message(_address, "/om/metadata/update", m);
}
/** \page client_osc_namespace
* \b /om/control_change - Notification the value of a port has changed
* \arg \b path (string) - Path of port
* \arg \b value (float) - New value of port
*
* \li This will only send updates for values set by clients of course - not values
* changing because of connections to other ports!
\n \n
*/
void
OSCClientSender::control_change(string port_path, float value)
{
if (!_enabled)
return;
lo_send(_address, "/om/control_change", "sf", port_path.c_str(), value);
}
/** \page client_osc_namespace
* \b /om/plugin - Notification of the existance of a plugin
* \arg \b type (string) - Type if plugin ("LADSPA", "DSSI", or "Internal")
\n \n
* \arg \b uri (string) - Type if plugin ("LADSPA", "DSSI", or "Internal")
\n \n
* \arg \b name (string) - Descriptive human-readable name of plugin (ie "ADSR Envelope")
*/
void
OSCClientSender::new_plugin(string uri, string name)
{
if (!_enabled)
return;
lo_message m = lo_message_new();
lo_message_add_string(m, uri.c_str());
lo_message_add_string(m, name.c_str());
//if (_transfer)
// lo_bundle_add_message(_transfer, "/om/plugin", m);
//else
lo_send_message(_address, "/om/plugin", m);
}
/** \page client_osc_namespace
* \b /om/new_patch - Notification of a new patch
* \arg \b path (string) - Path of new patch
* \arg \b poly (int) - Polyphony of new patch (\em not a boolean like new_node)
\n \n
*/
void
OSCClientSender::new_patch(string path, uint32_t poly)
{
if (!_enabled)
return;
lo_send(_address, "/om/new_patch", "si", path.c_str(), poly);
/*
if (p->process())
patch_enabled(p->path());
// Send metadata
const map& data = p->metadata();
for (map::const_iterator i = data.begin(); i != data.end(); ++i) {
metadata_update(p->path(), (*i).first, (*i).second);
}
*/
}
/** \page client_osc_namespace
* \b /om/object_renamed - Notification of an object's renaming
* \arg \b old-path (string) - Old path of object
* \arg \b new-path (string) - New path of object
\n \n
*/
void
OSCClientSender::object_renamed(string old_path, string new_path)
{
if (!_enabled)
return;
lo_send(_address, "/om/object_renamed", "ss", old_path.c_str(), new_path.c_str());
}
/** Sends information about a program associated with a DSSI plugin node.
*/
void
OSCClientSender::program_add(string node_path, uint32_t bank, uint32_t program, string name)
{
if (!_enabled)
return;
lo_send(_address, "/om/program_add", "siis",
node_path.c_str(), bank, program, name.c_str());
}
void
OSCClientSender::program_remove(string node_path, uint32_t bank, uint32_t program)
{
if (!_enabled)
return;
lo_send(_address, "/om/program_remove", "sii",
node_path.c_str(), bank, program);
}
} // namespace Ingen