Settings#

class omni.graph.core.Settings( VERSION: str = '/persistent/omnigraph/settingsVersion', UPDATE_MESH_TO_HYDRA: str = '/persistent/omnigraph/updateMeshPointsToHydra', PLAY_COMPUTE_GRAPH: str = '/app/player/playComputegraph', OPTIMIZE_GENERATED_PYTHON: str = '/persistent/omnigraph/generator/pyOptimize', ENABLE_PATH_CHANGED_CALLBACK: str = '/persistent/omnigraph/enablePathChangedCallback', DEPRECATIONS_ARE_ERRORS: str = '/persistent/omnigraph/deprecationsAreErrors', )#

Bases: object

Class that packages up all of the OmniGraph settings handling into a common location. The settings themselves are handled through the Carbonite settings ABI, this just provides a nicer and more focused interface. Values here should also be reflected in the C++ OmniGraphSettings class.

Methods

`__init__`([VERSION, UPDATE_MESH_TO_HYDRA, ...])
`generator_settings`()	Return the generator settings object corresponding to the current carb settings
`temporary`(setting_name[, setting_value])	Generator to temporarily use a new setting value

Attributes

`AUTO_INSTANCING_ENABLED`	Control whether or not similar graph should be merged together as instances in order to allow vectorized compute
`DEPRECATIONS_ARE_ERRORS`	Modify deprecation paths to raise errors or exceptions instead of logging warnings.
`DISABLE_INFO_NOTICE_HANDLING_IN_PLAYBACK`	Disable all processing of info-only notices by OG.
`ENABLE_PATH_CHANGED_CALLBACK`	Enable the deprecated Node.pathChangedCallback.
`OPTIMIZE_GENERATED_PYTHON`	Optimize the Python code being output by the node generator
`PLAY_COMPUTE_GRAPH`	Evaluate OmniGraph when the Kit 'Play' button is pressed
`UPDATE_MESH_TO_HYDRA`	Update mesh points directly to Hydra
`VERSION`	Version number of these settings

__init__( VERSION: str = '/persistent/omnigraph/settingsVersion', UPDATE_MESH_TO_HYDRA: str = '/persistent/omnigraph/updateMeshPointsToHydra', PLAY_COMPUTE_GRAPH: str = '/app/player/playComputegraph', OPTIMIZE_GENERATED_PYTHON: str = '/persistent/omnigraph/generator/pyOptimize', ENABLE_PATH_CHANGED_CALLBACK: str = '/persistent/omnigraph/enablePathChangedCallback', DEPRECATIONS_ARE_ERRORS: str = '/persistent/omnigraph/deprecationsAreErrors', ) → None#

static generator_settings() → Settings#

Return the generator settings object corresponding to the current carb settings

Returns:: Current settings object used by the code generator
Return type:: omni.graph.tools.Settings

static temporary( setting_name: str | List[Tuple[str, Any]] | Dict[str, Any], setting_value: Any = None, )#

Generator to temporarily use a new setting value

Parameters:

setting_name – A string containing the path to the setting (e.g. “/persistent/omnigraph/deprecationsAreErrors”) or a list of tuples containing setting name and value pairs.
setting_value – New value for the setting. ‘None’ is not a valid setting value and will generate a warning. Ignored if ‘setting_name’ is a list.

If a setting does not yet exist it will be created at context entry and removed at context exit.

Examples

with og.Settings.temporary(og.Settings.AUTO_INSTANCING_ENABLED, True):
    do_something_with_auto_instancing()

with og.Settings.temporary([("/MySettings/debug", True), (og.Settings.DEPRECATIONS_ARE_ERRORS, False)]):
    do_something_with_deprecations_as_errors_disabled()

AUTO_INSTANCING_ENABLED = '/persistent/omnigraph/autoInstancingEnabled'#: Control whether or not similar graph should be merged together as instances in order to allow vectorized compute

DEPRECATIONS_ARE_ERRORS: str = '/persistent/omnigraph/deprecationsAreErrors'#: Modify deprecation paths to raise errors or exceptions instead of logging warnings.

DISABLE_INFO_NOTICE_HANDLING_IN_PLAYBACK = '/persistent/omnigraph/disableInfoNoticeHandlingInPlayback'#: Disable all processing of info-only notices by OG. This is an optimization for applications which do not require any triggering of OG via USD (value_changed and path_changed callbacks, lazy-graph etc

ENABLE_PATH_CHANGED_CALLBACK: str = '/persistent/omnigraph/enablePathChangedCallback'#: Enable the deprecated Node.pathChangedCallback. This will affect performance.

OPTIMIZE_GENERATED_PYTHON: str = '/persistent/omnigraph/generator/pyOptimize'#: Optimize the Python code being output by the node generator

PLAY_COMPUTE_GRAPH: str = '/app/player/playComputegraph'#: Evaluate OmniGraph when the Kit ‘Play’ button is pressed

UPDATE_MESH_TO_HYDRA: str = '/persistent/omnigraph/updateMeshPointsToHydra'#: Update mesh points directly to Hydra

VERSION: str = '/persistent/omnigraph/settingsVersion'#: Version number of these settings