Write Variables

This is the simplest way to export variables from RoboRealm. For more advanced, efficient and interactive methods see the Extensions documentation.

Interface

Instructions

1. Select the variables that you want to save. The left list shows all the current RoboRealm variables available to save given the current processing pipeline. Use the arrows (or doubleclick on a variable) to move it to the 'save variables' list. Use the up/down arrows to reorder that list.

2. Specify which filename you would like the variable values to be saved to. Be sure to have created any needed directories/folders along the filename specification otherwise the module will NOT be able to update the file.

3. If you chose a text file select if you'd like the variable values to be appended to the end of the file. If chose append you should be ready for the file to become really large really quickly!

4. Specify the appropriate row, colom and text delimiters. The text delimiter are used when a variable containing a text value (non-numerical) is saved. You can also type in characters to use as delimiters. Using the default delimiters will allow you to load the file directly into Excel or other spreadsheet programs.

5. Press OK to start saving. Note that whenever the interface is visible values are NOT written to the specified file so you need to press OK before the file will be written.

Note that when reading the saved file you will need to check for the end of row delimiter (text file) or the </ROBOREALM> tag (xml file) to ensure that you have read a complete file. Due to the speed of the writing (once per frame) you are not assured that reads are atomic. RoboRealm is configured to write data in one write to help reduce this issue.

See Also