Scoundscape Index File Format

Version 2

Extension

The proposed file extension is .scidx (for soundscape index)

Format

Numeric types are in net byte order (big endian).

file :

field	desc
"SCIDX "	6 byte magic number
version	2 byte uint - indicates the version of this file format
offsetx	2 byte uint - value to be added to x coordinates in this index
offsety	2 byte uint - value to be added to y coordinates in this index
width	2 byte uint
height	2 byte uint
rec_count	3 byte uint
rec_bytes	1 byte uint
rows_ptr_start	array of 8 byte file offset from start - indicates begining of rows_ptr[] array
recs[]	array of rec structures of size rec_count
rows_ptr[]	array of 8 byte file offset from start - indicates begining of each entry of rows[]
rows[]	array of row structures of size height

rec structure :

field	desc
rec_id	8 byte uint - id of the recording in the database

row structure :

field	desc
cells_ptr[]	array of 8 byte offsets from the beginning of the file - indicates begining of each entry of cells[]
cells[]	array of cell structures of size width

cell structure :

field	desc
count	2 byte uint - number of recordings in indices[]
indices[]	array of byte uints of size count - indicates indices in recs[] lists
amplitudes[] *	array of 32 bit floats of size count

Example file

definitions:

ccc=3
ss = [5, 6, 3]
pppppppp = *p  (denotes start of rows)

data:

                                         *p
                                          |
SCIDX wwhhcccbppppppppsskkkkksskkkkkksskkkrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr ->