User Guide

registerScript() 501

• duration is the total number of milliseconds that will elapse between the registerForEvent

call and the last

#timeMS event. For example, if there are five iterations with a period of 500

ms, the duration is 2500 ms. For tasks with unlimited iterations, the duration is 0.

• systemTime is the absolute time in milliseconds since the Director movie started.

scriptObject Required. Specifies the script object that contains the handler handlerName. If 0

is specified for

scriptObject, then the first event handler with the given name found in a movie

script is called.

begin Optional. Specifies the number of milliseconds after registerForEvent() is called that

the first

#timeMS event occurs.

period Optional. Specifies the number of milliseconds between #timeMS events when the value

repetitions is greater then 0.

repetitions Optional. Specifies the number of repetitions for the #timeMS event. If

repetitions is 0, the #timeMS event occurs indefinitely.

Example

This statement registers the promptUser event handler found in a movie script to be called twice

at an interval of 5 seconds:

member("Scene").registerForEvent(#timeMS, #promptUser, 0, \

5000, 5000, 2)

This statement registers the promptUser event handler found in a movie script to be called each

time a collision occurs within the cast member named Scene:

member("Scene").registerForEvent(#collideAny, #promptUser, 0)

This statement declares the on promptUser handler in the same script that contains the

registerForEvent command to be called when any object collides with the model named Pluto

in the cast member named Scene:

member("Scene").registerForEvent(#collideWith, #promptUser, me, \

member("Scene").model("Pluto"))