64 lines
2.9 KiB
Plaintext
64 lines
2.9 KiB
Plaintext
-------------------------------------------------------------------------------
|
|
DojoX Timing
|
|
-------------------------------------------------------------------------------
|
|
Version 0.1.0
|
|
Release date: 08/08/2007
|
|
-------------------------------------------------------------------------------
|
|
Project state:
|
|
experimental
|
|
-------------------------------------------------------------------------------
|
|
Credits
|
|
Tom Trenka (ttrenka AT gmail.com): original Timer, Streamer, Thread and ThreadPool
|
|
Wolfram Kriesing (http://wolfram.kriesing.de/blog/): Sequence
|
|
Jonathan Bond-Caron (jbondc AT gmail.com): port of Timer and Streamer
|
|
Pete Higgins (phiggins AT gmail.com): port of Sequence
|
|
Mike Wilcox (anm8tr AT yahoo.com): dojo.doLater
|
|
-------------------------------------------------------------------------------
|
|
Project description
|
|
|
|
DojoX Timing is a project that deals with any kind of advanced use of timing
|
|
constructs. The central object, dojox.timing.Timer (included by default), is
|
|
a simple object that fires a callback on each tick of the timer, as well as
|
|
when starting or stopping it. The interval of each tick is settable, but the
|
|
default is 1 second--useful for driving something such as a clock.
|
|
|
|
dojox.timing.Streamer is an object designed to facilitate streaming/buffer-type
|
|
scenarios; it takes an input and an output function, will execute the output
|
|
function onTick, and run the input function when the internal buffer gets
|
|
beneath a certain threshold of items. This can be useful for something timed--
|
|
such as updating a data plot at every N interval, and getting new data from
|
|
a source when there's less than X data points in the internal buffer (think
|
|
real-time data updating).
|
|
|
|
dojox.timing.Sequencer is an object, similar to Streamer, that will allow you
|
|
to set up a set of functions to be executed in a specific order, at specific
|
|
intervals.
|
|
|
|
The DojoX Timing ThreadPool is a port from the original implementation in the
|
|
f(m) library. It allows a user to feed a set of callback functions (wrapped
|
|
in a Thread constructor) to a pool for background processing.
|
|
|
|
dojo.doLater() provides a simple mechanism that checks a conditional before allowing
|
|
your function to continue. If the conditional is false, the function is blocked and continually
|
|
re-called, with arguments, until the conditional passes.
|
|
-------------------------------------------------------------------------------
|
|
Dependencies:
|
|
|
|
DojoX Timing only relies on the Dojo Base.
|
|
-------------------------------------------------------------------------------
|
|
Documentation
|
|
|
|
TBD.
|
|
-------------------------------------------------------------------------------
|
|
Installation instructions
|
|
|
|
Grab the following from the Dojo SVN Repository:
|
|
http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/timing.js
|
|
http://svn.dojotoolkit.org/var/src/dojo/dojox/trunk/timing/*
|
|
|
|
Install into the following directory structure:
|
|
/dojox/timing.js
|
|
/dojox/timing/
|
|
|
|
...which should be at the same level as your Dojo checkout.
|