Preferences Panel

The preferences panel is a common element of all Omniverse Kit based apps and provides a long list of settings that are applicable to the current app. Because of this, not all apps have all of the categories or options listed on this page. Note that all settings here apply to the app as a whole and are not stored with individual USD stages.

1. Audio

Audio Output	Description
Output Device	Displays a drop-down box containing the names of all audio output devices connected to the system. This may be used to select the desired device for output in Omniverse USD Presenter. This affects output for the main USD stage and all UI audio. Once a device is selected from the list, the “Apply” button must be pushed to accept the change. Changing both this setting and the speaker configuration below will cause the output of all open audio contexts to be changed. If the state of devices attached to the system has changed recently (ie: a new device was connected or a device was disconnected from the system), the “Refresh” button can be used to collect the new device list. By default, the system’s default output device will be chosen. If the selected device is disconnected from the system between launches of Omniverse USD Presenter or the device list changes between launches, the previously selected device will attempt to be found first on the next launch. If it is still attached to the system, it will be used. If it could not be found in the device list, the system’s default output device will be used instead.
Input Device	Displays a drop-down box containing the names of all audio input devices connected to the system. This may be used to select the desired device to use for recording in Omniverse USD Presenter. This affects input for all USD stages. Once a device is selected from the list, the “Apply” button must be pushed to accept the change. The input device is unaffected by the “Speaker Configuration” setting. If the state of devices attached to the system has changed recently (ie: a new device was connected or a device was disconnected from the system), the “Refresh” button can be used to collect the new device list. By default, the system’s default input device will be chosen. If the selected device is disconnected from the system between launches of Omniverse USD Presenter or the device list changes between launches, the previously selected device will attempt to be found first on the next launch. If it is still attached to the system, it will be used. If it could not be found in the device list, the system’s default output device will be used instead.
Speaker Configuration	Sets the speaker configuration to use for output. All configurations are supported regardless of the device’s capabilities (ie: a 5.1 configuration is still supported on a stereo device). In the case the output mode is not directly supported by the selected device, the final output of the audio system will be down-mixed to the device’s preferred configuration. As much of the original stream as is possible will be preserved in the down-mixed output. If the “auto-detect” configuration is selected, the output will try to match the device’s preferred format. Note that this could result in extra processing requirements on some devices due to the larger number of speaker channels. The “Apply” button must be pushed (or Omniverse USD Presenter relaunched) after changing this setting for this to take effect. \| Refreshes the device lists for audio input and output. If a new device is connected to the system or an existing device is removed, pushing this button will refresh the device lists to reflect the new device sets for both input and output. Note this button may disappear in the future in favor of auto-detecting system device changes.
Apply	Applies all changes to the audio input and output device selections. This will have no effect if none of the options have changed. However, if a device is in use at the time (ie: actively recording audio or actively playing audio in a stage), this could result in a brief interruption in audio. It is best to ensure that all audio recording and playback has been stopped before pushing this button.

Audio Parameters

Description

Audio Stream Threshold

Defines the asset size at which the audio system will decide to stream a compressed audio asset instead of decompress it into memory. This threshold is expressed in kilobytes. If this is set to zero the auto-streaming feature will be disabled. If this is set to any larger value, any compressed audio asset with a decompressed size larger than this threshold will be streamed from the original compressed object instead of being decompressed. The benefit of this is lower memory usage and faster asset loading. However, streaming sounds do require slightly more processing time. The default value is 0KB.

Audio Player Preferences

Description

Audio Stream Threshold

Defines the asset size at which the audio player will decompress a compressed asset on-the-fly during playback instead of decompressing it into memory on load. This has the benefit of using less memory and allowing playback to start sooner (for large assets at least). This threshold is expressed in kilobytes. If set to zero, all assets will be decompressed before playing. If set to a non-zero value, any compressed asset with a decompressed size larger than this value will be decompressed as it plays. This defaults to 256KB.

Close Audio Player on Stop

Determines whether the audio player will close on its own once the first playback of a sound completes. This is useful when previewing large numbers of audio assets from the content browser. If this option is left unchecked, the audio player window will remain open after playback completes. This defaults to unchecked.

Volume Levels	Description
Master Volume	Defines the master volume level for all audio output in Omniverse USD Presenter. All other volume levels are effectively multiplied by this volume level to get the final overall volume. Setting this to 0.0 will result in silence (though audio data will still be fully processed). Setting this to 1.0 will be full volume. The volume level changes linearly across this range. This defaults to 1.0. If the selected device is disconnected from the system between launches of Omniverse USD Presenter or the device list changes between launches, the previously selected device will attempt to be found first on the next launch. If it is still attached to the system, it will be used. If it could not be found in the device list, the system’s default output device will be used instead.
USD Volume	Defines the volume level to be used by all audio for the USD stage audio output. This affects all spatial and non-spatial sounds. Setting this to 0.0 will result in silence (though audio data will still be fully processed). Setting this to 1.0 will be full volume. The volume level changes linearly across this range. This defaults to 1.0.
Spatial Voice Volume	Defines the volume level to be used for all spatial sounds in the USD stage. This volume level is effectively multiplied by the “USD Volume” level setting as well before output to get the final volume level for spatial sounds. Setting this to 0.0 will result in silence (though audio data will still be fully processed). Setting this to 1.0 will be full volume. The volume level changes linearly across this range. This defaults to 1.0.
Non-spatial Voice Volume	Defines the volume level to be used for all non-spatial sounds in the USD stage. This volume level is effectively multiplied by the “USD Volume” level setting as well before output to get the final volume level for non-spatial sounds. Setting this to 0.0 will result in silence (though audio data will still be fully processed). Setting this to 1.0 will be full volume. The volume level changes linearly across this range. This defaults to 1.0.
UI Audio Volume	Defines the volume level to be used for all UI audio sounds in Omniverse USD Presenter. Setting this to 0.0 will result in silence (though audio data will still be fully processed). Setting this to 1.0 will be full volume. The volume level changes linearly across this range. This defaults to 1.0.

Debug

Description

Stream Dump Filename

Defines the filename to be used when dumping the USD stage audio output to file. This will be written out in WAVE file format regardless of the extension on the filename. The channel count and data format will match the current output device’s selected channel count and format. This file will be written to disk as audio is played and will always try to remain within a few milliseconds of audio away from what is playing on the device (as close as possible).

The output file must be on a local file volume. Sending output to an omniverse location is not supported. Once stream dumping is enabled, the output file will be created and it will be written to as new audio data is produced. The output will continue until stream dumping is disabled or Omniverse USD Presenter is exited. The default value for this setting is an empty string.

Note that as long as this feature is left enabled, data will continue to be written to the output file. Since this is written as uncompressed data, this file will tend to grow rather quickly. For example, a 48KHz stereo floating point signal will write approximately 22MB per minute. For this reason, the “Enable Stream Dump” setting is not persistent in Omniverse USD Presenter user configuration. It will always be off when Omniverse USD Presenter launches.

Enable Stream Dump

Defines whether stream dumping is currently enabled. As soon as this is enabled and a valid filename is selected in “Stream Dump Filename”, writing to the output file will begin. Stream dumping will continue until this setting is disabled or Omniverse USD Presenter is exited. This setting does not persist in Omniverse Omniverse USD Presenter’s user configuration. It will always be disabled on a fresh launch of Omniverse USD Presenter.

2. Capture Screenshot

Capture Screenshot

Description

Path to Save Screenshots

The path where captured screenshots are saved.

Quality

Sets the compression level of screenshots captured.

Low: High Compression, Lower Quality, Smaller Files.

Medium: Medium Compression, Balanced Quality / Size

High: Low Compression, High Quality, Large Files.

Capture only 3D viewport

Checked: Will only Capture the Viewport.

Unchecked: Captures Interface and Viewport.

Super Resolution Scale	Description
Size	list of resolution multipliers, 2x, 4x, …, 32x to specify how large of an image Super Resolution Capture will create, as multiples of the current viewport resolution.

3. Measure

Measure Settings	Description
Startup Tool	Displays a list of Measure tools which can be set as the default Startup Tool.

4. Misc

Thumbnail Settings	Description
Path to save thumbnail files	Displays a directory browser for selecting the destination folder where any generated thumbnail images will be stored.

Inertia Settings	Description
Enable Inertia Mode	Toggles natural acceleration and deceleration on all camera movements. Different types of inertial motion can be selected with the Inertia Decay dropdown.

5. Rendering

Fabric Scene Delegate	Description
Enable Fabric Delegate	Enables Fabric Scene Delegate (preview feature, requires scene reload).
Fabric delegate GPU memory budget %	% of GPU memory budget to allocate to Fabric Scene Delegate.

Advanced Fabric Scene Delegate Settings	Description
Enable Geometry Streaming in Fabric Scene Delegate	This enables the progressive and sorted loading of geometry, as well as the device memory limit checks.
Geo Streaming Minimum Size	This sets a minimum relative size on screen for objects to be loaded, 0 loads everything.
Enable proxy cubes for unloaded prims	This helps visualizing scene content when having low device memory, but can have performance impact for very large scenes.
Merge instances	Fabric Scene Delegate will merge all meshes within USD scene graph instances.
Merge materials	Fabric Scene Delegate will identify unique materials and drop all duplicates.
Read materials	When off, Fabric Scene Delegate will not read any material from USD, which can speed up load time.
Infer displayColor from material	When on, Fabric Scene Delegate will read material info to infer mesh displayColor.
Read lights	When off, Fabric Scene Delegate will not read any lights from USD.
Read primvars	When off, Fabric Scene Delegate will not read any mesh primvar from USD.
Use Fabric Scene Graph Instancing	When off, Fabric Scene Delegate will ignore USD Scene Graph Instances.

Throttle Rendering	Description
Global Thread Synchronization Preset
Async Rendering	Allows for the viewport refresh and the UI refresh to be different and out of sync.
Skip Rendering While Minimized	Prevents GPU use when the program is minimized.
Yield ‘ms’ while in focus	Time in milliseconds until GPU rendering is paused when program is in focus.
Yield ‘ms’ while not in focus	Time in milliseconds until GPU rendering is paused when program is not in focus.
Enable UI FPS Limit	Reduces load on GPU by limiting the UI refresh (set below).
UI FPS Limit uses Busy Loop	Critical Internal Setting, Do not change
UI FPS Limit	Set the Frames Per Second Limit for the UI.
Used Fixed Time Stepping	Critical Internal Setting, Do not change
Use Present Thread	Critical Internal Setting, Do not change
Sync Threads and Present Thread	Critical Internal Setting, Do not change
Present Thread FPS Limit	Critical Internal Setting, Do not change
Sync Present Thread to Present After Rendering	Critical Internal Setting, Do not change
Vsync	Enables vsync for viewport rendering to prevent horizontal tearing.

Warning

Changing The Throttle Rendering settings can break the software. Do not change if you are unsure of what they do.

White Mode	Description
Material	Custom Material Slot for use with White Mode. Default is “DebugWhite”
Exceptions	A list of material types that you wish to ignore the White Mode setting when enabled

MDL	Description
Material Distilling	Enables support for MDL Material Distilling (preview feature, requires restart).

Texture Streaming	Description
Placeholder Texture Color	RGB color selector for texture placeholders used as textures are streamed in and loaded (requires restart).

Multi-Gpu	Description
Multi-GPU	Multi-gpu option select. Auto, True, False. Auto is default and will detect Multi-gpu (mpgu).

Opacity Micromap	Description
Enable Opacity MicroMap	Improves efficiency of rendering translucent objects. Requires ADA Lovelace GPU (requires restart).

6. Teleport

Teleport Mesh Filter	Description
Filter Keyword	“Filters by keyword”

7. Viewport

Selection Setting	Description
Selection outline Width	Sets the width of the selection outline around selected objects in pixels. Default is 2.0.

Gamepad Setting	Description
Gamepad Control	Enables viewport camera control with a connected gamepad.

Grid Setting	Description
Grid Color	Sets the color of the grid lines.
Grid Size	Sets the size of the grid cells.
Gizmo Size	Sets the size of the grid gizmo.

8. Viewport resolution Menubar

This lists the (4) standard resolution settings available in the Viewport Resolution Menubar, and gives you the option to add your own custom resolution presets. Custom preset name, resolution width and resolution height in pixels.