User Guide

Chapter 3166
Description
System message and event handler; contains statements that run each time a sound or sprite
passes a cue point in its media.
• me—The optional me parameter is the scriptInstanceRef value of the script being invoked.
You must include this parameter when using the message in a behavior. If this parameter is
omitted, the other arguments will not be processed correctly.
• channelID—The number of the sound or sprite channel for the file where the cue
point occurred.
• cuePointNumber—The ordinal number of the cue point that triggers the event in the list of
the cast member’s cue points.
• cuePointName—The name of the cue point that was encountered.
The message is passed—in order—to sprite, cast member, frame, and movie scripts. For the sprite
to receive the event, it must be the source of the sound, like a QuickTime movie or SWA cast
member. Use the
isPastCuePoint property to check cues in behaviors on sprites that don’t
generate sounds.
Example
This handler placed in a Movie or Frame script reports any cue points in sound channel 1 to the
Message window:
on cuePassed channel, number, name
if (channel = #Sound1) then
put "CuePoint" && number && "named" && name && "occurred in sound 1"
end if
end
See also
scriptInstanceList, cuePointNames, cuePointTimes, isPastCuePoint()
cuePointNames
Syntax
member(whichCastMember).cuePointNames
the cuePointNames of member whichCastMember
Description
Cast member property; creates list of cue point names, or if a cue point is not named, inserts an
empty string (
"") as a placeholder in the list. Cue point names are useful for synchronizing sound,
QuickTime, and animation.
This property is supported by SoundEdit cast members, QuickTime digital video cast members,
and Xtra extension cast members that contain cue points. Xtra extensions that generate cue points
at run time may not be able to list cue point names.
Example
This statement obtains the name of the third cue point of a cast member.
Dot syntax:
put member("symphony").cuePointNames[3]
Verbose syntax:
put (getAt(the cuePointNames of member "symphony",3))
See also
cuePointTimes, mostRecentCuePoint