Conversion Table

The conversion tables file is a comma separated file installed in the Viz folder. All the conversion tables are defined in this file name, using a fixed format. The tables are used to convert input data values to another value defined in the table. The first column in the table is the input value and the second column is the converted value (output).

Note: The file name is hard coded: DP_ConvTable.csv.

File syntax

The file contains a few reserved tokens used for defining conversion tables and other parameters:

  • __VERSION__: This entry is used for future file support and version compatibility issues.

  • __DELIMITER__: This entry is used to define a different file delimiter (other than comma). If omitted comma is used.

  • __TABLE__: This entry defines the beginning of a conversion table.

    The table end is defined by another table entry or end of file.

    Table example:

    __TABLE__,colors,
red,255 0 0
green,0 255 0
blue,0 0 255
yellow,255 255 0
cyan,0 255 255
purple,255 0 255
__DEFAULT__, 0 0 0
,

    In the example a table called colors is defined. When the conversion table is used in a plugin, an input string "red" will be converted to the output string "255 0 0" and sent back to the plugin for processing.

  • __DEFAULT__: This token is used in any of the conversion tables as a default conversion value, i.e. any value not found in the table will be converted to the default value.

Copyright © 2015 Vizrt