Jump to content

SET (CD/XA Commands)

From EDM2

The SET command sets the various control items.

Syntax

set object keywords

Syntax Diagram

 SET ──── object ────┬── AUDIO ───┬───┬─ ALL ───┬─ ON ──┬─┬───┬──────────┬────┤
                     │            │   │         └─ OFF ─┘ │   │          │
                     │            │   ├─ LEFT ──┬─ ON ──┬─┤   ├─ WAIT ───┤
                     │            │   │         └─ OFF ─┘ │   └─ NOTIFY ─┘
                     │            │   ├─ RIGHT ─┬─ ON ──┬─┤
                     │            │   │         └─ OFF ─┘ │
                     │            │   ├─ OVER milliseconds┤
                     │            │   └─ VOLUME percentage┘
                     ├── CHANNEL number ──┬──────────────┬┘
                     │                    └─ AUDIO DEVICE┘
                     ├── DOOR CLOSED ─────────────────────┤
                     ├── DOOR LOCKED ─────────────────────┤
                     ├── DOOR OPEN ───────────────────────┤
                     ├── DOOR UNLOCKED ───────────────────┤
                     ├── TIME FORMAT MILLISECONDS ────────┤
                     ├── TIME FORMAT MMTIME ──────────────┤
                     ├── TIME FORMAT MSF ─────────────────┤
                     └── TIME FORMAT TMSF ────────────────┘

Parameters

object
Object associated with this media control interface command. The object can be one of the following:
  • Device type
  • Device name
  • Filename
  • Alias
AUDIO
Sets the audio attributes of the device context specified by the ALL, LEFT, RIGHT, OVER, and VOLUME keywords.
ALL
Applies to both/all channels (default). Specify ON or OFF with the ALL keyword.
ON
Enables audio output (or enables audio output to the left/right channel).
OFF
Disables audio output (or disables audio output to the left/right channel).
LEFT
Applies to left channel. Specify ON or OFF with the LEFT keyword.
RIGHT
Applies to right channel. Specify ON or OFF with the RIGHT keyword.
OVER milliseconds
Applies the change over the specified time period (fade).
VOLUME percentage
Sets the device/mixer channel volume level.
CHANNEL number
Channel number to set for the given device.
AUDIO DEVICE
Channel set pertains to the audio device.
DOOR CLOSED
Retracts the tray and closes the door, if possible.
DOOR LOCKED
Locks the media cover on the device (if any). This disables manual ejection of the media from the device.
DOOR OPEN
Opens the door and ejects the tray, if possible. This enables manual ejection of the media from the device.
DOOR UNLOCKED
Unlocks the media cover on the device (if any). This enables manual ejection of the media from the device.
TIME FORMAT MILLISECONDS
Sets time format, to milliseconds. All position information is in this format after this command. You can abbreviate milliseconds as ms.
TIME FORMAT MMTIME
The time format is set to MMTIME.
TIME FORMAT MSF
Sets the time format to mm:ss:ff, where mm is minutes, ss is seconds, and ff is frames. All position information is in this format after this command.
TIME FORMAT TMSF
Sets the time format to tt:mm:ss:ff where tt is tracks, mm is minutes, ss is seconds, and ff is frames. All position information is in this format after this command.
WAIT
The command is executed synchronously. The function waits until the requested action is complete before returning to the application.
NOTIFY
The command is executed asynchronously, allowing control to be returned immediately to the application. When the requested action is complete, an MM_MCINOTIFY message is sent to the application window procedure.

Example Code

set cdxa door open wait