Testing and Debug (Tokens)
| Token Name | Type | Default Value | Accepted Values | Category | Description |
|---|---|---|---|---|---|
| AutomatedOutputDir | STRING | NULL | N/A | Testing and Debug | Enables automated test logging in the specified directory. Output is written to separate subdirectories under this directory, where the subdirectory names are taken from the path name prefix. These subdirectories contain the "output.txt" generated and any screenshots captured ("img_%d_%d.png"; if a node isn't Headless) when that path was active. A "currentPathIndex.txt" file is also repeatedly rewritten directly under AutomatedTestDir to indicate which path index is currently being played. |
| AutomatedTest | STRING | NULL | N/A | Testing and Debug | Specifies automated test path(s). Can be set to either a single path (.pth) file, or a path index (.cfg) file. Playback starts immediately on startup. |
| AutomatedTest_PathTimingScale | FLOAT | 1 | 0.01 to 100, inclusive | Testing and Debug | Scale Factor for automated test path timing (defaults to 1.0) when AutomatedTest points to a .pth file. NOTE: If AutomatedTest points to a path index file (.cfg), the path index file contains the scale factors used for each path. |
| ConfigDebug | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | Should be deprecated. Token debugging is now handled in the aeConfig library. |
| DebugDouble0 | DOUBLE | 0 | -DOUBLE_MAX and DOUBLE_MAX, inclusive | Testing and Debug | |
| DebugDouble1 | DOUBLE | 0 | -DOUBLE_MAX and DOUBLE_MAX, inclusive | Testing and Debug | |
| DebugDouble2 | DOUBLE | 0 | -DOUBLE_MAX and DOUBLE_MAX, inclusive | Testing and Debug | |
| DebugInt0 | INT | 0 | INT_MIN and INT_MAX, inclusive | Testing and Debug | |
| DebugInt1 | INT | 0 | INT_MIN and INT_MAX, inclusive | Testing and Debug | |
| DebugInt2 | INT | 0 | INT_MIN and INT_MAX, inclusive | Testing and Debug | |
| DebugReloadShaders | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | Causes "BREAK" keypress to reload all shader fragments. |
| DebugString0 | STRING | NULL | N/A | Testing and Debug | |
| DebugString1 | STRING | NULL | N/A | Testing and Debug | |
| DebugString2 | STRING | NULL | N/A | Testing and Debug | |
| ForceTreeMode | ENUM | DEFAULT | PUBLISHED_PSEUDO_INST, CUDA_PSEUDO_INST, MDI_INSTANCED, CLASSIC_INSTANCED, DEFAULT | Testing and Debug | Forces a specific X Tree Loading and Rendering method. Defaults: On RENDER nodes with Instanced X Tree clipmap, CUDA_PSEUDO_INSTANCED (if INT_FORMAT = P3F_T2F_TEXID) or MDI_INSTANCED (if INT_FORMAT = INSTANCE). On ISECT nodes, MDI_INSTANCED (which effectively falls back to CLASS_INSTANCED ISECT behavior). |
| FrameStatsFlushInterval | INT | 30000 | INT_MIN to INT_MAX, inclusive | Testing and Debug | If FrameStatsLogFile is enabled with a log file path, this token can be used to control how often (in frames) that writes are flushed to the log file. The frames number where the flush occurs will be even multiples of this value, making them easy to distinguish. Default = 30000, which will avoid flushing writes for over 2 minutes at 240Hz (e.g., 120Hz no VSync). See also other FrameStats* CFG tokens. |
| FrameStatsLogFile | STRING | NULL | N/A | Testing and Debug | If set, enables FrameStats logging, where sub-frame timing and internal operation stats are logged for all draw thread frames longer than FrameStatsLogThreshold ms. Valid values are: 1) CONSOLE 2) A file path to write the Frame Stats log to. %s, if found in the path string, will be replaced with the channel name, which can be useful when multiple channels are writing to the same directory on the same disk. If CONSOLE, the frame stats log lines will be logged on stdout with the string "FRAME TIMINGS: " prepended to each, for easy extraction. See also other FrameStats* CFG tokens. |
| FrameStatsLogThreshold | FLOAT | 0 | -FLOAT_MAX to FLOAT_MAX | Testing and Debug | If FrameStatsLogFile is enabled, frames with a draw thread frame times of this threshold or longer (in ms) will be logged, along with other internal statistics on what happened over the course of that frame. See also other FrameStats* CFG tokens. |
| FrameStatsLoggingAlwaysOn | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | If FrameStatsLogFile is enabled, setting this token to ON will cause FrameStats logging to always be active from startup, logging any frames longer than the threshold. If set to OFF, logging will only be performed when the "S" stats are displayed. This may be useful to help focus capture on a specific testing period. See also other FrameStats* CFG tokens. |
| GLSLShaders | BOOL | ON | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | Enables GLSL shader support. |
| GLSLSuperShaders | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | Toggles between NV ASM (OFF) and GLSL (ON) SuperShaders. |
| GLDebugOutput | ENUM | OFF | OFF, ON, NO_NOTIFS, NO_NOTIFS_PIXELXFER | Testing and Debug | Enables the logging of GL driver feedback messages and controls their verbosity. These provide warnings and tips from the GL driver, app context info, app names for GL objects (where provided), etc. OFF: No messages. ON: All messages. NO_NOTIFS: All messages but info notifications. NO_NOTIFS_PIXELXFER = All but notifications and Pixel transfer perf warnings. |
| GLDebugOutputDump | BOOL | ON | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | When ON, dump all received GL driver feedback messages to the console. When OFF, only GL errors are logged to the console. Disable this in NSight for best performance. |
| GLDebugOutputMarkup | ENUM | KHR_DEBUG | KHR_DEBUG, NVTX | Testing and Debug | API to use for GLDebugOutput markup annotations. |
| HaloDebug | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | |
| HaloPatternScaleFactor | FLOAT | 2 | -FLOAT_MAX to FLOAT_MAX, inclusive | Testing and Debug | |
| MaterialQA | CHAR | 0 | OFF, ON, 1, 0, TRUE, FALSE, AUTO | Testing and Debug | When ON, enables material QA mode. |
| MaterialQATable | STRING | DB/DB_SYSTEM/DB_SYS_CONFIG/materialQATable.txt | N/A | Testing and Debug | Used to select a file that contains material-to-color mappings for material QA mode. |
| PagerThreadProfileFile | STRING | NULL | N/A | Testing and Debug | |
| ProfileFrames | INT | 0 | INT_MIN to INT_MAX, inclusive | Testing and Debug | For places that support it, enables _mainThreadProfiler and _commThreadProfiler support. Results written to C:/pc-nova/profile.txt when BREAK key is hit. |
| ProfilingMarkup | ENUM | OFF | OFF, ON, NVTX | Testing and Debug | Enables the logging of GL driver feedback messages and controls their verbosity. These provide warnings and tips from the GL driver, app context info, app names for GL objects (where provided), etc. OFF: No messages. ON: All messages. NO_NOTIFS: All messages but info notifications. NO_NOTIFS_PIXELXFER: All but notifications and Pixel transfer perf warnings. |
| RadarVisualization | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | When ON, RadarVisualization will ensure that paged HIE geometry that is only visible in RADAR mode will be rendered for non-RADAR modes as well. This is useful when debugging paged hit clipmaps. |
| ShadarDumpPath | STRING | NULL | N/A | Testing and Debug | Generated shader source code written to this path (when requested and allowed). Requires unencrypted shader source. |
| ShaderGenDebugMode | INT | 0 | INT_MIN to INT_MAX, inclusive | Testing and Debug | Enables shader genration debug logging. 0: OFF, 1: Log shader permutations (hash only). 2: Log shader permutations (in English). 3: Log parent node name. 4: Log shader permutations (in CSV). |
| ShaderGenProfilingLevel | INT | 0 | INT_MIN to INT_MAX, inclusive | Testing and Debug | Shader generation profiling level. 0: Disabled. 1: Preload totals only. 2: Per-program timings. |
| StackTraceFile | STRING | NULL | N/A | Testing and Debug | |
| StateDebug | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | |
| SuspendThreadsOnError | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | |
| TestPatternHPRFactor | FLOAT | 1 | -FLOAT_MAX to FLOAT_MAX, inclusive | Testing and Debug | |
| TimestampDebug | CHAR | 0 | OFF, ON, 1, 0, TRUE, FALSE, AUTO | Testing and Debug | |
| TrackModeDebug | ENUM | OFF | OFF, ON, TRACK_POS, LASTER, LASER_MODEL, PAGING_CENTER | Testing and Debug | Enabled test mode for sensor track mode by placing a laser marker or model in the track center. Uses CCD (sensor ID 2) for testing. |
| UberLog | BOOL | OFF | OFF, ON, 1, 0, TRUE, FALSE | Testing and Debug | |
| UberLogFile | STRING | UberStats/log | N/A | Testing and Debug |