76 lines
1.3 KiB
Text
76 lines
1.3 KiB
Text
|
class:: SendTrig
|
||
|
|
summary:: Send a trigger message from the server back to the client.
|
||
|
|
categories:: UGens>Triggers
|
||
|
|
related:: Classes/OSCFunc, Classes/SendReply
|
||
|
|
|
||
|
|
|
||
|
|
Description::
|
||
|
|
|
||
|
|
On receiving a trigger (a non-positive to positive transition), send a
|
||
|
|
trigger message from the server back to the client.
|
||
|
|
|
||
|
|
|
||
|
|
The trigger message sent back to the client is this:
|
||
|
|
|
||
|
|
table::
|
||
|
|
|
||
|
|
## /tr || A trigger message.
|
||
|
|
|
||
|
|
## int: || Node ID.
|
||
|
|
|
||
|
|
## int: || Trigger ID.
|
||
|
|
|
||
|
|
## float: || Trigger value.
|
||
|
|
|
||
|
|
::
|
||
|
|
|
||
|
|
|
||
|
|
This command is the mechanism that synths can use to trigger events in
|
||
|
|
clients. The node ID is the node that is sending the trigger. The trigger
|
||
|
|
ID and value are determined by inputs to the SendTrig unit generator
|
||
|
|
which is the originator of this message.
|
||
|
|
|
||
|
|
|
||
|
|
classmethods::
|
||
|
|
|
||
|
|
method::ar, kr
|
||
|
|
|
||
|
|
argument::in
|
||
|
|
|
||
|
|
The trigger.
|
||
|
|
|
||
|
|
|
||
|
|
argument::id
|
||
|
|
|
||
|
|
An integer that will be passed with the trigger message. This is
|
||
|
|
useful if you have more than one SendTrig in a SynthDef.
|
||
|
|
|
||
|
|
|
||
|
|
argument::value
|
||
|
|
|
||
|
|
A UGen or float that will be polled at the time of trigger, and
|
||
|
|
its value passed with the trigger message.
|
||
|
|
|
||
|
|
|
||
|
|
Examples::
|
||
|
|
|
||
|
|
code::
|
||
|
|
|
||
|
|
s.boot;
|
||
|
|
|
||
|
|
(
|
||
|
|
SynthDef("help-SendTrig",{
|
||
|
|
SendTrig.kr(Dust.kr(1.0),0,0.9);
|
||
|
|
}).add;
|
||
|
|
|
||
|
|
// register to receive this message
|
||
|
|
o = OSCFunc({ arg msg, time;
|
||
|
|
[time, msg].postln;
|
||
|
|
},'/tr', s.addr);
|
||
|
|
)
|
||
|
|
|
||
|
|
Synth("help-SendTrig");
|
||
|
|
|
||
|
|
o.free;
|
||
|
|
::
|