A newer version of Max is available. Click here to access the latest version of this document.

timer

Report elapsed time between two events

Description

timer resets the time elapsed since the object was started to zero and starts keeping time when a bang is sent to the left inlet. The elapsed time output each time a bang is sent to the right inlet can be set for milliseconds, or ticks (one of the Max time format options).

Arguments

None.

Messages

bang		In left inlet: Starts - or restarts - the timer. In right inlet: Sends out the time elapsed since the timer was started.
clock	setclock object name [symbol]	The word clock, followed by the name of an existing setclock object, sets the timer object to be controlled by that setclock object rather than by Max’s internal millisecond clock. The word clock by itself sets the timer object back to using Max’s regular millisecond clock.

Attributes

Name	Type	g/s	Description
format	symbol		Set the time format to use for output (defult = milliseconds). By default, the output is in milliseconds. Output may also be specified in ticks (one of the Max time format options).
transport	symbol		The name of a transport object with which to associate. By default, the global transport is used. This is used in the output format conversion.

Information for box attributes common to all objects

Output

float: When a bang is received in the right inlet, the time elapsed -- in milliseconds -- since the timer was started, is sent out the outlet.

Examples

Report time between bang messages... A single event can report time then restart timer

Name	Description
clocker	Report elapsed time, at regular intervals
cpuclock	Precise "real-world" time measurements
delay	Delay a bang before passing it on.
setclock	Control the clock speed of timing objects remotely
transport	Control a master clock and report time values.
Max Basic Tutorial 19: Timing	Max Basic Tutorial 19: Timing