CurveFromSurface

Specialized parent for surface-derived curves; abstract Maya node type.

ClassAPI 2.0GEOMETRY

objectNodeDGNodeCurveFromSurface

0own Python properties 5own spec properties 0own methods 2class attributes

The Maya curveFromSurface type is abstract: create() fails in both target versions. At this checkpoint, the class also rejects wrapping a curveFromSurfaceIso directly. Use the concrete CurveFromSurfaceIso class. Descriptor types here are declarative; no live reads on an instance of this class are claimed.

Import

from weSkel.src.core.node.dg.curve_from_surface.lib import CurveFromSurface

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

Inheritance and scope

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

Constructor

Signature : CurveFromSurface(node) → CurveFromSurface.

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

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

Properties

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

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

Properties inherited from DGNode15

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

Properties inherited from Node10

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

Spec properties

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

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

Property	Maya plug	Returns
`input_surface`	`inputSurface`	`unavailable · SurfaceProp`
`output_curve`	`outputCurve`	`unavailable · CurveProp`
`max_value`	`maxValue`	`unavailable · FloatProp`
`min_value`	`minValue`	`unavailable · FloatProp`
`relative`	`relative`	`unavailable · BoolProp`

input_surface

node.input_surfaceNative spec

Access to native plug inputSurface.

Item	Type / behavior
Maya path	`inputSurface`
Property return	`unavailable · SurfaceProp`
Declared kind	`typed:nurbsSurface`
Declared default	`None`
Flags	`input`, `output`, `connectable`

Observed limitation on the tested fixture: RuntimeError: Wrapper unavailable: TypeError: CurveFromSurface cannot wrap Maya node 'api_CurveFromSurface' of type 'curveFromSurfaceIso'; expected 'curveFromSurface'..

output_curve

node.output_curveNative spec

Access to native plug outputCurve.

Item	Type / behavior
Maya path	`outputCurve`
Property return	`unavailable · CurveProp`
Declared kind	`typed:nurbsCurve`
Declared default	`None`
Flags	`output`, `connectable`

max_value

node.max_valueNative spec

Access to native plug maxValue.

Item	Type / behavior
Maya path	`maxValue`
Property return	`unavailable · FloatProp`
Declared kind	`numeric:double`
Declared default	`-1.0`
Flags	`input`, `output`, `connectable`, `stored`, `keyable`

min_value

node.min_valueNative spec

Access to native plug minValue.

Item	Type / behavior
Maya path	`minValue`
Property return	`unavailable · FloatProp`
Declared kind	`numeric:double`
Declared default	`1.0`
Flags	`input`, `output`, `connectable`, `stored`, `keyable`

relative

node.relativeNative spec

Access to native plug relative.

Item	Type / behavior
Maya path	`relative`
Property return	`unavailable · BoolProp`
Declared kind	`numeric:bool`
Declared default	`False`
Flags	`input`, `output`, `connectable`, `stored`

Specs inherited from DGNode6

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

Methods

No additional public method; inherited methods remain available.

Methods inherited from DGNode7

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

Methods inherited from Node2

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

Class attributes

Attribute	Value / composition
`NODE_TYPE`	`'curveFromSurface'`
`SPEC_LAYERS`	`get_dg_specs_all`, `get_curve_from_surface_specs_all`

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

Behavior at a glance

Point	Behavior
Identity	A node recreated under the same name is a new Maya object.
Creation and geometry	The constructor creates nothing; call create() before live operations.
Capture	Snapshots can contain Maya objects; do not assume JSON-ready data or complete geometry reconstruction.
Usage	The Maya curveFromSurface type is abstract: create() fails in both target versions. At this checkpoint, the class also rejects wrapping a curveFromSurfaceIso directly. Use the concrete CurveFromSurfaceIso class. Descriptor types here are declarative; no live reads on an instance of this class are claimed.

Usage examples

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

from uuid import uuid4
from weSkel.src.core.node.dg.curve_from_surface.lib import CurveFromSurface

node = CurveFromSurface("api_abstract_curve_" + uuid4().hex[:8])
try:
    try:
        node.create()
    except RuntimeError:
        assert not node.exists
        print("CurveFromSurface: abstract native type cannot be created")
    else:
        raise AssertionError("Expected an abstract native type")
finally:
    node.delete(snapshot=False)

Expected result : CurveFromSurface: abstract native type cannot be created.

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