Skip to main content
Skip table of contents

Testing and Debug (Tokens)

Token NameTypeDefault ValueAccepted ValuesCategoryDescription
AutomatedOutputDirSTRINGNULLN/ATesting 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.

AutomatedTestSTRINGNULLN/ATesting 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_PathTimingScaleFLOAT10.01 to 100, inclusiveTesting 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.

ConfigDebugBOOLOFFOFF, ON, 1, 0, TRUE, FALSETesting and Debug

Should be deprecated. Token debugging is now handled in the aeConfig library.

DebugDouble0DOUBLE0-DOUBLE_MAX and DOUBLE_MAX, inclusiveTesting and Debug


DebugDouble1DOUBLE0-DOUBLE_MAX and DOUBLE_MAX, inclusiveTesting and Debug


DebugDouble2DOUBLE0-DOUBLE_MAX and DOUBLE_MAX, inclusiveTesting and Debug


DebugInt0INT0INT_MIN and INT_MAX, inclusiveTesting and Debug


DebugInt1INT0INT_MIN and INT_MAX, inclusiveTesting and Debug


DebugInt2INT0INT_MIN and INT_MAX, inclusiveTesting and Debug


DebugReloadShadersBOOLOFFOFF, ON, 1, 0, TRUE, FALSETesting and Debug

Causes "BREAK" keypress to reload all shader fragments.

DebugString0STRINGNULLN/ATesting and Debug


DebugString1STRINGNULLN/ATesting and Debug


DebugString2STRINGNULLN/ATesting and Debug


ForceTreeModeENUMDEFAULTPUBLISHED_PSEUDO_INST, CUDA_PSEUDO_INST, MDI_INSTANCED, CLASSIC_INSTANCED, DEFAULTTesting 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).

FrameStatsFlushIntervalINT30000INT_MIN to INT_MAX, inclusiveTesting 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.

FrameStatsLogFileSTRINGNULLN/ATesting 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.

FrameStatsLogThresholdFLOAT0-FLOAT_MAX to FLOAT_MAXTesting 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.

FrameStatsLoggingAlwaysOnBOOLOFFOFF, ON, 1, 0, TRUE, FALSETesting 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.

GLSLShadersBOOLONOFF, ON, 1, 0, TRUE, FALSETesting and Debug

Enables GLSL shader support.

GLSLSuperShadersBOOLOFFOFF, ON, 1, 0, TRUE, FALSETesting and Debug

Toggles between NV ASM (OFF) and GLSL (ON) SuperShaders. 

GLDebugOutputENUMOFFOFF, ON, NO_NOTIFS, NO_NOTIFS_PIXELXFERTesting 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.

GLDebugOutputDumpBOOLONOFF, ON, 1, 0, TRUE, FALSETesting 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.

GLDebugOutputMarkupENUMKHR_DEBUGKHR_DEBUG, NVTXTesting and Debug

API to use for GLDebugOutput markup annotations.

HaloDebugBOOLOFFOFF, ON, 1, 0, TRUE, FALSETesting and Debug


HaloPatternScaleFactorFLOAT2-FLOAT_MAX to FLOAT_MAX, inclusiveTesting and Debug


MaterialQACHAR0OFF, ON, 1, 0, TRUE, FALSE, AUTOTesting and Debug

When ON, enables material QA mode.

MaterialQATableSTRINGDB/DB_SYSTEM/DB_SYS_CONFIG/materialQATable.txtN/ATesting and Debug

Used to select a file that contains material-to-color mappings for material QA mode.

PagerThreadProfileFileSTRINGNULLN/ATesting and Debug


ProfileFramesINT0INT_MIN to INT_MAX, inclusiveTesting 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.

ProfilingMarkupENUMOFFOFF, ON, NVTXTesting 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.

RadarVisualizationBOOLOFFOFF, ON, 1, 0, TRUE, FALSETesting 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.

ShadarDumpPathSTRINGNULLN/ATesting and Debug

Generated shader source code written to this path (when requested and allowed).

Requires unencrypted shader source.

ShaderGenDebugModeINT0INT_MIN to INT_MAX, inclusiveTesting 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).

ShaderGenProfilingLevelINT0INT_MIN to INT_MAX, inclusiveTesting and Debug

Shader generation profiling level.

0: Disabled.

1: Preload totals only.

2: Per-program timings.

StackTraceFileSTRINGNULLN/ATesting and Debug


StateDebugBOOLOFFOFF, ON, 1, 0, TRUE, FALSETesting and Debug


SuspendThreadsOnErrorBOOLOFFOFF, ON, 1, 0, TRUE, FALSETesting and Debug


TestPatternHPRFactorFLOAT1-FLOAT_MAX to FLOAT_MAX, inclusiveTesting and Debug


TimestampDebugCHAR0OFF, ON, 1, 0, TRUE, FALSE, AUTOTesting and Debug


TrackModeDebugENUMOFFOFF, ON, TRACK_POS, LASTER, LASER_MODEL, PAGING_CENTERTesting 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.

UberLogBOOLOFFOFF, ON, 1, 0, TRUE, FALSETesting and Debug


UberLogFileSTRINGUberStats/logN/ATesting and Debug


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.