Skip to content
weSkelDOCUMENTATION
Documentation/API reference/GeometryShape

GeometryShape

Geometry shape foundation: rendering, components and groups.

ClassAPI 2.0Base
objectNodeDGNodeContainerBaseDAGNodeGeometryShape
from weSkel.src.core.node.abstract.geometry_shape.lib import GeometryShape

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.

Item Value
Class GeometryShape
Module weSkel.src.core.node.abstract.geometry_shape.lib
Direct parent DAGNode
Represented direct descendants ControlPoint
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.

Signature : GeometryShape(node) → GeometryShape 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.

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.

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
as_background asBackground _ValuePlugProxy · .value: bool
depth_jitter depthJitter _ValuePlugProxy · .value: bool
primary_visiblity primaryVisibility _ValuePlugProxy · .value: bool
antialiasing_level antialiasingLevel _ValuePlugProxy · .value: int
geometry_antialiasing_override geometryAntialiasingOverride _ValuePlugProxy · .value: bool
component_tags componentTags ArrayCompoundProxy
component_tag_name componentTags[].componentTagName IndexedPathProxy
component_tag_contents componentTags[].componentTagContents IndexedPathProxy
casts_shadows castsShadows _ValuePlugProxy · .value: bool
hardware_fog_multiplier hardwareFogMultiplier _ValuePlugProxy · .value: float
ignore_self_shadowing ignoreSelfShadowing _ValuePlugProxy · .value: bool
max_shading_samples maxShadingSamples _ValuePlugProxy · .value: int
receive_shadows receiveShadows _ValuePlugProxy · .value: bool
shading_samples shadingSamples _ValuePlugProxy · .value: int
shading_samples_override shadingSamplesOverride _ValuePlugProxy · .value: bool
inst_material_assign instMaterialAssign list[str]
pick_texture pickTexture None
comp_inst_obj_groups compInstObjGroups ArrayCompoundProxy
comp_object_groups compInstObjGroups[].objectGroups AttributeError (direct access)
comp_object_grp_comp_list compInstObjGroups[].objectGroups[].objectGrpCompList IndexedPathProxy
comp_object_group_id compInstObjGroups[].objectGroups[].objectGroupId IndexedPathProxy
reference_object referenceObject None
max_visibility_samples maxVisibilitySamples _ValuePlugProxy · .value: int
max_visibility_samples_override maxVisibilitySamplesOverride _ValuePlugProxy · .value: bool
render_type renderType _ValuePlugProxy · .value: int
render_volume renderVolume _ValuePlugProxy · .value: bool
visible_fraction visibleFraction _ValuePlugProxy · .value: float
visible_in_reflections visibleInReflections _ValuePlugProxy · .value: bool
visible_in_refractions visibleInRefractions _ValuePlugProxy · .value: bool
volume_samples volumeSamples _ValuePlugProxy · .value: int
volume_samples_override volumeSamplesOverride _ValuePlugProxy · .value: bool
motion_blur motionBlur _ValuePlugProxy · .value: bool

node.as_backgroundRead / write

Native background-use option.

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

node.depth_jitterRead / write

Native depth-jitter option.

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

node.primary_visiblityRead / write

Primary render visibility. The Python name is spelled visiblity.

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

node.antialiasing_levelRead / write

Geometry antialiasing level.

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

node.geometry_antialiasing_overrideRead / write

Geometry antialiasing override switch.

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

node.component_tagsStructured access

Component-tag array.

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

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

node.component_tag_nameLimited access

Tag name at the requested index.

Item Type / behavior
Declared Maya path componentTags[].componentTagName
Property return IndexedPathProxy
Declared spec kind typed:string
Declared default ''
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["componentTags"][i1]["componentTagName"]

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.

node.component_tag_contentsLimited access

Component-tag contents.

Item Type / behavior
Declared Maya path componentTags[].componentTagContents
Property return IndexedPathProxy
Declared spec kind typed:componentList
Declared default None
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["componentTags"][i1]["componentTagContents"]

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.

node.casts_shadowsRead / write

Shadow casting switch.

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

node.hardware_fog_multiplierRead / write

Hardware fog multiplier.

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

node.ignore_self_shadowingRead / write

Ignore-self-shadowing option.

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

node.max_shading_samplesRead / write

Maximum shading sample count.

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

node.receive_shadowsRead / write

Shadow receiving switch.

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

node.shading_samplesRead / write

Shading sample count.

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

node.shading_samples_overrideRead / write

Shading sample override switch.

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

node.inst_material_assignConnections

Per-instance material assignment data.

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

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

node.pick_textureConnections

Native texture-picking connection.

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

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

node.comp_inst_obj_groupsStructured access

Per-instance component groups.

Item Type / behavior
Declared Maya path compInstObjGroups
Property return ArrayCompoundProxy
Declared spec kind array:compound
Declared default None
Flags array, input, output, connectable, stored
Plug access node.comp_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.

node.comp_object_groupsLimited access

Groups beneath a component instance.

Item Type / behavior
Declared Maya path compInstObjGroups[].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["compInstObjGroups"][i1]["compObjectGroups"]
Observed native path compInstObjGroups[].compObjectGroups

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. The spec uses child-attribute names that differ from those observed in Maya. The alternative uses native names; this documentation does not fix the spec code.

node.comp_object_grp_comp_listLimited access

Component list of the indexed group.

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

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. The spec uses child-attribute names that differ from those observed in Maya. The alternative uses native names; this documentation does not fix the spec code.

node.comp_object_group_idLimited access

Indexed component group identifier.

Item Type / behavior
Declared Maya path compInstObjGroups[].objectGroups[].objectGroupId
Property return IndexedPathProxy
Declared spec kind numeric:int
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["compInstObjGroups"][i1]["compObjectGroups"][i2]["compObjectGroupId"]
Observed native path compInstObjGroups[].compObjectGroups[].compObjectGroupId

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. The spec uses child-attribute names that differ from those observed in Maya. The alternative uses native names; this documentation does not fix the spec code.

node.reference_objectConnections

Connection to the shape reference object.

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

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

node.max_visibility_samplesRead / write

Maximum visibility sample count.

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

node.max_visibility_samples_overrideRead / write

Visibility sample override switch.

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

On the verified mesh, .value returns a bool, while the spec declares numeric:int with default 1. Both facts are deliberately distinguished.

node.render_typeRead / write

Native shape render type.

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

node.render_volumeRead / write

Native volume rendering option.

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

node.visible_fractionRead / write

Native visible fraction.

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

node.visible_in_reflectionsRead / write

Visibility in reflections.

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

node.visible_in_refractionsRead / write

Visibility in refractions.

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

node.volume_samplesRead / write

Volume sample count.

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

node.volume_samples_overrideRead / write

Volume sample override switch.

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

node.motion_blurRead / write

Motion blur switch.

Item Type / behavior
Declared Maya path motionBlur
Property return _ValuePlugProxy · .value: bool
Declared spec kind numeric:bool
Declared default True
Flags input, output, connectable, stored
Read the value node.motion_blur.value
Assignment node.motion_blur = value
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.

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.
Attribute Type Value / role
NODE_TYPE str | None "geometryShape"
SPEC_LAYERS list[SpecLayer] Parent layers + get_geometry_shape_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 GeometryShapeSnapshot types exported by these modules are TypedDict descriptions, not classes to instantiate for capture. Use node.snapshot().

Point Behavior
primary_visiblity Current public spelling to preserve in scripts.
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.

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.geometry_shape.lib import GeometryShape
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 GeometryShape(node.mobject) is node
node.casts_shadows = False
assert node.casts_shadows.value is False
print("GeometryShape: inherited shape property OK")
finally:
node.delete(snapshot=False)
parent.delete(snapshot=False)

Expected result : GeometryShape: 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.