Lingo Dictionary > G-K > go |
![]() ![]() ![]() |
go
Syntax
go {to} {frame}
whichFrame
go {to} movie
whichMovie
go {to} {frame} whichFrame of movie
whichMovie
Description
Command; causes the playback head to branch to the frame specified by whichFrame
in the movie specified by whichMovie
. The expression whichFrame
can be a marker label or an integer frame number. The expression whichMovie
must specify a movie file. (If the movie is in another folder, whichMovie
must specify the path.)
The phrase go loop
tells the playback head to loop to the previous marker and is a convenient means of keeping the playback head in the same section of the movie while Lingo remains active and avoids the use of go to the frame
in a frame that has a transition which would slow the movie and overwhelm the processor.
It is best to refer to marker labels instead of frame numbers; editing a movie can cause frame numbers to change. Using marker labels also makes it easier to read scripts.
The go to movie
command loads frame 1 of the movie. If the command is called from within a handler, the handler in which it is placed continues executing. To suspend the handler while playing the movie, use the play
command, which may be followed by a subsequent play done
to return.
When you specify a movie to play, specify its path if the movie is in a different folder, but to prevent a potential load failure, don't include the movie's .dir, .dxr or .dcr file extension.
To more efficiently go to a movie at a URL, use the downloadNetThing
command to download the movie file to a local disk first and then use the go to movie
command to go to that movie on the local disk.
The following are reset when a movie is loaded: beepOn
and constraint
properties; keyDownScript
, mouseDownScript
, and mouseUpScript
; cursor
and immediate
sprite properties; cursor
and puppetSprite
commands; and custom menus. However, the timeoutScript
is not reset when loading a movie.
Example
This statement sends the playback head to the marker named start:
go to "start"
Example
This statement sends the playback head to the marker named Memory in the movie named Noh Tale to Tell:
go frame("Memory") of movie("Noh Tale to Tell")
Example
This handler tells the movie to loop in the current frame. This handler is useful for making the movie wait in a frame while it plays so the movie can respond to events.
on exitFrame go the frame end
See also
downloadNetThing
, gotoNetMovie
, label()
, marker()
, pathName (movie property)
, play
, play done
![]() ![]() ![]() |