Director Help Member Properties

All properties of the DirectMediaXtra cast member can be easily set in the Properties Dialog box, which is displayed when the cast member is created and also when you double-click the cast member icon in the cast window. These properties can also be set via Lingo.

File - the complete pathname of the linked media file.
Example: put the file of member 1
-- "C:\myfiles\myfile.mpg"

Title - the filename of the linked Media file. This property is used to resolve the pathname if the Media file is not found on the original location.
Example: put the title of member 1
-- "file1.mpg"

Duration - the duration of the linked Media file in milliseconds.
Example: put the duration of member 1
-- 45200

Videowidth - the original encoded width of the linked Media file, in pixels. This is a read-only property.
Example: put the videowidth of member 1
-- 320

Videoheight - the original encoded height of the linked Media file, in pixels. This is a read-only property.
Example: put the videoheight of member 1
-- 240

Volume - The default audio volume to be used during playback of new Xtra sprites. Values range from -100 to 0, expressed in dB. The sprite function SetVolume may be used when you want to modify the volume of a sprite that is already on the stage.
Example: put the volume of member 1
-- -10

Balance - The default audio balance to be used during playback of new Xtra sprites. Values range from -100 to 100, expressed in dB. The sprite function SetBalance may be used when you want to modify the balance of audio of a sprite that is already on the stage.
Example: put the balance of member 1
-- 0

Rate - The default playback rate to be used during playback. Values range from 0 to 200, expressed in percentage of the original playback rate. The sprite function SetRate may be used when you want to modify the rate of playback of a sprite that is already on the stage. IMPORTANT: Windos Media files do not support the rate property. Playback will fail if the rate is set to any value but the default of 100.
Example: set the rate of member 1 to 50

Cpuboost - DirectMediaXtra can slow down Director to allow more CPU time for the DirectShow driver. This can be useful if you are experiencing poor or stuttering playback. Legal values are in the range of 0 to 95 percent, although values over 80 may result in problems with the performance of your Director animation and/or Lingo event detection.
Example: set the cpuboost of member 1 to 50

AdjustDurationBeforePlayback - If this property is TRUE, the Xtra will scan the media file and adjust the duration of member property as soon as the sprite starts playing. This is necessary because different DirectShow filters may report different durations for the same clip. If this happens when you take your finished product to a machine with a different DirectShow filter, the Xtra may not reach certain cuepoints or it may consider that the end of the file was not reached. Depending on your scripting this can prevent your movie from operating correctly, so this setting should be enabled in the majority of cases.
Example: set the adjustdurationbeforeplayback of member 1 to TRUE

ShowLocateFileDialog - the Xtra will try to locate the linked media files at runtime if you move them from the original location. The mechanism is described in the CREATING PROJECTORS section of the documentation. If the linked file can not be found, this property is used to specify if a dialog box is displayed asking the user to locate the file, or if the Xtra fails silently.
Example: set the showlocatefiledialog of member 1 to TRUE

LinkedMediaLocated - This is a property that is set automatically by the Xtra, and indicates if the linked media file for this member was located when the movie loaded (either automatically by the Xtra, or using the Locate File dialog box.) The Xtra will not attempt to initialize playback of a linked file if this property is FALSE.
Example: put the linkedmedialocated of member 1
-- 1

HasToolbar - Indicates whether a toolbar is attached to the video window. Possible values are 0 (FALSE) or 1 (TRUE).
Example: set the hastoolbar of member 1 to TRUE

Loop - Indicates whether the linked Media file will loop automatically. Possible values are 0 (FALSE) or 1 (TRUE).
Example: set the loop of member 1 to TRUE

PlaySegment - Indicates whether only a segment of the Media file is to be played. Possible values are 0 (FALSE) and 1 (TRUE).
Example: set the playsegment of member 1 to TRUE

SegmentStart - Specifies the start time of the Media file to be played, in milliseconds. Only active if "the playsegment of the member" is TRUE.
Example: set the segmentstart of member 1 to 10700

SegmentEnd - Specifies the end time of the Media file to be played, in milliseconds. Only active if "the playsegment of the member" is TRUE.
Example: set the segmentend of member 1 to 43200

PausedAtStart - Indicates whether the Media file should be opened in "paused" state. Possible values are 0 (FALSE) and 1 (TRUE).
Example: set the pausedatstart of member 1 to TRUE

CuePointTimes - Contains a list of the cue point times associated with this member.
Example: put the cuepointtimes of member 1
-- [4500,12300,34650,67321]

CuePointNames - Contains a list of the cue point names associated with this member.
Example: put the cuepointnames of member 1
-- ["Cue 1","NewCuePoint","Start Point","Second part"]

DirectMediaXtra Help