Help/Streams-Patterns-Events/Patterns/PhidKey.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <meta http-equiv="Content-Style-Type" content="text/css">
   6 <title></title>
   7 <meta name="Generator" content="Cocoa HTML Writer">
   8 <meta name="CocoaVersion" content="949.43">
   9 <style type="text/css">
  10 p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
  11 p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; min-height: 12.0px}
  12 p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
  13 p.p4 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #bf0000}
  14 p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco}
  15 p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #007300}
  16 p.p7 {margin: 0.0px 0.0px 0.0px 0.0px; font: 9.0px Monaco; color: #0000bf}
  17 span.s1 {font: 18.0px Helvetica}
  18 span.s2 {font: 9.0px Monaco}
  19 span.s3 {color: #0000bf}
  20 span.s4 {color: #000000}
  21 span.s5 {color: #007300}
  22 span.Apple-tab-span {white-space:pre}
  23 </style>
  24 </head>
  25 <body>
  26 <p class="p1"><span class="s1"><b>PhidKey</b></span><span class="s2"><span class="Apple-tab-span">      </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></span><b>pattern that polls values from a human device interface, based on a named slot</b></p>
  27 <p class="p2"><br></p>
  28 <p class="p2"><br></p>
  29 <p class="p1">superclass: Pattern</p>
  30 <p class="p2"><br></p>
  31 <p class="p2"><br></p>
  32 <p class="p1"><b>*new(key, device, repeats)</b></p>
  33 <p class="p2"><span class="Apple-tab-span">     </span></p>
  34 <p class="p1"><span class="s2"><span class="Apple-tab-span">    </span><span class="Apple-tab-span">    </span></span><b>key</b><span class="Apple-tab-span">   </span><span class="Apple-tab-span">    </span>key defined in the Spec of the device, pointing to a slot like a button or an axis</p>
  35 <p class="p3"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
  36 <p class="p1"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><b>device</b><span class="Apple-tab-span">       </span><span class="Apple-tab-span">    </span>a GeneralHIDDevice, or an element from the GeneralHID.deviceList, which will then be opened by the pattern</p>
  37 <p class="p3"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
  38 <p class="p1"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span><b>repeats</b><span class="Apple-tab-span">      </span><span class="Apple-tab-span">    </span>number of values to return (defaults to inf)</p>
  39 <p class="p3"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
  40 <p class="p1"><b>See also:</b> <a href="../../Control/GeneralHID.html"><span class="s2">GeneralHID</span></a> and <a href="PhidSlot.html"><span class="s2">PhidSlot</span></a></p>
  41
  42 <p class="p3"><span class="Apple-tab-span">     </span><span class="Apple-tab-span">    </span></p>
  43
  44 <p class="p4">// example <br>
  45
  46 // build the device list and start the event loop: <br>
  47 GeneralHID.buildDeviceList; <br>
  48 GeneralHID.startEventLoop; <br>
  49  <br>
  50 // find an Impact game device and open it: <br>
  51 a = GeneralHID.open( GeneralHID.findBy( 1973 ) ); <br>
  52
  53 // define a spec: <br>
  54 ( <br>
  55 a.add( \lx, [3,0]); // left x <br>
  56 a.add( \ly, [3,1]); // left y <br>
  57 a.add( \rx, [3,2]); // right x <br>
  58 a.add( \ry, [3,5]); // right y <br>
  59 ); <br>
  60
  61 // or find a spec defined previously for this device: <br>
  62 c = a.findSpec; <br>
  63 // set it: <br>
  64 a.setSpec( c[0] ); <br>
  65
  66 // inspect the spec <br>
  67 a.spec.map <br>
  68 a.caps; <br>
  69
  70 // boot the server <br>
  71 s.boot; <br>
  72
  73 // simple example: <br>
  74 p = Pbind( <br>
  75         \degree, ( PhidKey( \lx, a, inf )*12 ).round(1), <br>
  76         \dur, 0.25 <br>
  77 ).play; <br>
  78
  79 p.stop; <br>
  80
  81 // more complex example, showing multichannel expansion and sequences of slots: <br>
  82 p = Pbind( <br>
  83         \degree, ( PhidKey( Pseq([[\lx,\ly],\rx,\ry],inf), a, inf )*12 ).round(1), <br>
  84         \dur, 0.25 <br>
  85 ).play; <br>
  86
  87 p.stop; <br>
  88
  89
  90 // clean up: close the device and stop the eventloop <br>
  91 a.close; <br>
  92 GeneralHID.stopEventLoop; <br>
  93 </p>
  94
  95 </body>
  96 </html>