Surface

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

30propriétés Python propres64propriétés de specs propres33méthodes propres2attributs de classe

Import

from weSkel.src.core.node.dag.surface.lib import Surface

À exécuter dans Maya ou dans un processus mayapy initialisé. L’import om n’est nécessaire que si votre script utilise des types OpenMaya.

Héritage et périmètre

Élément	Valeur
Classe	Surface
Module	weSkel.src.core.node.dag.surface.lib
Type Maya	nurbsSurface
Parent direct	SurfaceShape
Inventaire	Membres définis ou redéfinis ici ; les membres hérités sont regroupés par parent dans chaque rubrique.

Constructeur

Signature : Surface(node) → Surface.

Paramètre	Type accepté	Défaut
node	Union[str, om.MObject, om.MObjectHandle, om.MFnDependencyNode, om.MDagPath, om.MFnDagNode, om.MFnNurbsSurface, om.MFnNurbsSurfaceData]	Obligatoire

Enveloppe un nœud existant ou prépare un wrapper pour un nom absent ; ne crée pas le nœud. Utiliser create() séparément. Un objet ou type incompatible peut lever TypeError. L’identité partagée peut renvoyer un wrapper compatible déjà enregistré.

Propriétés

Propriétés Python définies ou redéfinies ici. L : lecture seule ; L/E : setter disponible, avec les restrictions précisées dans la fiche. Les types om.* appartiennent à maya.api.OpenMaya.

Propriété	Type retourné	Accès
mfn_surface	Optional[om.MFnNurbsSurface]	L
mfn_surface_data	Optional[om.MFnNurbsSurfaceData]	L
u_degree	int	L/E
v_degree	int	L/E
u_spans	int	L/E
v_spans	int	L/E
u_knots	om.MDoubleArray	L/E
v_knots	om.MDoubleArray	L/E
u_form	int	L/E
v_form	int	L/E
is_uniform	bool	L/E
is_rational	bool	L/E
is_trimmed	bool	L
num_regions	int	L
boundary_per_region	List[int]	L
area	float	L
num_patches	int	L
num_patches_u	int	L
num_patches_v	int	L
num_edges_u	int	L
num_edges_v	int	L
edges_indices_u	List[Tuple[Tuple[int, int], Tuple[int, int]]]	L
edges_indices_v	List[Tuple[Tuple[int, int], Tuple[int, int]]]	L
edges_points_u	List[Tuple[om.MPoint, om.MPoint]]	L
edges_points_v	List[Tuple[om.MPoint, om.MPoint]]	L
cv_list	Optional[List[Tuple[Tuple[int, int], om.MObject]]]	L
num_cvs_u	int	L
num_cvs_v	int	L
cvs	om.MPointArray	L/E
num_cvs	int	L

mfn_surface

node.mfn_surfaceLecture seule

Function set de surface, ou None si indisponible.

Élément	Type / comportement
Retour	Optional[om.MFnNurbsSurface]
Type observé sur géométrie live	MFnNurbsSurface

mfn_surface_data

node.mfn_surface_dataLecture seule

Function set des données de sortie local, ou None si indisponibles.

Élément	Type / comportement
Retour	Optional[om.MFnNurbsSurfaceData]
Type observé sur géométrie live	MFnNurbsSurfaceData

u_degree

node.u_degreeLecture / écriture

Degré dans la direction U.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int
Valeur du setter	int

Le setter refuse une surface live (RuntimeError). La définition préparée peut renvoyer des valeurs différentes de l’annotation, notamment None ou des listes avant initialisation.

v_degree

node.v_degreeLecture / écriture

Degré dans la direction V.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int
Valeur du setter	int

Le setter refuse une surface live (RuntimeError). La définition préparée peut renvoyer des valeurs différentes de l’annotation, notamment None ou des listes avant initialisation.

u_spans

node.u_spansLecture / écriture

Nombre de spans dans la direction U.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int
Valeur du setter	int

Le setter refuse une surface live (RuntimeError). La définition préparée peut renvoyer des valeurs différentes de l’annotation, notamment None ou des listes avant initialisation.

v_spans

node.v_spansLecture / écriture

Nombre de spans dans la direction V.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int
Valeur du setter	int

Le setter refuse une surface live (RuntimeError). La définition préparée peut renvoyer des valeurs différentes de l’annotation, notamment None ou des listes avant initialisation.

u_knots

node.u_knotsLecture / écriture

Vecteur de knots U, lu sur la surface live ou dans la définition préparée.

Élément	Type / comportement
Retour	om.MDoubleArray
Type observé sur géométrie live	MDoubleArray
Valeur du setter	om.MDoubleArray

Sur un wrapper sans surface live, le setter appelle .length() sur le tableau. Avec le type annoncé om.MDoubleArray, cet appel lève AttributeError dans les deux versions vérifiées. Le setter refuse une surface live (RuntimeError). La définition préparée peut renvoyer des valeurs différentes de l’annotation, notamment None ou des listes avant initialisation.

v_knots

node.v_knotsLecture / écriture

Vecteur de knots V, lu sur la surface live ou dans la définition préparée.

Élément	Type / comportement
Retour	om.MDoubleArray
Type observé sur géométrie live	MDoubleArray
Valeur du setter	om.MDoubleArray

Sur un wrapper sans surface live, le setter appelle .length() sur le tableau. Avec le type annoncé om.MDoubleArray, cet appel lève AttributeError dans les deux versions vérifiées. Le setter refuse une surface live (RuntimeError). La définition préparée peut renvoyer des valeurs différentes de l’annotation, notamment None ou des listes avant initialisation.

u_form

node.u_formLecture / écriture

Forme native dans la direction U.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int
Valeur du setter	int

Le setter refuse une surface live (RuntimeError). La définition préparée peut renvoyer des valeurs différentes de l’annotation, notamment None ou des listes avant initialisation.

v_form

node.v_formLecture / écriture

Forme native dans la direction V.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int
Valeur du setter	int

Le setter refuse une surface live (RuntimeError). La définition préparée peut renvoyer des valeurs différentes de l’annotation, notamment None ou des listes avant initialisation.

is_uniform

node.is_uniformLecture / écriture

État uniforme de la surface.

Élément	Type / comportement
Retour	bool
Type observé sur géométrie live	bool
Valeur du setter	bool

Le setter refuse une surface live (RuntimeError). La définition préparée peut renvoyer des valeurs différentes de l’annotation, notamment None ou des listes avant initialisation.

is_rational

node.is_rationalLecture / écriture

État rationnel de la géométrie. Setter réservé à l’état sans géométrie live.

Élément	Type / comportement
Retour	bool
Type observé sur géométrie live	bool
Valeur du setter	bool

Le setter refuse une surface live (RuntimeError). La définition préparée peut renvoyer des valeurs différentes de l’annotation, notamment None ou des listes avant initialisation.

is_trimmed

node.is_trimmedLecture seule

Indique si la surface comporte un découpage (trim).

Élément	Type / comportement
Retour	bool
Type observé sur géométrie live	bool

num_regions

node.num_regionsLecture seule

Nombre de régions de trim ; zéro sans surface live.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int

boundary_per_region

node.boundary_per_regionLecture seule

Nombre de frontières de chaque région de trim ; liste vide sans surface live.

Élément	Type / comportement
Retour	List[int]
Type observé sur géométrie live	list

area

node.areaLecture seule

Aire de la géométrie ; voir le retour réel et les limites propres à cette classe.

Élément	Type / comportement
Retour	float
Type observé sur géométrie live	float

num_patches

node.num_patchesLecture seule

Nombre total de patches ; zéro sans surface live.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int

num_patches_u

node.num_patches_uLecture seule

Nombre de patches en U ; zéro sans surface live.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int

num_patches_v

node.num_patches_vLecture seule

Nombre de patches en V ; zéro sans surface live.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int

num_edges_u

node.num_edges_uLecture seule

Nombre de segments calculé à partir des spans en U et V.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int

num_edges_v

node.num_edges_vLecture seule

Nombre de segments calculé à partir des spans en U et V.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int

edges_indices_u

node.edges_indices_uLecture seule

Paires d’indices de grille calculées à partir des spans, selon U.

Élément	Type / comportement
Retour	List[Tuple[Tuple[int, int], Tuple[int, int]]]
Type observé sur géométrie live	list

edges_indices_v

node.edges_indices_vLecture seule

Paires d’indices de grille calculées à partir des spans, selon V.

Élément	Type / comportement
Retour	List[Tuple[Tuple[int, int], Tuple[int, int]]]
Type observé sur géométrie live	list

edges_points_u

node.edges_points_uLecture seule

Extrémités des segments précédents, lues avec get_cv_position().

Élément	Type / comportement
Retour	List[Tuple[om.MPoint, om.MPoint]]
Type observé sur géométrie live	list

edges_points_v

node.edges_points_vLecture seule

Extrémités des segments précédents, lues avec get_cv_position().

Élément	Type / comportement
Retour	List[Tuple[om.MPoint, om.MPoint]]
Type observé sur géométrie live	list

cv_list

node.cv_listLecture seule

Liste de couples (indices U/V, composant MObject) ; None sans surface live.

Élément	Type / comportement
Retour	Optional[List[Tuple[Tuple[int, int], om.MObject]]]
Type observé sur géométrie live	list

num_cvs_u

node.num_cvs_uLecture seule

Nombre de CVs U natifs ; sinon somme des spans et du degré préparés.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int

num_cvs_v

node.num_cvs_vLecture seule

Nombre de CVs V natifs ; sinon somme des spans et du degré préparés.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int

cvs

node.cvsLecture / écriture

Tableau des points de contrôle ; consulter les limites du setter ci-dessous.

Élément	Type / comportement
Retour	om.MPointArray
Type observé sur géométrie live	MPointArray
Valeur du setter	Optional[Union[om.MPointArray, List[om.MPoint], List[List[float]]]]

Le setter modifie la définition en mémoire et celle de shape_orig ; il ne met pas directement à jour les CVs natifs et peut échouer sans shape intermédiaire. Utiliser set_cv_positions() pour une édition live.

num_cvs

node.num_cvsLecture seule

Nombre total de CVs.

Élément	Type / comportement
Retour	int
Type observé sur géométrie live	int

Propriétés héritées de DAGNode20

Propriété	Type retourné	Accès	Description
dag_fn	om.MFnDagNode	L	Function set DAG live, ou objet non attaché si le nœud est absent ou invalide.
dag_path	om.MDagPath	L	Un chemin vers le nœud courant ; chemin vide si indisponible.
has_valid_dag_path	bool	L	Validité du chemin renvoyé par dag_path.
full_path_name	str	L	Chemin DAG complet ; chaîne vide si le chemin est invalide.
short_name	str	L	Chemin DAG partiel renvoyé par Maya, éventuellement plus long qu’un simple nom ; chaîne vide si invalide.
is_valid_dag_fn	bool	L	Validité du function set pour l’objet courant.
is_shape	bool	L	Compatibilité de l’objet courant avec om.MFn.kShape.
parents	list[DAGNode]	L	Tous les parents natifs.
parent	DAGNode | None	L/E	Premier parent uniquement ; None sous le world.
is_instanced	bool	L	Indique plusieurs chemins / parents pour l’objet DAG ; False si absent.
children	list[DAGNode]	L	Enfants directs, sans parcours récursif.
is_under_world	bool	L	Nœud live directement sous le world ; False si absent.
child_count	int	L	Nombre d’enfants directs du chemin ; 0 si invalide.
child_names	list[str]	L	Chemins complets des enfants directs ; liste vide si le chemin est invalide.
shape_count	int	L	Nombre de shapes directement sous ce chemin ; 0 si invalide.
shapes	list[DAGNode]	L	Shapes enfants directes, y compris les shapes intermédiaires ; liste vide si invalide.
shape_orig	DAGNode | None	L	Première shape enfant avec intermediateObject=True ; None si absente.
intermediate_shapes	list[DAGNode]	L	Toutes les shapes enfants directes marquées intermédiaires.
draw_override_info	om.MDAGDrawOverrideInfo | None	L	Informations natives d’override du chemin ; None si indisponibles.
fn_bounding_box	om.MBoundingBox | None	L	Bounding box locale obtenue par le function set ; None si indisponible.

Propriétés héritées de DGNode15

Propriété	Type retourné	Accès	Description
dep_fn	om.MFnDependencyNode	L	Function set live ; objet non attaché si le nœud est absent.
uuid	str | None	L	UUID live, ou dernière valeur mémorisée si elle reste disponible.
name	str | None	L/E	Nom live, sinon nom mémorisé.
absolute_name	str | None	L	Nom absolu de namespace renvoyé par MFnDependencyNode.absoluteName() ; None sans nœud.
stripped_name	str | None	L/E	Nom sans namespace, ou None si aucun nom.
namespace	str | None	L/E	Namespace normalisé comme a:b ; None à la racine.
plugs	Plugs | None	L	Gestionnaire des plugs du nœud live ; None sinon.
is_valid_dep_fn	bool	L	Compatibilité du function set avec le MObject courant.
is_default_node	bool	L	Indique un nœud par défaut de Maya ; False sans nœud.
is_from_referenced_file	bool	L	Indique un nœud issu d’un fichier référencé ; False sans nœud.
is_locked	bool	L/E	Verrouillage du nœud, distinct des locks de plugs.
is_shared	bool	L	État partagé renvoyé par Maya ; False sans nœud.
plugin_name	str | None	L	Nom du plugin Maya associé, éventuellement chaîne vide ; None sans nœud.
affect_animation	bool	L	Résultat de MFnDependencyNode.affectsAnimation() ; False sans nœud.
type	str | None	L/E	Type natif live ou type mémorisé.

Propriétés héritées de Node10

Propriété	Type retourné	Accès	Description
mobject	om.MObject	L/E	Objet Maya live, ou objet nul.
mobject_handle	om.MObjectHandle	L/E	Handle associé au nœud.
api_type	int | None	L	Identifiant du type API Maya.
api_type_str	str	L	Nom du type API, par exemple "kTime".
exists	bool	L	Le wrapper possède actuellement un nœud live.
is_null	bool	L	L’objet Maya retourné est nul.
is_alive	bool	L	L’objet existe avec un handle valide et vivant.
is_valid_handle	bool	L	Validité du handle mémorisé.
is_dag_node	bool	L	Compatibilité avec om.MFn.kDagNode.
hash_code	int	L	Hash du handle Maya.

Propriétés issues des specs

Les defaults et flags ci-dessous sont les déclarations des specs, pas une garantie de valeur live. Un descriptor peut renvoyer un proxy : .value lit sa valeur ; .plug donne accès au Plug. Les noms des proxies décrivent le résultat, sans demander d’importer des classes privées. Les types observés proviennent d’un cas de contrôle ; une entrée géométrique non connectée peut notamment valoir None.

Pour une écriture dont il faut vérifier l’échec, utiliser explicitement le Plug et contrôler le résultat live. Les setters de descriptors ne propagent pas tous les échecs natifs.

Propriété	Plug Maya	Retour
tweak	tweak	_ValuePlugProxy · .value: bool
in_place	inPlace	_ValuePlugProxy · .value: bool
disp_cv	dispCV	_ValuePlugProxy · .value: bool
disp_ep	dispEP	_ValuePlugProxy · .value: bool
disp_geometry	dispGeometry	_ValuePlugProxy · .value: bool
disp_hull	dispHull	_ValuePlugProxy · .value: bool
disp_origin	dispOrigin	_ValuePlugProxy · .value: bool
sel_cv_disp	selCVDisp	_ValuePlugProxy · .value: bool
disp_sf	dispSF	_ValuePlugProxy · .value: bool
display_render_tessellation	displayRenderTessellation	_ValuePlugProxy · .value: bool
normals_display_scale	normalsDisplayScale	_ValuePlugProxy · .value: float
curve_precision	curvePrecision	_ValuePlugProxy · .value: int
curve_precision_shaded	curvePrecisionShaded	_ValuePlugProxy · .value: int
divisions_u	divisionsU	_ValuePlugProxy · .value: int
divisions_v	divisionsV	_ValuePlugProxy · .value: int
simplify_mode	simplifyMode	_ValuePlugProxy · .value: int
simplify_u	simplifyU	_ValuePlugProxy · .value: int
simplify_v	simplifyV	_ValuePlugProxy · .value: int
cached	cached	_ValuePlugProxy · .value: SurfaceProxy
curvature_tolerance	curvatureTolerance	_ValuePlugProxy · .value: int
degree_uv	degreeUV	_ValuePlugProxy · .value: tuple
degree_u	degreeUV.degreeU	_ValuePlugProxy · .value: int
degree_v	degreeUV.degreeV	_ValuePlugProxy · .value: int
smooth_edge_ratio	smoothEdgeRatio	_ValuePlugProxy · .value: float
form_u	formU	_ValuePlugProxy · .value: int
form_v	formV	_ValuePlugProxy · .value: int
header	header	MObject
create_spec	create	_ValuePlugProxy · .value: None
local	local	_ValuePlugProxy · .value: SurfaceProxy
min_max_range_u	minMaxRangeU	_ValuePlugProxy · .value: tuple
min_value_u	minMaxRangeU.minValueU	_ValuePlugProxy · .value: float
max_value_u	minMaxRangeU.maxValueU	_ValuePlugProxy · .value: float
min_max_range_v	minMaxRangeV	_ValuePlugProxy · .value: tuple
min_value_v	minMaxRangeV.minValueV	_ValuePlugProxy · .value: float
max_value_v	minMaxRangeV.maxValueV	_ValuePlugProxy · .value: float
spans_uv	spansUV	_ValuePlugProxy · .value: tuple
spans_u	spansUV.spansU	_ValuePlugProxy · .value: int
spans_v	spansUV.spansV	_ValuePlugProxy · .value: int
trim_face	trimFace	list
tweak_size_u	tweakSizeU	_ValuePlugProxy · .value: int
tweak_size_v	tweakSizeV	_ValuePlugProxy · .value: int
world_space	worldSpace	TypedArrayProxy
fix_texture_warp	fixTextureWarp	_ValuePlugProxy · .value: bool
render_triangle_count	renderTriangleCount	_ValuePlugProxy · .value: int
patch_uv_ids	patchUVIds	list
explicit_tessellation_attributes	explicitTessellationAttributes	_ValuePlugProxy · .value: bool
basic_tessellation_type	basicTessellationType	_ValuePlugProxy · .value: int
chord_height	chordHeight	_ValuePlugProxy · .value: float
obj_space_chord_height	objSpaceChordHeight	_ValuePlugProxy · .value: bool
chord_height_ratio	chordHeightRatio	_ValuePlugProxy · .value: float
edge_swap	edgeSwap	_ValuePlugProxy · .value: bool
grid_division_per_span_u	gridDivisionPerSpanU	_ValuePlugProxy · .value: int
grid_division_per_span_v	gridDivisionPerSpanV	_ValuePlugProxy · .value: int
min_screen	minScreen	_ValuePlugProxy · .value: float
mode_u	modeU	_ValuePlugProxy · .value: int
mode_v	modeV	_ValuePlugProxy · .value: int
number_u	numberU	_ValuePlugProxy · .value: int
number_v	numberV	_ValuePlugProxy · .value: int
u_divisions_factor	uDivisionsFactor	_ValuePlugProxy · .value: float
v_divisions_factor	vDivisionsFactor	_ValuePlugProxy · .value: float
use_chord_height	useChordHeight	_ValuePlugProxy · .value: bool
use_chord_height_ratio	useChordHeightRatio	_ValuePlugProxy · .value: bool
smooth_edge	smoothEdge	_ValuePlugProxy · .value: bool
use_min_screen	useMinScreen	_ValuePlugProxy · .value: bool

tweak

node.tweakSpec native

Accès au plug natif tweak.

Élément	Type / comportement
Chemin Maya	tweak
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	True
Flags	input, output, connectable, stored
Lecture	node.tweak.value
Affectation du descriptor	node.tweak = value

in_place

node.in_placeSpec native

Accès au plug natif inPlace.

Élément	Type / comportement
Chemin Maya	inPlace
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.in_place.value
Affectation du descriptor	node.in_place = value

disp_cv

node.disp_cvSpec native

Accès au plug natif dispCV.

Élément	Type / comportement
Chemin Maya	dispCV
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.disp_cv.value
Affectation du descriptor	node.disp_cv = value

disp_ep

node.disp_epSpec native

Accès au plug natif dispEP.

Élément	Type / comportement
Chemin Maya	dispEP
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.disp_ep.value
Affectation du descriptor	node.disp_ep = value

disp_geometry

node.disp_geometrySpec native

Accès au plug natif dispGeometry.

Élément	Type / comportement
Chemin Maya	dispGeometry
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	True
Flags	input, output, connectable, stored
Lecture	node.disp_geometry.value
Affectation du descriptor	node.disp_geometry = value

disp_hull

node.disp_hullSpec native

Accès au plug natif dispHull.

Élément	Type / comportement
Chemin Maya	dispHull
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.disp_hull.value
Affectation du descriptor	node.disp_hull = value

disp_origin

node.disp_originSpec native

Accès au plug natif dispOrigin.

Élément	Type / comportement
Chemin Maya	dispOrigin
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.disp_origin.value
Affectation du descriptor	node.disp_origin = value

sel_cv_disp

node.sel_cv_dispSpec native

Accès au plug natif selCVDisp.

Élément	Type / comportement
Chemin Maya	selCVDisp
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.sel_cv_disp.value
Affectation du descriptor	node.sel_cv_disp = value

disp_sf

node.disp_sfSpec native

Accès au plug natif dispSF.

Élément	Type / comportement
Chemin Maya	dispSF
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.disp_sf.value
Affectation du descriptor	node.disp_sf = value

display_render_tessellation

node.display_render_tessellationSpec native

Accès au plug natif displayRenderTessellation.

Élément	Type / comportement
Chemin Maya	displayRenderTessellation
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.display_render_tessellation.value
Affectation du descriptor	node.display_render_tessellation = value

normals_display_scale

node.normals_display_scaleSpec native

Accès au plug natif normalsDisplayScale.

Élément	Type / comportement
Chemin Maya	normalsDisplayScale
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	1.0
Flags	input, output, connectable, stored
Lecture	node.normals_display_scale.value
Affectation du descriptor	node.normals_display_scale = value

curve_precision

node.curve_precisionSpec native

Accès au plug natif curvePrecision.

Élément	Type / comportement
Chemin Maya	curvePrecision
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:byte
Défaut déclaré	4
Flags	input, output, connectable, stored
Lecture	node.curve_precision.value
Affectation du descriptor	node.curve_precision = value

curve_precision_shaded

node.curve_precision_shadedSpec native

Accès au plug natif curvePrecisionShaded.

Élément	Type / comportement
Chemin Maya	curvePrecisionShaded
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:byte
Défaut déclaré	4
Flags	input, output, connectable, stored
Lecture	node.curve_precision_shaded.value
Affectation du descriptor	node.curve_precision_shaded = value

divisions_u

node.divisions_uSpec native

Accès au plug natif divisionsU.

Élément	Type / comportement
Chemin Maya	divisionsU
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:byte
Défaut déclaré	0
Flags	input, output, connectable, stored
Lecture	node.divisions_u.value
Affectation du descriptor	node.divisions_u = value

divisions_v

node.divisions_vSpec native

Accès au plug natif divisionsV.

Élément	Type / comportement
Chemin Maya	divisionsV
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:byte
Défaut déclaré	0
Flags	input, output, connectable, stored
Lecture	node.divisions_v.value
Affectation du descriptor	node.divisions_v = value

simplify_mode

node.simplify_modeSpec native

Accès au plug natif simplifyMode.

Élément	Type / comportement
Chemin Maya	simplifyMode
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:byte
Défaut déclaré	0
Flags	input, output, connectable, stored
Lecture	node.simplify_mode.value
Affectation du descriptor	node.simplify_mode = value

simplify_u

node.simplify_uSpec native

Accès au plug natif simplifyU.

Élément	Type / comportement
Chemin Maya	simplifyU
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:byte
Défaut déclaré	0
Flags	input, output, connectable, stored
Lecture	node.simplify_u.value
Affectation du descriptor	node.simplify_u = value

simplify_v

node.simplify_vSpec native

Accès au plug natif simplifyV.

Élément	Type / comportement
Chemin Maya	simplifyV
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:byte
Défaut déclaré	0
Flags	input, output, connectable, stored
Lecture	node.simplify_v.value
Affectation du descriptor	node.simplify_v = value

cached

node.cachedSpec native

Accès au plug natif cached.

Élément	Type / comportement
Chemin Maya	cached
Retour de la propriété	_ValuePlugProxy · .value: SurfaceProxy
Type déclaré	typed:nurbsSurface
Défaut déclaré	None
Flags	input, output, connectable
Lecture	node.cached.value

curvature_tolerance

node.curvature_toleranceSpec native

Accès au plug natif curvatureTolerance.

Élément	Type / comportement
Chemin Maya	curvatureTolerance
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	enum
Défaut déclaré	2
Flags	input, output, connectable, stored
Lecture	node.curvature_tolerance.value
Affectation du descriptor	node.curvature_tolerance = value

degree_uv

node.degree_uvSpec native

Accès au plug natif degreeUV.

Élément	Type / comportement
Chemin Maya	degreeUV
Retour de la propriété	_ValuePlugProxy · .value: tuple
Type déclaré	short2
Défaut déclaré	(0, 0)
Flags	output, connectable
Lecture	node.degree_uv.value

degree_u

node.degree_uSpec native

Accès au plug natif degreeUV.degreeU.

Élément	Type / comportement
Chemin Maya	degreeUV.degreeU
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:short
Défaut déclaré	0
Flags	output, connectable
Lecture	node.degree_u.value

degree_v

node.degree_vSpec native

Accès au plug natif degreeUV.degreeV.

Élément	Type / comportement
Chemin Maya	degreeUV.degreeV
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:short
Défaut déclaré	0
Flags	output, connectable
Lecture	node.degree_v.value

smooth_edge_ratio

node.smooth_edge_ratioSpec native

Accès au plug natif smoothEdgeRatio.

Élément	Type / comportement
Chemin Maya	smoothEdgeRatio
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	0.99
Flags	input, output, connectable, stored
Lecture	node.smooth_edge_ratio.value
Affectation du descriptor	node.smooth_edge_ratio = value

form_u

node.form_uSpec native

Accès au plug natif formU.

Élément	Type / comportement
Chemin Maya	formU
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	enum
Défaut déclaré	0
Flags	output, connectable
Lecture	node.form_u.value

form_v

node.form_vSpec native

Accès au plug natif formV.

Élément	Type / comportement
Chemin Maya	formV
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	enum
Défaut déclaré	0
Flags	output, connectable
Lecture	node.form_v.value

header

node.headerSpec native

Accès au plug natif header.

Élément	Type / comportement
Chemin Maya	header
Retour de la propriété	MObject
Type déclaré	typed:nurbsSurfaceHeader
Défaut déclaré	None
Flags	input, output

Le setter du descriptor refuse l’affectation ; utiliser les opérations de connexion du Plug.

create_spec

node.create_specSpec native

Accès au plug natif create.

Élément	Type / comportement
Chemin Maya	create
Retour de la propriété	_ValuePlugProxy · .value: None
Type déclaré	typed:nurbsSurface
Défaut déclaré	None
Flags	input, output, connectable
Lecture	node.create_spec.value

local

node.localSpec native

Accès au plug natif local.

Élément	Type / comportement
Chemin Maya	local
Retour de la propriété	_ValuePlugProxy · .value: SurfaceProxy
Type déclaré	typed:nurbsSurface
Défaut déclaré	None
Flags	output, connectable
Lecture	node.local.value

min_max_range_u

node.min_max_range_uSpec native

Accès au plug natif minMaxRangeU.

Élément	Type / comportement
Chemin Maya	minMaxRangeU
Retour de la propriété	_ValuePlugProxy · .value: tuple
Type déclaré	double2
Défaut déclaré	(0.0, 0.0)
Flags	output, connectable
Lecture	node.min_max_range_u.value

min_value_u

node.min_value_uSpec native

Accès au plug natif minMaxRangeU.minValueU.

Élément	Type / comportement
Chemin Maya	minMaxRangeU.minValueU
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	0.0
Flags	output, connectable
Lecture	node.min_value_u.value

max_value_u

node.max_value_uSpec native

Accès au plug natif minMaxRangeU.maxValueU.

Élément	Type / comportement
Chemin Maya	minMaxRangeU.maxValueU
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	0.0
Flags	output, connectable
Lecture	node.max_value_u.value

min_max_range_v

node.min_max_range_vSpec native

Accès au plug natif minMaxRangeV.

Élément	Type / comportement
Chemin Maya	minMaxRangeV
Retour de la propriété	_ValuePlugProxy · .value: tuple
Type déclaré	double2
Défaut déclaré	(0.0, 0.0)
Flags	output, connectable
Lecture	node.min_max_range_v.value

min_value_v

node.min_value_vSpec native

Accès au plug natif minMaxRangeV.minValueV.

Élément	Type / comportement
Chemin Maya	minMaxRangeV.minValueV
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	0.0
Flags	output, connectable
Lecture	node.min_value_v.value

max_value_v

node.max_value_vSpec native

Accès au plug natif minMaxRangeV.maxValueV.

Élément	Type / comportement
Chemin Maya	minMaxRangeV.maxValueV
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	0.0
Flags	output, connectable
Lecture	node.max_value_v.value

spans_uv

node.spans_uvSpec native

Accès au plug natif spansUV.

Élément	Type / comportement
Chemin Maya	spansUV
Retour de la propriété	_ValuePlugProxy · .value: tuple
Type déclaré	long2
Défaut déclaré	(0, 0)
Flags	output, connectable
Lecture	node.spans_uv.value

spans_u

node.spans_uSpec native

Accès au plug natif spansUV.spansU.

Élément	Type / comportement
Chemin Maya	spansUV.spansU
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:int
Défaut déclaré	0
Flags	output, connectable
Lecture	node.spans_u.value

spans_v

node.spans_vSpec native

Accès au plug natif spansUV.spansV.

Élément	Type / comportement
Chemin Maya	spansUV.spansV
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:int
Défaut déclaré	0
Flags	output, connectable
Lecture	node.spans_v.value

trim_face

node.trim_faceSpec native

Accès au plug natif trimFace.

Élément	Type / comportement
Chemin Maya	trimFace
Retour de la propriété	list
Type déclaré	array:typed:nurbstrimface
Défaut déclaré	()
Flags	array, input, output, stored

tweak_size_u

node.tweak_size_uSpec native

Accès au plug natif tweakSizeU.

Élément	Type / comportement
Chemin Maya	tweakSizeU
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:int
Défaut déclaré	-1
Flags	input, output, connectable
Lecture	node.tweak_size_u.value

tweak_size_v

node.tweak_size_vSpec native

Accès au plug natif tweakSizeV.

Élément	Type / comportement
Chemin Maya	tweakSizeV
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:int
Défaut déclaré	-1
Flags	input, output, connectable
Lecture	node.tweak_size_v.value

world_space

node.world_spaceSpec native

Accès au plug natif worldSpace.

Élément	Type / comportement
Chemin Maya	worldSpace
Retour de la propriété	TypedArrayProxy
Type déclaré	array:typed:nurbsSurface
Défaut déclaré	()
Flags	array, output, connectable
Plug sous-jacent	node.world_space.plug

fix_texture_warp

node.fix_texture_warpSpec native

Accès au plug natif fixTextureWarp.

Élément	Type / comportement
Chemin Maya	fixTextureWarp
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.fix_texture_warp.value
Affectation du descriptor	node.fix_texture_warp = value

render_triangle_count

node.render_triangle_countSpec native

Accès au plug natif renderTriangleCount.

Élément	Type / comportement
Chemin Maya	renderTriangleCount
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:int
Défaut déclaré	0
Flags	output, connectable
Lecture	node.render_triangle_count.value

patch_uv_ids

node.patch_uv_idsSpec native

Accès au plug natif patchUVIds.

Élément	Type / comportement
Chemin Maya	patchUVIds
Retour de la propriété	list
Type déclaré	array:typed:nurbspatchuvids
Défaut déclaré	()
Flags	array, input, output, connectable, stored, hidden

explicit_tessellation_attributes

node.explicit_tessellation_attributesSpec native

Accès au plug natif explicitTessellationAttributes.

Élément	Type / comportement
Chemin Maya	explicitTessellationAttributes
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.explicit_tessellation_attributes.value
Affectation du descriptor	node.explicit_tessellation_attributes = value

basic_tessellation_type

node.basic_tessellation_typeSpec native

Accès au plug natif basicTessellationType.

Élément	Type / comportement
Chemin Maya	basicTessellationType
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	enum
Défaut déclaré	0
Flags	input, output, connectable, stored, hidden
Lecture	node.basic_tessellation_type.value
Affectation du descriptor	node.basic_tessellation_type = value

chord_height

node.chord_heightSpec native

Accès au plug natif chordHeight.

Élément	Type / comportement
Chemin Maya	chordHeight
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	0.1
Flags	input, output, connectable, stored
Lecture	node.chord_height.value
Affectation du descriptor	node.chord_height = value

obj_space_chord_height

node.obj_space_chord_heightSpec native

Accès au plug natif objSpaceChordHeight.

Élément	Type / comportement
Chemin Maya	objSpaceChordHeight
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	True
Flags	input, output, connectable, stored, hidden
Lecture	node.obj_space_chord_height.value
Affectation du descriptor	node.obj_space_chord_height = value

chord_height_ratio

node.chord_height_ratioSpec native

Accès au plug natif chordHeightRatio.

Élément	Type / comportement
Chemin Maya	chordHeightRatio
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	0.983
Flags	input, output, connectable, stored
Lecture	node.chord_height_ratio.value
Affectation du descriptor	node.chord_height_ratio = value

edge_swap

node.edge_swapSpec native

Accès au plug natif edgeSwap.

Élément	Type / comportement
Chemin Maya	edgeSwap
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.edge_swap.value
Affectation du descriptor	node.edge_swap = value

grid_division_per_span_u

node.grid_division_per_span_uSpec native

Accès au plug natif gridDivisionPerSpanU.

Élément	Type / comportement
Chemin Maya	gridDivisionPerSpanU
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:short
Défaut déclaré	4
Flags	input, output, connectable, stored
Lecture	node.grid_division_per_span_u.value
Affectation du descriptor	node.grid_division_per_span_u = value

grid_division_per_span_v

node.grid_division_per_span_vSpec native

Accès au plug natif gridDivisionPerSpanV.

Élément	Type / comportement
Chemin Maya	gridDivisionPerSpanV
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:short
Défaut déclaré	4
Flags	input, output, connectable, stored
Lecture	node.grid_division_per_span_v.value
Affectation du descriptor	node.grid_division_per_span_v = value

min_screen

node.min_screenSpec native

Accès au plug natif minScreen.

Élément	Type / comportement
Chemin Maya	minScreen
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	14.0
Flags	input, output, connectable, stored
Lecture	node.min_screen.value
Affectation du descriptor	node.min_screen = value

mode_u

node.mode_uSpec native

Accès au plug natif modeU.

Élément	Type / comportement
Chemin Maya	modeU
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	enum
Défaut déclaré	3
Flags	input, output, connectable, stored
Lecture	node.mode_u.value
Affectation du descriptor	node.mode_u = value

mode_v

node.mode_vSpec native

Accès au plug natif modeV.

Élément	Type / comportement
Chemin Maya	modeV
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	enum
Défaut déclaré	3
Flags	input, output, connectable, stored
Lecture	node.mode_v.value
Affectation du descriptor	node.mode_v = value

number_u

node.number_uSpec native

Accès au plug natif numberU.

Élément	Type / comportement
Chemin Maya	numberU
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:int
Défaut déclaré	3
Flags	input, output, connectable, stored
Lecture	node.number_u.value
Affectation du descriptor	node.number_u = value

number_v

node.number_vSpec native

Accès au plug natif numberV.

Élément	Type / comportement
Chemin Maya	numberV
Retour de la propriété	_ValuePlugProxy · .value: int
Type déclaré	numeric:int
Défaut déclaré	3
Flags	input, output, connectable, stored
Lecture	node.number_v.value
Affectation du descriptor	node.number_v = value

u_divisions_factor

node.u_divisions_factorSpec native

Accès au plug natif uDivisionsFactor.

Élément	Type / comportement
Chemin Maya	uDivisionsFactor
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	4.5
Flags	input, output, connectable, stored
Lecture	node.u_divisions_factor.value
Affectation du descriptor	node.u_divisions_factor = value

v_divisions_factor

node.v_divisions_factorSpec native

Accès au plug natif vDivisionsFactor.

Élément	Type / comportement
Chemin Maya	vDivisionsFactor
Retour de la propriété	_ValuePlugProxy · .value: float
Type déclaré	numeric:double
Défaut déclaré	4.5
Flags	input, output, connectable, stored
Lecture	node.v_divisions_factor.value
Affectation du descriptor	node.v_divisions_factor = value

use_chord_height

node.use_chord_heightSpec native

Accès au plug natif useChordHeight.

Élément	Type / comportement
Chemin Maya	useChordHeight
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.use_chord_height.value
Affectation du descriptor	node.use_chord_height = value

use_chord_height_ratio

node.use_chord_height_ratioSpec native

Accès au plug natif useChordHeightRatio.

Élément	Type / comportement
Chemin Maya	useChordHeightRatio
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	True
Flags	input, output, connectable, stored
Lecture	node.use_chord_height_ratio.value
Affectation du descriptor	node.use_chord_height_ratio = value

smooth_edge

node.smooth_edgeSpec native

Accès au plug natif smoothEdge.

Élément	Type / comportement
Chemin Maya	smoothEdge
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.smooth_edge.value
Affectation du descriptor	node.smooth_edge = value

use_min_screen

node.use_min_screenSpec native

Accès au plug natif useMinScreen.

Élément	Type / comportement
Chemin Maya	useMinScreen
Retour de la propriété	_ValuePlugProxy · .value: bool
Type déclaré	numeric:bool
Défaut déclaré	False
Flags	input, output, connectable, stored
Lecture	node.use_min_screen.value
Affectation du descriptor	node.use_min_screen = value

Specs héritées de SurfaceShape27

Propriété	Plug Maya	Retour	Description
bounding_box_scale	boundingBoxScale	_ValuePlugProxy · .value: tuple[float, float, float]	Échelle native de la bounding box de surface.
bounding_box_scale_x	boundingBoxScale.boundingBoxScaleX	_ValuePlugProxy · .value: float	Composante X de bounding_box_scale.
bounding_box_scale_y	boundingBoxScale.boundingBoxScaleY	_ValuePlugProxy · .value: float	Composante Y de bounding_box_scale.
bounding_box_scale_z	boundingBoxScale.boundingBoxScaleZ	_ValuePlugProxy · .value: float	Composante Z de bounding_box_scale.
display_hw_environment	displayHWEnvironment	_ValuePlugProxy · .value: bool	Affichage de l’environnement matériel.
hold_out	holdOut	_ValuePlugProxy · .value: bool	Option native de holdout.
smooth_shading	smoothShading	_ValuePlugProxy · .value: bool	Activation du smooth shading.
feature_displacement	featureDisplacement	_ValuePlugProxy · .value: bool	Option native de feature displacement.
texture_treshold	textureTreshold	_ValuePlugProxy · .value: int	Seuil natif textureTreshold ; orthographe de l’API conservée.
ignore_hw_shader	ignoreHwShader	_ValuePlugProxy · .value: bool	Option pour ignorer le shader matériel.
normal_treshold	normalTreshold	_ValuePlugProxy · .value: float	Seuil natif normalTreshold ; orthographe de l’API conservée.
double_sided	doubleSided	_ValuePlugProxy · .value: bool	Option d’affichage / rendu double face.
opposite	opposite	_ValuePlugProxy · .value: bool	Inversion de l’orientation utilisée par la shape.
initial_sample_rate	initialSampleRate	_ValuePlugProxy · .value: int	Taux initial d’échantillonnage de la surface.
extra_sample_rate	extraSampleRate	_ValuePlugProxy · .value: int	Taux supplémentaire d’échantillonnage.
collision_depth_velocity_increment	collisionDepthVelocityIncrement	ArrayCompoundProxy	Rampe native d’incrément de vitesse selon la profondeur de collision.
collision_depth_velocity_increment_position	collisionDepthVelocityIncrement[].collisionDepthVelocityIncrement_Position	IndexedPathProxy	Position d’un point de la rampe collision_depth_velocity_increment.
collision_depth_velocity_increment_float_value	collisionDepthVelocityIncrement[].collisionDepthVelocityIncrement_FloatValue	IndexedPathProxy	Valeur d’un point de la rampe collision_depth_velocity_increment.
collision_depth_velocity_increment_interp	collisionDepthVelocityIncrement[].collisionDepthVelocityIncrement_Interp	IndexedPathProxy	Interpolation d’un point de la rampe collision_depth_velocity_increment.
collision_depth_velocity_multiplier	collisionDepthVelocityMultiplier	ArrayCompoundProxy	Rampe native de multiplicateur de vitesse selon la profondeur de collision.
collision_depth_velocity_multiplier_position	collisionDepthVelocityMultiplier[].collisionDepthVelocityMultiplier_Position	IndexedPathProxy	Position d’un point de la rampe collision_depth_velocity_multiplier.
collision_depth_velocity_multiplier_float_value	collisionDepthVelocityMultiplier[].collisionDepthVelocityMultiplier_FloatValue	IndexedPathProxy	Valeur d’un point de la rampe collision_depth_velocity_multiplier.
collision_depth_velocity_multiplier_interp	collisionDepthVelocityMultiplier[].collisionDepthVelocityMultiplier_Interp	IndexedPathProxy	Interpolation d’un point de la rampe collision_depth_velocity_multiplier.
collision_offset_velocity_multiplier	collisionOffsetVelocityMultiplier	ArrayCompoundProxy	Rampe native de multiplicateur de vitesse selon l’offset de collision.
collision_offset_velocity_multiplier_position	collisionOffsetVelocityMultiplier[].collisionOffsetVelocityMultiplier_Position	IndexedPathProxy	Position d’un point de la rampe collision_offset_velocity_multiplier.
collision_offset_velocity_multiplier_float_value	collisionOffsetVelocityMultiplier[].collisionOffsetVelocityMultiplier_FloatValue	IndexedPathProxy	Valeur d’un point de la rampe collision_offset_velocity_multiplier.
collision_offset_velocity_multiplier_interp	collisionOffsetVelocityMultiplier[].collisionOffsetVelocityMultiplier_Interp	IndexedPathProxy	Interpolation d’un point de la rampe collision_offset_velocity_multiplier.

Specs héritées de ControlPoint31

Propriété	Plug Maya	Retour	Description
blind_data_nodes	blindDataNodes	list[str]	Données de liens vers les nœuds de blind data.
color_set	colorSet	ArrayCompoundProxy	Tableau des color sets.
current_color_set	currentColorSet	_ValuePlugProxy · .value: str	Nom du color set courant.
color_name	colorSet[].colorName	IndexedPathProxy	Nom du color set indexé.
clamped	colorSet[].clamped	IndexedPathProxy	État clamped du color set.
representation	colorSet[].representation	IndexedPathProxy	Mode de représentation des couleurs.
color_set_points	colorSet[].colorSetPoints	AttributeError (accès direct)	Couleurs sous un color set indexé.
color_set_points_r	colorSet[].colorSetPoints[].colorSetPointsR	IndexedPathProxy	Composante R de color_set_points.
color_set_points_g	colorSet[].colorSetPoints[].colorSetPointsG	IndexedPathProxy	Composante G de color_set_points.
color_set_points_b	colorSet[].colorSetPoints[].colorSetPointsB	IndexedPathProxy	Composante B de color_set_points.
color_set_points_a	colorSet[].colorSetPoints[].colorSetPointsA	IndexedPathProxy	Composante A de color_set_points.
control_points	controlPoints	ArrayCompoundProxy	Tableau natif des control points / tweaks ; ce n’est pas une lecture universelle des positions finales.
control_points_x_value	controlPoints[].xValue	IndexedPathProxy	Composante X du control point indexé.
control_points_y_value	controlPoints[].yValue	IndexedPathProxy	Composante Y du control point indexé.
control_points_z_value	controlPoints[].zValue	IndexedPathProxy	Composante Z du control point indexé.
relative_tweak	relativeTweak	_ValuePlugProxy · .value: bool	Mode de tweak relatif.
tweak_location	tweakLocation	Any (donnée native)	Données natives de localisation des tweaks.
display_immediate	displayImmediate	_ValuePlugProxy · .value: bool	Option native d’affichage immédiat.
display_color_channel	displayColorChannel	_ValuePlugProxy · .value: str	Canal de couleur affiché.
display_colors	displayColors	_ValuePlugProxy · .value: bool	Activation de l’affichage des couleurs de composants.
current_uv_set	currentUVSet	_ValuePlugProxy · .value: str	Nom du UV set courant.
uv_set	uvSet	ArrayCompoundProxy	Tableau des UV sets.
uv_set_name	uvSet[].uvSetName	IndexedPathProxy	Nom du UV set indexé.
uv_set_points	uvSet[].uvSetPoints	_DynNumericArrayProxy	Paires UV du UV set ; accès via son élément parent pour choisir le set.
uv_set_points_u	uvSet[].uvSetPoints[].uvSetPointsU	IndexedPathProxy	Coordonnée U à deux indices logiques.
uv_set_points_v	uvSet[].uvSetPoints[].uvSetPointsV	IndexedPathProxy	Coordonnée V à deux indices logiques.
uv_set_tweak_location	uvSet[].uvSetTweakLocation	IndexedPathProxy	Données de localisation des tweaks du UV set.
uv_pivot	uvPivot	_ValuePlugProxy · .value: tuple[float, float]	Pivot UV à deux composantes.
uv_pivot_x	uvPivot.uvPivotX	_ValuePlugProxy · .value: float	Première composante du pivot UV.
uv_pivot_y	uvPivot.uvPivotY	_ValuePlugProxy · .value: float	Deuxième composante du pivot UV.
weights	weights	TypedArrayProxy	Poids natifs des control points ; distincts des poids d’influences d’un skinCluster.

Specs héritées de GeometryShape32

Propriété	Plug Maya	Retour	Description
as_background	asBackground	_ValuePlugProxy · .value: bool	Option native d’utilisation en arrière-plan.
depth_jitter	depthJitter	_ValuePlugProxy · .value: bool	Option native de depth jitter.
primary_visiblity	primaryVisibility	_ValuePlugProxy · .value: bool	Visibilité primaire au rendu.
antialiasing_level	antialiasingLevel	_ValuePlugProxy · .value: int	Niveau d’antialiasing de la géométrie.
geometry_antialiasing_override	geometryAntialiasingOverride	_ValuePlugProxy · .value: bool	Activation de l’override d’antialiasing.
component_tags	componentTags	ArrayCompoundProxy	Tableau des tags de composants.
component_tag_name	componentTags[].componentTagName	IndexedPathProxy	Nom du tag à l’indice demandé.
component_tag_contents	componentTags[].componentTagContents	IndexedPathProxy	Contenu du tag de composants.
casts_shadows	castsShadows	_ValuePlugProxy · .value: bool	Participation à la projection d’ombres.
hardware_fog_multiplier	hardwareFogMultiplier	_ValuePlugProxy · .value: float	Multiplicateur de brouillard matériel.
ignore_self_shadowing	ignoreSelfShadowing	_ValuePlugProxy · .value: bool	Option pour ignorer l’auto-ombrage.
max_shading_samples	maxShadingSamples	_ValuePlugProxy · .value: int	Nombre maximal d’échantillons de shading.
receive_shadows	receiveShadows	_ValuePlugProxy · .value: bool	Réception des ombres.
shading_samples	shadingSamples	_ValuePlugProxy · .value: int	Nombre d’échantillons de shading.
shading_samples_override	shadingSamplesOverride	_ValuePlugProxy · .value: bool	Activation de l’override des échantillons de shading.
inst_material_assign	instMaterialAssign	list[str]	Données d’affectation de matériau par instance.
pick_texture	pickTexture	None	Connexion native de sélection de texture.
comp_inst_obj_groups	compInstObjGroups	ArrayCompoundProxy	Groupes de composants par instance.
comp_object_groups	compInstObjGroups[].objectGroups	AttributeError (accès direct)	Groupes sous une instance de composants.
comp_object_grp_comp_list	compInstObjGroups[].objectGroups[].objectGrpCompList	IndexedPathProxy	Liste de composants du groupe indexé.
comp_object_group_id	compInstObjGroups[].objectGroups[].objectGroupId	IndexedPathProxy	Identifiant du groupe de composants indexé.
reference_object	referenceObject	None	Connexion à l’objet de référence de la shape.
max_visibility_samples	maxVisibilitySamples	_ValuePlugProxy · .value: int	Nombre maximal d’échantillons de visibilité.
max_visibility_samples_override	maxVisibilitySamplesOverride	_ValuePlugProxy · .value: bool	Activation de l’override des échantillons de visibilité.
render_type	renderType	_ValuePlugProxy · .value: int	Type de rendu natif de la shape.
render_volume	renderVolume	_ValuePlugProxy · .value: bool	Option native de rendu volumique.
visible_fraction	visibleFraction	_ValuePlugProxy · .value: float	Fraction visible native.
visible_in_reflections	visibleInReflections	_ValuePlugProxy · .value: bool	Visibilité dans les réflexions.
visible_in_refractions	visibleInRefractions	_ValuePlugProxy · .value: bool	Visibilité dans les réfractions.
volume_samples	volumeSamples	_ValuePlugProxy · .value: int	Nombre d’échantillons de volume.
volume_samples_override	volumeSamplesOverride	_ValuePlugProxy · .value: bool	Activation de l’override des échantillons de volume.
motion_blur	motionBlur	_ValuePlugProxy · .value: bool	Participation au motion blur.

Specs héritées de DAGNode93

Propriété	Plug Maya	Retour	Description
use_object_color	useObjectColor	_ValuePlugProxy · .value: int	Mode d’utilisation de la couleur de l’objet.
visibility	visibility	_ValuePlugProxy · .value: bool	Visibilité locale du nœud ; elle ne résume pas la visibilité de toute sa hiérarchie.
template	template	_ValuePlugProxy · .value: bool	Affichage de l’objet en mode template.
lod_visibility	lodVisibility	_ValuePlugProxy · .value: bool	Visibilité associée au niveau de détail.
object_color	objectColor	_ValuePlugProxy · .value: int	Indice de couleur de l’objet.
object_color_rgb	objectColorRGB	_ValuePlugProxy · .value: tuple[float, float, float]	Couleur RGB de l’objet.
object_color_r	objectColorR	_ValuePlugProxy · .value: float	Composante R de object_color_rgb.
object_color_g	objectColorG	_ValuePlugProxy · .value: float	Composante G de object_color_rgb.
object_color_b	objectColorB	_ValuePlugProxy · .value: float	Composante B de object_color_rgb.
wire_color_rgb	wireColorRGB	_ValuePlugProxy · .value: tuple[float, float, float]	Couleur RGB du wireframe.
wire_color_r	wireColorRGB.wireColorR	_ValuePlugProxy · .value: float	Composante R de wire_color_rgb.
wire_color_g	wireColorRGB.wireColorG	_ValuePlugProxy · .value: float	Composante G de wire_color_rgb.
wire_color_b	wireColorRGB.wireColorB	_ValuePlugProxy · .value: float	Composante B de wire_color_rgb.
hidden_in_outliner	hiddenInOutliner	_ValuePlugProxy · .value: bool	Masquage dans l’Outliner.
use_outliner_color	useOutlinerColor	_ValuePlugProxy · .value: bool	Activation de la couleur personnalisée dans l’Outliner.
outliner_color	outlinerColor	_ValuePlugProxy · .value: tuple[float, float, float]	Couleur RGB dans l’Outliner.
outliner_color_r	outlinerColorR	_ValuePlugProxy · .value: float	Composante R de outliner_color.
outliner_color_g	outlinerColorG	_ValuePlugProxy · .value: float	Composante G de outliner_color.
outliner_color_b	outlinerColorB	_ValuePlugProxy · .value: float	Composante B de outliner_color.
ghosting	ghosting	_ValuePlugProxy · .value: bool	Activation du ghosting Maya.
ghosting_mode	ghostingMode	_ValuePlugProxy · .value: int	Mode de ghosting.
ghost_custom_steps	ghostCustomSteps	CompoundProxy	Réglages composés des pas de ghosting.
ghost_pre_frames	ghostCustomSteps.ghostPreFrames	_ValuePlugProxy · .value: int	Nombre de frames avant la frame courante.
ghost_post_frames	ghostCustomSteps.ghostPostFrames	_ValuePlugProxy · .value: int	Nombre de frames après la frame courante.
ghosts_step	ghostCustomSteps.ghostsStep	_ValuePlugProxy · .value: int	Pas entre les échantillons de ghosting.
ghost_frames	ghostFrames	TypedArrayProxy	Liste native des frames de ghosting.
ghost_use_driver	ghostUseDriver	_ValuePlugProxy · .value: bool	Utilisation d’un driver pour le ghosting.
ghost_driver	ghostDriver	None	Connexion au driver de ghosting.
ghost_color_pre	ghostColorPre	_ValuePlugProxy · .value: tuple[float, float, float]	Couleur des ghosts précédents.
ghost_color_pre_r	ghostColorPre.ghostColorPreR	_ValuePlugProxy · .value: float	Composante R de ghost_color_pre.
ghost_color_pre_g	ghostColorPre.ghostColorPreG	_ValuePlugProxy · .value: float	Composante G de ghost_color_pre.
ghost_color_pre_b	ghostColorPre.ghostColorPreB	_ValuePlugProxy · .value: float	Composante B de ghost_color_pre.
ghost_color_post	ghostColorPost	_ValuePlugProxy · .value: tuple[float, float, float]	Couleur des ghosts suivants.
ghost_color_post_r	ghostColorPost.ghostColorPostR	_ValuePlugProxy · .value: float	Composante R de ghost_color_post.
ghost_color_post_g	ghostColorPost.ghostColorPostG	_ValuePlugProxy · .value: float	Composante G de ghost_color_post.
ghost_color_post_b	ghostColorPost.ghostColorPostB	_ValuePlugProxy · .value: float	Composante B de ghost_color_post.
ghost_opacity_range	ghostOpacityRange	_ValuePlugProxy · .value: tuple[float, float]	Plage composée d’opacité du ghosting.
ghost_near_opacity	ghostOpacityRange.ghostNearOpacity	_ValuePlugProxy · .value: float	Opacité des ghosts proches.
ghost_far_opacity	ghostOpacityRange.ghostFarOpacity	_ValuePlugProxy · .value: float	Opacité des ghosts éloignés.
render_info	renderInfo	CompoundProxy	Informations composées de rendu du nœud.
identification	renderInfo.identification	_ValuePlugProxy · .value: int	Identifiant natif dans les informations de rendu.
layer_renderable	renderInfo.layerRenderable	_ValuePlugProxy · .value: bool	Participation au rendu du layer.
layer_override_color	renderInfo.layerOverrideColor	_ValuePlugProxy · .value: int	Indice de couleur de remplacement du layer.
render_layer_info	renderLayerInfo	ArrayCompoundProxy	Tableau d’informations par render layer.
render_layer_id	renderLayerInfo[].renderLayerId	IndexedPathProxy	Identifiant du render layer à l’indice demandé.
render_layer_renderable	renderLayerInfo[].renderLayerRenderable	IndexedPathProxy	Participation au rendu du layer à l’indice demandé.
render_layer_color	renderLayerInfo[].renderLayerColor	IndexedPathProxy	Indice de couleur du render layer.
selection_child_highlighting	selectionChildHighlighting	_ValuePlugProxy · .value: bool	Surlignage des enfants lors de la sélection.
inst_obj_groups	instObjGroups	ArrayCompoundProxy	Groupes d’appartenance par instance DAG.
object_groups	instObjGroups[].objectGroups	AttributeError (accès direct)	Groupes de composants sous une instance DAG.
object_grp_comp_list	instObjGroups[].objectGroups[].objectGrpCompList	IndexedPathProxy	Composants du groupe à deux indices logiques.
object_group_id	instObjGroups[].objectGroups[].objectGroupId	IndexedPathProxy	Identifiant du groupe de composants.
object_grp_color	instObjGroups[].objectGroups[].objectGrpColor	IndexedPathProxy	Indice de couleur du groupe de composants.
matrix	matrix	_ValuePlugProxy · .value: om.MMatrix	Matrice locale évaluée par Maya.
inverse_matrix	inverseMatrix	_ValuePlugProxy · .value: om.MMatrix	Inverse de la matrice locale.
parent_matrix	parentMatrix	TypedArrayProxy	Matrices des parents, indexées par instance.
parent_inverse_matrix	parentInverseMatrix	TypedArrayProxy	Inverses des matrices des parents.
world_matrix	worldMatrix	TypedArrayProxy	Matrices monde, indexées par instance DAG.
world_inverse_matrix	worldInverseMatrix	TypedArrayProxy	Inverses des matrices monde.
intermediate_object	intermediateObject	_ValuePlugProxy · .value: bool	Marqueur Maya de shape intermédiaire.
draw_override	drawOverride	CompoundProxy	Ensemble des overrides d’affichage.
override_enabled	overrideEnabled	_ValuePlugProxy · .value: bool	Activation des overrides d’affichage.
override_display_type	overrideDisplayType	_ValuePlugProxy · .value: int	Type d’affichage imposé par l’override.
override_level_of_detail	overrideLevelOfDetail	_ValuePlugProxy · .value: int	Niveau de détail imposé par l’override.
override_shading	overrideShading	_ValuePlugProxy · .value: bool	Activation du shading dans l’override.
override_texturing	overrideTexturing	_ValuePlugProxy · .value: bool	Activation des textures dans l’override.
override_playback	overridePlayback	_ValuePlugProxy · .value: bool	Affichage pendant la lecture, selon l’override.
override_visibility	overrideVisibility	_ValuePlugProxy · .value: bool	Visibilité imposée par l’override.
override_color	overrideColor	_ValuePlugProxy · .value: int	Indice de couleur de l’override.
hide_on_playback	hideOnPlayback	_ValuePlugProxy · .value: bool	Masquage pendant la lecture.
override_rgb_colors	overrideRGBColors	_ValuePlugProxy · .value: bool	Utilisation de la couleur RGB pour l’override.
override_color_rgb	overrideColorRGB	_ValuePlugProxy · .value: tuple[float, float, float]	Couleur RGB de l’override.
override_color_r	overrideColorRGB.overrideColorR	_ValuePlugProxy · .value: float	Composante R de override_color_rgb.
override_color_g	overrideColorRGB.overrideColorG	_ValuePlugProxy · .value: float	Composante G de override_color_rgb.
override_color_b	overrideColorRGB.overrideColorB	_ValuePlugProxy · .value: float	Composante B de override_color_rgb.
override_color_a	overrideColorA	_ValuePlugProxy · .value: float	Composante alpha de la couleur d’override.
bounding_box	boundingBox	CompoundProxy	Plugs composés de la bounding box ; distincts de fn_bounding_box.
bounding_box_min	boundingBox.boundingBoxMin	_ValuePlugProxy · .value: tuple[float, float, float]	Coin minimum de la bounding box locale.
bounding_box_min_x	boundingBox.boundingBoxMin.boundingBoxMinX	_ValuePlugProxy · .value: float	Composante X de bounding_box_min.
bounding_box_min_y	boundingBox.boundingBoxMin.boundingBoxMinY	_ValuePlugProxy · .value: float	Composante Y de bounding_box_min.
bounding_box_min_z	boundingBox.boundingBoxMin.boundingBoxMinZ	_ValuePlugProxy · .value: float	Composante Z de bounding_box_min.
bounding_box_max	boundingBox.boundingBoxMax	_ValuePlugProxy · .value: tuple[float, float, float]	Coin maximum de la bounding box locale.
bounding_box_max_x	boundingBox.boundingBoxMax.boundingBoxMaxX	_ValuePlugProxy · .value: float	Composante X de bounding_box_max.
bounding_box_max_y	boundingBox.boundingBoxMax.boundingBoxMaxY	_ValuePlugProxy · .value: float	Composante Y de bounding_box_max.
bounding_box_max_z	boundingBox.boundingBoxMax.boundingBoxMaxZ	_ValuePlugProxy · .value: float	Composante Z de bounding_box_max.
bounding_box_size	boundingBox.boundingBoxSize	_ValuePlugProxy · .value: tuple[float, float, float]	Dimensions de la bounding box locale.
bounding_box_size_x	boundingBox.boundingBoxSize.boundingBoxSizeX	_ValuePlugProxy · .value: float	Composante X de bounding_box_size.
bounding_box_size_y	boundingBox.boundingBoxSize.boundingBoxSizeY	_ValuePlugProxy · .value: float	Composante Y de bounding_box_size.
bounding_box_size_z	boundingBox.boundingBoxSize.boundingBoxSizeZ	_ValuePlugProxy · .value: float	Composante Z de bounding_box_size.
center	center	_ValuePlugProxy · .value: tuple[float, float, float]	Centre de la bounding box locale.
center_x	center.boundingBoxCenterX	_ValuePlugProxy · .value: float	Composante X de center.
center_y	center.boundingBoxCenterY	_ValuePlugProxy · .value: float	Composante Y de center.
center_z	center.boundingBoxCenterZ	_ValuePlugProxy · .value: float	Composante Z de center.

Specs héritées de ContainerBase21

Propriété	Plug Maya	Retour	Description
black_box	blackBox	_ValuePlugProxy · .value: bool	Présentation du container en boîte noire dans Maya.
border_connections	borderConnections	list[str]	Données de connexions à la frontière du container.
creator	creator	_ValuePlugProxy · .value: str	Métadonnée de créateur du container.
creation_date	creationDate	_ValuePlugProxy · .value: str	Métadonnée de date de création.
custom_treatment	customTreatment	_ValuePlugProxy · .value: str	Traitement personnalisé du container.
hyper_layout	hyperLayout	None	Connexion au layout de l’Hypergraph.
icon_name	iconName	_ValuePlugProxy · .value: str	Nom d’icône associé au container.
is_collapsed	isCollapsed	_ValuePlugProxy · .value: bool	État replié du container dans les vues Maya.
is_hierarchical_connection	isHierarchicalConnection	TypedArrayProxy	Indicateurs de connexions hiérarchiques.
rmb_command	rmbCommand	_ValuePlugProxy · .value: str	Commande de menu contextuel associée au container.
template_name	templateName	_ValuePlugProxy · .value: str	Nom du template du container.
template_path	templatePath	_ValuePlugProxy · .value: str	Chemin du template du container.
template_version	templateVersion	_ValuePlugProxy · .value: int	Version du template du container.
container_type	containerType	_ValuePlugProxy · .value: str	Métadonnée de type du container.
ui_treatment	uiTreatment	_ValuePlugProxy · .value: int	Mode de présentation du container.
view_mode	viewMode	_ValuePlugProxy · .value: int	Mode de vue du container.
view_name	viewName	_ValuePlugProxy · .value: str	Nom de la vue du container.
published_node_info	publishedNodeInfo	ArrayCompoundProxy	Tableau des informations sur les nœuds publiés.
published_node	publishedNodeInfo[].publishedNode	IndexedPathProxy	Connexion vers le nœud publié à un indice donné.
is_hierarchical_node	publishedNodeInfo[].isHierarchicalNode	IndexedPathProxy	Indicateur hiérarchique d’un nœud publié.
published_node_type	publishedNodeInfo[].publishedNodeType	IndexedPathProxy	Type déclaré d’un nœud publié.

Specs héritées de DGNode6

Propriété	Plug Maya	Retour	Description
message	message	None	Plug de message du nœud ; sert aux connexions, sans valeur numérique.
frozen	frozen	_ValuePlugProxy · .value: bool	État natif de gel de l’évaluation.
is_historically_interesting	isHistoricallyInteresting	_ValuePlugProxy · .value: int	Niveau d’intérêt du nœud dans l’historique Maya.
bin_membership	binMembership	_ValuePlugProxy · .value: str	Appartenance aux bins Maya.
caching_enabled	caching	_ValuePlugProxy · .value: bool	Activation du cache natif du nœud.
caching_node_state	nodeState	_ValuePlugProxy · .value: int	État d’évaluation natif nodeState.

Méthodes

Méthode	Retour
create	None
snapshot	SurfaceSnapshot
closest_point	om.MPoint
closest_param	Tuple[float, float]
get_param_at_point	Tuple[float, float]
get_point_at_param	om.MPoint
intersect	Tuple[om.MPoint, float, float]
is_param_on_surface	bool
is_point_on_trimmed_region	bool
is_point_on_surface	bool
add_cvs	None
add_line	None
remove_cvs	None
clear_cvs	None
get_cv	om.MObject
get_cv_position	om.MPoint
get_cvs	om.MPointArray
set_cv_position	None
set_cv_positions	None
add_u_knots	None
add_v_knots	None
remove_u_knots	None
remove_v_knots	None
clear_knots	None
clear_u_knots	None
clear_v_knots	None
set_u_knot	None
set_v_knot	None
set_u_degree	None
set_v_degree	None
set_degrees	None
set_u_spans	None
set_v_spans	None

create

node.create() → NoneMéthode

Crée une shape vide si aucune définition préparée n’existe. Refuse une définition partielle ; ne fait rien si le nœud existe déjà.

Élément	Type / comportement
Retour	None

Le parcours de définition complète appelle une signature native différente de celle utilisée par l’exemple validé ci-dessous. La création d’une surface depuis cette définition n’est pas validée ici ; l’exemple crée explicitement la géométrie via API 2.0 puis l’enveloppe avec Surface.

snapshot

node.snapshot(profile: str='rig') → SurfaceSnapshotMéthode

Capture un dictionnaire d’état SVD et ajoute les champs spécifiques de la classe. Mémorise cette capture sur le wrapper ; ce n’est pas une sauvegarde complète de scène.

Élément	Type / comportement
Retour	SurfaceSnapshot
profile	str · défaut : 'rig'

closest_point

node.closest_point(point: om.MPoint, space: om.MSpace=None) → om.MPointMéthode

Recherche le point géométrique le plus proche de la position fournie.

Élément	Type / comportement
Retour	om.MPoint
point	om.MPoint · défaut : —
space	om.MSpace · défaut : None

Le paramètre space n’est pas transmis au function set. La méthode impose aussi une tolérance native de zéro ; ne pas supposer une requête en espace monde.

closest_param

node.closest_param(point: om.MPoint, space: om.MSpace=None) → Tuple[float, float]Méthode

Recherche les paramètres U/V les plus proches de la position fournie.

Élément	Type / comportement
Retour	Tuple[float, float]
point	om.MPoint · défaut : —
space	om.MSpace · défaut : None

Le paramètre space n’est pas transmis au function set. La méthode impose aussi une tolérance native de zéro ; ne pas supposer une requête en espace monde.

get_param_at_point

node.get_param_at_point(point: om.MPoint, ignore_trim: bool=False, tolerance: float=None, space: om.MSpace=None) → Tuple[float, float]Méthode

Recherche le ou les paramètres au point fourni ; ce n’est pas une projection automatique depuis un point éloigné.

Élément	Type / comportement
Retour	Tuple[float, float]
point	om.MPoint · défaut : —
ignore_trim	bool · défaut : False
tolerance	float · défaut : None
space	om.MSpace · défaut : None

Le function set est construit depuis un MObject. Une requête en espace monde lève RuntimeError sans MDagPath, comme reproduit sur le patch de contrôle. Choisir un espace objet lorsque le paramètre le permet.

get_point_at_param

node.get_point_at_param(u: float, v: float) → om.MPointMéthode

Évalue la position au paramètre demandé.

Élément	Type / comportement
Retour	om.MPoint
u	float · défaut : —
v	float · défaut : —

intersect

node.intersect(ray_start: om.MPoint, ray_dir: om.MVector, tolerance: float=None, space: om.MSpace=None) → Tuple[om.MPoint, float, float]Méthode

Interroge l’intersection d’un rayon avec la surface native.

Élément	Type / comportement
Retour	Tuple[om.MPoint, float, float]
ray_start	om.MPoint · défaut : —
ray_dir	om.MVector · défaut : —
tolerance	float · défaut : None
space	om.MSpace · défaut : None

Le function set est construit depuis un MObject. Une requête en espace monde lève RuntimeError sans MDagPath, comme reproduit sur le patch de contrôle. Choisir un espace objet lorsque le paramètre le permet.

is_param_on_surface

node.is_param_on_surface(u: float, v: float) → boolMéthode

Teste si les paramètres U/V appartiennent au domaine de la surface.

Élément	Type / comportement
Retour	bool
u	float · défaut : —
v	float · défaut : —

is_point_on_trimmed_region

node.is_point_on_trimmed_region(u: float, v: float) → boolMéthode

Tente un appel à isPointOnTrimmedEdge(), indisponible dans les versions API 2.0 vérifiées.

Élément	Type / comportement
Retour	bool
u	float · défaut : —
v	float · défaut : —

Appel vérifié : AttributeError, car om.MFnNurbsSurface ne possède pas isPointOnTrimmedEdge() dans les deux versions ciblées. Aucun booléen exploitable n’est renvoyé par ce parcours.

is_point_on_surface

node.is_point_on_surface(point: om.MPoint, tolerance: float=None, space: om.MSpace=None) → boolMéthode

Teste l’appartenance d’un point à la surface avec une tolérance.

Élément	Type / comportement
Retour	bool
point	om.MPoint · défaut : —
tolerance	float · défaut : None
space	om.MSpace · défaut : None

add_cvs

node.add_cvs(points: Union[om.MPoint, List[om.MPoint], om.MPointArray, List[Union[int, float]], List[List[Union[int, float]]]]) → NoneMéthode

Ajoute des CVs à la définition en mémoire, sans reconstruire la surface live.

Élément	Type / comportement
Retour	None
points	Union[om.MPoint, List[om.MPoint], om.MPointArray, List[Union[int, float]], List[List[Union[int, float]]]] · défaut : —

add_line

node.add_line(start: om.MPoint=None, end: om.MPoint=None, line: Union[om.MPointArray, List[List[Union[int, float]]]]=None) → NoneMéthode

Ajoute des points à la définition en mémoire : fournir soit start et end, soit line.

Élément	Type / comportement
Retour	None
start	om.MPoint · défaut : None
end	om.MPoint · défaut : None
line	Union[om.MPointArray, List[List[Union[int, float]]]] · défaut : None

remove_cvs

node.remove_cvs(indices: Union[List[int], int]) → NoneMéthode

Retire des indices de CVs de la définition en mémoire, dans l’ordre décroissant.

Élément	Type / comportement
Retour	None
indices	Union[List[int], int] · défaut : —

clear_cvs

node.clear_cvs() → NoneMéthode

Vide les CVs de la définition en mémoire.

Élément	Type / comportement
Retour	None

get_cv

node.get_cv(u: int, v: int) → om.MObjectMéthode

Renvoie le composant Maya d’un CV identifié par ses indices U/V.

Élément	Type / comportement
Retour	om.MObject
u	int · défaut : —
v	int · défaut : —

get_cv_position

node.get_cv_position(uIndex: int, vIndex: int, space: Optional[om.MSpace]=None) → om.MPointMéthode

Lit la position d’un CV dans l’espace demandé.

Élément	Type / comportement
Retour	om.MPoint
uIndex	int · défaut : —
vIndex	int · défaut : —
space	Optional[om.MSpace] · défaut : None

get_cvs

node.get_cvs(space: Optional[Union[om.MSpace, int]]=None) → om.MPointArrayMéthode

Lit les CVs live, ou convertit les CVs préparés si aucune surface live n’existe.

Élément	Type / comportement
Retour	om.MPointArray
space	Optional[Union[om.MSpace, int]] · défaut : None

set_cv_position

node.set_cv_position(uIndex: int, vIndex: int, position: om.MPoint, space: Optional[om.MSpace]=None) → NoneMéthode

Modifie la position d’un CV live.

Élément	Type / comportement
Retour	None
uIndex	int · défaut : —
vIndex	int · défaut : —
position	om.MPoint · défaut : —
space	Optional[om.MSpace] · défaut : None

set_cv_positions

node.set_cv_positions(positions: om.MPointArray, space: Optional[om.MSpace]=None) → NoneMéthode

Modifie toutes les positions de CVs live et met à jour la géométrie.

Élément	Type / comportement
Retour	None
positions	om.MPointArray · défaut : —
space	Optional[om.MSpace] · défaut : None

add_u_knots

node.add_u_knots(knots: Union[List[Union[int, float]], int]) → NoneMéthode

Ajoute des knots U à la définition en mémoire.

Élément	Type / comportement
Retour	None
knots	Union[List[Union[int, float]], int] · défaut : —

add_v_knots

node.add_v_knots(knots: Union[List[Union[int, float]], int]) → NoneMéthode

Ajoute des knots V à la définition en mémoire.

Élément	Type / comportement
Retour	None
knots	Union[List[Union[int, float]], int] · défaut : —

remove_u_knots

node.remove_u_knots(indices: Union[List[int], int]) → NoneMéthode

Retire des knots U de la définition en mémoire.

Élément	Type / comportement
Retour	None
indices	Union[List[int], int] · défaut : —

remove_v_knots

node.remove_v_knots(indices: Union[List[int], int]) → NoneMéthode

Retire des knots V de la définition en mémoire.

Élément	Type / comportement
Retour	None
indices	Union[List[int], int] · défaut : —

clear_knots

node.clear_knots() → NoneMéthode

Vide les deux vecteurs de knots préparés.

Élément	Type / comportement
Retour	None

clear_u_knots

node.clear_u_knots() → NoneMéthode

Vide les knots U préparés.

Élément	Type / comportement
Retour	None

clear_v_knots

node.clear_v_knots() → NoneMéthode

Vide les knots V préparés.

Élément	Type / comportement
Retour	None

set_u_knot

node.set_u_knot(index: int, knot: int) → NoneMéthode

Remplace un knot U dans la définition en mémoire.

Élément	Type / comportement
Retour	None
index	int · défaut : —
knot	int · défaut : —

set_v_knot

node.set_v_knot(index: int, knot: int) → NoneMéthode

Remplace un knot V dans la définition en mémoire.

Élément	Type / comportement
Retour	None
index	int · défaut : —
knot	int · défaut : —

set_u_degree

node.set_u_degree(degree: int) → NoneMéthode

Modifie le degré U préparé puis tente de recalculer CVs et knots ; ce n’est pas un rebuild natif de surface.

Élément	Type / comportement
Retour	None
degree	int · défaut : —

set_v_degree

node.set_v_degree(degree: int) → NoneMéthode

Modifie le degré V préparé puis tente de recalculer CVs et knots ; ce n’est pas un rebuild natif de surface.

Élément	Type / comportement
Retour	None
degree	int · défaut : —

set_degrees

node.set_degrees(degrees: Union[List[int], int]) → NoneMéthode

Applique set_u_degree() puis set_v_degree() ; un entier est répété pour les deux directions.

Élément	Type / comportement
Retour	None
degrees	Union[List[int], int] · défaut : —

set_u_spans

node.set_u_spans(spans: int) → NoneMéthode

Modifie les spans U préparés puis tente de recalculer CVs et knots.

Élément	Type / comportement
Retour	None
spans	int · défaut : —

set_v_spans

node.set_v_spans(spans: int) → NoneMéthode

Modifie les spans V préparés puis tente de recalculer CVs et knots.

Élément	Type / comportement
Retour	None
spans	int · défaut : —

Méthodes héritées de DAGNode3

Méthode	Retour	Description
delete	None	Utilise la suppression de DGNode.
finalize	None	Mémorise le dictionnaire puis délègue le replay à DGNode.finalize().
set_parent	None	Reparente le nœud live.

Méthodes héritées de DGNode3

Méthode	Retour	Description
snapshot_svd	SVDSnapshot	Capture Source / Value / Destinations pour la liste demandée.
svd	SVDView	Renvoie une vue live en lecture seule de la source, de la valeur et des destinations ; ce n’est pas une capture figée.
clear_attr_cache	None	Vide le cache d’attributs de cette instance ; ne supprime aucun nœud et ne vide pas le registre global de wrappers.

Méthodes héritées de Node2

Méthode	Retour	Description
has_fn(fn_type)	bool	Tester la compatibilité avec un function set Maya.
clear_node_registry()	None	Détacher les wrappers enregistrés et vider leur registre partagé.

Attributs de classe

Attribut	Valeur / composition
NODE_TYPE	'nurbsSurface'
SPEC_LAYERS	get_dg_specs_all, get_container_base_specs_all, get_dag_specs_all, get_geometry_shape_specs_all, get_control_point_specs_all, get_surface_shape_specs_all, get_surface_specs_all, get_curve_spec_overrides_map

NODE_REGISTRY et les autres attributs de classe non redéfinis restent hérités. Les types Snapshot exportés décrivent des dictionnaires ; utiliser node.snapshot() pour effectuer une capture.

Comportements à retenir

Point	Comportement
Identité	Un nœud recréé sous le même nom est un nouvel objet Maya.
Création et géométrie	Créer une shape vide ne construit pas sa topologie. L’exemple ci-dessous utilise API 2.0 pour la géométrie et le wrapper pour les opérations documentées.
Capture	Les snapshots peuvent contenir des objets Maya ; ne pas supposer un JSON prêt à exporter ni une reconstruction complète de géométrie.
cvs	Le setter modifie la définition en mémoire et celle de shape_orig ; il ne met pas directement à jour les CVs natifs et peut échouer sans shape intermédiaire. Utiliser set_cv_positions() pour une édition live.
closest_point	Le paramètre space n’est pas transmis au function set. La méthode impose aussi une tolérance native de zéro ; ne pas supposer une requête en espace monde.
closest_param	Le paramètre space n’est pas transmis au function set. La méthode impose aussi une tolérance native de zéro ; ne pas supposer une requête en espace monde.
create	Le parcours de définition complète appelle une signature native différente de celle utilisée par l’exemple validé ci-dessous. La création d’une surface depuis cette définition n’est pas validée ici ; l’exemple crée explicitement la géométrie via API 2.0 puis l’enveloppe avec Surface.
u_knots	Sur un wrapper sans surface live, le setter appelle .length() sur le tableau. Avec le type annoncé om.MDoubleArray, cet appel lève AttributeError dans les deux versions vérifiées.
v_knots	Sur un wrapper sans surface live, le setter appelle .length() sur le tableau. Avec le type annoncé om.MDoubleArray, cet appel lève AttributeError dans les deux versions vérifiées.
is_point_on_trimmed_region	Appel vérifié : AttributeError, car om.MFnNurbsSurface ne possède pas isPointOnTrimmedEdge() dans les deux versions ciblées. Aucun booléen exploitable n’est renvoyé par ce parcours.
get_param_at_point	Le function set est construit depuis un MObject. Une requête en espace monde lève RuntimeError sans MDagPath, comme reproduit sur le patch de contrôle. Choisir un espace objet lorsque le paramètre le permet.
intersect	Le function set est construit depuis un MObject. Une requête en espace monde lève RuntimeError sans MDagPath, comme reproduit sur le patch de contrôle. Choisir un espace objet lorsque le paramètre le permet.

Exemples d’utilisation

Exemple autonome pour le Script Editor Python de Maya. Dans mayapy, initialiser maya.standalone avant ce bloc. La démonstration crée ses propres nœuds et les supprime dans le finally.

from uuid import uuid4
import maya.api.OpenMaya as om
from weSkel.src.core.node.dag.transform.lib import Transform
from weSkel.src.core.node.dag.surface.lib import Surface

parent = Transform("api_surface_" + uuid4().hex[:8])
try:
    parent.create()
    points = om.MPointArray([(0, 0, 0), (0, 0, 1), (1, 0, 0), (1, 0, 1)])
    obj = om.MFnNurbsSurface().create(points, [0, 1], [0, 1], 1, 1,
                                    om.MFnNurbsSurface.kOpen, om.MFnNurbsSurface.kOpen,
                                    False, parent.mobject)
    node = Surface(obj)
    assert node.num_cvs_u == 2 and node.num_cvs_v == 2
    point = node.get_point_at_param(0.5, 0.5)
    assert isinstance(point, om.MPoint)
    assert abs(node.area - 1.0) < 1e-6
    print("Surface: native patch and parameter sampling OK")
finally:
    parent.delete(snapshot=False)

Résultat attendu : Surface: native patch and parameter sampling OK.

Checkpoint SDK 87c3486. Inventaire des membres et lectures de contrôle vérifiés sous Maya 2025.3 et 2026.3 ; exemple exécuté dans les deux versions. Les méthodes ne sont pas toutes couvertes par cet exemple. Les limites indiquées restent présentes dans les sources ; le package compilé n’est pas validé par ces contrôles.