HelpSource/Classes/ProgramChangeResponder.schelp

   1 class:: ProgramChangeResponder
   2 summary:: allow functions to be registered to respond to MIDI program change events
   3 related:: Classes/MIDIFunc, Classes/MIDIdef, Classes/MIDIResponder, Classes/CCResponder
   4 categories:: External Control>MIDI
   5
   6 Description::
   7 note:: SC 3.5 added the link::Classes/MIDIFunc:: and link::Classes/MIDIdef:: classes. These are faster, and aim to have a more convenient, logical and consistent interface, which shares a common design with link::Classes/OSCFunc:: and link::Classes/OSCdef::. They still lack some features of the MIDIresponder classes.::
   8 ClassMethods::
   9
  10 method::new
  11
  12 argument::function
  13 A link::Classes/Function:: to be evaluated. Arguments passed to the function are: src, chan, value.
  14
  15 argument::src
  16 The src number may be the system UID (obtained from code:: MIDIClient.sources[index].uid ::) or the index of the source in the code:: MIDIClient.sources :: array. nil matches all.
  17
  18 argument::chan
  19 An link::Classes/Integer:: between 0 and 15 that selects which MIDI channel to match. nil matches all. May also be a link::Classes/Function:: which will be evaluated to determine the match. eg: { |val| val < 2 }
  20
  21 argument::num
  22 An link::Classes/Integer:: between 0 and 127 that selects which program change number to match. nil matches all. May also be a link::Classes/Function:: which will be evaluated to determine the match. eg: { |val| val >= 4 }
  23
  24 argument::install
  25 If true, then if the midi event is matched, cease testing any further responders. Note that doing this will prevent any other responders of this type from responding, including ones added behind the scenes in classes. Note also that this functionality is sensitive to the order in which responders are added.
  26
  27 Examples::
  28
  29 code::
  30 (
  31         c = ProgramChangeResponder({ |src,chan,val|
  32                 [src,chan,val].postln;
  33                 },
  34                 nil, // any source
  35                 nil, // any channel
  36                 nil // any value
  37         )
  38 )
  39
  40 c.remove
  41 ::
  42
  43 code::
  44 (
  45         c = ProgramChangeResponder({ |src,chan,val|
  46                 [src,chan,val].postln;
  47                 },
  48                 nil, // any source
  49                 nil, // any channel
  50                 (50..60) // within this value range
  51         )
  52 )
  53
  54 c.remove
  55 ::