Skip to main content

Offset Line

Move the outline of a line or polygon a specified distance with offset line.

Written by Holly Conrad Smith

Use this when you want to move a line or polygon outline by a specified distance within a flow, for example creating a parallel edge or buffer along a road or boundary.

Inputs

This node runs in Transform mode by default, so its settings come from the paired Transform node through the T connector. You can't wire a value straight into a single setting. To drive one setting from your flow, override it with a Write Property node between the Transform node and T, or switch this node to Exposed Inputs to get a connector for each setting.

Name

Abbreviation

Type

Access

Description

Input

I

Feature

Item

The input data

Transform

T

Object

Item

Transform controls (overridden by individual parameters)

Outputs

Name

Abbreviation

Type

Access

Description

Primary

P

Object

List

The primary output

How to:

  1. Add the Offset Line node and the Offset Line Transform node. Connect the transform's output to the Offset Line node's T connector.

  2. Click “edit defaults” to set the starting values

  3. Edit the settings and outputs in Properties

Connect the Offset Line Transform node

The Offset Line node needs the Offset Line Transform node connected to its T connector to use your settings. Without it, the Offset Line node runs on Giraffe's built-in default settings, and you can't change any of them in Edit Defaults or the Properties Palette.

OR

Use the exposed inputs version of the Offset Line node, which has its own connector for each setting and needs no transform node.

Offset Line Transform settings object

The Offset Line Transform node creates a set of inputs in the Properties Palette for anyone using the flow to fill out. It converts those inputs into a plain JSON object and sends it to the Offset Line node through the T connector. The object has type set to offsetLine and the settings inside parameters. The values below are the built-in defaults.

{
"type": "offsetLine",
"parameters": {
"delta": 10,
"left": true
}
}

The Offset Line Transform settings in the Properties Palette show lengths, areas, and volumes in your project units. The JSON always stores them in meters, square meters, and cubic meters, so a value you write into it with Write Property must use those units too.

To drive one setting from elsewhere in your flow, override it with a Write Property node. Put Write Property between the Offset Line Transform node and the T connector, and set Property to a path like parameters.delta.

Offset Line Settings

  • Input offset distance

    • use negative distance to shrink

    • use positive distance to grow

  • Select direction - left or right

  • Toggle polygon output to generate a polygon between the original line and the offset

Use the Offset Line node with exposed inputs

The exposed inputs version of the Offset Line node has its own connector for each setting, so you can wire values straight in without a Offset Line Transform node.

  1. Right-click the Offset Line node and choose Expose inputs. Giraffe replaces it with the exposed inputs version.

  2. Connect your input to the Features connector.

  3. Type a value into each setting on the node, or connect a value to its connector. A Number node, a value from another node, or an Input Parameter all work.

  4. To let people using the flow change a setting in the Properties Palette, connect an Input Parameter to it. Settings without an Input Parameter stay hidden.

To get the exposed inputs version every time you add a node, turn on Show exposed inputs when creating new nodes (the gearbox icon) in the flow editor toolbar. Settings don't carry over when you switch between versions.

Offset Line exposed inputs

Connector

What it does

Features

The input line features to offset.

Distance

The distance to offset.

Side

The side to offset the line (left or right).

Cap

Whether to create a closed polygon by capping the ends of the offset line.

Miter Limit

Maximum miter spike length, expressed as a multiple of distance. Caps how far sharp corners are extended; falls back to a bevel beyond the limit.

Offset line Output

  • The output is a line offset by the distance and direction specified

Did this answer your question?