Tool

Toolset

Carve

Carve

Toolset

Extract the part of a curve between start and end positions

Docs for v4.0.1, the latest version.

ID

tool-toolset-carve

Group

Toolset

Plugin

Tool

Keywords

carve
trim
subCurve
segment
subCrv
3 inputs, 3 outputs, 1 config port

Ports

Inputs

3

What the node takes in, from wires or typed values.

Curve

Curve

Curve to carve

Start

Number

Default 0

Position where the carved part begins

End

Number

Default 1

Position where the carved part ends; before start, the part runs through the seam of a closed curve

Outputs

3

What the node gives out, to wire into other nodes.

Inside

Curve

Part of the curve between start and end

Outside

Curve

Rest of the curve outside start and end: one part for a closed curve, up to two for an open one

Length

Number

Length of the whole curve

Config

1

Settings on the node itself, changed in its panel.

Mode

Number

Default 0

Relative: start and end are fractions of the curve length (0..1). Absolute: distances from the curve start

Creation method#

There are two options for creating a Carve node.#

  • The first way to create a Carve node using the search list, which is opened by double left-clicking in the workspace. You can write the name of the node you need, or words associated with this node.
    • carve , trim , subCurve , segment , subCrv
  • The second way is to select a Carve node from the menu that opens from the top left.
    • Menu > Tool > Toolset > Carve

Steps#

  • Create a Carve node.
  • Connect the curve, or an array of curves, you want to carve to the first port.
  • Choose the mode in the field in the middle of the node:
    • Relative — start and end are fractions of the curve length from 0.0 to 1.0.
    • Absolute — start and end are distances from the beginning of the curve in model units.
  • Set the start and end positions. When start is after end, the part runs through the seam of a closed curve; an open curve reports an error.

On the Inside port, you will get the part of the curve between the start and end positions. On the Outside port, you will get the rest of the curve: one part for a closed curve, or up to two parts for an open curve, the one before start and the one after end. On the Length port, you will get the length of the whole curve. For an array of curves, the positions are applied to each curve individually. Animate the end position from 0 to 1 in Relative mode to grow a line along the curve.

See also#

Shatter
Extend Curve
Dash Pattern

History

Added in v3.0.0

Nov 3, 2026