GSIFILE(1)

NAME
gsifile - file information and conversion (part of GSI - general sound interface)

SYNOPSIS

gsifile
    [file]
    [-C file1 file2 [-f file_format] [-s samplerate] [-c channels] [-t type]]

DESCRIPTION
gsifile gives information about sound files and converts them to other fileformats and sampe types.
Without options, gsifile myfile gives file information about myfile : file format, comment (usually a description), and for samples, the number of blocks, samplerate, channels, sample type, duration (last 4 are shown for each block), total duration. For songs (midi/hmp/mus) information about each track and the instruments used are shown. Also, whether the tempo is fixed or variable (tempo changes during the song, i.e. when time > 0), is shown. The following options are available:

-C  file1 file2 [-f file_format] [-s samplerate] [-c channels] [-t type]
    converts file1 to file_format, samplerate, channels, type as specified by the options and saves it as file2 (the format will stay the same without -f and ditto for the other options).
    [ NOTE: NOT YET FUNCTIONAL (due to some unimplemented gsif_* functions) ]

sample types are: 8BIT_ALAW, 8BIT_MULAW, 8BIT (i.e. unsigned), 8BIT_SIGNED, 16BIT (i.e. BE), 16BIT_LE, 24BIT (i.e. BE), 24BIT_LE.
file formats are: RAW, AU, AIFF, AIFC, VOC, WAV.

EXAMPLE

gsifile boing.au
    displays information on the file boing.au

gsifile -C boing.au boing.aiff -f AIFF -s 22050 -t 8BIT_MULAW
    converts boing.au to aiff format and converts data blocks to 22050Hz 8 bit mulaw samples.

ERRORS
Not all fileformats support all formats given above, e.g. .au is MSB, aiff uses 8 bit signed, not unsigned etc. A germane message will be presented in such a case.

SEE ALSO
gsiplay(1),
gsi(3)

AUTHOR
Wouter Scholten email: whs@xs4all.nl

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