====== Spat Convert ======
Spatialization Converter is a script for converting loudspeaker and sound source configuration data between various sound spatialization software system formats.
===== Usage =====
Basic usage, assuming the directory containing the executable \\ ''SpatializationConverter'' is your current working directory:
''./SpatializationConverter ''.
It is also possible to simply execute:
''./SpatializationConverter''.
In the latter case, the user is asked to input the required parameters interactively.
The format of the input file is detected automatically. If the format is supported, the loudspeaker
configuration is read and converted into an internal object representation. From this
representation, it is transformed to the desired target file format.
Supported input file formats: \\
* LISP (List with nested lists containing (x,y,z) tuples) \\
* IOSONSO XML \\
* SpatDif XML \\
* Zirkonium XML\\
* CSV \\
Supported output file formats and corresponding output format identifiers: \\
* ''lisp'': LISP (List with nested lists containing (x,y,z) tuples) \\
* ''iosono'': IOSONSO XML \\
* ''spatdif'': SpatDif XML \\
* ''zirkonium'': Zirkonium XML \\
* ''csv'': CSV \\
===== Installation =====
* Find the script executable in the ComputerStudio Team Dropbox or create an executable by executing the script ''BuildExecutable.sh'' in the root directory of the project.
* Copy the executable file ''(dist/)SpatializationConverter'' to a folder of your choice.
* Run the executable from a terminal as described above.
===== Dependencies =====
Note: you only need to care about dependencies if you intend to build an executable yourself.
The script depends on the module ''pyparsing'' (required to parse LISP code). It can be installed using the command ''pip3 install pyparsing''.
===== Conversion example =====
SPATGRIS format: