Picker Panel¶
One sub-tab of a picker: a 2D canvas of buttons.
| Node type | RigExecPickerPanel |
| Example | picker.usda |
On this page:
Overview¶
A picker's sub-tab — Body, Face, Hands — and the coordinate space its
buttons are placed in. The origin is the TOP LEFT with y increasing
downward, matching every picker authoring tool and the Qt widget the panel
is drawn into, so positions copied out of a conventional picker land where
they did there. A panel holds nothing but RigExecPickerButton children
and a background colour or image.
One sub-tab of a RigExecPicker: Body, Face, and so on. Holds RigExecPickerButton children in a 2D coordinate space whose origin is the top left, y increasing downward, matching every picker authoring tool and the Qt widget this is drawn into.
How it works¶
Read in usdview only, in no rig phase: pickerScene.read() takes the
picker's children that are RigExecPickerPanel, sorts them on ui:order
with namespace order breaking ties, and makes one sub-tab each; its own
children that are RigExecPickerButton become that tab's items
(plugin/rigExecUsdview/pickerScene.py:176-204). ui:background is
converted from the schema's 0-1 colour to 8-bit for Qt, and ui:label
falls back to the prim name. ui:size is the declared extent, but the
view fits the tab to the BUTTONS' bounding box plus a 12-unit margin when
the panel has any, adds the declared extent to that box when
ui:backgroundImage is set, and only falls back to ui:size for an empty
panel without an image (pickerModel.py:372-400).
Wiring¶
| Relationship | Points to | Required |
|---|---|---|
| (child prims) | RigExecPickerButton children — direct children only — are this tab's items. |
no |
| (none) | A panel names nothing else; it is placed by being a child of its RigExecPicker. |
- |
Parameters¶
Node parameters¶
ui:label¶
Type: uniform string. Default: "".
Sub-tab label; empty means use the prim name.
ui:order¶
Type: uniform int. Default: 0.
Sort key among sibling panels.
ui:size¶
Type: uniform float2. Default: (400, 600).
Declared panel extent in picker units: the area ui:backgroundImage is stretched over from the panel origin, and the canvas of a panel with no buttons. The view fits the box around the panel's buttons (and background image) plus a margin, not this size.
ui:background¶
Type: uniform color4f. Default: (0.16, 0.16, 0.16, 1).
Panel fill behind every button.
ui:backgroundImage¶
Type: uniform asset. Default: @@.
Optional image stretched to the panel extent behind buttons; resolved relative to its authoring layer and packaged with USDZ.
Example¶
picker.usda carries a single Body panel, 200 by 260 picker units on
a dark grey ground, holding nine buttons: a backdrop, a shoulder select
button, two mode-filtered pairs, a multi-control All FK button, an IK/FK
switch and a Zero Ctrls command. Its buttons happen to fill the declared ui:size exactly, so the
fitted view and the declaration agree.
Open it live with:
Tips¶
- Author button positions as if
ui:sizewere the frame, but do not rely on it: the tab is fitted to the buttons, so a panel split out of a shared canvas still reads (pickerModel.py:372-400). - y grows DOWNWARD in panel units — a button at y=24 is near the top of the tab, not the bottom (
schema.usda:4312-4315). ui:labelis the tab caption and empty means the prim name, so a panel namedBodyneeds no label at all (pickerScene.py:188).