DagPose

object→Node→DGNode→DagPose

0own Python properties7own spec properties0own methods2class attributes

Import

from weSkel.src.core.node.dg.dag_pose.lib import DagPose

Run in Maya or an initialized mayapy process. Import om only if your script uses OpenMaya types.

Inheritance and scope

Item	Value
Classe	DagPose
Module	weSkel.src.core.node.dg.dag_pose.lib
Maya type	dagPose
Direct parent	DGNode
Inventory	Members defined or overridden here; inherited members are grouped by parent in each section.

Constructor

Signature : DagPose(node) → DagPose.

Parameter	Accepted type	Default
node	Union[str, om.MObject, om.MObjectHandle, om.MFnDependencyNode]	Required

Wraps an existing node or stages a wrapper for an absent name; does not create the node. Call create() separately. An incompatible object or type can raise TypeError. Shared identity can return an already registered compatible wrapper.

Properties

Python properties defined or overridden here. R: read-only; R/W: a setter exists, subject to the member notes. om.* types belong to maya.api.OpenMaya.

No new Python property; see inherited members and specs below.

Properties inherited from DGNode15

Property	Return type	Access	Description
dep_fn	om.MFnDependencyNode	R	Live function set; unattached object when the node is missing.
uuid	str | None	R	Live UUID, or the last staged value if still available.
name	str | None	R/W	Live name, otherwise staged name.
absolute_name	str | None	R	Absolute namespace name from MFnDependencyNode.absoluteName(); None without a node.
stripped_name	str | None	R/W	Name without its namespace, or None when unnamed.
namespace	str | None	R/W	Normalized namespace such as a:b; None at the root.
plugs	Plugs | None	R	Live node plug manager; None otherwise.
is_valid_dep_fn	bool	R	Function-set compatibility with the current MObject.
is_default_node	bool	R	Whether this is a Maya default node; False without a node.
is_from_referenced_file	bool	R	Whether the node comes from a referenced file; False without a node.
is_locked	bool	R/W	Node lock, separate from plug locks.
is_shared	bool	R	Shared state reported by Maya; False without a node.
plugin_name	str | None	R	Associated Maya plugin name, possibly an empty string; None without a node.
affect_animation	bool	R	Result of MFnDependencyNode.affectsAnimation(); False without a node.
type	str | None	R/W	Live native type or staged type.

Properties inherited from Node10

Property	Return type	Access	Description
mobject	om.MObject	R/W	Live Maya object, or a null object.
mobject_handle	om.MObjectHandle	R/W	Handle associated with the node.
api_type	int | None	R	Maya API type identifier.
api_type_str	str	R	API type name, for example "kTime".
exists	bool	R	The wrapper currently has a live node.
is_null	bool	R	The returned Maya object is null.
is_alive	bool	R	The object exists with a valid, live handle.
is_valid_handle	bool	R	Validity of the stored handle.
is_dag_node	bool	R	Compatibility with om.MFn.kDagNode.
hash_code	int	R	Maya handle hash.

Spec properties

Defaults and flags below are spec declarations, not guaranteed live values. A descriptor can return a proxy: .value reads its value; .plug accesses the Plug. Proxy names describe results, not private classes to import. Observed types come from a test fixture; disconnected geometry inputs may notably return None.

For writes where failure must be checked, use the Plug explicitly and verify live state. Descriptor setters do not propagate every native failure.

Property	Maya plug	Returns
bind_pose	bindPose	_ValuePlugProxy · .value: bool
global_spec	global	TypedArrayProxy
members	members	list
parents	parents	list
world	world	None
world_matrix	worldMatrix	TypedArrayProxy
xform_matrix	xformMatrix	TypedArrayProxy

bind_pose

node.bind_poseNative spec

Access to native plug bindPose.

Item	Type / behavior
Maya path	bindPose
Property return	_ValuePlugProxy · .value: bool
Declared kind	numeric:bool
Declared default	False
Flags	input, output, stored, hidden
Read	node.bind_pose.value
Descriptor assignment	node.bind_pose = value

global_spec

node.global_specNative spec

Access to native plug global.

Item	Type / behavior
Maya path	global
Property return	TypedArrayProxy
Declared kind	array:numeric:bool
Declared default	()
Flags	array, input, output, stored, hidden
Underlying plug	node.global_spec.plug

members

node.membersNative spec

Access to native plug members.

Item	Type / behavior
Maya path	members
Property return	list
Declared kind	array:message
Declared default	()
Flags	array, input, output, connectable, hidden

On the tested single-joint pose, the descriptor returns [] despite a connected element. The example uses node.plugs[“members”].getExistingArrayAttributeIndices() followed by .source().node() to check the actual connection.

parents

node.parentsNative spec

Access to native plug parents.

Item	Type / behavior
Maya path	parents
Property return	list
Declared kind	array:message
Declared default	()
Flags	array, input, output, connectable, hidden

world

node.worldNative spec

Access to native plug world.

Item	Type / behavior
Maya path	world
Property return	None
Declared kind	message
Declared default	None
Flags	output, connectable, hidden

The descriptor setter rejects assignment; use Plug connection operations.

world_matrix

node.world_matrixNative spec

Access to native plug worldMatrix.

Item	Type / behavior
Maya path	worldMatrix
Property return	TypedArrayProxy
Declared kind	array:typed:matrix
Declared default	()
Flags	array, input, output, connectable, stored, hidden
Underlying plug	node.world_matrix.plug

xform_matrix

node.xform_matrixNative spec

Access to native plug xformMatrix.

Item	Type / behavior
Maya path	xformMatrix
Property return	TypedArrayProxy
Declared kind	array:typed:matrix
Declared default	()
Flags	array, input, output, stored, hidden
Underlying plug	node.xform_matrix.plug

Specs inherited from DGNode6

Property	Maya plug	Returns	Description
message	message	None	Node message plug; used for connections, with no numeric value.
frozen	frozen	_ValuePlugProxy · .value: bool	Native evaluation freeze state.
is_historically_interesting	isHistoricallyInteresting	_ValuePlugProxy · .value: int	Node interest level in Maya history.
bin_membership	binMembership	_ValuePlugProxy · .value: str	Maya bin membership.
caching_enabled	caching	_ValuePlugProxy · .value: bool	Native node caching switch.
caching_node_state	nodeState	_ValuePlugProxy · .value: int	Native nodeState evaluation state.

Methods

No additional public method; inherited methods remain available.

Methods inherited from DGNode7

Method	Returns	Description
create	None	Creates a missing node; does nothing if it already exists.
delete	None	Disconnects live connections, detaches the wrapper and deletes the node.
snapshot	DGSnapshot	Captures and stores an identity and spec-driven SVD dictionary.
snapshot_svd	SVDSnapshot	Captures Source / Value / Destinations for the requested list.
svd	SVDView	Returns a read-only live view of source, value and destinations; it is not a frozen capture.
finalize	None	Applies all sources, then undriven values, then destinations; enabled FSET dispatch follows.
clear_attr_cache	None	Clears this instance attribute cache; does not delete nodes or clear the global wrapper registry.

Methods inherited from Node2

Method	Returns	Description
has_fn(fn_type)	bool	Test compatibility with a Maya function set.
clear_node_registry()	None	Detach registered wrappers and clear their shared registry.

Class attributes

Attribute	Value / composition
NODE_TYPE	'dagPose'
SPEC_LAYERS	get_dg_specs_all, get_dag_pose_specs_all

NODE_REGISTRY and other class attributes not overridden here remain inherited. Exported Snapshot types describe dictionaries; use node.snapshot() to capture state.

Behavior at a glance

Point	Behavior
Identity	A node recreated under the same name is a new Maya object.
Creation and geometry	The constructor creates nothing; call create() before live operations.
Capture	Snapshots can contain Maya objects; do not assume JSON-ready data or complete geometry reconstruction.
members	On the tested single-joint pose, the descriptor returns [] despite a connected element. The example uses node.plugs[“members”].getExistingArrayAttributeIndices() followed by .source().node() to check the actual connection.
Usage	create() produces an empty node; it does not capture a pose. The example uses Maya’s native pose command, then wraps the result. The wrapper adds no dedicated pose-restoration method.

Usage examples

Self-contained Maya Python Script Editor example. In mayapy, initialize maya.standalone before this block. The demonstration creates its own nodes and removes them in finally.

from uuid import uuid4
from maya import cmds
from weSkel.src.core.node.dg.dag_pose.lib import DagPose
from weSkel.src.core.node.dag.joint.lib import Joint

suffix = uuid4().hex[:8]
joint = Joint("api_pose_joint_" + suffix)
node = None
try:
    joint.create()
    joint.set_translation((1.0, 2.0, 3.0))
    native = cmds.dagPose(joint.name, save=True, bindPose=True, name="api_pose_" + suffix)
    node = DagPose(native)
    assert node.bind_pose.value is True
    indices = node.plugs["members"].getExistingArrayAttributeIndices()
    assert len(indices) == 1
    assert node.plugs["members"][indices[0]].source().node() == joint.mobject
    matrix = node.plugs["worldMatrix"][0].value
    assert matrix.isEquivalent(joint.plugs["worldMatrix"][0].value, 1e-6)
    print("DagPose: native bind pose and saved matrix OK")
finally:
    if node is not None:
        node.delete(snapshot=False)
    joint.delete(snapshot=False)

Expected result : DagPose: native bind pose and saved matrix OK.

SDK checkpoint 87c3486. Member inventory checked against loaded classes in Maya 2025.3 and 2026.3; reads and compatibility are specified in the member cards. Example run in both versions, including explicitly documented expected failures. The example does not cover every method. Listed limitations remain in source; these checks do not validate the compiled package.