timer

Go to: Synopsis. Return value. Keywords. Related. Flags. MEL examples.

Synopsis

timer [-endTimer] [-lapTime] [-name string] [-startTimer]

timer is NOT undoable, NOT queryable, and NOT editable.

Allow simple timing of scripts and commands. The resolution of this timer is at the level of your OS's gettimeofday() function.

Note:This command does not handle stacked calls. For example, this code below will give an incorrect answer on the second timer -e call.

timer -s;
timer -s;
timer -e;
timer -e;

timer -s;
timer -s -name "innerTimer";
timer -e -name "innerTimer";
timer -e;

• I the -e flag or -lap flag return the time elapsed since the last 'timer -s' call.
• I the -s flag has no return value.

Return value

None

Keywords

Related

Flags

Long name (short name)	Argument types	Properties
-endTimer(-e)
Stop the timer and return the time elapsed since the timer was started (in seconds). Once a timer is turned off it no longer exists, though it can be recreated with a new start
-lapTime(-lap)
Get the lap time of the timer (time elapsed since start in seconds). Unlike the end flag this keeps the timer running.
-name(-n)	string
Use a named timer for the operation. If this is omitted then the default timer is assumed.
-startTimer(-s)
Start the timer.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command.

MEL examples

timer -s;
// code being timed
print( "START: time this\n" );
for ($i = 0 ; $i<50 ; $i++)
	print( "time this "+$i+"\n" );
print( "END: time this\n" );
timer -e;

// Named timers can be used for nesting
timer -s -tn "outerLoop";
print( "START: macro loop timing\n" );
for ($i=0; $i<50; $i++ )
{
	timer -s;
	for ($j=5; $j<50; $j++ )
	{
		delete `sphere -spans $j`;
	}
	$innerTime = `timer -e`;
	print( "\tInner loop " + $i + " = " + $innerTime + "\n" );
	$lapTime = `timer -lap -tn "outerLoop"`;
	print( "\t       SUB = " + $lapTime + "\n" );
}
$lapTime = `timer -e -tn "outerLoop"`;
print( "END: Full timing was " + $lapTime + "\n" );