Orch90CD is started from the command line. To play the Orchestra-90 music file 
named 'orchfile', type the command:


orch90cd orchfile


The file 'orchfile' will be compiled and start playing through the default 
sound device. The assumed filetype is .ORC.

The file name may be preceded by these switches:

-o Compiles and plays the file as the original Orchestra-90 would have. 'JATn' 
    and 'Ln' parameters in the file are ignored.

-p Compiles and plays the file as the original Piano-90 would have. 'JATn' and 
    'Ln; parameters in the file are observed with the default setting of 'JAT6' 
    and 'LF'.

-gxx Compiles and plays the file starting at Part xx.

-w Writes a .WAV file with the same name as the .ORC file.

-c Compiles and displays a CRC of the audio samples.

If neither -o or -p are set, 'JATn' and 'Ln' parameters in the file are 
observed with the default setting of 'JAT0' and 'LF'.



While the music is playing: 

Pressing the ESC key will terminate the program.

Repeated pressing of the TAB key will fast forward through the music.

Pressing the space-bar will open the orchfile for editing using the program 
identified by the ORCH_EDIT environment variable.

In addition, if Orch90CD is set as the default application for .ORC files, 
double-clicking on the file name in a File Explorer window will start the 
program. If the shift-key is pressed when clicking, Orch90CD will immediately 
launch the editor.



When Orch90CD encounters an error condition, it exits and notes the class of 
error in the exit code.

EXIT 1: File I/O Error. The file named in the command line could not be found 
or the file could not be read.

EXIT 2: Memory Allocation Error. A memory allocation request failed.

EXIT 3: Compiler Detected Music File Error. When the compiler detects an error, 
an error number will be displayed along with the location of the error. At that 
point you can press the space bar to edit the file and correct the error or 
press any other key to exit.

    ERROR 1: Memory Overflow. The current file exceeds Orch90CD's buffer 
    capacity.

    ERROR 2: Symbol Out of Context. The command operand contains an invalid 
    hexadecimal digit. The tempo symbol (=) is not followed by two hex digits. 
    The compiler was expecting a hex digit or a note symbol (0 - 9 or A - G) 
    but none was found.

    ERROR 3: Parameter Error. The number of sharps or flats in the key 
    signature is too large or is not followed by a sharp (#) or flat (&) 
    symbol. The note value 	in the time signature is not H, Q, S, or T. The 
    voice specified is not 1, 2, 3, 4, or 5. The register specified is not A, 
    B, C, D, or E. The register type is not S, R, or T.

    ERROR 4: Invalid Part Number. The part or repeat specified is not a two-
    digit hex number or the part is not blank. The part is already defined. 
    The repeat is not previously defined.

    ERROR 5: Measure Overflow. The measure being compiled is too long. Split 
    the measure in half and carry forward any accidentals.

    ERROR 6: Note Overflow. Dotted whole notes, 7-dotted triplets, and other 
    unusual combinations cannot be compiled.

EXIT 4: WaveOut Error. A WaveOut Audio Library function failed. Either the 
WaveOut resource is not installed, is being used by another process, or does 
not support the requested format.
