Go to: Related nodes. Attributes.

This node represents a NURBS surface.

Node nameParentsMFn typeCompatible function sets
nurbsSurfacesurfaceShapekNurbsSurfacekBase
kNamedObject
kDependencyNode
kDagNode
kShape
kGeometric
kSurface
kNurbsSurface
kNurbsSurfaceGeom

Related nodes

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

Attributes (96)

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

Long name (short name)TypeDefaultFlags
header (hd) nurbsSurfaceHeaderNULLoutputinput
surface header
create (cr) nurbsSurfaceNULLoutputinputconnectable
Create in local space. Construction history operations put the result in this attribute.
local (l) nurbsSurfaceNULLoutputconnectable
Surface in local space to be used in subsequent operations
worldSpace (ws) nurbsSurfaceNULLarrayoutputconnectable
Surface in world space (indexed by the instance number) to be used in subsequent operations
divisionsU (dvu) unsigned char0outputinputconnectablestorable
controls the num of divisions per span along U
divisionsV (dvv) unsigned char0outputinputconnectablestorable
controls the num of divisions per span along V
curvePrecision (cpr) unsigned char4outputinputconnectablestorable
controls the wireframe display resolution: num of pts per span
curvePrecisionShaded (cps) unsigned char1outputinputconnectablestorable
controls the shaded mode display resolution
simplifyMode (sm) unsigned char0outputinputconnectablestorable
Whether the geometry is displayed in full (actual) or hull mode
simplifyU (smu) unsigned char1outputinputconnectablestorable
Hull mode simplification value along U direction
simplifyV (smv) unsigned char1outputinputconnectablestorable
Hull mode simplification value along V direction
smoothEdge (ues) boolfalseoutputinputconnectablestorable
Specifies if the decision to continue tessellation should be based on the nurbs edge smoothness
smoothEdgeRatio (esr) double0.99outputinputconnectablestorable
Specifies the edge smooth ratio. The higher the value, the smoother the edge will be.
useChordHeight (uch) boolfalseoutputinputconnectablestorable
Specifies if the decision to continue tessellation should be based on the chord height tolerance value.
objSpaceChordHeight (uco) booltrueoutputinputconnectablestorablehidden
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.
useChordHeightRatio (ucr) booltrueoutputinputconnectablestorable
Specifies if the decision to continue tessellation should be based on the chord height ratio tolerance value.
edgeSwap (es) boolfalseoutputinputconnectablestorable
Specifies if we want to examine the tessellation of quads to find the best triangles to represent them.
useMinScreen (uns) boolfalseoutputinputconnectablestorable
Specifies if the decision to continue tessellation should be based on the minimum triangle screen size.
selCVDisp (scvd) boolfalseoutputinputconnectablestorable
Controls selective CV display
dispCV (dcv) boolfalseoutputinputconnectablestorable
Controls explicit CV display
dispEP (dep) boolfalseoutputinputconnectablestorable
Controls explicit edit point display
dispHull (dh) boolfalseoutputinputconnectablestorable
Controls explicit hull display
dispGeometry (dg) booltrueoutputinputconnectablestorable
Controls explicit geometry display
dispOrigin (dor) boolfalseoutputinputconnectablestorable
Controls explicit origin display
numberU (nu) integer3outputinputconnectablestorable
Specifies the number of initial isoparametric lines to create in U to start tessellation.
modeU (mu) enum3outputinputconnectablestorable
Specifies the manner in which to distribute the initial isoparametric lines in U to start tessellation.
numberV (nv) integer3outputinputconnectablestorable
Specifies the number of initial isoparametric lines to create in V to start tessellation.
modeV (mv) enum3outputinputconnectablestorable
Specifies the manner in which to distribute the initial isoparametric lines in V to start tessellation.
chordHeight (ch) double0.1outputinputconnectablestorable
Specifies the maximum distance the center of a tessellated span can be from the actual NURBs surface (technically called chord height).
chordHeightRatio (chr) double0.983outputinputconnectablestorable
Specifies the maximum ratio between the length of a span and the distance the center of that span is from the actual NURBS surface.
minScreen (mns) double14outputinputconnectablestorable
Specifies the maximum screen size (in pixels) a triangle can be for tessellation.
formU (fu) enum0outputconnectable
Form in U (open = 0, closed = 1, periodic = 2)
formV (fv) enum0outputconnectable
Form in V(open = 0, closed = 1, periodic = 2)
cached (cc) nurbsSurfaceNULLoutputinputconnectablestorable
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)
trimFace (tf) nurbsTrimFaceNULLarrayoutputinputstorable
Trim faces
patchUVIds (pu) nurbsPatchUVIdsNULLarrayoutputinputconnectablestorablehidden
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.
inPlace (ipo) boolfalseoutputinputconnectablestorable
In place with history
tweakSizeU (tsu) integer-1outputinputconnectable
What was the topology in U when we tweaked
tweakSizeV (tsv) integer-1outputinputconnectable
What was the topology in V when we tweaked
minMaxRangeU (mmu) double2outputconnectable
Compound attribute holding the minValueU and maxValueU. See the children attributes for explanation.
minValueU (mnu) double0.0outputconnectable
U Parameter range min
maxValueU (mxu) double0.0outputconnectable
U Parameter range max
minMaxRangeV (mmv) double2outputconnectable
Compound attribute holding the minValueV and maxValueV. See the children attributes for explanation.
minValueV (mnv) double0.0outputconnectable
V Parameter range min
maxValueV (mxv) double0.0outputconnectable
V Parameter range max
degreeUV (d) short2outputconnectable
Compound attribute holding the degreeU and degreeV. See the children attributes for explanation.
degreeU (du) short0outputconnectable
Degree in U
degreeV (dv) short0outputconnectable
Degree in V
spansUV (sp) long2outputconnectable
Compound attribute holding the spansU and spansV. See the children attributes for explanation.
spansU (su) integer0outputconnectable
Number of spans in U
spansV (sv) integer0outputconnectable
Number of spans in V
displayRenderTessellation (drt) boolfalseoutputinputconnectablestorable
Specifies if the rendering tessellation is to be used for shaded mode display. This is a UI toggle only.
renderTriangleCount (tcn) integer0outputconnectable
This will return the render tessellation triangle count (if known). This is for UI informational purposes only
fixTextureWarp (ftwp) boolfalseoutputinputconnectablestorable
Specifies if the rendering needs to use the Chord Length Texture Mapping method instead of the default surface parameter based.
gridDivisionPerSpanU (gdsu) short4outputinputconnectablestorable
Specifies the number of divisions per span of the ChordLength grid along the u param
gridDivisionPerSpanV (gdsv) short4outputinputconnectablestorable
Specifies the number of divisions per span of the ChordLength grid along the v param
explicitTessellationAttributes (eta) boolfalseoutputinputconnectablestorable
specify advanced or novice mode for tessellation parameters
uDivisionsFactor (nufa) double1.5outputinputconnectablestorable
Specifies the tessellation increase factor in U for novice mode
vDivisionsFactor (nvfa) double1.5outputinputconnectablestorable
Specifies the tessellation increase factor in V for novice mode
curvatureTolerance (cvto) enum2outputinputconnectablestorable
Presets for level of secondary criteria curvature tolerance: 0 = highest tolerance, 1 = high tolerance, 2 = medium tolerance, 3 = no tolerance
basicTessellationType (btt) enum0outputinputconnectablestorablehidden
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.
dispSF (dsf) boolfalseoutputinputconnectablestorable
Controls explicit surface face display
normalsDisplayScale (ndf) double1.0outputinputconnectablestorable
Specifies the scaling factor for the surface normal display.
mentalRayControls (mrc) compoundn/aoutputinputconnectablestorable
This is a root of following mental ray attributes.
miOverrideCaustics (oca) boolfalseoutputinputconnectablestorable
Enable caustic settings override for this shape. If this parameter is set, the following caustics settings will override the renddr global settings for this shape node.
miCausticAccuracy (caa) short64outputinputconnectablestorable
Caustic accuracy for this shape if miOverrideCaustics is on.
miCausticRadius (car) float0outputinputconnectablestorable
Caustic radius for this shape if miOverrideCaustics is on.
miOverrideGlobalIllumination (ogi) boolfalseoutputinputconnectablestorable
Enable global illumination settings override for this shape. If this parameter is set, the following global illumination settings will override the renddr global settings for this shape node.
miGlobillumAccuracy (gia) short64outputinputconnectablestorable
Global illumination accuracy for this shape if miOverrideGlobalIllumination is on.
miGlobillumRadius (gir) float0outputinputconnectablestorable
Global illumination radius for this shape if miOverrideGlobalIllumination is on.
miOverrideFinalGather (ofg) boolfalseoutputinputconnectablestorable
Enable final gather settings override for this shape. If this parameter is set, the following final gather settings will override the renddr global settings for this shape node.
miFinalGatherRays (fry) integer1000outputinputconnectablestorable
Final gather rays for this shape if miOverrideFinalGather is on.
miFinalGatherMinRadius (fmn) float0outputinputconnectablestorable
Final gather min radius for this shape if miOverrideFinalGather is on.
miFinalGatherMaxRadius (fmx) float0outputinputconnectablestorable
Final gather max radius for this shape if miOverrideFinalGather is on.
miFinalGatherFilter (ffi) short1outputinputconnectablestorable
Final gather filter for this shape if miOverrideFinalGather is on.
miFinalGatherView (fgv) boolfalseoutputinputconnectablestorable
Final gather view flag for this shape if miOverrideFinalGather is on.
miOverrideSamples (oos) boolfalseoutputinputconnectablestorable
Override global object sample settings. In addition to global sample settings mental ray supports per-object sample settings. The global mental ray default for all objects in the scene can be set by minObjectSamples and maxObjectSamples on the mental ray options node (miDefaultOptions). Similar attributes on individual shape nodes miMinSamples and miMaxSamples are overriding the global default, within global samples range.
miMinSamples (mins) short0outputinputconnectablestorable
Specifies min sample settings for the shape. For all pixels that touch this object, at least pow(2, miMinSamples) samples are taken. miMinSamples lower than the global min samples is ignored.
miMaxSamples (maxs) short2outputinputconnectablestorable
Specifies max sample settings for the shape. For all pixels that touch this object, at most pow(2, miMaxSamples) samples are taken. miMaxSamples higher than the global max samples is ignored.
miFinalGatherCast (fgc) booltrueoutputinputconnectablestorable
The object casts final gather rays if miFinalGatherCast is on, which means that the object participates in final gather.
miFinalGatherReceive (fge) booltrueoutputinputconnectablestorable
The object receives final gather rays if miFinalGatherReceive is on, which means that the object is not affected by final gathering.
miTransparencyCast (tpc) booltrueoutputinputconnectablestorable
The object casts transparent rays if miTransparencyCast is on. thus shown through transparent object if ray depth has not been reached the limit.
miTransparencyReceive (tpr) booltrueoutputinputconnectablestorable
The object receives transparent rays if miTransparencyReceive is on.
miReflectionReceive (rflr) booltrueoutputinputconnectablestorable
The object receives reflection rays if miReflectionReceive is on. This flag controls reflection of other objects on this object. If disabled, this object will not show any reflection, as if the surface is not reflective. The casting behaviour is ruled by visibleInReflections flag, which controls reflection of this object on other objects. Disabling visibleInReflections will make this object disappera from reflection.
miRefractionReceive (rfrr) booltrueoutputinputconnectablestorable
The object receives refraction rays if miRefractionReceive is on. This flag contols refraction of other objects through this object. Disabling this value will make this object non-refractive. The casting behaviour is ruled by visibleInRefractions flag, which controls refraction of this object showing through other objects. Disabling visibleInRefractions will make this object disappear from refraction.
miProxyFile (mof) stringNULLoutputinputconnectablestorable
When rendering with mental ray, replace this object with the mental ray assembly file referenced by this attribute.
miUpdateProxyBoundingBoxMode (upbm) enum0outputinputconnectablestorable
Controls how the bounding box attributes for the render proxy are updated when the render proxy file changes. Choices are:
  • Proxy and geometry bounding boxes: both the proxy bounding box and geometry are updated
  • Proxy bounding box only: only the proxy bounding box is updated, the geometry remains the same in the scene
  • Geometry bounding box only: only the geometry changes in the scene, the proxy bounding box attributes are untouched
  • None: Neither proxy bounding box or geometry is changed
miProxyBoundingBox (mbb) compoundn/aoutputinputconnectablestorable
Root for the bounding box attribute of the proxy object
miProxyBoundingBoxMin (mbmn) double3outputinputconnectablestorable
Minimum value of bounding box for proxy object
miProxyBoundingBoxMinX (mbnx) double0.0outputinputconnectablestorable
X value of minimum bounding box for proxy object
miProxyBoundingBoxMinY (mbny) double0.0outputinputconnectablestorable
Y value of minimum bounding box for proxy object
miProxyBoundingBoxMinZ (mbnz) double0.0outputinputconnectablestorable
Z value of minimum bounding box for proxy object
miProxyBoundingBoxMax (mbmx) double3outputinputconnectablestorable
Maximum value of bounding box for proxy object
miProxyBoundingBoxMaxX (mbxx) double0.0outputinputconnectablestorable
X value of maximum bounding box for proxy object
miProxyBoundingBoxMaxY (mbxy) double0.0outputinputconnectablestorable
Y value of maximum bounding box for proxy object
miProxyBoundingBoxMaxZ (mbxz) double0.0outputinputconnectablestorable
Z value of maximum bounding box for proxy object