Share

separate_mesh

Separates a single mesh with multiple islands into multiple, individual meshes. Conceptually, this is the opposite of merge_geometry. Each island is a group of faces that are connected to each other. A face can belong to only one island.

Inputs

mesh

The mesh to separate.

properties

The names of geo properties to transfer to the new geometry, such as point_color. Make sure to include all geo properties that you want, including those that target components other than faces (such as points and face-vertices). Properties that are not geo properties are always transferred.

  • Separate multiple geo property names with spaces.
  • You can use the wildcard * in expressions, for example, point_user* to transfer all geo properties that begin with the string "point_user".
  • The default value * transfers all geo properties.
  • Use an empty string to prevent any geo properties from being transferred, except for those that are required by the mesh schema (point_position, face_offset, and face_vertex).
  • Use a * followed by a ! to exclude a property. For example * !point_user* includes all properties, except ones that begin with the string "point_user"

Outputs

separated_meshes

An array of the mesh's islands, as separate mesh objects.

Was this information helpful?