Extrudes the specified faces of an input mesh. This detaches the specified faces, offsets them by the thickness input, and inserts new faces between the specified faces and the faces they were adjacent to. The specified faces will be kept together in the output mesh.

When using an extrusion path, you can click the D flag at the bottom of the node to display axis markers that can help you to diagnose alignment issues.

Inputs

mesh

The mesh to extrude faces on.

faces_to_extrude

The faces to extrude. 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.

enable

Enables/disables this node. When disabled the input geometry is passed through to the output.

divisions

The number of new faces inserted between each face_to_extrude and the other faces of the mesh they are adjacent to.

smoothing_angle

Creates hard edges when the dihedral angle between faces exceeds this threshold. Note this only applies to new edges generated by this node; existing edges are not modified.

thickness

This port uses interpret_auto_port_as_scalar and is interpreted this way :

• A single float is interpreted as a constant value for selected faces. Positive values means faces are offset along the normals of the surface, negative values offset along the opposite direction.
• An array<float> is interpreted as values per-element (e.g. per-point). The array gets passed through, but may be resized to match the number of elements on the geometry input. Each specified face will see it's corresponding points be offseted by this amount.
• An array<long> specifies the indices to be assigned a value of 1. Other indices are assigned 0.
• An array<bool> is interpreted as values of 0 (false) or 1 (true) per point.
• A string is interpreted as the name of an existing geo property, and its values are used.
• A Core::Fields::ScalarField is interpreted as the value of the field at the vertex locations.

properties

The properties to transfer to the output mesh.

• Separate multiple property names with spaces.
• You can use the wildcard * in expressions, for example, point_user* to specify all properties that begin with the string "point_user".
• The default value * specifies all geo properties.
• Use an empty string to specify no properties.
• To include all properties except those specified, use * (to include all properties) and then prefix specific properties or patterns individually with ! to exclude them. For example * !point_foo !point_bar* includes all properties except "point_foo" and those that begin with the string "point_bar".

use_extrusion_path

Enable to use the strands_extrusion_path.

strands_extrusion_path

The first strand in the connected strands geo is used as a path for the extrusion if use_extrusion_path is enabled.

taper

The scaling of the extruded faces. Edit the curve to control the profile of the extruded faces along the extrusion path.

twist

The amount to rotate the extruded faces. Use this to twist the faces along the extrusion path.

Tags

create_tags

When enabled tags will be added to the output mesh.

merge_mode

If create_tags is checked and tags with the same name already exist on the input mesh, this controls how the existing tags are merged into the generated tags.

• Replace Overwrites any existing tag data.
• Union Performs a boolean union of the existing tag and the generated tag data.
• Intersection Performs a boolean intersection of the existing tag and the generated tag data.
• Subtraction Subtracts the generated tag data from the existing tag.

front_tag

The name of the tag for the faces being extruded. If blank, no tag will be output.

side_tag

The name of the tag for the faces that are generated as part of the extrusion. If blank, no tag will be output.

Outputs

out_mesh

The mesh with the specified faces extruded.