User Guide

Description

Function; adds the given sound cast member to the queue of sound channel channelNum.

Once a sound has been queued, it can be played immediately with the

play() command. This is

because Director preloads a certain amount of each sound that is queued, preventing any delay

between the

play() command and the start of playback. The default amount of sound that is

preloaded is 1500 milliseconds. This parameter can be modified by passing a property list

containing one or more parameters with the

queue() command.

You can specify these properties may be specified with the

queue() command:

These parameters can also be passed with the

setPlayList() command.

To see an example of

queue() used in a completed movie, see the Sound Control movie in the

Learning/Lingo Examples folder inside the Director application folder.

Example

The following handler queues and plays two sounds. The first sound, cast member Chimes, is

played in its entirety. The second sound, cast member introMusic, is played starting at its 3-

second point, with a loop repeated 5 times from the 8-second point to the 8.9 second point, and

stopping at the 10-second point.

on playMusic

sound(2).queue([#member: member("Chimes")])

sound(2).queue([#member: member("introMusic"), #startTime: 3000,\

#endTime: 10000, #loopCount: 5, #loopStartTime: 8000, #loopEndTime: 8900])

sound(2).play()

end