SET (CD Audio Commands)

The SET command configures various control items for the CD audio device, such as audio channel output, physical door state, and time display formats.

Syntax

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

Keywords

object

Object associated with this media control interface command (Device type, name, filename, or alias).

AUDIO

Required prefix to set audio attributes using the **ALL**, **LEFT**, **RIGHT**, **OVER**, or **VOLUME** keywords.

ALL | LEFT | RIGHT

Specifies which channel(s) the **ON** or **OFF** command applies to. **ALL** is the default.

**ON**: Enables audio output for the specified channel.
**OFF**: Disables audio output for the specified channel.

OVER milliseconds

Specifies a transition time for audio changes, allowing for fade-in or fade-out effects.

VOLUME percentage

Sets the audio volume level as a percentage (0–100).

DOOR CLOSED | DOOR OPEN

Physically controls the CD tray. **DOOR OPEN** ejects the tray; **DOOR CLOSED** retracts it.

DOOR LOCKED | DOOR UNLOCKED

Locks or unlocks the manual eject button on the CD device.

TIME FORMAT format

Sets the unit of measurement for position information:

**MILLISECONDS (ms)**: Standard time units.
**MMTIME**: Multimedia time format.
**MSF**: Minutes, Seconds, Frames ($mm:ss:ff$). Max values: 99m, 59s, 74f.
**TMSF**: Tracks, Minutes, Seconds, Frames ($tt:mm:ss:ff$). Max values: 99t, 99m, 59s, 74f.

WAIT: Executes the command synchronously.
NOTIFY: Executes the command asynchronously and sends an MM_MCINOTIFY message upon completion.

Purpose

The SET command is the primary tool for defining the environment of the CD device, particularly for syncing time formats with application UI and managing physical media security (locking the door).

Example

set cdaudio time format tmsf wait

*(Configures the device to report and accept positions in Track:Minutes:Seconds:Frames format)*