delete_faces

Returns a new mesh object without the specified faces. Vertices that aren't referenced by any of the kept faces are also discarded.

Inputs

mesh

The mesh from which to delete faces.

faces_to_delete

The faces to delete. This port accepts the same inputs as interpret_auto_port_as_component_tag:

• An array<bool> is interpreted as values per-face. The array gets passed through, but may be resized to match the number of elements on the mesh input.
• An array<long> or array<uint> is interpreted as face indices.
• A string is interpreted as the name of an existing tag or a tag expression. See the documentation for resolve_tag_expression for more details on the tag expression syntax.

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 meshes (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

out_mesh

The mesh without the faces specified by faces_to_delete.