DAGNode

object→Node→DGNode→ContainerBase→DAGNode

20own Python properties93own spec properties5own methods3class attributes

Import

from weSkel.src.core.node.abstract.dag.lib import DAGNode

In Maya or in a Python script run by Maya / initialized mayapy, with weSkel available. Importing om is only required when using OpenMaya types in your own code.

Inheritance and scope

Item	Value
Class	DAGNode
Module	weSkel.src.core.node.abstract.dag.lib
Direct parent	ContainerBase
Represented direct descendants	Transform, GeometryShape
Own members	20 Python properties + 93 spec properties; 5 methods defined or overridden here.

Parent members remain available. Each section includes collapsible tables grouped by parent class, with links to the full contracts. Private methods and standard Python mechanisms are outside this inventory.

Constructor

Signature : DAGNode(node) → DAGNode or an already registered compatible subclass.

Parameter	Accepted types	Default
node	str, om.MObject, om.MObjectHandle, om.MFnDependencyNode, om.MDagPath, om.MFnDagNode	Required

Wraps an existing node or stages a wrapper if the name is unresolved; creates no node. For another wrapper, pass other.mobject. The shared registry preserves identity and may return the existing concrete wrapper. Incompatible input can raise TypeError, and identity conflicts RuntimeError.

Properties

Python properties defined on this class. om means maya.api.OpenMaya. Spec-generated properties are detailed in the following section.

Property	Return type	Access
dag_fn	om.MFnDagNode	R
dag_path	om.MDagPath	R
has_valid_dag_path	bool	R
full_path_name	str	R
short_name	str	R
is_valid_dag_fn	bool	R
is_shape	bool	R
parents	list[DAGNode]	R
parent	DAGNode | None	R/W
is_instanced	bool	R
children	list[DAGNode]	R
is_under_world	bool	R
child_count	int	R
child_names	list[str]	R
shape_count	int	R
shapes	list[DAGNode]	R
shape_orig	DAGNode | None	R
intermediate_shapes	list[DAGNode]	R
draw_override_info	om.MDAGDrawOverrideInfo | None	R
fn_bounding_box	om.MBoundingBox | None	R

dag_fn

node.dag_fnRead only

Live DAG function set, or unattached object when missing or invalid.

Item	Type / behavior
Returns	om.MFnDagNode

dag_path

node.dag_pathRead only

One path to the current node; empty path when unavailable. For an instanced object, it does not represent every path.

Item	Type / behavior
Returns	om.MDagPath

has_valid_dag_path

node.has_valid_dag_pathRead only

Validity of the path returned by dag_path.

Item	Type / behavior
Returns	bool

full_path_name

node.full_path_nameRead only

Full DAG path; empty string when the path is invalid.

Item	Type / behavior
Returns	str

short_name

node.short_nameRead only

Maya partial DAG path, which may contain more than a leaf name; empty string when invalid.

Item	Type / behavior
Returns	str

is_valid_dag_fn

node.is_valid_dag_fnRead only

Function-set validity for the current object.

Item	Type / behavior
Returns	bool

is_shape

node.is_shapeRead only

Current object compatibility with om.MFn.kShape.

Item	Type / behavior
Returns	bool

parents

node.parentsRead only

All native parents. At the root, this list may include the world wrapper, unlike parent. Raises TypeError without a DAG object.

Item	Type / behavior
Returns	list[DAGNode]

parent

node.parentRead / write

First parent only; None under world. The setter calls set_parent(..., keep_world=True). Without a live node, reading returns the staged parent.

Item	Type / behavior
Returns	DAGNode | None
node.parent = value	DAGNode | str | None

is_instanced

node.is_instancedRead only

Whether the DAG object has multiple paths / parents; False when missing.

Item	Type / behavior
Returns	bool

children

node.childrenRead only

Direct children, without recursive traversal. Raises TypeError without a DAG object.

Item	Type / behavior
Returns	list[DAGNode]

is_under_world

node.is_under_worldRead only

Live node directly under world; False when missing.

Item	Type / behavior
Returns	bool

child_count

node.child_countRead only

Number of direct path children; 0 when invalid.

Item	Type / behavior
Returns	int

child_names

node.child_namesRead only

Full paths of direct children; empty list when the path is invalid.

Item	Type / behavior
Returns	list[str]

shape_count

node.shape_countRead only

Number of shapes directly under this path; 0 when invalid.

Item	Type / behavior
Returns	int

shapes

node.shapesRead only

Direct child shapes, including intermediate shapes; empty list when invalid.

Item	Type / behavior
Returns	list[DAGNode]

shape_orig

node.shape_origRead only

First child shape with intermediateObject=True; None when absent.

Item	Type / behavior
Returns	DAGNode | None

intermediate_shapes

node.intermediate_shapesRead only

All direct child shapes marked as intermediate.

Item	Type / behavior
Returns	list[DAGNode]

draw_override_info

node.draw_override_infoRead only

Native path override information; None when unavailable.

Item	Type / behavior
Returns	om.MDAGDrawOverrideInfo | None

fn_bounding_box

node.fn_bounding_boxRead only

Local bounding box from the function set; None when unavailable. This member does not return a plug.

Item	Type / behavior
Returns	om.MBoundingBox | None

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

Python and Maya names are reproduced exactly. Declared kind, Python return and declared default are different facts. A spec default is not necessarily the live node value, nor a value automatically written at creation.

The returns below describe this class descriptors; live observations use a network, container, transform, mesh or skinCluster as appropriate. Some plugs depend on the concrete type. A subclass may override a member and its write capabilities. Proxy names identify current results: do not import their private classes.

Form	Usage
_ValuePlugProxy	.value reads the value; .plug gives a Plug, .mplug an MPlug.
IndexedPathProxy	Indexed access object. Resolution has limitations at this checkpoint: member cards provide verified alternatives using node.plugs[...].
Flags / writing	stored, input, output, connectable describe the replay contract. They do not guarantee a native plug is editable in its current state.

For writes where failure must be checked, use the Plug explicitly and verify live state: some descriptor setters can stage a value without propagating a Maya write error.

Property	Maya plug	Returns
use_object_color	useObjectColor	_ValuePlugProxy · .value: int
visibility	visibility	_ValuePlugProxy · .value: bool
template	template	_ValuePlugProxy · .value: bool
lod_visibility	lodVisibility	_ValuePlugProxy · .value: bool
object_color	objectColor	_ValuePlugProxy · .value: int
object_color_rgb	objectColorRGB	_ValuePlugProxy · .value: tuple[float, float, float]
object_color_r	objectColorR	_ValuePlugProxy · .value: float
object_color_g	objectColorG	_ValuePlugProxy · .value: float
object_color_b	objectColorB	_ValuePlugProxy · .value: float
wire_color_rgb	wireColorRGB	_ValuePlugProxy · .value: tuple[float, float, float]
wire_color_r	wireColorRGB.wireColorR	_ValuePlugProxy · .value: float
wire_color_g	wireColorRGB.wireColorG	_ValuePlugProxy · .value: float
wire_color_b	wireColorRGB.wireColorB	_ValuePlugProxy · .value: float
hidden_in_outliner	hiddenInOutliner	_ValuePlugProxy · .value: bool
use_outliner_color	useOutlinerColor	_ValuePlugProxy · .value: bool
outliner_color	outlinerColor	_ValuePlugProxy · .value: tuple[float, float, float]
outliner_color_r	outlinerColorR	_ValuePlugProxy · .value: float
outliner_color_g	outlinerColorG	_ValuePlugProxy · .value: float
outliner_color_b	outlinerColorB	_ValuePlugProxy · .value: float
ghosting	ghosting	_ValuePlugProxy · .value: bool
ghosting_mode	ghostingMode	_ValuePlugProxy · .value: int
ghost_custom_steps	ghostCustomSteps	CompoundProxy
ghost_pre_frames	ghostCustomSteps.ghostPreFrames	_ValuePlugProxy · .value: int
ghost_post_frames	ghostCustomSteps.ghostPostFrames	_ValuePlugProxy · .value: int
ghosts_step	ghostCustomSteps.ghostsStep	_ValuePlugProxy · .value: int
ghost_frames	ghostFrames	TypedArrayProxy
ghost_use_driver	ghostUseDriver	_ValuePlugProxy · .value: bool
ghost_driver	ghostDriver	None
ghost_color_pre	ghostColorPre	_ValuePlugProxy · .value: tuple[float, float, float]
ghost_color_pre_r	ghostColorPre.ghostColorPreR	_ValuePlugProxy · .value: float
ghost_color_pre_g	ghostColorPre.ghostColorPreG	_ValuePlugProxy · .value: float
ghost_color_pre_b	ghostColorPre.ghostColorPreB	_ValuePlugProxy · .value: float
ghost_color_post	ghostColorPost	_ValuePlugProxy · .value: tuple[float, float, float]
ghost_color_post_r	ghostColorPost.ghostColorPostR	_ValuePlugProxy · .value: float
ghost_color_post_g	ghostColorPost.ghostColorPostG	_ValuePlugProxy · .value: float
ghost_color_post_b	ghostColorPost.ghostColorPostB	_ValuePlugProxy · .value: float
ghost_opacity_range	ghostOpacityRange	_ValuePlugProxy · .value: tuple[float, float]
ghost_near_opacity	ghostOpacityRange.ghostNearOpacity	_ValuePlugProxy · .value: float
ghost_far_opacity	ghostOpacityRange.ghostFarOpacity	_ValuePlugProxy · .value: float
render_info	renderInfo	CompoundProxy
identification	renderInfo.identification	_ValuePlugProxy · .value: int
layer_renderable	renderInfo.layerRenderable	_ValuePlugProxy · .value: bool
layer_override_color	renderInfo.layerOverrideColor	_ValuePlugProxy · .value: int
render_layer_info	renderLayerInfo	ArrayCompoundProxy
render_layer_id	renderLayerInfo[].renderLayerId	IndexedPathProxy
render_layer_renderable	renderLayerInfo[].renderLayerRenderable	IndexedPathProxy
render_layer_color	renderLayerInfo[].renderLayerColor	IndexedPathProxy
selection_child_highlighting	selectionChildHighlighting	_ValuePlugProxy · .value: bool
inst_obj_groups	instObjGroups	ArrayCompoundProxy
object_groups	instObjGroups[].objectGroups	AttributeError (direct access)
object_grp_comp_list	instObjGroups[].objectGroups[].objectGrpCompList	IndexedPathProxy
object_group_id	instObjGroups[].objectGroups[].objectGroupId	IndexedPathProxy
object_grp_color	instObjGroups[].objectGroups[].objectGrpColor	IndexedPathProxy
matrix	matrix	_ValuePlugProxy · .value: om.MMatrix
inverse_matrix	inverseMatrix	_ValuePlugProxy · .value: om.MMatrix
parent_matrix	parentMatrix	TypedArrayProxy
parent_inverse_matrix	parentInverseMatrix	TypedArrayProxy
world_matrix	worldMatrix	TypedArrayProxy
world_inverse_matrix	worldInverseMatrix	TypedArrayProxy
intermediate_object	intermediateObject	_ValuePlugProxy · .value: bool
draw_override	drawOverride	CompoundProxy
override_enabled	overrideEnabled	_ValuePlugProxy · .value: bool
override_display_type	overrideDisplayType	_ValuePlugProxy · .value: int
override_level_of_detail	overrideLevelOfDetail	_ValuePlugProxy · .value: int
override_shading	overrideShading	_ValuePlugProxy · .value: bool
override_texturing	overrideTexturing	_ValuePlugProxy · .value: bool
override_playback	overridePlayback	_ValuePlugProxy · .value: bool
override_visibility	overrideVisibility	_ValuePlugProxy · .value: bool
override_color	overrideColor	_ValuePlugProxy · .value: int
hide_on_playback	hideOnPlayback	_ValuePlugProxy · .value: bool
override_rgb_colors	overrideRGBColors	_ValuePlugProxy · .value: bool
override_color_rgb	overrideColorRGB	_ValuePlugProxy · .value: tuple[float, float, float]
override_color_r	overrideColorRGB.overrideColorR	_ValuePlugProxy · .value: float
override_color_g	overrideColorRGB.overrideColorG	_ValuePlugProxy · .value: float
override_color_b	overrideColorRGB.overrideColorB	_ValuePlugProxy · .value: float
override_color_a	overrideColorA	_ValuePlugProxy · .value: float
bounding_box	boundingBox	CompoundProxy
bounding_box_min	boundingBox.boundingBoxMin	_ValuePlugProxy · .value: tuple[float, float, float]
bounding_box_min_x	boundingBox.boundingBoxMin.boundingBoxMinX	_ValuePlugProxy · .value: float
bounding_box_min_y	boundingBox.boundingBoxMin.boundingBoxMinY	_ValuePlugProxy · .value: float
bounding_box_min_z	boundingBox.boundingBoxMin.boundingBoxMinZ	_ValuePlugProxy · .value: float
bounding_box_max	boundingBox.boundingBoxMax	_ValuePlugProxy · .value: tuple[float, float, float]
bounding_box_max_x	boundingBox.boundingBoxMax.boundingBoxMaxX	_ValuePlugProxy · .value: float
bounding_box_max_y	boundingBox.boundingBoxMax.boundingBoxMaxY	_ValuePlugProxy · .value: float
bounding_box_max_z	boundingBox.boundingBoxMax.boundingBoxMaxZ	_ValuePlugProxy · .value: float
bounding_box_size	boundingBox.boundingBoxSize	_ValuePlugProxy · .value: tuple[float, float, float]
bounding_box_size_x	boundingBox.boundingBoxSize.boundingBoxSizeX	_ValuePlugProxy · .value: float
bounding_box_size_y	boundingBox.boundingBoxSize.boundingBoxSizeY	_ValuePlugProxy · .value: float
bounding_box_size_z	boundingBox.boundingBoxSize.boundingBoxSizeZ	_ValuePlugProxy · .value: float
center	center	_ValuePlugProxy · .value: tuple[float, float, float]
center_x	center.boundingBoxCenterX	_ValuePlugProxy · .value: float
center_y	center.boundingBoxCenterY	_ValuePlugProxy · .value: float
center_z	center.boundingBoxCenterZ	_ValuePlugProxy · .value: float

use_object_color

node.use_object_colorRead / write

Object-color usage mode.

Item	Type / behavior
Declared Maya path	useObjectColor
Property return	_ValuePlugProxy · .value: int
Declared spec kind	enum
Declared default	0
Flags	input, output, connectable, stored
Read the value	node.use_object_color.value
Assignment	node.use_object_color = value

visibility

node.visibilityRead / write

Local node visibility; it does not summarize visibility across the hierarchy.

Item	Type / behavior
Declared Maya path	visibility
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	True
Flags	input, output, connectable, stored, keyable
Read the value	node.visibility.value
Assignment	node.visibility = value

template

node.templateRead / write

Object template display state.

Item	Type / behavior
Declared Maya path	template
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	False
Flags	input, output, connectable, stored
Read the value	node.template.value
Assignment	node.template = value

lod_visibility

node.lod_visibilityRead / write

Level-of-detail visibility.

Item	Type / behavior
Declared Maya path	lodVisibility
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	True
Flags	input, output, connectable, stored
Read the value	node.lod_visibility.value
Assignment	node.lod_visibility = value

object_color

node.object_colorRead / write

Object color index.

Item	Type / behavior
Declared Maya path	objectColor
Property return	_ValuePlugProxy · .value: int
Declared spec kind	numeric:short
Declared default	0
Flags	input, output, connectable, stored
Read the value	node.object_color.value
Assignment	node.object_color = value

object_color_rgb

node.object_color_rgbRead / write

Object RGB color.

Item	Type / behavior
Declared Maya path	objectColorRGB
Property return	_ValuePlugProxy · .value: tuple[float, float, float]
Declared spec kind	float3
Declared default	(0.0, 0.0, 0.0)
Flags	input, output, connectable, stored
Read the value	node.object_color_rgb.value
Assignment	node.object_color_rgb = value

object_color_r

node.object_color_rRead / write

R component of object_color_rgb.

Item	Type / behavior
Declared Maya path	objectColorR
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.object_color_r.value
Assignment	node.object_color_r = value

object_color_g

node.object_color_gRead / write

G component of object_color_rgb.

Item	Type / behavior
Declared Maya path	objectColorG
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.object_color_g.value
Assignment	node.object_color_g = value

object_color_b

node.object_color_bRead / write

B component of object_color_rgb.

Item	Type / behavior
Declared Maya path	objectColorB
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.object_color_b.value
Assignment	node.object_color_b = value

wire_color_rgb

node.wire_color_rgbRead / write

Wireframe RGB color.

Item	Type / behavior
Declared Maya path	wireColorRGB
Property return	_ValuePlugProxy · .value: tuple[float, float, float]
Declared spec kind	float3
Declared default	(0.0, 0.0, 0.0)
Flags	input, output, connectable, stored
Read the value	node.wire_color_rgb.value
Assignment	node.wire_color_rgb = value

wire_color_r

node.wire_color_rRead / write

R component of wire_color_rgb.

Item	Type / behavior
Declared Maya path	wireColorRGB.wireColorR
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.wire_color_r.value
Assignment	node.wire_color_r = value

wire_color_g

node.wire_color_gRead / write

G component of wire_color_rgb.

Item	Type / behavior
Declared Maya path	wireColorRGB.wireColorG
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.wire_color_g.value
Assignment	node.wire_color_g = value

wire_color_b

node.wire_color_bRead / write

B component of wire_color_rgb.

Item	Type / behavior
Declared Maya path	wireColorRGB.wireColorB
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.wire_color_b.value
Assignment	node.wire_color_b = value

hidden_in_outliner

node.hidden_in_outlinerRead / write

Hidden state in the Outliner.

Item	Type / behavior
Declared Maya path	hiddenInOutliner
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	False
Flags	input, output, connectable, stored
Read the value	node.hidden_in_outliner.value
Assignment	node.hidden_in_outliner = value

use_outliner_color

node.use_outliner_colorRead / write

Custom Outliner color switch.

Item	Type / behavior
Declared Maya path	useOutlinerColor
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	False
Flags	input, output, connectable, stored
Read the value	node.use_outliner_color.value
Assignment	node.use_outliner_color = value

outliner_color

node.outliner_colorRead / write

Outliner RGB color.

Item	Type / behavior
Declared Maya path	outlinerColor
Property return	_ValuePlugProxy · .value: tuple[float, float, float]
Declared spec kind	float3
Declared default	()
Flags	input, output, connectable, stored
Read the value	node.outliner_color.value
Assignment	node.outliner_color = value

outliner_color_r

node.outliner_color_rRead / write

R component of outliner_color.

Item	Type / behavior
Declared Maya path	outlinerColorR
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.outliner_color_r.value
Assignment	node.outliner_color_r = value

outliner_color_g

node.outliner_color_gRead / write

G component of outliner_color.

Item	Type / behavior
Declared Maya path	outlinerColorG
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.outliner_color_g.value
Assignment	node.outliner_color_g = value

outliner_color_b

node.outliner_color_bRead / write

B component of outliner_color.

Item	Type / behavior
Declared Maya path	outlinerColorB
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.outliner_color_b.value
Assignment	node.outliner_color_b = value

ghosting

node.ghostingRead / write

Maya ghosting switch.

Item	Type / behavior
Declared Maya path	ghosting
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	False
Flags	input, output, connectable, stored
Read the value	node.ghosting.value
Assignment	node.ghosting = value

ghosting_mode

node.ghosting_modeRead / write

Ghosting mode.

Item	Type / behavior
Declared Maya path	ghostingMode
Property return	_ValuePlugProxy · .value: int
Declared spec kind	enum
Declared default	0
Flags	input, output, connectable, stored
Read the value	node.ghosting_mode.value
Assignment	node.ghosting_mode = value

ghost_custom_steps

node.ghost_custom_stepsStructured access

Compound ghosting-step settings.

Item	Type / behavior
Declared Maya path	ghostCustomSteps
Property return	CompoundProxy
Declared spec kind	compound
Declared default	None
Flags	input, output, connectable, stored
Plug access	node.ghost_custom_steps.plug

The property returns a structure. Edit an explicit child or use Plug operations; do not replace the proxy with a Python assignment.

ghost_pre_frames

node.ghost_pre_framesRead / write

Number of frames before the current frame.

Item	Type / behavior
Declared Maya path	ghostCustomSteps.ghostPreFrames
Property return	_ValuePlugProxy · .value: int
Declared spec kind	numeric:int
Declared default	3
Flags	input, output, connectable, stored
Read the value	node.ghost_pre_frames.value
Assignment	node.ghost_pre_frames = value

ghost_post_frames

node.ghost_post_framesRead / write

Number of frames after the current frame.

Item	Type / behavior
Declared Maya path	ghostCustomSteps.ghostPostFrames
Property return	_ValuePlugProxy · .value: int
Declared spec kind	numeric:int
Declared default	3
Flags	input, output, connectable, stored
Read the value	node.ghost_post_frames.value
Assignment	node.ghost_post_frames = value

ghosts_step

node.ghosts_stepRead / write

Step between ghosting samples.

Item	Type / behavior
Declared Maya path	ghostCustomSteps.ghostsStep
Property return	_ValuePlugProxy · .value: int
Declared spec kind	numeric:int
Declared default	1
Flags	input, output, connectable, stored
Read the value	node.ghosts_step.value
Assignment	node.ghosts_step = value

ghost_frames

node.ghost_framesRead / write

Native ghosting frame list.

Item	Type / behavior
Declared Maya path	ghostFrames
Property return	TypedArrayProxy
Declared spec kind	typed:intArray
Declared default	()
Flags	input, output, connectable, stored
Plug access	node.ghost_frames.plug

This attribute contains typed-array data, not necessarily a Maya multi-attribute. Read its contents with .plug.value; do not equate data indices with logical plug indices.

ghost_use_driver

node.ghost_use_driverRead / connections

Use of a ghosting driver.

Item	Type / behavior
Declared Maya path	ghostUseDriver
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	False
Flags	input, output, connectable
Read the value	node.ghost_use_driver.value

ghost_driver

node.ghost_driverConnections

Connection to the ghosting driver.

Item	Type / behavior
Declared Maya path	ghostDriver
Property return	None
Declared spec kind	message
Declared default	None
Flags	input, output, connectable

The descriptor setter raises AttributeError. Manage connections with node.plugs[...]; this property does not return the connected node.

ghost_color_pre

node.ghost_color_preRead / write

Previous-ghost color.

Item	Type / behavior
Declared Maya path	ghostColorPre
Property return	_ValuePlugProxy · .value: tuple[float, float, float]
Declared spec kind	float3
Declared default	(0.44699999690055847, 1.0, 1.0)
Flags	input, output, connectable, stored
Read the value	node.ghost_color_pre.value
Assignment	node.ghost_color_pre = value

ghost_color_pre_r

node.ghost_color_pre_rRead / write

R component of ghost_color_pre.

Item	Type / behavior
Declared Maya path	ghostColorPre.ghostColorPreR
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.44699999690055847
Flags	input, output, connectable, stored
Read the value	node.ghost_color_pre_r.value
Assignment	node.ghost_color_pre_r = value

ghost_color_pre_g

node.ghost_color_pre_gRead / write

G component of ghost_color_pre.

Item	Type / behavior
Declared Maya path	ghostColorPre.ghostColorPreG
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	1.0
Flags	input, output, connectable, stored
Read the value	node.ghost_color_pre_g.value
Assignment	node.ghost_color_pre_g = value

ghost_color_pre_b

node.ghost_color_pre_bRead / write

B component of ghost_color_pre.

Item	Type / behavior
Declared Maya path	ghostColorPre.ghostColorPreB
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	1.0
Flags	input, output, connectable, stored
Read the value	node.ghost_color_pre_b.value
Assignment	node.ghost_color_pre_b = value

ghost_color_post

node.ghost_color_postRead / write

Following-ghost color.

Item	Type / behavior
Declared Maya path	ghostColorPost
Property return	_ValuePlugProxy · .value: tuple[float, float, float]
Declared spec kind	float3
Declared default	(0.878000020980835, 0.6779999732971191, 0.6629999876022339)
Flags	input, output, connectable, stored
Read the value	node.ghost_color_post.value
Assignment	node.ghost_color_post = value

ghost_color_post_r

node.ghost_color_post_rRead / write

R component of ghost_color_post.

Item	Type / behavior
Declared Maya path	ghostColorPost.ghostColorPostR
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.878000020980835
Flags	input, output, connectable, stored
Read the value	node.ghost_color_post_r.value
Assignment	node.ghost_color_post_r = value

ghost_color_post_g

node.ghost_color_post_gRead / write

G component of ghost_color_post.

Item	Type / behavior
Declared Maya path	ghostColorPost.ghostColorPostG
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.6779999732971191
Flags	input, output, connectable, stored
Read the value	node.ghost_color_post_g.value
Assignment	node.ghost_color_post_g = value

ghost_color_post_b

node.ghost_color_post_bRead / write

B component of ghost_color_post.

Item	Type / behavior
Declared Maya path	ghostColorPost.ghostColorPostB
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.6629999876022339
Flags	input, output, connectable, stored
Read the value	node.ghost_color_post_b.value
Assignment	node.ghost_color_post_b = value

ghost_opacity_range

node.ghost_opacity_rangeRead / write

Compound ghost opacity range.

Item	Type / behavior
Declared Maya path	ghostOpacityRange
Property return	_ValuePlugProxy · .value: tuple[float, float]
Declared spec kind	float2
Declared default	(0.15, 0.5)
Flags	input, output, connectable, stored
Read the value	node.ghost_opacity_range.value
Assignment	node.ghost_opacity_range = value

ghost_near_opacity

node.ghost_near_opacityRead / write

Near-ghost opacity.

Item	Type / behavior
Declared Maya path	ghostOpacityRange.ghostNearOpacity
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.5
Flags	input, output, connectable, stored
Read the value	node.ghost_near_opacity.value
Assignment	node.ghost_near_opacity = value

ghost_far_opacity

node.ghost_far_opacityRead / write

Far-ghost opacity.

Item	Type / behavior
Declared Maya path	ghostOpacityRange.ghostFarOpacity
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.15
Flags	input, output, connectable, stored
Read the value	node.ghost_far_opacity.value
Assignment	node.ghost_far_opacity = value

render_info

node.render_infoStructured access

Compound node render information.

Item	Type / behavior
Declared Maya path	renderInfo
Property return	CompoundProxy
Declared spec kind	compound
Declared default	None
Flags	input, output, connectable, stored
Plug access	node.render_info.plug

The property returns a structure. Edit an explicit child or use Plug operations; do not replace the proxy with a Python assignment.

identification

node.identificationRead / write

Native identifier in render information.

Item	Type / behavior
Declared Maya path	renderInfo.identification
Property return	_ValuePlugProxy · .value: int
Declared spec kind	numeric:short
Declared default	0
Flags	input, output, connectable, stored
Read the value	node.identification.value
Assignment	node.identification = value

layer_renderable

node.layer_renderableRead / write

Layer renderability.

Item	Type / behavior
Declared Maya path	renderInfo.layerRenderable
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	True
Flags	input, output, connectable, stored
Read the value	node.layer_renderable.value
Assignment	node.layer_renderable = value

layer_override_color

node.layer_override_colorRead / write

Layer override color index.

Item	Type / behavior
Declared Maya path	renderInfo.layerOverrideColor
Property return	_ValuePlugProxy · .value: int
Declared spec kind	numeric:byte
Declared default	0
Flags	input, output, connectable, stored
Read the value	node.layer_override_color.value
Assignment	node.layer_override_color = value

render_layer_info

node.render_layer_infoStructured access

Per-render-layer information array.

Item	Type / behavior
Declared Maya path	renderLayerInfo
Property return	ArrayCompoundProxy
Declared spec kind	array:compound
Declared default	None
Flags	array, input, output, connectable, stored
Plug access	node.render_layer_info.plug

The property returns a structure. Edit an explicit child or use Plug operations; do not replace the proxy with a Python assignment.

render_layer_id

node.render_layer_idLimited access

Render layer identifier at the requested index.

Item	Type / behavior
Declared Maya path	renderLayerInfo[].renderLayerId
Property return	IndexedPathProxy
Declared spec kind	numeric:short
Declared default	0
Flags	input, output, connectable, stored
Indices	1 logical index(es), in the order of [] in the Maya path.
Verified alternative · returns a Plug	node.plugs["renderLayerInfo"][i1]["renderLayerId"]

Current limitation: descriptor resolution raises AttributeError in the verified case. Use the explicit path above with logical indices. The resulting Plug can then read .value or manage connections.

render_layer_renderable

node.render_layer_renderableLimited access

Renderability of the layer at the requested index.

Item	Type / behavior
Declared Maya path	renderLayerInfo[].renderLayerRenderable
Property return	IndexedPathProxy
Declared spec kind	numeric:bool
Declared default	True
Flags	input, output, connectable, stored
Indices	1 logical index(es), in the order of [] in the Maya path.
Verified alternative · returns a Plug	node.plugs["renderLayerInfo"][i1]["renderLayerRenderable"]

Current limitation: descriptor resolution raises AttributeError in the verified case. Use the explicit path above with logical indices. The resulting Plug can then read .value or manage connections.

render_layer_color

node.render_layer_colorLimited access

Render layer color index.

Item	Type / behavior
Declared Maya path	renderLayerInfo[].renderLayerColor
Property return	IndexedPathProxy
Declared spec kind	numeric:byte
Declared default	0
Flags	input, output, connectable, stored
Indices	1 logical index(es), in the order of [] in the Maya path.
Verified alternative · returns a Plug	node.plugs["renderLayerInfo"][i1]["renderLayerColor"]

Current limitation: descriptor resolution raises AttributeError in the verified case. Use the explicit path above with logical indices. The resulting Plug can then read .value or manage connections.

selection_child_highlighting

node.selection_child_highlightingRead / write

Child highlighting on selection.

Item	Type / behavior
Declared Maya path	selectionChildHighlighting
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	True
Flags	input, output, connectable, stored
Read the value	node.selection_child_highlighting.value
Assignment	node.selection_child_highlighting = value

inst_obj_groups

node.inst_obj_groupsStructured access

Membership groups per DAG instance.

Item	Type / behavior
Declared Maya path	instObjGroups
Property return	ArrayCompoundProxy
Declared spec kind	array:compound
Declared default	None
Flags	array, input, output, connectable, stored
Plug access	node.inst_obj_groups.plug

The property returns a structure. Edit an explicit child or use Plug operations; do not replace the proxy with a Python assignment.

object_groups

node.object_groupsLimited access

Component groups beneath a DAG instance.

Item	Type / behavior
Declared Maya path	instObjGroups[].objectGroups
Property return	AttributeError (direct access)
Declared spec kind	array:compound
Declared default	None
Flags	array, input, output, connectable, stored
Verified alternative · returns a Plug	node.plugs["instObjGroups"][i1]["objectGroups"]

Current limitation: descriptor resolution raises AttributeError in the verified case. Use the explicit path above with logical indices. The resulting Plug can then read .value or manage connections.

object_grp_comp_list

node.object_grp_comp_listLimited access

Group components addressed by two logical indices.

Item	Type / behavior
Declared Maya path	instObjGroups[].objectGroups[].objectGrpCompList
Property return	IndexedPathProxy
Declared spec kind	componentList
Declared default	()
Flags	input, output, connectable, stored
Indices	2 logical index(es), in the order of [] in the Maya path.
Verified alternative · returns a Plug	node.plugs["instObjGroups"][i1]["objectGroups"][i2]["objectGrpCompList"]

Current limitation: descriptor resolution raises AttributeError in the verified case. Use the explicit path above with logical indices. The resulting Plug can then read .value or manage connections.

object_group_id

node.object_group_idLimited access

Component group identifier.

Item	Type / behavior
Declared Maya path	instObjGroups[].objectGroups[].objectGroupId
Property return	IndexedPathProxy
Declared spec kind	numeric:long
Declared default	0
Flags	input, output, connectable
Indices	2 logical index(es), in the order of [] in the Maya path.
Verified alternative · returns a Plug	node.plugs["instObjGroups"][i1]["objectGroups"][i2]["objectGroupId"]

Current limitation: descriptor resolution raises AttributeError in the verified case. Use the explicit path above with logical indices. The resulting Plug can then read .value or manage connections.

object_grp_color

node.object_grp_colorLimited access

Component group color index.

Item	Type / behavior
Declared Maya path	instObjGroups[].objectGroups[].objectGrpColor
Property return	IndexedPathProxy
Declared spec kind	numeric:short
Declared default	-1
Flags	input, output, connectable
Indices	2 logical index(es), in the order of [] in the Maya path.
Verified alternative · returns a Plug	node.plugs["instObjGroups"][i1]["objectGroups"][i2]["objectGrpColor"]

Current limitation: descriptor resolution raises AttributeError in the verified case. Use the explicit path above with logical indices. The resulting Plug can then read .value or manage connections.

matrix

node.matrixRead / connections

Local matrix evaluated by Maya.

Item	Type / behavior
Declared Maya path	matrix
Property return	_ValuePlugProxy · .value: om.MMatrix
Declared spec kind	typed:matrix
Declared default	(1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0)
Flags	output, connectable
Read the value	node.matrix.value

inverse_matrix

node.inverse_matrixRead / connections

Inverse local matrix.

Item	Type / behavior
Declared Maya path	inverseMatrix
Property return	_ValuePlugProxy · .value: om.MMatrix
Declared spec kind	typed:matrix
Declared default	(1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0)
Flags	output, connectable
Read the value	node.inverse_matrix.value

parent_matrix

node.parent_matrixRead / connections

Parent matrices indexed by instance.

Item	Type / behavior
Declared Maya path	parentMatrix
Property return	TypedArrayProxy
Declared spec kind	array:typed:matrix
Declared default	()
Flags	array, output, connectable
Plug access	node.parent_matrix.plug
Logical element	node.parent_matrix.element_plug(i).value

parent_inverse_matrix

node.parent_inverse_matrixRead / connections

Inverse parent matrices.

Item	Type / behavior
Declared Maya path	parentInverseMatrix
Property return	TypedArrayProxy
Declared spec kind	array:typed:matrix
Declared default	()
Flags	array, output, connectable
Plug access	node.parent_inverse_matrix.plug
Logical element	node.parent_inverse_matrix.element_plug(i).value

world_matrix

node.world_matrixRead / connections

World matrices indexed by DAG instance.

Item	Type / behavior
Declared Maya path	worldMatrix
Property return	TypedArrayProxy
Declared spec kind	array:typed:matrix
Declared default	()
Flags	array, output, connectable
Plug access	node.world_matrix.plug
Logical element	node.world_matrix.element_plug(i).value

world_inverse_matrix

node.world_inverse_matrixRead / connections

Inverse world matrices.

Item	Type / behavior
Declared Maya path	worldInverseMatrix
Property return	TypedArrayProxy
Declared spec kind	array:typed:matrix
Declared default	()
Flags	array, output, connectable
Plug access	node.world_inverse_matrix.plug
Logical element	node.world_inverse_matrix.element_plug(i).value

intermediate_object

node.intermediate_objectRead / write

Maya intermediate-shape flag.

Item	Type / behavior
Declared Maya path	intermediateObject
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	False
Flags	input, output, connectable, stored
Read the value	node.intermediate_object.value
Assignment	node.intermediate_object = value

draw_override

node.draw_overrideStructured access

Compound display overrides.

Item	Type / behavior
Declared Maya path	drawOverride
Property return	CompoundProxy
Declared spec kind	compound
Declared default	None
Flags	input, output, connectable, stored
Plug access	node.draw_override.plug

The property returns a structure. Edit an explicit child or use Plug operations; do not replace the proxy with a Python assignment.

override_enabled

node.override_enabledRead / write

Display override switch.

Item	Type / behavior
Declared Maya path	overrideEnabled
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	False
Flags	input, output, connectable, stored
Read the value	node.override_enabled.value
Assignment	node.override_enabled = value

override_display_type

node.override_display_typeRead / write

Override display type.

Item	Type / behavior
Declared Maya path	overrideDisplayType
Property return	_ValuePlugProxy · .value: int
Declared spec kind	enum
Declared default	0
Flags	input, output, connectable, stored
Read the value	node.override_display_type.value
Assignment	node.override_display_type = value

override_level_of_detail

node.override_level_of_detailRead / write

Override level of detail.

Item	Type / behavior
Declared Maya path	overrideLevelOfDetail
Property return	_ValuePlugProxy · .value: int
Declared spec kind	enum
Declared default	0
Flags	input, output, connectable, stored
Read the value	node.override_level_of_detail.value
Assignment	node.override_level_of_detail = value

override_shading

node.override_shadingRead / write

Shading switch in the override.

Item	Type / behavior
Declared Maya path	overrideShading
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	True
Flags	input, output, connectable, stored
Read the value	node.override_shading.value
Assignment	node.override_shading = value

override_texturing

node.override_texturingRead / write

Texturing switch in the override.

Item	Type / behavior
Declared Maya path	overrideTexturing
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	True
Flags	input, output, connectable, stored
Read the value	node.override_texturing.value
Assignment	node.override_texturing = value

override_playback

node.override_playbackRead / write

Playback display according to the override.

Item	Type / behavior
Declared Maya path	overridePlayback
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	True
Flags	input, output, connectable, stored
Read the value	node.override_playback.value
Assignment	node.override_playback = value

override_visibility

node.override_visibilityRead / write

Override visibility.

Item	Type / behavior
Declared Maya path	overrideVisibility
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	True
Flags	input, output, connectable, stored
Read the value	node.override_visibility.value
Assignment	node.override_visibility = value

override_color

node.override_colorRead / write

Override color index.

Item	Type / behavior
Declared Maya path	overrideColor
Property return	_ValuePlugProxy · .value: int
Declared spec kind	numeric:byte
Declared default	0
Flags	input, output, connectable, stored
Read the value	node.override_color.value
Assignment	node.override_color = value

hide_on_playback

node.hide_on_playbackRead / write

Hide-on-playback switch.

Item	Type / behavior
Declared Maya path	hideOnPlayback
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	False
Flags	input, output, connectable, stored
Read the value	node.hide_on_playback.value
Assignment	node.hide_on_playback = value

override_rgb_colors

node.override_rgb_colorsRead / write

RGB color mode for the override.

Item	Type / behavior
Declared Maya path	overrideRGBColors
Property return	_ValuePlugProxy · .value: bool
Declared spec kind	numeric:bool
Declared default	False
Flags	input, output, connectable, stored
Read the value	node.override_rgb_colors.value
Assignment	node.override_rgb_colors = value

override_color_rgb

node.override_color_rgbRead / write

Override RGB color.

Item	Type / behavior
Declared Maya path	overrideColorRGB
Property return	_ValuePlugProxy · .value: tuple[float, float, float]
Declared spec kind	float3
Declared default	(0.0, 0.0, 0.0)
Flags	input, output, connectable, stored
Read the value	node.override_color_rgb.value
Assignment	node.override_color_rgb = value

override_color_r

node.override_color_rRead / write

R component of override_color_rgb.

Item	Type / behavior
Declared Maya path	overrideColorRGB.overrideColorR
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.override_color_r.value
Assignment	node.override_color_r = value

override_color_g

node.override_color_gRead / write

G component of override_color_rgb.

Item	Type / behavior
Declared Maya path	overrideColorRGB.overrideColorG
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.override_color_g.value
Assignment	node.override_color_g = value

override_color_b

node.override_color_bRead / write

B component of override_color_rgb.

Item	Type / behavior
Declared Maya path	overrideColorRGB.overrideColorB
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.override_color_b.value
Assignment	node.override_color_b = value

override_color_a

node.override_color_aRead / write

Override color alpha component.

Item	Type / behavior
Declared Maya path	overrideColorA
Property return	_ValuePlugProxy · .value: float
Declared spec kind	numeric:float
Declared default	0.0
Flags	input, output, connectable, stored
Read the value	node.override_color_a.value
Assignment	node.override_color_a = value

bounding_box

node.bounding_boxStructured access

Compound bounding-box plugs; distinct from fn_bounding_box.

Item	Type / behavior
Declared Maya path	boundingBox
Property return	CompoundProxy
Declared spec kind	compound
Declared default	None
Flags	output, connectable
Plug access	node.bounding_box.plug

The property returns a structure. Edit an explicit child or use Plug operations; do not replace the proxy with a Python assignment.

bounding_box_min

node.bounding_box_minRead / connections

Minimum corner of the local bounding box.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxMin
Property return	_ValuePlugProxy · .value: tuple[float, float, float]
Declared spec kind	double3
Declared default	(0.0, 0.0, 0.0)
Flags	output, connectable
Read the value	node.bounding_box_min.value

bounding_box_min_x

node.bounding_box_min_xRead / connections

X component of bounding_box_min.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxMin.boundingBoxMinX
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.bounding_box_min_x.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

bounding_box_min_y

node.bounding_box_min_yRead / connections

Y component of bounding_box_min.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxMin.boundingBoxMinY
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.bounding_box_min_y.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

bounding_box_min_z

node.bounding_box_min_zRead / connections

Z component of bounding_box_min.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxMin.boundingBoxMinZ
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.bounding_box_min_z.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

bounding_box_max

node.bounding_box_maxRead / connections

Maximum corner of the local bounding box.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxMax
Property return	_ValuePlugProxy · .value: tuple[float, float, float]
Declared spec kind	double3
Declared default	(0.0, 0.0, 0.0)
Flags	output, connectable
Read the value	node.bounding_box_max.value

bounding_box_max_x

node.bounding_box_max_xRead / connections

X component of bounding_box_max.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxMax.boundingBoxMaxX
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.bounding_box_max_x.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

bounding_box_max_y

node.bounding_box_max_yRead / connections

Y component of bounding_box_max.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxMax.boundingBoxMaxY
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.bounding_box_max_y.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

bounding_box_max_z

node.bounding_box_max_zRead / connections

Z component of bounding_box_max.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxMax.boundingBoxMaxZ
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.bounding_box_max_z.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

bounding_box_size

node.bounding_box_sizeRead / connections

Local bounding-box dimensions.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxSize
Property return	_ValuePlugProxy · .value: tuple[float, float, float]
Declared spec kind	double3
Declared default	(0.0, 0.0, 0.0)
Flags	output, connectable
Read the value	node.bounding_box_size.value

bounding_box_size_x

node.bounding_box_size_xRead / connections

X component of bounding_box_size.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxSize.boundingBoxSizeX
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.bounding_box_size_x.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

bounding_box_size_y

node.bounding_box_size_yRead / connections

Y component of bounding_box_size.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxSize.boundingBoxSizeY
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.bounding_box_size_y.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

bounding_box_size_z

node.bounding_box_size_zRead / connections

Z component of bounding_box_size.

Item	Type / behavior
Declared Maya path	boundingBox.boundingBoxSize.boundingBoxSizeZ
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.bounding_box_size_z.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

center

node.centerRead / connections

Local bounding-box center.

Item	Type / behavior
Declared Maya path	center
Property return	_ValuePlugProxy · .value: tuple[float, float, float]
Declared spec kind	double3
Declared default	(0.0, 0.0, 0.0)
Flags	output, connectable
Read the value	node.center.value

center_x

node.center_xRead / connections

X component of center.

Item	Type / behavior
Declared Maya path	center.boundingBoxCenterX
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.center_x.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

center_y

node.center_yRead / connections

Y component of center.

Item	Type / behavior
Declared Maya path	center.boundingBoxCenterY
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.center_y.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

center_z

node.center_zRead / connections

Z component of center.

Item	Type / behavior
Declared Maya path	center.boundingBoxCenterZ
Property return	_ValuePlugProxy · .value: float
Declared spec kind	unit:distance
Declared default	0.0
Flags	output, connectable
Read the value	node.center_z.value

The descriptor value is a float in the UI distance unit; the native Plug.value read returns an om.MDistance.

Specs inherited from ContainerBase21

Property	Maya plug	Returns	Description
black_box	blackBox	_ValuePlugProxy · .value: bool	Maya container black-box presentation.
border_connections	borderConnections	list[str]	Container boundary connection data.
creator	creator	_ValuePlugProxy · .value: str	Container creator metadata.
creation_date	creationDate	_ValuePlugProxy · .value: str	Creation date metadata.
custom_treatment	customTreatment	_ValuePlugProxy · .value: str	Custom container treatment.
hyper_layout	hyperLayout	None	Connection to the Hypergraph layout.
icon_name	iconName	_ValuePlugProxy · .value: str	Icon name associated with the container.
is_collapsed	isCollapsed	_ValuePlugProxy · .value: bool	Collapsed container state in Maya views.
is_hierarchical_connection	isHierarchicalConnection	TypedArrayProxy	Hierarchical connection flags.
rmb_command	rmbCommand	_ValuePlugProxy · .value: str	Container context-menu command.
template_name	templateName	_ValuePlugProxy · .value: str	Container template name.
template_path	templatePath	_ValuePlugProxy · .value: str	Container template path.
template_version	templateVersion	_ValuePlugProxy · .value: int	Container template version.
container_type	containerType	_ValuePlugProxy · .value: str	Container type metadata.
ui_treatment	uiTreatment	_ValuePlugProxy · .value: int	Container presentation mode.
view_mode	viewMode	_ValuePlugProxy · .value: int	Container view mode.
view_name	viewName	_ValuePlugProxy · .value: str	Container view name.
published_node_info	publishedNodeInfo	ArrayCompoundProxy	Array of published-node information.
published_node	publishedNodeInfo[].publishedNode	IndexedPathProxy	Connection to the published node at a given index.
is_hierarchical_node	publishedNodeInfo[].isHierarchicalNode	IndexedPathProxy	Hierarchical flag of a published node.
published_node_type	publishedNodeInfo[].publishedNodeType	IndexedPathProxy	Declared type of a published node.

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

Method	Returns
create	None
delete	None
snapshot	DAGSnapshot
finalize	None
set_parent	None

create

node.create() -> NoneOverridden method

Creates a missing DAG node with its optional staged parent. Does nothing if it exists. Use Transform, Joint, Mesh or another concrete wrapper to choose the type. Replays stored state in permissive mode.

Item	Type / behavior
Returns	None

RuntimeError without a creation type. Returns None; it is not a fluent constructor.

delete

node.delete(*, snapshot: bool = True) -> NoneOverridden method

Uses DGNode deletion. Native DAG parent deletion can also remove descendants: restrict it to objects whose lifecycle you own.

Item	Type / behavior
Returns	None
snapshot	bool · default True — Retain state before deletion.

snapshot

node.snapshot(profile: str = "rig") -> DAGSnapshotOverridden method

Extends the DG dictionary with parent (partial path) and parent_long_name (full path), using schema_version="dag-1.0". Both parent fields are None under world.

Item	Type / behavior
Returns	DAGSnapshot
profile	str · default "rig" — Captured profile label.

Captures the first parent; does not describe every DAG instance.

finalize

node.finalize(snapshot: dict | None = None, **kwargs) -> NoneOverridden method

Stores the dictionary and delegates replay to DGNode.finalize(). Does not apply the snapshot parent. Call set_parent() explicitly when parenting is part of the operation.

Item	Type / behavior
Returns	None
snapshot	dict | None · default None — Explicit state, otherwise stored state.
**kwargs	Options DGNode.finalize · default — — apply_values, apply_connections, apply_fset, strict.

Same error policy and lack of general rollback as DGNode.finalize().

set_parent

node.set_parent(parent: DAGNode | str | om.MObject | None, keep_world: bool = False) -> NoneMethod

Reparents the live node. Without a live node, stores an existing parent for creation. keep_world=True recomputes local transformation for transform objects; this correction does not apply to shapes.

Item	Type / behavior
Returns	None
parent	DAGNode | str | om.MObject | None · default — — Target parent; None for world.
keep_world	bool · default False — Attempt to preserve a transform world transformation.

A parent that does not resolve to a live node is treated as world. Check target.exists to avoid unintended unparenting. Maya errors remain possible (cycles, incompatible parents…). node.parent = target uses keep_world=True, unlike this method default.

Methods inherited from DGNode3

Method	Returns	Description
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.
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	Type	Value / role
NODE_TYPE	str | None	None
COMPATIBLE_MAYA_FN_TYPES	tuple[int, ...]	(om.MFn.kDagNode,)
SPEC_LAYERS	list[SpecLayer]	Parent layers + get_dag_specs_all

Attributes defined or overridden here. NODE_REGISTRY is inherited from Node.

The DAGSnapshot types exported by these modules are TypedDict descriptions, not classes to instantiate for capture. Use node.snapshot().

Behavior at a glance

Point	Behavior
Parenting	finalize() does not reparent. set_parent() is explicit, and its keep_world=False default differs from the parent setter.
Identity	The wrapper follows the Maya object; a replacement with the same name is not the same node.
Reading	Live reads take priority; check exists before native operations.
Specs	Describe existing plugs; do not automatically add Maya attributes.
Examples	The demonstration creates and deletes only its own nodes with a random name suffix.

Usage examples

Self-contained example for the Maya Python Script Editor. To run it in mayapy, initialize maya.standalone before this block and shut it down afterwards, as shown in the Node.

from uuid import uuid4
from weSkel.src.core.node.abstract.dag.lib import DAGNode
from weSkel.src.core.node.dag.transform.lib import Transform

prefix = "api_dag_" + uuid4().hex[:8]
parent = Transform(prefix + "_parent")
child = Transform(prefix + "_child")
try:
    parent.create()
    child.create()
    assert DAGNode(child.dag_path) is child
    child.set_parent(parent, keep_world=True)
    assert child.parent is parent
    state = child.snapshot()
    child.set_parent(None)
    child.finalize(state, apply_connections=False, strict=True)
    assert child.is_under_world
    child.set_parent(parent, keep_world=True)
    assert child.full_path_name in parent.child_names
    print("DAGNode: explicit parenting OK")
finally:
    child.delete(snapshot=False)
    parent.delete(snapshot=False)

Expected result : DAGNode: explicit parenting OK. Demonstration nodes are removed in finally.

SDK checkpoint 87c3486 reference. Inventory and examples checked against source under Maya 2025.3 and 2026.3; this does not validate the compiled package.