blob: 6673d19de5252133ec70ddefeef17f128297b997 [file] [log] [blame]
-------------------------------------------------------------------------------
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.