We will be adding a new TorqueScript function to a project based on the Torque 3D Full template and try it out using the Empty Terrain level. If you haven't already, use the Torque Project Manager (Project Manager.exe) to create a new project from the Full template. It will be found under the My Projects directory. Then start up your favorite script editor, such as Torsion, and let's get going!

We are going to write a TorqueScript function that will demonstrate how to schedule a function as follows:

The example code schedules our MyScheduleFunction using the schedule() function that has the following form:

eventID = schedule( time, SimObjectID, function args… );

Here, the time parameter is the delay in milliseconds before the function is executed. The SimObjectID parameter is an optional object to invoke this function on (or 0 if no object), the function parameter is the name of the function to execute, and the args… parameter is actually a variable number of optional arguments that are passed to the given function. The eventID parameter of the scheduled event is returned by schedule() so that we may cancel the schedule before it is invoked.

If a SimObject ID is provided to the schedule() function, the schedule essentially operates as if we used the SimObject schedule() method. If the SimObject ID is left as 0 then the function is invoked on its own.

The actual time taken for the scheduled method to execute may be greater than the delay time requested. This can be due to a number of factors, such as current engine load. However, the delay will never be less than the requested time.

It is possible to manually cancel a schedule by using the cancel() function. This function has the following form:

cancel( eventID ); 

Here the eventID parameter is the value returned by the schedule() function.