find_movie

Declaration

find_movie (name: STRING): STRING

Description

Finds the first movie named name in the current list of frames. Use this function if you only know the name of the movie, but not which frame it is in. The name of the movie is not the same as the file name. The name is assigned as a property of the movie when you make the page.

All of the movie functions only operate on the first movie of that name in a given frame. If you want to have movies with the same name, but in different frames you can't use find movie to find all of them; you will have to know the frame names in advance.

See Also

movie
multimedia functions
Frame Manager

Example

script restart_intro_movie is
  movie_frame   :=   find_movie ('intro_logo')
  if is_movie (movie_frame, 'intro_logo') then
      -- in case the frame is empty
    stop_movie (movie_frame, 'intro_logo')
    go_to_movie_start (movie_frame, 'intro_logo')
    start_movie (movie_frame, 'intro_logo')
  end
end