Version
It is possible to import a large amount of media files from a tab-delimited (also known as tab-separated) text file. Tab-delimited text files (.txt or .tsv extensions) can be generated by Microsoft Excel or other spreadsheet applications.
The tab-delimited file can define the following elements:
WAV or MIDI file to import.
Object structure to contain the files.
Any property values or references, such as the Voice Volume or Output Bus.
Events to create.
The first row of the tab delimited text file defines the content of the columns for the subsequent rows. The order of the columns has no impact on the import process.
Possible column headers are:
Header |
Content |
||||||
---|---|---|---|---|---|---|---|
Audio File |
Defines the path to the WAV or MIDI file to import. The file will be copied to the Originals folder if it's not already present in it. The path can be absolute or relative to the tab- delimited file's directory. Example: C:\MyWaves\MyFolder\MySound.wav This column can be left blank if creating a container. If the column Object Type is not defined, the Audio File column defines the name of the imported object. |
||||||
Object Path |
Defines the path and name of the object to be created. The path used backslashes. The path can either be absolute or relative.
If this column is left blank, the name of the object will be taken from the imported audio file, and will be imported to the destination specified in the Audio File Importer dialog. |
||||||
Object Type |
Specifies the type of the object. Common object types:
If this column is left blank, a default object type will be selected depending on the destination. Work Units can not be created at import.
|
||||||
Property[PropertyName] Example: Property[Voice Volume] |
The column header specifies which property to set. The property name is the display name, as shown in WObjects.xml, RTPC tab, Multi-Editor or List View. Common property names:
Each subsequent row specifies a property value to set on the created objects. Enumerated values must specify the integer value associated with the enumerated name, which can be found in the .wwu files or in WObjects.xml. If this column is left blank, no value is set. |
||||||
Reference[ReferenceName] Example: Reference[Output Bus] |
The column header specifies which reference to set. The reference name is the full display name, as shown in WObjects.xml. Common reference names:
Each subsequent row specifies one of the following:
If this column is left blank, no reference is set. |
||||||
Notes |
Defines the notes or comments for the object to be created. |
||||||
Event |
Defines the name of an event to be created for the imported object. This column can contains one the following:
To specify the action type, append @ActionName to the end of the event name. If not specified, the Play action will be used. Examples:
A Virtual Folder will be created for any path element that does not already exist at destination. If the specified event already exist at the destination, a new event action will be appended to the existing event.
|
Here is an example of a tab delimited worksheet that creates a random container called 'Bird' with 3 sounds.
Audio File |
Object Path |
Property[Voice Volume] |
Reference[Output Bus] |
Event |
---|---|---|---|---|
Bird |
\Master-Mixer Hierarchy\Default Work Unit\Master Audio Bus\Music |
Play_Bird |
||
C:\Sound1.wav |
Bird\Sound1 |
-3 |
||
C:\Sound2.wav |
Bird\Sound2 |
-4 |
||
C:\Sound3.wav |
Bird\Sound3 |
-2 |
To import a tab delimited file
In Project Explorer, select the import destination object.
Right-click the object to open the shortcut menu.
From shortcut menu, select Import Audio Files... (Shift+I).
Click the Import Tab Delimited... button.
Browse for the tab delimited file, and click OK.
Verify the import content in the Audio File Importer list.
Click Import.
Questions? Problems? Need more info? Contact us, and we can help!
Visit our Support pageRegister your project and we'll help you get started with no strings attached!
Get started with Wwise