|
|
#GslWave
|
|
|
|
|
|
# GslWave file sample header. all gslwave files should contain
|
|
|
# "#GslWave" as their initial bytes, to allow magic(5) identification.
|
|
|
|
|
|
# single line comments are enclosed in '#' and newlines.
|
|
|
# newlines (also consecutive), tabs and spaces are all treated as
|
|
|
# a single 'space', i.e. word boundary.
|
|
|
|
|
|
# Wave definition, a wave consists of one or more samples (chunks),
|
|
|
# which usually compose a single instrument. the individual samples
|
|
|
# are provided for different notes or sampling frequences, the wave
|
|
|
# can be played at.
|
|
|
wave {
|
|
|
name = "quoted string" # each wave must have a descriptive name
|
|
|
mix_freq = 44100 # the default sampling frequency for the
|
|
|
# wave chunks to follow. defaults to 44100.
|
|
|
|
|
|
# a chunk definition, a sample chunk points to encoded sample
|
|
|
# data which records how the wave sounds at given note.
|
|
|
chunk {
|
|
|
osc_freq = 440.0 # note frequency the chunk is to be
|
|
|
# played at. (or, the note that was
|
|
|
# played when the chunk was recorded).
|
|
|
midi_note = 57 # alternative way to specify osc_freq.
|
|
|
# e.g. the midi note number '57' means
|
|
|
# 440 Hz (A-1).
|
|
|
mix_freq = 44100 # the sampling frequency with which
|
|
|
# this chunk has been recorded.
|
|
|
file = "filename" # file containing this chunk's
|
|
|
# sampled data.
|
|
|
index = "wavename" # wavename of sample to read from
|
|
|
# filename, indexing this chunk's
|
|
|
# sampled data.
|
|
|
boffset = 256 # for raw samples, the number of bytes
|
|
|
# to skip at beginning of filename
|
|
|
n_values = 512 # number of values recorded in
|
|
|
# filename. (maybe 0 for default)
|
|
|
# defaults to filelength without the
|
|
|
# offset, divided by the format size
|
|
|
# loop definition
|
|
|
# for samples that contain parts which are to be looped,
|
|
|
# the loop definition specifies the start and end points of
|
|
|
# the loop, and how often it is supposed to be repeated.
|
|
|
# the loop start and end positions are supposed to be
|
|
|
# n_channels aligned.
|
|
|
loop_type = jump # the loop type can be one of:
|
|
|
# none, jump or pingpong.
|
|
|
# defaults to jump.
|
|
|
loop_start = 16
|
|
|
loop_end = 32 # should be >=loop_start
|
|
|
loop_count = 42 # defaults to maximum
|
|
|
}
|
|
|
# more chunk definitions may follow
|
|
|
|
|
|
format = signed_8 # for raw samples, possible formats are:
|
|
|
# signed_8, unsigned_8, signed_12,
|
|
|
# unsigned_12, signed_16, unsigned_16 or
|
|
|
# float. defaults to signed_16.
|
|
|
byte_order = little # for raw samples, possible values are:
|
|
|
# little_endian, little, big_endian or big.
|
|
|
# defaults to little_endian.
|
|
|
n_channels = 2 # for raw samples, must be greater than 0.
|
|
|
# defaults to 1 (mono).
|
|
|
}
|
|
|
|
|
|
# a literal "\000" byte in the header denotes the parsing end.
|
|
|
# this can be used to construct gslwave files that contain:
|
|
|
# 1) the gslwave header
|
|
|
# 2) a literal "\000" byte
|
|
|
# 3) encoded sample data which the chunks refer to
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
File content which is ignore by the gslwave header parser.
|
