nurbsSurface

Go to: Related nodes. Attributes.

This node represents a NURBS surface, for creating and manipulating nurbs surface objects. A nurbs surface is defined by a rectangular two-dimensional parameter space (u and v) and an array of vertices, referred to as control vertices.

Related nodes

birailSrf, squareSrf, spBirailSrf, dpBirailSrf, mpBirailSrf, ffFilletSrf, closeSurface, explodeNurbsShell, boolean, intersectSurface, attachSurface, detachSurface, avgNurbsSurfacePoints, boundaryBase, boundary

Attributes (63)

Attribute quick index omitted (too many attributes to show them all).

Long name (short name)	Type	Default	Flags
explicitTessellationAttributes (eta)	bool	boolfalse
specify advanced or novice mode for tessellation parameters
basicTessellationType (btt)	enum	0
Specify the space to use for novice tessellation. Object space will give constant tessellation between frames, whereas screen space tessellation will vary as the distance between the geometry and the camera changes. Surfaces which are far from the camera will be tesselated more coarsely than surfaces close to the camera. The screen based tessellation can be better render times or tessellation quality; but shading artifacts may be exhibited between frames when the tessellation changes. A highly reflective surface is one case where problems may be observed.
cached (cc)	nurbsSurface	nullptr
Cached surface Defines geometry of the surface. The properties are defined in this order: First line: degree in U, degree in V, form in U, form in V, rational (yes/no) Second line: number of knots in U, list of knot values in U Third line: number of knots in V, list of knot values in V Fourth line: number of CVs Fifth and later lines: CV positions in x,y,z (and w if rational)
chordHeight (ch)	double	double0.1
Specifies the maximum distance the center of a tessellated span can be from the actual NURBs surface (technically called chord height).
objSpaceChordHeight (uco)	bool	booltrue
Specifies whether chord height should be measured in object space (as opposed to world space) when chord height is being used as a tessellation criterion.
chordHeightRatio (chr)	double	double0.983
Specifies the maximum ratio between the length of a span and the distance the center of that span is from the actual NURBS surface.
fixTextureWarp (ftwp)	bool	boolfalse
Specifies if the rendering needs to use the Chord Length Texture Mapping method instead of the default surface parameter based.
curvatureTolerance (cvto)	enum	2
Presets for level of secondary criteria curvature tolerance: 0 = highest tolerance, 1 = high tolerance, 2 = medium tolerance, 3 = no tolerance
degreeUV (d)	short2
Compound attribute holding the degreeU and degreeV. See the children attributes for explanation.
degreeU (du) short 0 Degree in U
degreeV (dv) short 0 Degree in V
dispCV (dcv)	bool	boolfalse
Controls explicit CV display
dispEP (dep)	bool	boolfalse
Controls explicit edit point display
dispGeometry (dg)	bool	booltrue
Controls explicit geometry display
dispHull (dh)	bool	boolfalse
Controls explicit hull display
dispOrigin (dor)	bool	boolfalse
Controls explicit origin display
selCVDisp (scvd)	bool	boolfalse
Controls selective CV display
dispSF (dsf)	bool	boolfalse
Controls explicit surface face display
displayRenderTessellation (drt)	bool	boolfalse
Specifies if the rendering tessellation is to be used for shaded mode display. This is a UI toggle only.
smoothEdgeRatio (esr)	double	double0.99
Specifies the edge smooth ratio. The higher the value, the smoother the edge will be.
edgeSwap (es)	bool	boolfalse
Specifies if we want to examine the tessellation of quads to find the best triangles to represent them.
formU (fu)	enum	0
Form in U (open = 0, closed = 1, periodic = 2)
formV (fv)	enum	0
Form in V(open = 0, closed = 1, periodic = 2)
gridDivisionPerSpanU (gdsu)	short	4
Specifies the number of divisions per span of the ChordLength grid along the u param
gridDivisionPerSpanV (gdsv)	short	4
Specifies the number of divisions per span of the ChordLength grid along the v param
header (hd)	nurbsSurfaceHeader	nullptr
surface header
create (cr)	nurbsSurface	nullptr
Create in local space. Construction history operations put the result in this attribute.
local (l)	nurbsSurface	nullptr
Surface in local space to be used in subsequent operations
inPlace (ipo)	bool	boolfalse
In place with history
minScreen (mns)	double	double14
Specifies the maximum screen size (in pixels) a triangle can be for tessellation.
normalsDisplayScale (ndf)	double	double1.0
Specifies the scaling factor for the surface normal display.
curvePrecision (cpr)	unsigned char	uint8_t4
controls the wireframe display resolution: num of pts per span
curvePrecisionShaded (cps)	unsigned char	uint8_t1
controls the shaded mode display resolution
divisionsU (dvu)	unsigned char	uint8_t0
controls the num of divisions per span along U
divisionsV (dvv)	unsigned char	uint8_t0
controls the num of divisions per span along V
patchUVIds (pu)	nurbsPatchUVIds	nullptr
Patch corner UV Ids. Explicit UVs on nurbs surfaces are stored on a per-patch per-patchCorner basis. This attribute is used to specify the UV ids on a per-patch per-patchCorner for each UV set that exists on the surface. The values on this attribute are to be used in conjunction with the UVSetPoints attribute defined in the parent controlPointShape class, since that attribute holds on to the uv values corresponding to these ids.
minMaxRangeU (mmu)	double2
Compound attribute holding the minValueU and maxValueU. See the children attributes for explanation.
minValueU (mnu) double 0.0 U Parameter range min
maxValueU (mxu) double 0.0 U Parameter range max
minMaxRangeV (mmv)	double2
Compound attribute holding the minValueV and maxValueV. See the children attributes for explanation.
minValueV (mnv) double 0.0 V Parameter range min
maxValueV (mxv) double 0.0 V Parameter range max
renderTriangleCount (tcn)	integer	0
This will return the render tessellation triangle count (if known). This is for UI informational purposes only
simplifyMode (sm)	unsigned char	uint8_t0
Whether the geometry is displayed in full (actual) or hull mode
simplifyU (smu)	unsigned char	uint8_t1
Hull mode simplification value along U direction
simplifyV (smv)	unsigned char	uint8_t1
Hull mode simplification value along V direction
spansUV (sp)	long2
Compound attribute holding the spansU and spansV. See the children attributes for explanation.
spansU (su) integer 0 Number of spans in U
spansV (sv) integer 0 Number of spans in V
trimFace (tf)	nurbsTrimFace	nullptr
Trim faces
tweakSizeU (tsu)	integer	int-1
What was the topology in U when we tweaked
tweakSizeV (tsv)	integer	int-1
What was the topology in V when we tweaked
modeU (mu)	enum	3
Specifies the manner in which to distribute the initial isoparametric lines in U to start tessellation.
numberU (nu)	integer	int3
Specifies the number of initial isoparametric lines to create in U to start tessellation.
uDivisionsFactor (nufa)	double	1.5
Specifies the tessellation increase factor in U for novice mode
useChordHeight (uch)	bool	boolfalse
Specifies if the decision to continue tessellation should be based on the chord height tolerance value.
useChordHeightRatio (ucr)	bool	booltrue
Specifies if the decision to continue tessellation should be based on the chord height ratio tolerance value.
smoothEdge (ues)	bool	boolfalse
Specifies if the decision to continue tessellation should be based on the nurbs edge smoothness
useMinScreen (uns)	bool	boolfalse
Specifies if the decision to continue tessellation should be based on the minimum triangle screen size.
modeV (mv)	enum	3
Specifies the manner in which to distribute the initial isoparametric lines in V to start tessellation.
numberV (nv)	integer	int3
Specifies the number of initial isoparametric lines to create in V to start tessellation.
vDivisionsFactor (nvfa)	double	1.5
Specifies the tessellation increase factor in V for novice mode
worldSpace (ws)	nurbsSurface	nullptr
Surface in world space (indexed by the instance number) to be used in subsequent operations