Share

subdivide_mesh

Subdivides a mesh using various subdivision schemes. This node refines the mesh geometry by adding new vertices and faces according to the specified subdivision algorithm.

Inputs

mesh

The input mesh to subdivide.

level

The number of subdivision levels to apply.

  • 0: No subdivision (returns the original mesh)
  • 1: One level of subdivision (default)
  • Higher values: Progressively more detailed subdivision

scheme

The subdivision algorithm to use.

Available schemes:

  • Bilinear: A subdivision scheme that adds new vertices at edge midpoints and face centers.
  • CatmullClark: A subdivision scheme that produces smooth, curved surfaces.
  • Loop: A subdivision scheme specifically designed for triangular meshes. Note that meshes are automatically triangulated before subdivision is applied.
Note: Subdivision schemes follow OpenSubdiv definitions.

properties

The properties to transfer to the output mesh. This is an expression-based list of properties you wish to transfer. For specific properties, use a space-separated list:

point_normal point_color

To transfer every incoming property, use:

*

To exclude a specific property, use !:

* !point_normal

By default, this is *, meaning all supported incoming properties will be transferred.

Outputs

subdivided_mesh

The subdivided mesh with the specified level of refinement applied according to the chosen subdivision scheme.

Was this information helpful?