PreferenceBuilder

class omni.kit.window.preferences.scripts.preference_builder.PreferenceBuilder(title)

Bases: object

Page building class

Methods

__init__(title)
add_frame(name)	Create a UI collapsable frame.
cleanup_slashes(path[, is_directory])	Makes path/slashes uniform
create_setting_widget(label_name, ...)	Create a UI widget connected with a setting.
create_setting_widget_combo(name, ...[, ...])	Creating a Combo Setting widget.
get_title()	Gets the page title
label(name[, tooltip])	Create a UI widget label.
show_page()	Page is visible.
spacer()	Create a UI spacer.

Attributes

WINDOW_NAME

__init__(title)

add_frame(name: str) → CollapsableFrame

Create a UI collapsable frame.

Parameters

name – Name to be in frame

Returns

ui.Widget connected with the setting on the path specified.

cleanup_slashes(path: str, is_directory: bool = False) → str

Makes path/slashes uniform

Parameters

• path – path

• directory (is_directory is path a) –

• added (so final slash can be) –

Returns

path

create_setting_widget(label_name: str, setting_path: str, setting_type: SettingType, **kwargs) → Widget

Create a UI widget connected with a setting.

If ``range_from`` >= ``range_to`` there is no limit. Undo/redo operations are also supported, because changing setting goes through the omni.kit.commands` module, using :class:`.ChangeSettingCommand.

Parameters

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

• setting_type – Type of the setting to expect.

• range_from – Limit setting value lower bound.

• range_to – Limit setting value upper bound.

Returns

ui.Widget connected with the setting on the path specified.

create_setting_widget_combo(name: str, setting_path: str, list: List[str], setting_is_index: Optional[bool] = None, **kwargs) → Widget

Creating 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 False - setting_path value is string in items list (default)

get_title() → str

Gets the page title

Parameters

None –

Returns

str name of the page

label(name: str, tooltip: Optional[str] = None)

Create a UI widget label.

Parameters

• name – Name to be in label

• tooltip – The Tooltip string to be displayed when mouse hovers on the label

Returns

ui.Widget connected with the setting on the path specified.

show_page() → bool

Page is visible. Function can be overridden in subclasses to hide pages.

Returns

True or False

spacer() → Spacer

Create a UI spacer.

Parameters

None –

Returns

ui.Widget connected with the setting on the path specified.