ControlPoint

object→Node→DGNode→ContainerBase→DAGNode→GeometryShape→ControlPoint

0own Python properties32own spec properties0own methods2class attributes

Import

from weSkel.src.core.node.abstract.control_point.lib import ControlPoint

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	ControlPoint
Module	weSkel.src.core.node.abstract.control_point.lib
Direct parent	GeometryShape
Represented direct descendants	Curve, SurfaceShape
Own members	0 Python properties + 32 spec properties; 0 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 : ControlPoint(node) → ControlPoint 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.

This base has an abstract NODE_TYPE. Descendant type recognition depends on concrete classes already imported. Import and use Mesh, Curve or Surface as appropriate; the bottom example shows base access after importing the concrete wrapper. Do not call .create() to instantiate the abstract type.

Properties

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

No additional Python properties: this class adds the spec properties below and inherits its parent properties.

Properties inherited from DAGNode20

Property	Return type	Access	Description
dag_fn	om.MFnDagNode	R	Live DAG function set, or unattached object when missing or invalid.
dag_path	om.MDagPath	R	One path to the current node; empty path when unavailable.
has_valid_dag_path	bool	R	Validity of the path returned by dag_path.
full_path_name	str	R	Full DAG path; empty string when the path is invalid.
short_name	str	R	Maya partial DAG path, which may contain more than a leaf name; empty string when invalid.
is_valid_dag_fn	bool	R	Function-set validity for the current object.
is_shape	bool	R	Current object compatibility with om.MFn.kShape.
parents	list[DAGNode]	R	All native parents.
parent	DAGNode | None	R/W	First parent only; None under world.
is_instanced	bool	R	Whether the DAG object has multiple paths / parents; False when missing.
children	list[DAGNode]	R	Direct children, without recursive traversal.
is_under_world	bool	R	Live node directly under world; False when missing.
child_count	int	R	Number of direct path children; 0 when invalid.
child_names	list[str]	R	Full paths of direct children; empty list when the path is invalid.
shape_count	int	R	Number of shapes directly under this path; 0 when invalid.
shapes	list[DAGNode]	R	Direct child shapes, including intermediate shapes; empty list when invalid.
shape_orig	DAGNode | None	R	First child shape with intermediateObject=True; None when absent.
intermediate_shapes	list[DAGNode]	R	All direct child shapes marked as intermediate.
draw_override_info	om.MDAGDrawOverrideInfo | None	R	Native path override information; None when unavailable.
fn_bounding_box	om.MBoundingBox | None	R	Local bounding box from the function set; None when unavailable.

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
blind_data_nodes	blindDataNodes	list[str]
color_set	colorSet	ArrayCompoundProxy
current_color_set	currentColorSet	_ValuePlugProxy · .value: str
color_name	colorSet[].colorName	IndexedPathProxy
clamped	colorSet[].clamped	IndexedPathProxy
representation	colorSet[].representation	IndexedPathProxy
color_set_points	colorSet[].colorSetPoints	AttributeError (direct access)
color_set_points_r	colorSet[].colorSetPoints[].colorSetPointsR	IndexedPathProxy
color_set_points_g	colorSet[].colorSetPoints[].colorSetPointsG	IndexedPathProxy
color_set_points_b	colorSet[].colorSetPoints[].colorSetPointsB	IndexedPathProxy
color_set_points_a	colorSet[].colorSetPoints[].colorSetPointsA	IndexedPathProxy
control_points	controlPoints	ArrayCompoundProxy
control_points_x_value	controlPoints[].xValue	IndexedPathProxy
control_points_y_value	controlPoints[].yValue	IndexedPathProxy
control_points_z_value	controlPoints[].zValue	IndexedPathProxy
tweak	tweak	_ValuePlugProxy · .value: bool
relative_tweak	relativeTweak	_ValuePlugProxy · .value: bool
tweak_location	tweakLocation	Any (native data)
display_immediate	displayImmediate	_ValuePlugProxy · .value: bool
display_color_channel	displayColorChannel	_ValuePlugProxy · .value: str
display_colors	displayColors	_ValuePlugProxy · .value: bool
current_uv_set	currentUVSet	_ValuePlugProxy · .value: str
uv_set	uvSet	ArrayCompoundProxy
uv_set_name	uvSet[].uvSetName	IndexedPathProxy
uv_set_points	uvSet[].uvSetPoints	_DynNumericArrayProxy
uv_set_points_u	uvSet[].uvSetPoints[].uvSetPointsU	IndexedPathProxy
uv_set_points_v	uvSet[].uvSetPoints[].uvSetPointsV	IndexedPathProxy
uv_set_tweak_location	uvSet[].uvSetTweakLocation	IndexedPathProxy
uv_pivot	uvPivot	_ValuePlugProxy · .value: tuple[float, float]
uv_pivot_x	uvPivot.uvPivotX	_ValuePlugProxy · .value: float
uv_pivot_y	uvPivot.uvPivotY	_ValuePlugProxy · .value: float
weights	weights	TypedArrayProxy

blind_data_nodes

node.blind_data_nodesConnections

Link data for blind-data nodes.

Item	Type / behavior
Declared Maya path	blindDataNodes
Property return	list[str]
Declared spec kind	array:message
Declared default	None
Flags	array, output, connectable

The returned list is not a guaranteed inventory of connected nodes. Inspect sources and destinations through node.plugs[...] for actual connections.

color_set

node.color_setStructured access

Color-set array.

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

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

current_color_set

node.current_color_setRead / write

Current color-set name.

Item	Type / behavior
Declared Maya path	currentColorSet
Property return	_ValuePlugProxy · .value: str
Declared spec kind	typed:string
Declared default	''
Flags	input, output, connectable, stored
Read the value	node.current_color_set.value
Assignment	node.current_color_set = value

color_name

node.color_nameLimited access

Indexed color-set name.

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

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.

clamped

node.clampedLimited access

Color-set clamping state.

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

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.

representation

node.representationLimited access

Color representation mode.

Item	Type / behavior
Declared Maya path	colorSet[].representation
Property return	IndexedPathProxy
Declared spec kind	enum
Declared default	4
Flags	input, output, connectable, stored, keyable
Indices	1 logical index(es), in the order of [] in the Maya path.
Verified alternative · returns a Plug	node.plugs["colorSet"][i1]["representation"]

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.

color_set_points

node.color_set_pointsLimited access

Colors beneath an indexed color set.

Item	Type / behavior
Declared Maya path	colorSet[].colorSetPoints
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["colorSet"][i1]["colorSetPoints"]

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.

color_set_points_r

node.color_set_points_rLimited access

R component of color_set_points.

Item	Type / behavior
Declared Maya path	colorSet[].colorSetPoints[].colorSetPointsR
Property return	IndexedPathProxy
Declared spec kind	numeric:float
Declared default	0.0
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["colorSet"][i1]["colorSetPoints"][i2]["colorSetPointsR"]

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.

color_set_points_g

node.color_set_points_gLimited access

G component of color_set_points.

Item	Type / behavior
Declared Maya path	colorSet[].colorSetPoints[].colorSetPointsG
Property return	IndexedPathProxy
Declared spec kind	numeric:float
Declared default	0.0
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["colorSet"][i1]["colorSetPoints"][i2]["colorSetPointsG"]

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.

color_set_points_b

node.color_set_points_bLimited access

B component of color_set_points.

Item	Type / behavior
Declared Maya path	colorSet[].colorSetPoints[].colorSetPointsB
Property return	IndexedPathProxy
Declared spec kind	numeric:float
Declared default	0.0
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["colorSet"][i1]["colorSetPoints"][i2]["colorSetPointsB"]

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.

color_set_points_a

node.color_set_points_aLimited access

A component of color_set_points.

Item	Type / behavior
Declared Maya path	colorSet[].colorSetPoints[].colorSetPointsA
Property return	IndexedPathProxy
Declared spec kind	numeric:float
Declared default	0.0
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["colorSet"][i1]["colorSetPoints"][i2]["colorSetPointsA"]

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.

control_points

node.control_pointsStructured access

Native control-point / tweak array; not a universal read of final positions.

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

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

control_points_x_value

node.control_points_x_valueLimited access

X component of the indexed control point.

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

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.

control_points_y_value

node.control_points_y_valueLimited access

Y component of the indexed control point.

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

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.

control_points_z_value

node.control_points_z_valueLimited access

Z component of the indexed control point.

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

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.

tweak

node.tweakRead / write

Native tweak state.

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

relative_tweak

node.relative_tweakRead / write

Relative tweak mode.

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

tweak_location

node.tweak_locationRead / connections

Native tweak-location data.

Item	Type / behavior
Declared Maya path	tweakLocation
Property return	Any (native data)
Declared spec kind	generic:typed:data
Declared default	None
Flags	input, connectable, hidden

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

display_immediate

node.display_immediateRead / write

Native immediate-display option.

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

display_color_channel

node.display_color_channelRead / write

Displayed color channel.

Item	Type / behavior
Declared Maya path	displayColorChannel
Property return	_ValuePlugProxy · .value: str
Declared spec kind	typed:string
Declared default	'Ambient+Diffuse'
Flags	input, output, connectable, stored
Read the value	node.display_color_channel.value
Assignment	node.display_color_channel = value

display_colors

node.display_colorsRead / write

Component color display switch.

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

The concrete Mesh wrapper overrides this property without a Python setter. Direct assignment on a Mesh raises AttributeError; use the native plug explicitly when a change is intended.

current_uv_set

node.current_uv_setRead / write

Current UV-set name.

Item	Type / behavior
Declared Maya path	currentUVSet
Property return	_ValuePlugProxy · .value: str
Declared spec kind	typed:string
Declared default	'map1'
Flags	input, output, connectable, stored
Read the value	node.current_uv_set.value
Assignment	node.current_uv_set = value

The concrete Mesh wrapper overrides this property without a Python setter. Direct assignment on a Mesh raises AttributeError; use the native plug explicitly when a change is intended.

uv_set

node.uv_setStructured access

UV-set array.

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

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

uv_set_name

node.uv_set_nameLimited access

Indexed UV-set name.

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

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.

uv_set_points

node.uv_set_pointsRead / write

UV pairs of the UV set; access through its parent element to choose the set.

Item	Type / behavior
Declared Maya path	uvSet[].uvSetPoints
Property return	_DynNumericArrayProxy
Declared spec kind	array:float2
Declared default	(0.0, 0.0)
Flags	array, input, output, connectable, stored

To choose a specific UV set, use node.plugs["uvSet"][i]["uvSetPoints"] and its elements. Do not interpret the direct proxy index as the UV-set number.

uv_set_points_u

node.uv_set_points_uLimited access

U coordinate addressed by two logical indices.

Item	Type / behavior
Declared Maya path	uvSet[].uvSetPoints[].uvSetPointsU
Property return	IndexedPathProxy
Declared spec kind	numeric:float
Declared default	0.0
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["uvSet"][i1]["uvSetPoints"][i2]["uvSetPointsU"]

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.

uv_set_points_v

node.uv_set_points_vLimited access

V coordinate addressed by two logical indices.

Item	Type / behavior
Declared Maya path	uvSet[].uvSetPoints[].uvSetPointsV
Property return	IndexedPathProxy
Declared spec kind	numeric:float
Declared default	0.0
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["uvSet"][i1]["uvSetPoints"][i2]["uvSetPointsV"]

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.

uv_set_tweak_location

node.uv_set_tweak_locationLimited access

UV-set tweak-location data.

Item	Type / behavior
Declared Maya path	uvSet[].uvSetTweakLocation
Property return	IndexedPathProxy
Declared spec kind	generic:typed:data
Declared default	None
Flags	input, connectable
Indices	1 logical index(es), in the order of [] in the Maya path.
Verified alternative · returns a Plug	node.plugs["uvSet"][i1]["uvSetTweakLocation"]

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.

uv_pivot

node.uv_pivotRead / write

Two-component UV pivot.

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

uv_pivot_x

node.uv_pivot_xRead / write

First UV pivot component.

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

uv_pivot_y

node.uv_pivot_yRead / write

Second UV pivot component.

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

weights

node.weightsRead / connections

Native control-point weights; distinct from skinCluster influence weights.

Item	Type / behavior
Declared Maya path	weights
Property return	TypedArrayProxy
Declared spec kind	array:numeric:double
Declared default	1.0
Flags	array, input, output, connectable
Plug access	node.weights.plug
Logical element	node.weights.element_plug(i).value

Specs inherited from GeometryShape32

Property	Maya plug	Returns	Description
as_background	asBackground	_ValuePlugProxy · .value: bool	Native background-use option.
depth_jitter	depthJitter	_ValuePlugProxy · .value: bool	Native depth-jitter option.
primary_visiblity	primaryVisibility	_ValuePlugProxy · .value: bool	Primary render visibility.
antialiasing_level	antialiasingLevel	_ValuePlugProxy · .value: int	Geometry antialiasing level.
geometry_antialiasing_override	geometryAntialiasingOverride	_ValuePlugProxy · .value: bool	Geometry antialiasing override switch.
component_tags	componentTags	ArrayCompoundProxy	Component-tag array.
component_tag_name	componentTags[].componentTagName	IndexedPathProxy	Tag name at the requested index.
component_tag_contents	componentTags[].componentTagContents	IndexedPathProxy	Component-tag contents.
casts_shadows	castsShadows	_ValuePlugProxy · .value: bool	Shadow casting switch.
hardware_fog_multiplier	hardwareFogMultiplier	_ValuePlugProxy · .value: float	Hardware fog multiplier.
ignore_self_shadowing	ignoreSelfShadowing	_ValuePlugProxy · .value: bool	Ignore-self-shadowing option.
max_shading_samples	maxShadingSamples	_ValuePlugProxy · .value: int	Maximum shading sample count.
receive_shadows	receiveShadows	_ValuePlugProxy · .value: bool	Shadow receiving switch.
shading_samples	shadingSamples	_ValuePlugProxy · .value: int	Shading sample count.
shading_samples_override	shadingSamplesOverride	_ValuePlugProxy · .value: bool	Shading sample override switch.
inst_material_assign	instMaterialAssign	list[str]	Per-instance material assignment data.
pick_texture	pickTexture	None	Native texture-picking connection.
comp_inst_obj_groups	compInstObjGroups	ArrayCompoundProxy	Per-instance component groups.
comp_object_groups	compInstObjGroups[].objectGroups	AttributeError (direct access)	Groups beneath a component instance.
comp_object_grp_comp_list	compInstObjGroups[].objectGroups[].objectGrpCompList	IndexedPathProxy	Component list of the indexed group.
comp_object_group_id	compInstObjGroups[].objectGroups[].objectGroupId	IndexedPathProxy	Indexed component group identifier.
reference_object	referenceObject	None	Connection to the shape reference object.
max_visibility_samples	maxVisibilitySamples	_ValuePlugProxy · .value: int	Maximum visibility sample count.
max_visibility_samples_override	maxVisibilitySamplesOverride	_ValuePlugProxy · .value: bool	Visibility sample override switch.
render_type	renderType	_ValuePlugProxy · .value: int	Native shape render type.
render_volume	renderVolume	_ValuePlugProxy · .value: bool	Native volume rendering option.
visible_fraction	visibleFraction	_ValuePlugProxy · .value: float	Native visible fraction.
visible_in_reflections	visibleInReflections	_ValuePlugProxy · .value: bool	Visibility in reflections.
visible_in_refractions	visibleInRefractions	_ValuePlugProxy · .value: bool	Visibility in refractions.
volume_samples	volumeSamples	_ValuePlugProxy · .value: int	Volume sample count.
volume_samples_override	volumeSamplesOverride	_ValuePlugProxy · .value: bool	Volume sample override switch.
motion_blur	motionBlur	_ValuePlugProxy · .value: bool	Motion blur switch.

Specs inherited from DAGNode93

Property	Maya plug	Returns	Description
use_object_color	useObjectColor	_ValuePlugProxy · .value: int	Object-color usage mode.
visibility	visibility	_ValuePlugProxy · .value: bool	Local node visibility; it does not summarize visibility across the hierarchy.
template	template	_ValuePlugProxy · .value: bool	Object template display state.
lod_visibility	lodVisibility	_ValuePlugProxy · .value: bool	Level-of-detail visibility.
object_color	objectColor	_ValuePlugProxy · .value: int	Object color index.
object_color_rgb	objectColorRGB	_ValuePlugProxy · .value: tuple[float, float, float]	Object RGB color.
object_color_r	objectColorR	_ValuePlugProxy · .value: float	R component of object_color_rgb.
object_color_g	objectColorG	_ValuePlugProxy · .value: float	G component of object_color_rgb.
object_color_b	objectColorB	_ValuePlugProxy · .value: float	B component of object_color_rgb.
wire_color_rgb	wireColorRGB	_ValuePlugProxy · .value: tuple[float, float, float]	Wireframe RGB color.
wire_color_r	wireColorRGB.wireColorR	_ValuePlugProxy · .value: float	R component of wire_color_rgb.
wire_color_g	wireColorRGB.wireColorG	_ValuePlugProxy · .value: float	G component of wire_color_rgb.
wire_color_b	wireColorRGB.wireColorB	_ValuePlugProxy · .value: float	B component of wire_color_rgb.
hidden_in_outliner	hiddenInOutliner	_ValuePlugProxy · .value: bool	Hidden state in the Outliner.
use_outliner_color	useOutlinerColor	_ValuePlugProxy · .value: bool	Custom Outliner color switch.
outliner_color	outlinerColor	_ValuePlugProxy · .value: tuple[float, float, float]	Outliner RGB color.
outliner_color_r	outlinerColorR	_ValuePlugProxy · .value: float	R component of outliner_color.
outliner_color_g	outlinerColorG	_ValuePlugProxy · .value: float	G component of outliner_color.
outliner_color_b	outlinerColorB	_ValuePlugProxy · .value: float	B component of outliner_color.
ghosting	ghosting	_ValuePlugProxy · .value: bool	Maya ghosting switch.
ghosting_mode	ghostingMode	_ValuePlugProxy · .value: int	Ghosting mode.
ghost_custom_steps	ghostCustomSteps	CompoundProxy	Compound ghosting-step settings.
ghost_pre_frames	ghostCustomSteps.ghostPreFrames	_ValuePlugProxy · .value: int	Number of frames before the current frame.
ghost_post_frames	ghostCustomSteps.ghostPostFrames	_ValuePlugProxy · .value: int	Number of frames after the current frame.
ghosts_step	ghostCustomSteps.ghostsStep	_ValuePlugProxy · .value: int	Step between ghosting samples.
ghost_frames	ghostFrames	TypedArrayProxy	Native ghosting frame list.
ghost_use_driver	ghostUseDriver	_ValuePlugProxy · .value: bool	Use of a ghosting driver.
ghost_driver	ghostDriver	None	Connection to the ghosting driver.
ghost_color_pre	ghostColorPre	_ValuePlugProxy · .value: tuple[float, float, float]	Previous-ghost color.
ghost_color_pre_r	ghostColorPre.ghostColorPreR	_ValuePlugProxy · .value: float	R component of ghost_color_pre.
ghost_color_pre_g	ghostColorPre.ghostColorPreG	_ValuePlugProxy · .value: float	G component of ghost_color_pre.
ghost_color_pre_b	ghostColorPre.ghostColorPreB	_ValuePlugProxy · .value: float	B component of ghost_color_pre.
ghost_color_post	ghostColorPost	_ValuePlugProxy · .value: tuple[float, float, float]	Following-ghost color.
ghost_color_post_r	ghostColorPost.ghostColorPostR	_ValuePlugProxy · .value: float	R component of ghost_color_post.
ghost_color_post_g	ghostColorPost.ghostColorPostG	_ValuePlugProxy · .value: float	G component of ghost_color_post.
ghost_color_post_b	ghostColorPost.ghostColorPostB	_ValuePlugProxy · .value: float	B component of ghost_color_post.
ghost_opacity_range	ghostOpacityRange	_ValuePlugProxy · .value: tuple[float, float]	Compound ghost opacity range.
ghost_near_opacity	ghostOpacityRange.ghostNearOpacity	_ValuePlugProxy · .value: float	Near-ghost opacity.
ghost_far_opacity	ghostOpacityRange.ghostFarOpacity	_ValuePlugProxy · .value: float	Far-ghost opacity.
render_info	renderInfo	CompoundProxy	Compound node render information.
identification	renderInfo.identification	_ValuePlugProxy · .value: int	Native identifier in render information.
layer_renderable	renderInfo.layerRenderable	_ValuePlugProxy · .value: bool	Layer renderability.
layer_override_color	renderInfo.layerOverrideColor	_ValuePlugProxy · .value: int	Layer override color index.
render_layer_info	renderLayerInfo	ArrayCompoundProxy	Per-render-layer information array.
render_layer_id	renderLayerInfo[].renderLayerId	IndexedPathProxy	Render layer identifier at the requested index.
render_layer_renderable	renderLayerInfo[].renderLayerRenderable	IndexedPathProxy	Renderability of the layer at the requested index.
render_layer_color	renderLayerInfo[].renderLayerColor	IndexedPathProxy	Render layer color index.
selection_child_highlighting	selectionChildHighlighting	_ValuePlugProxy · .value: bool	Child highlighting on selection.
inst_obj_groups	instObjGroups	ArrayCompoundProxy	Membership groups per DAG instance.
object_groups	instObjGroups[].objectGroups	AttributeError (direct access)	Component groups beneath a DAG instance.
object_grp_comp_list	instObjGroups[].objectGroups[].objectGrpCompList	IndexedPathProxy	Group components addressed by two logical indices.
object_group_id	instObjGroups[].objectGroups[].objectGroupId	IndexedPathProxy	Component group identifier.
object_grp_color	instObjGroups[].objectGroups[].objectGrpColor	IndexedPathProxy	Component group color index.
matrix	matrix	_ValuePlugProxy · .value: om.MMatrix	Local matrix evaluated by Maya.
inverse_matrix	inverseMatrix	_ValuePlugProxy · .value: om.MMatrix	Inverse local matrix.
parent_matrix	parentMatrix	TypedArrayProxy	Parent matrices indexed by instance.
parent_inverse_matrix	parentInverseMatrix	TypedArrayProxy	Inverse parent matrices.
world_matrix	worldMatrix	TypedArrayProxy	World matrices indexed by DAG instance.
world_inverse_matrix	worldInverseMatrix	TypedArrayProxy	Inverse world matrices.
intermediate_object	intermediateObject	_ValuePlugProxy · .value: bool	Maya intermediate-shape flag.
draw_override	drawOverride	CompoundProxy	Compound display overrides.
override_enabled	overrideEnabled	_ValuePlugProxy · .value: bool	Display override switch.
override_display_type	overrideDisplayType	_ValuePlugProxy · .value: int	Override display type.
override_level_of_detail	overrideLevelOfDetail	_ValuePlugProxy · .value: int	Override level of detail.
override_shading	overrideShading	_ValuePlugProxy · .value: bool	Shading switch in the override.
override_texturing	overrideTexturing	_ValuePlugProxy · .value: bool	Texturing switch in the override.
override_playback	overridePlayback	_ValuePlugProxy · .value: bool	Playback display according to the override.
override_visibility	overrideVisibility	_ValuePlugProxy · .value: bool	Override visibility.
override_color	overrideColor	_ValuePlugProxy · .value: int	Override color index.
hide_on_playback	hideOnPlayback	_ValuePlugProxy · .value: bool	Hide-on-playback switch.
override_rgb_colors	overrideRGBColors	_ValuePlugProxy · .value: bool	RGB color mode for the override.
override_color_rgb	overrideColorRGB	_ValuePlugProxy · .value: tuple[float, float, float]	Override RGB color.
override_color_r	overrideColorRGB.overrideColorR	_ValuePlugProxy · .value: float	R component of override_color_rgb.
override_color_g	overrideColorRGB.overrideColorG	_ValuePlugProxy · .value: float	G component of override_color_rgb.
override_color_b	overrideColorRGB.overrideColorB	_ValuePlugProxy · .value: float	B component of override_color_rgb.
override_color_a	overrideColorA	_ValuePlugProxy · .value: float	Override color alpha component.
bounding_box	boundingBox	CompoundProxy	Compound bounding-box plugs; distinct from fn_bounding_box.
bounding_box_min	boundingBox.boundingBoxMin	_ValuePlugProxy · .value: tuple[float, float, float]	Minimum corner of the local bounding box.
bounding_box_min_x	boundingBox.boundingBoxMin.boundingBoxMinX	_ValuePlugProxy · .value: float	X component of bounding_box_min.
bounding_box_min_y	boundingBox.boundingBoxMin.boundingBoxMinY	_ValuePlugProxy · .value: float	Y component of bounding_box_min.
bounding_box_min_z	boundingBox.boundingBoxMin.boundingBoxMinZ	_ValuePlugProxy · .value: float	Z component of bounding_box_min.
bounding_box_max	boundingBox.boundingBoxMax	_ValuePlugProxy · .value: tuple[float, float, float]	Maximum corner of the local bounding box.
bounding_box_max_x	boundingBox.boundingBoxMax.boundingBoxMaxX	_ValuePlugProxy · .value: float	X component of bounding_box_max.
bounding_box_max_y	boundingBox.boundingBoxMax.boundingBoxMaxY	_ValuePlugProxy · .value: float	Y component of bounding_box_max.
bounding_box_max_z	boundingBox.boundingBoxMax.boundingBoxMaxZ	_ValuePlugProxy · .value: float	Z component of bounding_box_max.
bounding_box_size	boundingBox.boundingBoxSize	_ValuePlugProxy · .value: tuple[float, float, float]	Local bounding-box dimensions.
bounding_box_size_x	boundingBox.boundingBoxSize.boundingBoxSizeX	_ValuePlugProxy · .value: float	X component of bounding_box_size.
bounding_box_size_y	boundingBox.boundingBoxSize.boundingBoxSizeY	_ValuePlugProxy · .value: float	Y component of bounding_box_size.
bounding_box_size_z	boundingBox.boundingBoxSize.boundingBoxSizeZ	_ValuePlugProxy · .value: float	Z component of bounding_box_size.
center	center	_ValuePlugProxy · .value: tuple[float, float, float]	Local bounding-box center.
center_x	center.boundingBoxCenterX	_ValuePlugProxy · .value: float	X component of center.
center_y	center.boundingBoxCenterY	_ValuePlugProxy · .value: float	Y component of center.
center_z	center.boundingBoxCenterZ	_ValuePlugProxy · .value: float	Z component of center.

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

No new public methods on this class. Use inherited methods below; an abstract base does not provide a new creatable Maya type.

Methods inherited from DAGNode5

Method	Returns	Description
create	None	Creates a missing DAG node with its optional staged parent.
delete	None	Uses DGNode deletion.
snapshot	DAGSnapshot	Extends the DG dictionary with parent (partial path) and parent_long_name (full path), using schema_version="dag-1.0".
finalize	None	Stores the dictionary and delegates replay to DGNode.finalize().
set_parent	None	Reparents the live node.

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	"controlPoint"
SPEC_LAYERS	list[SpecLayer]	Parent layers + get_control_point_specs_all

Attributes defined or overridden here. NODE_REGISTRY is inherited from Node. COMPATIBLE_MAYA_FN_TYPES is inherited; for a class with explicit NODE_TYPE, its use also depends on the compatibility policy described under Constructor.

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

Behavior at a glance

Point	Behavior
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.

The demonstration shape is an empty mesh: this tests the inherited property, not topology creation.

from uuid import uuid4
from weSkel.src.core.node.abstract.control_point.lib import ControlPoint
from weSkel.src.core.node.dag.mesh.lib import Mesh
from weSkel.src.core.node.dag.transform.lib import Transform

prefix = "api_shape_" + uuid4().hex[:8]
parent = Transform(prefix + "_parent")
node = Mesh(prefix + "Shape")
try:
    parent.create()
    node.parent = parent
    node.create()
    assert ControlPoint(node.mobject) is node
    node.relative_tweak = False
    assert node.relative_tweak.value is False
    print("ControlPoint: inherited shape property OK")
finally:
    node.delete(snapshot=False)
    parent.delete(snapshot=False)

Expected result : ControlPoint: inherited shape property 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.