HelpSource/Classes/SystemClock.schelp

   1 CLASS::SystemClock
   2 categories::Scheduling>Clocks
   3 summary:: Clock running on separate accurately timed thread
   4 related::Classes/AppClock, Classes/TempoClock
   5
   6 DESCRIPTION::
   7
   8 SystemClock is more accurate, but cannot call Cocoa primitives. AppClock is less accurate (uses NSTimers) but can call Cocoa primitives.
   9
  10 CLASSMETHODS::
  11
  12 method::sched
  13 The float you return specifies the delta to resched the function for. Returning nil will stop the task from being rescheduled.
  14 code::
  15 (
  16 SystemClock.sched(0.0,{ arg time;
  17         time.postln;
  18         rrand(0.1,0.9);
  19 });
  20 )
  21 ::
  22 code::
  23 (
  24 SystemClock.sched(2.0,{
  25         "2.0 seconds later".postln;
  26         nil;
  27 });
  28 )
  29 ::
  30
  31 method::clear
  32 Clear the SystemClock's scheduler to stop it.
  33 code::
  34 SystemClock.clear;
  35 ::
  36
  37 method::schedAbs
  38 code::
  39 (
  40 SystemClock.schedAbs( (thisThread.seconds + 4.0).round(1.0),{ arg time;
  41         ("the time is exactly " ++ time.asString
  42                 ++ " seconds since starting SuperCollider").postln;
  43 });
  44 )
  45 ::
  46
  47 method::play
  48 Calls to the cocoa framework (including all GUI) may not be made directly from actions triggered by SystemClock or incoming socket messages (OSCFunc).
  49
  50 To get around this, use code::{ }.defer ::. This will execute the function using the AppClock and is equivalent to code::AppClock.sched(0, function)::
  51
  52 code::
  53 (
  54 var w, r;
  55 w = Window.new("trem", Rect(512, 256, 360, 130));
  56 w.front;
  57 r = Routine({ arg time;
  58         60.do({ arg i;
  59                 0.05.yield;
  60                 {
  61                         w.bounds = w.bounds.moveBy(10.rand2, 10.rand2);
  62                         w.alpha = cos(i*0.1pi)*0.5+0.5;
  63                 }.defer;
  64         });
  65         1.yield;
  66         w.close;
  67 });
  68 SystemClock.play(r);
  69 )
  70 ::
  71 This example is only to show how to make calls to Cocoa/GUI when scheduling with the SystemClock. If you only wish to control the GUI, use AppClock.