digitalVideoTimeScale

Syntax

the digitalVideoTimeScale
Description

System property; determines the time scale, in units per second, that the system uses to track digital video cast members.

For example, if digitalVideoTimeScale is set to:

100—The time scale is 1/100 of a second (and the movie is tracked in 100 units per second).

500—The time scale is 1/500 of a second (and the movie is tracked in 500 units per second).

0—Director uses the time scale of the movie that is currently playing.



Set digitalVideoTimeScale to precisely access tracks by ensuring that the system's time unit for video is a multiple of the digital video's time unit.

This property can be tested and set.

Example

This statement sets the time scale that the system uses to measure digital video to 600 units per second:

the digitalVideoTimeScale to 600

EMPTY

Syntax

EMPTY
Description

Character constant; represents the empty string, "", a string with no characters.

Example

This statement erases all characters in the field cast member Notice by setting the field to EMPTY:

member("Notice").text = EMPTY

enabled

Syntax

the enabled of menuItem whichItem of menu whichMenu
Description

Menu item property; determines whether the menu item specified by whichItem is displayed in plain text and is selectable (TRUE, default) or appears dimmed and is not selectable (FALSE).

The expression whichItem can be either a menu item name or a menu item number. The expression whichMenu can be either a menu name or a menu number.

The enabled property can be tested and set.

Note: Menus are not available in Shockwave

Example

This handler enables or disables all the items in the specified menu. The argument theMenu specifies the menu; the argument Setting specifies TRUE or FALSE. For example, the calling statement ableMenu ("Special", FALSE) disables all the items in the Special menu.

on ableMenu theMenu, vSetting
    set n = the number of menuItems of menu theMenu
    repeat with i = 1 to n
        set the enabled of menuItem i of menu theMenu to vSetting
    end repeat
end ableMenu
See also

name (menu property), number (menus), checkMark, script, number (menu items)

end

Syntax

end
Description

Keyword; marks the end of handlers and multiple-line control structures.

endColor

Syntax

the endColor of member whichCastMember
Description

Vector shape cast member property; the ending color of a gradient shape's fill specified as an RGB value.

endColor is only valid when the fillMode is set to #gradient, and the starting color is set with fillColor.

This property can be tested and set.

To see an example of endColor used in a completed movie, see the Vector Shapes movie in the Learning\Lingo Examples folder inside the Director application folder.

See also

color(), fillColor, fillMode

endRecording

Syntax

endRecording
Description

Keyword; ends a Score update session. You can resume control of Score channels through puppetting after the endRecording keyword is issued.

Example

When used in the following handler, the endRecording keyword ends the Score generation session:

on animBall numberOfFrames
    beginRecording
        horizontal = 0
        vertical = 100
        repeat with i = 1 to numberOfFrames
            go to frame i
            sprite(20).member = member "Ball"
            sprite(20).locH = horizontal
            sprite(20).locV = vertical
            horizontal = horizontal + 3
            vertical = vertical + 2
            updateFrame
        end repeat
    endRecording
end
See also

beginRecording, scriptNum, tweened, updateFrame

id3Tags

Syntax

member(whichMember).id3Tags
Description

MP3 sound property; returns the list of ID3 tags from the sound file. These tags include information provided by the sound's author. The id3Tags returns a property list that may include any of the following properties: Tag Name
Content

TALB
Album/Movie/Show title

TBPM
Beats Per Minute

TCOM
Composer

TCON
Content type

TCOP
CopyRight message

TDAT
Date

TDLY
Playlist delay

TENC
Encoded By

TEXT
Text Writer

TFLT
File Type

TIME
Time

TIT1
Content group description

TIT2
Title/SongName/Content description

TIT3
Subtitle/ Description refinement

TKEY
Initial Key

TLAN
Language(s)

TLEN
Length

TMED
Media Type

TOAL
Original album/movie/showTitle

TOFN
Original FileName

TOLY
Original lyrics/text writer(s)

TOPE
Original Artist/performer

TORY
Original release year

TOWN
File owner/licensee

TPE1
Lead performers/Soloists

TPE2
Band

TPE3
Conductor

TPE4
Modified by

TPOS
Part of set

TPUB
Publisher

TRCK
Track number

TRDA
Recording dates

TRSN
Internet radio station name

TRSO
Internat radio station owner

TSIZ
Size

TSRC
ISRC (International standard recording code)

TSSE
Software/ hardware and settings used for encoding

TYER
Year

COMM
Comment




The id3Tags property can only be tested for MP3 cast members that are inserted into the cast via the Insert > Shockwave Audio command. The member must be preloaded with preLoadBuffer() before the id3Tags property is tested. Id3Tags information is not available from MP3's that are imported via the Import command or for Shockwave Audio (.swa) files.

The id3Tags property cannot be set within Director. However, most MP3 playback and extraction applications offer this capability.

Example

These statements display the ID3 tags of the MP3 cast member Title Song in the Message window:

member("TitleSong").preload()
put member("Title Song").id3Tags
-- [#TALB: "Love Theme", #TCOM: "Jane Smith", #TRDA: "8/19/76"]
See also

preLoadBuffer()