139 lines
3.3 KiB
Text
139 lines
3.3 KiB
Text
class:: SkipJack
|
|
summary:: A utility for background tasks that survive cmd-period
|
|
categories:: Scheduling, Libraries>JITLib>GUI
|
|
related:: Classes/CmdPeriod
|
|
|
|
Description::
|
|
SkipJack is a utility to run a function in the background repeatedly, that survive cmd-period.
|
|
|
|
A typical use is with a window displaying the state of some objects every now and then. (This is better in some cases than
|
|
updating the GUI at every change. If the changes happen fast, you don't choke your CPU on gui updating.)
|
|
|
|
But SkipJack is useful whenever you need a periodic function to run in the background and not go away if the user hits cmd-period.
|
|
|
|
ClassMethods::
|
|
|
|
private::initClass
|
|
|
|
method::new
|
|
|
|
argument::updateFunc
|
|
A link::Classes/Function:: to repeat in the background.
|
|
|
|
argument::dt
|
|
The time interval at which to repeat. It can also be a stream or a function that returns a number.
|
|
|
|
argument::stopTest
|
|
A test whether to stop the task now. Usually a Function.
|
|
|
|
argument::name
|
|
A name for this skipjack. Used for posting information and in the link::#*stop:: classmethod.
|
|
|
|
argument::clock
|
|
The clock that plays the task. Default is link::Classes/AppClock::, so SkipJack can call GUI primitives. If you need more precise timing, you can supply your own clock, and use defer only where necessary.
|
|
|
|
argument::autostart
|
|
When true (default) SkipJack starts automatically as it is created.
|
|
|
|
method:: stop
|
|
Stop a skipjack by name.
|
|
|
|
method:: stopAll
|
|
Stop all skipjacks.
|
|
|
|
method:: defaultClock
|
|
The default clock (AppClock)
|
|
|
|
method:: verbose
|
|
When true, SkipJack posts messages when it starts, stops or restarts.
|
|
|
|
method:: all
|
|
The global set of all skipjacks.
|
|
|
|
Instancemethods::
|
|
private:: cmdPeriod
|
|
|
|
method:: dt
|
|
Get or set the time interval.
|
|
|
|
method:: task
|
|
The internal Routine that wraps updateFunc.
|
|
|
|
method:: name
|
|
The name of this skipjack.
|
|
|
|
method:: stopTest
|
|
The current stopTest. (see argument in link::#*new:: )
|
|
|
|
method:: start
|
|
Start this skipjack.
|
|
|
|
method:: play
|
|
Same as code::start::
|
|
|
|
method:: stop
|
|
Stop this skipjack.
|
|
|
|
method:: clock
|
|
Get or set the clock used. This will only be updated when the skipjack restarts.
|
|
|
|
method:: updateFunc
|
|
The updateFunc set by the argument to link::#*new::
|
|
|
|
Examples::
|
|
Simple example:
|
|
code::
|
|
w = SkipJack({ "watch...".postln; }, 0.5, name: "test");
|
|
SkipJack.verbose = true; // post stop/wakeup logs
|
|
|
|
w.stop;
|
|
w.start;
|
|
|
|
// now try to stop with cmd-. : SkipJack always restarts itself.
|
|
thisProcess.stop;
|
|
|
|
w.stop;
|
|
::
|
|
|
|
Using stopTest:
|
|
code::
|
|
a = 5;
|
|
w = SkipJack({ "watch...".postln; }, 0.5, { a == 10 }, "test");
|
|
a = 10; // fulfill stopTest
|
|
::
|
|
|
|
Typical use: SkipJack updates a window displaying the state of some objects every now and then.
|
|
code::
|
|
(
|
|
d = (a: 12, b: 24);
|
|
d.win = Window("dict", Rect(0,0,200,60)).front;
|
|
d.views = [\a, \b].collect { |name, i|
|
|
StaticText(d.win, Rect(i * 100,0,96,20))
|
|
.background_(Color.yellow).align_(0).string_(name);
|
|
};
|
|
w = SkipJack({
|
|
"...".postln;
|
|
[\a, \b].do { |name, i|
|
|
d.views[i].string_(name ++ ":" + d[name])
|
|
}
|
|
},
|
|
0.5,
|
|
{ d.win.isClosed },
|
|
"showdict"
|
|
);
|
|
)
|
|
|
|
d.a = 123; // updates should be displayed
|
|
d.b = \otto;
|
|
d.win.close; // when window closes, SkipJack stops.
|
|
::
|
|
|
|
If you need to get rid of an unreachable skipjack:
|
|
code::
|
|
SkipJack({ "unreachable, unkillable...".postln }, name: "jack");
|
|
|
|
SkipJack.stopAll // do this to stop all;
|
|
|
|
SkipJack.stop("jack"); // reach it by name and stop
|
|
::
|
|
|