aboutsummaryrefslogtreecommitdiff
path: root/includes/js/dojox/timing/README
blob: e9b19b5e19a9fc1693a602d8aef71bb78e49b760 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
-------------------------------------------------------------------------------
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
-------------------------------------------------------------------------------
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.
-------------------------------------------------------------------------------
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.