Pushers

Open Pushers

In the Maya 2026.3 Python Script Editor:

from weSkel.src.ui import pushers

pushers.show_dockable(floating=True)

pushers.show() opens a floating window. show_dockable() starts floating by default or restores saved Maya state. pushers.close_dockable() closes the dock; pushers.reset_dockable_state() clears its saved state.

Create and adjust a corrective

Step	Action	Guidance
1	Choose module creation in the scene list.	Enter Base Name and select the sides offered by the dialog.
2	Connect Reference and Driver.	Choose their actual matrix plugs in the picker; the reader uses their relationship.
3	Pose the rig at rest, then use Capture Rest.	Defines the reader’s reference orientation.
4	Add and select an output.	Choose its direction, ranges and transform/joint options.
5	Pose the Driver, then use + Capture Pose.	Captures the quaternion pose with the desired output values.
6	Select a pose and output, then adjust Pose Value.	Edits the value for this pose on the outputs targeted by Edit all outputs.
7	Test intermediate poses and adjust the remap.	Check the result on the rig beyond the captured poses.

A module may exist with incomplete reader sources; resolve runtime diagnostics before considering its behavior ready.

Recapture Rest replaces the rest pose and clears all named poses on the affected sides after confirmation. Output definitions and reader connections are preserved.

Sides, outputs and edit scope

Setting	Meaning
L / C / R buttons	Choose the active side; stored values are l, c, r.
Mirror L/R edits	Extends compatible lateral edits to the opposite side; this is separate from right-side geometric mirroring.
posX, negX, posY, negY, posZ, negZ	Canonical local directions. The runtime applies the right-side reflection convention even to a right-only module.
Edit all outputs, enabled by default	Extends Pose Value, remap, ranges, orientation and creation options to outputs on the affected sides; identity fields remain specific to the selected output.
Recapture Pose	Replaces the selected pose capture and updates the solver.
Delete Pose	Deletes the selected pose with the scope shown by the UI.

Edit mirroring and runtime transformations have separate contracts. After a code correction affecting an existing graph, reopening the UI does not replace an explicit Rebuild.

Read the captured orientation

Selecting a pose displays its name and axis-colored X / Y / Z angles below the pose table.

Information	Meaning
Source	Stored pose quaternion: Driver orientation relative to Reference and the captured Rest.
Display	XYZ Euler representation in degrees, rounded to one decimal place.
Reading	No new scene sampling; moving the Driver does not change the displayed capture. Use Recapture Pose to update it.
No selected pose	Workflow help returns.

These angles help read the stored pose. They are neither a rotation editor nor a measurement of the Driver’s local channels.

Adjust the remap

Edit Remap Curve opens a nonmodal editor with a live preview, keeping the scene accessible for testing.

Command	Effect
Add/move/delete a point	Previews the curve on the scope captured when the dialog opened.
Reset Linear	Proposes a linear curve in the preview.
Compare Original	Shows each target’s opening curve; click again to return to the edits.
Apply	Keeps the edited curves.
Cancel / close the dialog or Manager	Restores opening curves on targets that are still valid.

Positions are unique, ordered between 0 and 1, with at least two points. Interpolation follows native Maya remap modes.

Changing the Manager’s selection, side or scope does not redirect an open editor. Cancel affects these curves; it does not undo other independent scene actions performed during the preview.

Lifecycle and Undo

Action	Guarantee and limit
Rebuild	Inspects the runtime, performs a read-only preflight, then rebuilds through a temporary generation; a preflight refusal does not implicitly repair the scene.
Duplicate	Copies settings, poses, design and reader sources/values into a new runtime with new joints. Existing skins, weights and consumers stay attached to the source.
Delete	Deletes the whole module regardless of active side and Mirror; preserves the detached skin skeleton and Reference/Driver source objects. Foreign items or incompatible external consumers cause refusal.
Incompatible legacy runtime	Read the diagnostic and version contract; normal actions are not automatic migration.
Maya Undo	Pusher scene edits do not create an Undo entry and preserve existing history. Save the scene before significant changes.

Presets

Action	Data
Save As Preset	Serializes the full spec: sides, poses, outputs, remaps, blends and RBF settings.
Build Selected Preset	Validates JSON before any scene mutation, then uses the same builder as manual creation.
Reference/Driver connections	Roles are preserved; wires to external Maya nodes are not portable preset data. Reconnect sources in the target scene.
Storage	Defaults to user_data/pushers/presets; the Manager allows a different preset root.

Legacy TAR Degrees, Driver Axis and Invert fields are rejected.