forked from livecode/livecode
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathplayer.lcdoc
More file actions
37 lines (21 loc) · 2.12 KB
/
Copy pathplayer.lcdoc
File metadata and controls
37 lines (21 loc) · 2.12 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
Name: player
Type: object
Syntax: player
Summary: A <control> that displays a movie or sound <file>.
Introduced: 1.0
OS: mac,windows,linux
Platforms: desktop,server,web
Example:
start player "San Antone"
Example:
hide player (the selectedText of button "Current Movie")
Description:
Use the <player> <object type> to display a movie or sound from a separate <file>.
Unlike an audio clip or video clip, a player does not contain the movie or sound data. Instead, you use the player's filename <property> to indicate the separate <file> that holds the movie or sound. This reduces the memory required by your <stack>, because the movie or sound data is only <loaded into memory> when it's being used, rather than being <loaded into memory> whenever the <stack file> is open. However, it also makes it possible for the movie or sound data to be misplaced during distribution, since the <file> is separate from your <stack file>.
A player is contained in a card, group, or background. Players cannot contain other objects.
The player object has a number of properties and messages associated with it. To see a list of messages that can be sent to a player as a result of user actions or internal LiveCode events, open the "LiveCode Language Dictionary" page of the main Documentation window, ensure that the player column is visible and use sort and filter to bring the relevant entries to the top.
>*Important:* Setting a <player|player's> filename does not automatically update its <currentTime> <property>. If you play a <movie|movie file>, then change the <player|player's> <filename> in order to play another, you must reset the <currentTime> to zero in order to start from the beginning of the second <movie> :
set the filename of player "My Player" to "SecondMovie.mov"
set the currentTime of player "My Player" to zero
References: templatePlayer (keyword), control (keyword), file (keyword), filename (property), currentTime (property), qtIdleRate (property), stack (object), player (object), property (glossary), stack file (glossary), movie (glossary), loaded into memory (glossary), object type (glossary), movie (function)
Tags: objects