SET (CD/XA Commands)
Appearance
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