SettingsWidgetBuilder#

class omni.kit.widget.settings.settings_widget_builder.SettingsWidgetBuilder#

Bases: object

Widget builder functions.

Methods

createAssetWidget(model[, ...])

Create widget for file asset with filepicker.

createBoolWidget(model[, ...])

Create a boolean widget.

createColorWidget(model[, comp_count, ...])

Create a three color floating-point widget.

createComboboxWidget(setting_path[, items, ...])

Create a Combo Setting widget.

createDoubleArrayWidget(model, range_min, ...)

Create a widget for multiple double-precision floating-point numbers.

createFloatWidget(model, range_min, range_max)

Create a floating point widget.

createIntArrayWidget(model, range_min, range_max)

Create a widget for multiple integer numbers.

createIntWidget(model, range_min, range_max)

Create a integer widget.

createRadiobuttonWidget(model[, ...])

Create a RadioButtons Setting widget.

createVecWidget(model, range_min, range_max)

Create a widget for multiple XYZW float values.

get_checkbox_alignment()

Get checkbox alignment from setting "/ext/omni.kit.window.property/checkboxAlignment" and return True/False

get_label_alignment()

Get label alignment from setting "/ext/omni.kit.window.property/labelAlignment" and return True/False

__init__()#
classmethod createAssetWidget(
model,
additional_widget_kwargs: dict | None = None,
)#

Create widget for file asset with filepicker.

classmethod createBoolWidget(
model,
additional_widget_kwargs: dict | None = None,
)#

Create a boolean widget.

classmethod createColorWidget(
model,
comp_count=3,
additional_widget_kwargs: dict | None = None,
) HStack#

Create a three color floating-point widget.

classmethod createComboboxWidget(
setting_path: str,
items: list | dict | None = None,
setting_is_index: bool | None = None,
additional_widget_kwargs: dict | None = None,
) Tuple[SettingsComboItemModel, ComboBox]#

Create a Combo Setting widget.

This function creates a combo box that shows a provided list of names and it is connected with setting by path specified. Underlying setting values are used from values of `items` dict.

Parameters:
  • setting_path – Path to the setting to show and edit.

  • items – Can be either dict` or :py:obj:`list`. For :py:obj:`dict keys are UI displayed names, values are actual values set into settings. If it is a list UI displayed names are equal to setting values.

  • setting_is_index – None - Detect type from setting_path value. If the type is int, set to True. True - setting_path value is index into items list (default) False - setting_path value is string in items list

classmethod createDoubleArrayWidget(
model,
range_min,
range_max,
comp_count=3,
additional_widget_kwargs: dict | None = None,
)#

Create a widget for multiple double-precision floating-point numbers.

classmethod createFloatWidget(
model,
range_min,
range_max,
additional_widget_kwargs: dict | None = None,
)#

Create a floating point widget.

classmethod createIntArrayWidget(
model,
range_min,
range_max,
comp_count=3,
additional_widget_kwargs: dict | None = None,
)#

Create a widget for multiple integer numbers.

classmethod createIntWidget(
model,
range_min,
range_max,
additional_widget_kwargs: dict | None = None,
)#

Create a integer widget.

classmethod createRadiobuttonWidget(
model: RadioButtonSettingModel,
setting_path: str = '',
additional_widget_kwargs: dict | None = None,
) RadioCollection#

Create a RadioButtons Setting widget.

This function creates a Radio Buttons that shows a list of names that are connected with setting by path specified - “{setting_path}/items”.

Parameters:
  • model – A RadioButtonSettingModel instance.

  • setting_path – Path to the setting to show and edit.

Returns:

A omni.ui.RadioCollection instance.

Return type:

(omni.ui.RadioCollection)

classmethod createVecWidget(
model,
range_min,
range_max,
comp_count=3,
additional_widget_kwargs: dict | None = None,
)#

Create a widget for multiple XYZW float values.

classmethod get_checkbox_alignment()#

Get checkbox alignment from setting “/ext/omni.kit.window.property/checkboxAlignment” and return True/False

classmethod get_label_alignment()#

Get label alignment from setting “/ext/omni.kit.window.property/labelAlignment” and return True/False