GSIPLAY(1)

NAME
gsiplay - sample, song and cd player, with mixer control (part of GSI - general sound interface)

SYNOPSIS

gsiplay
    [-S] [-m master_volume ] [-p device pcm_volume ] [-s device synth_volume ] [-c cd cd_volume ]
    [-V volume ] [-v volume ] [[r] file ] ...
    [cdplay] [cdstop] [cdpause] [cdresume] [cdnext] [cdprev] [cdtrack n ] [cdstatus] [cdeject] [cdinsert] [cdchange slot ] [cdi] [cddevice device_name ]

DESCRIPTION
gsiplay plays PCM samples and songs (any format supported by the gsif(3) library which is currently .raw, .au, .snd, .aif[fc], .voc, .wav for samples and MIDI, hmp, mus for songs), controls the cd player and sets mixer multipliers. Note that raw samples MUST have the extension .raw (other types are recognized by signature) and are assumed to be 8 bit unsigned mono 8000Hz.
The following options are available:
MIXER

-S  Shows current gsi volumes.

-m  master sets the hardware master volume (if available, otherwise all other mixer channels/multipliers are adjusted to emulate a master volume).

-p  dev pcm_vol sets the PCM mixer volume for device dev

-s  dev synth sets the synthesizer volume for device dev (for songs, i.e. currently midi/hmp/mus).

-c  cd cd_vol sets the CD volume for cd cd

OTHER

-v  vol sets the software mixer volume at which a sample will be played (default is 128 (= 0.50) to avoid clipping when playing multiple sounds, this can be altered with the next option).

-V  vol sets the default softvolume for samples to volume (default is 128).

r   repeats the next file to be played (until n or q is pressed when using curses).

All volumes are in the range 0-256. When a volume (for one of the mixer devices) is prefixed by a + or - sign, this is interpreted as a relative change (i.e. the volume is changed by the given amount).

The following cd commands are available:
    cdplay, cdstop, cdpause, cdresume, cdnext, cdprev, cdtrack <n>, cdstatus, cdeject, cdinsert, cdchange <slot>, cdi, cddevice <device>

cdplay plays all audio tracks, cdtrack plays the given track (or the first audio track following it, if it's a data track) and all following audio tracks. cdi starts the interactive cd player wich has the following commands:
v (play, i.e. all audio tracks) b (previous track), n (next track), 1 ... 9 go to track 1-9 (and play all following audio tracks), s (stop), p (pause), r (resume), +/- (alter volume), e (eject disk), i (insert disk), q (quit cdi) All arguments are processed sequentially, which means they can be given multiple times like this: gsiplay -v 150 file1 -v 200 file2 , which will play file1 at a software mixer volume of 150, then file2 at a volume of 200 (without -v 200, the second file would be played at the default 128). gsiplay -V 200 file1 file2 on the other hand will play both files at a soft volume of 200. Note that all cd playing commands finish without waiting for a track to have played. If the program was compiled with USE_CURSES defined (the default), - and + (or the shifted/unshifted versions _ and =) can be pressed while gsiplay runs in the foreground, to adjust the volume during play. Also, p pauses, r resumes when paused, b goes back to the previous sample/song, n skips playing the rest of the current sample/song and goes to the next sample/midi/cd command, and q quits.

SEE ALSO
gsifile(1), gsi(3)

AUTHOR
Wouter Scholten email: whs@xs4all.nl

WWW page: http://www.xs4all.nl/~whs/