---

The ARexx interface

---

RexxCD features an ARexx interface, from there you can control the program behaviour. If you are not familiar with ARexx, please refer to the "ARexx User's Guide" supplied with your computer.

---

ARexx commands

---

ARexx commands in RexxCD:

---

ACTIVATE

---

---

BUTTON

---

---

DEACTIVATE

---

Template:

,

Function:

Iconifies RexxCD.

Options:

Example:

DEACTIVATE

See also:

---

DISABLE

---

---

EJECT

---

Template:

,

Function:

---

ENABLE

---

Template:

NAMES/M

Function:

This command enables the specified command or commands.

Options:

NAMES/M
A list of commands to enable.

Example:

ENABLE LOCK

See also:

---

GETATTR

---

Template:

OBJECT/A,NAME,FIELD,STEM/K,VAR/K

Function:

Get parameters from RexxCD.

Options:

OBJECT/A

APPLICATION
        .NAME
        .VERSION
        .SCREEN

SETTINGS
        .REPEAT
        .CREATEICONS
        .ALLOWMACROS
        .TOCPATH

BUTTON
        .1
        .2
        .3
        .4
        .5
        .6
        .7

DEVICE
        .NAME
        .UNIT

VOLUME
        .LEFT
        .RIGHT

DRIVE
        .NAME
        .VENDOR
        .REVISION
        .PRIVATE
        .STATUS
                0 - No disc
                1 - Playing
                2 - Paused
                3 - Stopped
        .TYPE
                0  - Hard disc
                1  - Streamer
                2  - Printer
                3  - CPU
                4  - WORM
                5  - CD-ROM
                6  - Scanner
                7  - MO
                8  - Jukebox
                9  - Comm
                10 - Pre-Press device
                11 - Pre-Press device
        .BPS
        .STEREO
        .COMPATFIXES

DISC
        .ARTIST
        .TITLE
        .ID
        .BARCODE
        .IDFILE
        .LENGTH
        .ELAPSED

TRACK
        .COUNT
        .CURRENT
        .ELAPSED

        With NAME (track number) set:
        .LENGTH
        .LYRICS
        .ARTIST
        .TITLE

NAME argument required:(TEXTFONT, DIGITFONT, LYRICFONT)
FONT
        .NAME
        .SIZE

NAME argument required: (MAIN, LYRICS)
WINDOW
        .TOP
        .LEFT
        .WIDTH
        .HEIGHT
        .TITLE
        .OPEN

NAME
If there are multiple instances of the same type of data you have to specify the name.
For example: if you want to get attributes for the text font to the stem 'TEST':
GETATTR FONT NAME TEXTFONT STEM TEST

FIELD
Only get the specified field

STEM/K
Put results in the named stem variable

VAR/K
Put the result into the named variable. Multiple fields are separated with spaces. If neither VAR or STEM are specified, the result will be placed in the special ARexx variable called 'RESULT'.

Example:

/* Show the table of contents */
GETATTR TRACK STEM TRACK
do i=1 to TRACK.COUNT
      'GETATTR TRACK NAME 'i' STEM TRACK'
      Say RIGHT(i, 2, '0')': 'TRACK.ARTIST' - 'TRACK.TITLE
      end

See also:

---

HELP

---

Template:

COMMAND,PROMPT/S

Function:

This command will display a list of the available commands in RexxCD. This might be useful if you don't have the documentation at hand.

Options:

COMMAND
Get detailed information about a command.
Available for:
GETATTR

PROMPT/S
Not Implemented.

Example:

HELP GETATTR

---

INSERT

---

Template:

,

Function:

Inserts the caddie.

Options:

Example:

See also:

---

LOADSETTINGS

---

Template:

NAME/K,PROMPT/S

Function:

Load a settings file

Options:

NAME/K
Name of the settings file to load, this defaults to "RexxCD.settings"

PROMPT/S
Open a file requester

Example:

See also:

---

LOCK

---

Template:

,

Function:

Prevents the user to eject the caddie. Note: some CD drives may not support this command, and still let the user to eject the disc.

Options:

Example:

See also:

---

NOP

---

Template:

,

Function:

Nothing.

Options:

None

Example:

NOP

---

QUIT

---

Template:

FORCE/S

Function:

Quits RexxCD.

Options:

FORCE/S
Nothing special about this.

Example:

QUIT

---

PAUSE

---

Template:

,

Function:

This command will pause playback from the CD.

Options:

Example:

---

RESUME

---

Template:

,

Function:

This command will resume playback from the CD if it was paused previously.

Options:

Example:

---

PLAY

---

Template:

TRACK/N,INDEX/N,OFFSET/N

Function:

Start to play one track.

Options:

TRACK/N
What track to play.

INDEX/N
Not implemented, probably won't be.

OFFSET/K
Where to start playing on the track. OFFSET is in the format "mm:ss.t" like "01:30.7".

TMOFFSET/K
A special format that Thorsten Marquardt wanted. Like this: "ttmmssbb"
tt - track number
mm - minutes into the track
ss - seconds into the track
bb - blocks (1/75:th of seconds) into the track


BLOCKS/K/N
How many blocks to play. One block is normally 1/75:th of a second.

Example:

---

SAVESETTINGS

---

Template:

NAME/K,PROMPT/S

Function:

Save a settings file

Options:

NAME/K
Save the file under this name, if omitted, this defaults to "RexxCD.settings"

PROMPT/S
Open a file requester

Example:

See also:

---

SETATTR

---

Template:

OBJECT/A,NAME,FIELD,STEM/K,VAR/K,VALUE/K

Function:

Set parameters in RexxCD.

Options:

Example:

DEV.NAME='z3scsi.device'
DEV.UNIT=0
SETATTR DEVICE STEM DEV

See also:

---

SKIP

---

Template:

TRACKS/K/N,SECONDS/K/N,BLOCKS/K/N,BACK/S

Function:

This command does 'fast forward', and with the BACK switch set, it does 'rewind'.

Options:

TRACKS/K/N
Not implemented.

SECONDS/K/N
Number of seconds to skip.

BLOCKS/K/N
Number of blocks to skip. 75 blocks equals one second. (On normal drives)

BACK/S
Skip backwards instead.

Example:

---

START

---

Template:

,

Function:

Start the motor.

Options:

Example:

---

STOP

---

Template:

,

Function:

Stop the motor.

Options:

Example:

---

UNLOCK

---

Template:

,

Function:

Enables the user to eject the caddie.

Options:

Example:

See also:

---

Example Programs

---

        /*      Show the table of contents
        */
        options results
        address REXXCD

        GETATTR TRACK STEM T
        Say
        Say 'No.__Artist/Group__             __Title__'
        do i=1 to T.COUNT
                'GETATTR TRACK NAME 'i' STEM T'
                Say RIGHT(i,2,'0')':'LEFT(T.ARTIST,28)' 'LEFT(T.TITLE,48)
                end


        /*      Load the TOC-file into TurboText
        */
        options results
        address REXXCD

        GETATTR DISC FIELD IDFILE VAR FILE

        address COMMAND
        'TTX 'FILE

---

The startup program

---

RexxCD starts an ARexx script at startup time, This defaults to "Startup_RexxCD.rexx"

Here's an example of how it can look like:

        /*
        Name            : StartUp_RexxCD.rexx
        Created         : 05/07/95
        Last change     : 18/06/96
        Programmer      : Urban Lindeskog
        Organization    : ProNotion SoftWare Development Group
        */
        OPTIONS RESULTS

        SETATTR DRIVE FIELD STEREO VALUE 0

        V.LEFT=255
        V.RIGHT=255
        SETATTR VOLUME STEM V

        PLAY 1