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
, andface_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.