You cannot apply auxiliary data to SI3D scenes and models directly. You have to import the SI3D scene or model and save it in the Softimage scene format first.
Setting Values After a Scene Has Loaded (Auxiliary Files)
An auxiliary data file contains a sequence of values to that can be set once a scene finished loading. All parameters are set sequentially prior to registered OnEndSceneOpen events.
Auxiliary data is especially useful for batch rendering as it provides a simple way to modify various parameters of a scene without having to modify the scene file.
|
You cannot apply auxiliary data to SI3D scenes and models directly. You have to import the SI3D scene or model and save it in the Softimage scene format first. |
Loading and Applying Auxiliary Data
To apply auxiliary data in Softimage, you have to specify which file contains the values you want to set with the -auxiliary_data switch.
1. If your auxiliary data file is named c:\myData.txt, type the following at the command line:
xsi -auxiliary_data c:\myData.txt
This creates a new check box labeled Apply Auxiliary Data in the Open Scene dialog box.
2. Turn this option on to apply the auxiliary data when a scene is opened. This is a very convenient way to test if your auxiliary data is applied correctly.
To apply auxiliary data with scripting
You can use scripting to apply previously loaded auxiliary data. For example, if you want to apply auxiliary data to your scene called c:\MyProject\Scenes\MyScene.scn, use the following command:
OpenScene "c:\MyProject\Scenes\MyScene.scn",,TRUE
|
Auxiliary data is not applied by default in both cases (through the interface and scripting). |
To apply auxiliary data from the command line
You can apply auxiliary data automatically to a scene from the command line by typing either of these lines at the prompt:
xsi c:\MyProject\Scenes\MyScene.scn -auxiliary_data c:\myData.txt
or
XSIBatch -r -scene c:\MyProject\Scenes\MyScene.scn -auxiliary_data c:/myData.txt
Defining an Auxiliary Data File
The auxiliary data file format is a plain ASCII file that must start with the following header:
XSI_AuxiliaryDataFile ASCII 1 0
The header identifies the file as a v1.0 Auxiliary data file in plain ASCII. At the time being, there is no other format but we might introduce other file formats in the future.
Lines following the header can be:
• Comments (lines starting with //)
Comments cannot be put anywhere else but on the start of a line, unlike C++ style comments.
• White space (carriage returns, tabs, or spaces)
• Parameters
Parameters use the same syntax as the argument of the SetValue command called with VBScript. For instance using this line in your auxiliary file:
"Passes.Default_Pass.RenderOptions.EndFrame", 1
... has the same effect as calling using this command in Softimage:
SetValue "Passes.Default_Pass.RenderOptions.EndFrame", 1
|
Make sure that every parameter in the auxiliary data file fits on a single line. |
Autodesk Softimage v7.5