MeshType
Changes between polygon and subdivision representations for mesh objects, and optionally recalculates vertex normals for polygon meshes.
Note that currently the Gaffer viewport does not display subdivision meshes with smoothing, so the results of using this node will not be seen until a render is performed.
user
Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.
out
The processed output scene.
enabled
The on/off state of the node. When it is off, the node outputs the input scene unchanged.
in
The input scene
filter
The filter used to control which parts of the scene are processed. A Filter node should be connected here.
meshType
The interpolation type to apply to the mesh.
calculatePolygonNormals
Causes new vertex normals to be calculated for polygon meshes. Has no effect for subdivision surfaces, since those are naturally smooth and do not require surface normals. Vertex normals are represented as primitive variables named “N”.
overwriteExistingNormals
By default, vertex normals will only be calculated for polygon meshes which don’t already have them. Turning this on will force new normals to be calculated even for meshes which had them already.
interpolateBoundary
Specifies which parts of mesh boundaries are forced to exactly meet the boundary. Without this forcing, a subdivision surface will naturally shrink back from the boundary as it smooths out.
Usually, you want to force both edges and corners to exactly meet the boundary. The main reasons to
change this are to use Edge Only
if you want to produce curved edges from polygonal boundaries,
or to use None
if you’re doing something tricky with seamlessly splitting subdiv meshes by
providing the split meshes with a border of shared polygons in order to get continuous tangents.
faceVaryingLinearInterpolation
Specifies where face varying primitive variables should use a simple linear interpolation instead of being smoothed.
In order for UVs to correspond to approximately the same texture areas as the original polygons, usually you want to, at minimum, pin the outside corners. But pinning the entire boundary causes some pretty weird discontinuities, so finding the right compromise is tricky.
See the OpenSubdiv docs for explanation of the details of options like Corners Plus 1
:
https://graphics.pixar.com/opensubdiv/docs/subdivision_surfaces.html#schemes-and-options
triangleSubdivisionRule
Option to use a non-standard Smooth
subdivision rule that provides slightly better results
at triangular faces in Catmull-Clark meshes than the standard Catmull-Clark algorithm.