Expert Sleepers OSC Control Manual v1.0.
Copyright © 2009 Expert Sleepers. All rights reserved. This manual, as well as the software described in it, is furnished under licence and may be used or copied only in accordance with the terms of such licence. The content of this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Expert Sleepers. Expert Sleepers assumes no responsibility or liability for any errors or inaccuracies that may appear in this document.
Contents OSC Received OSC Commands /ping s:returnUrl s:returnPath /set i:param f:value /get i:param s:returnUrl s:returnPath /getAll s:returnUrl s:returnPath /getNumParameters s:returnUrl s:returnPath /isParameterUsed i:param s:returnUrl s:returnPath /getInfo i:param s:returnUrl s:returnPath /registerUpdate i:param s:returnUrl s:returnPath /unregisterUpdate i:param s:returnUrl s:returnPath /getAllRegistered /exec s:func ... /call s:func s:returnUrl s:returnPath ...
OSC Most Expert Sleepers plug-ins can be controlled via the Open Sound Control (OSC) protocol. Refer to the user manual of the individual plug-ins for information on their particular OSC implementation. If you’re new to OSC, start by visiting opensoundcontrol.org. Two settings control what port the plug-in uses to listen on for OSC commands. One is the base OSC port, set in the plug-in’s preferences window. The second is the OSC Port Offset control.
i:param f:value where ‘value’ is the value of parameter ‘param’. E.g. /get 14 osc.udp://10.0.0.2:7000 “/foo” replies to 10.0.0.2:7000 with (assuming parameter 14 has the value 64.0) /foo 14 64.0 /getAll s:returnUrl s:returnPath Behaves exactly as if a /get message was received for every parameter.
/unregisterUpdate i:param s:returnUrl s:returnPath Cancels a request made via /registerUpdate (above). /getAllRegistered Behaves exactly as if every parameter registered for updates with /registerUpdate had changed. A message will be sent for every such parameter. /exec s:func ... Executes the Lua function ‘func’, which is assumed to be defined by the MIDI & OSC scripting system (see the separate documentation, available from the Expert Sleepers website).
/startNote i:note f:velocity Starts playback of a note - equivalent of a MIDI note on message. ‘note’ is the MIDI note number; ‘velocity’ should be between 0.0 and 1.0. E.g. /startNote 60 0.7 /stopNote i:note f:velocity Stops playback of a note - equivalent of a MIDI note off message. ‘note’ is the MIDI note number; ‘velocity’ should be between 0.0 and 1.0. E.g. /stopNote 60 0.
Version History 1.0.0 19/5/2009 • Initial version.
Contact The Expert Sleepers website is here: http://www.expert-sleepers.co.uk/ Or you can email info@expertsleepers.co.uk Or you can use the forum, which is here: http://www.kvraudio.com/forum/viewforum.
Acknowledgements The software described in this manual makes use of the following open source projects. The author is greatly indebted to them for their efforts and generosity. Below are reproduced the various copyright notices and disclaimers that accompany these software projects, in accordance with their terms of use. Lua Copyright (C) 1994-2008 Lua.org, PUC-Rio.