Skip to main content

Input Parameter

Create an end-user parametric input for your flow

Holly Conrad Smith avatar
Written by Holly Conrad Smith
Updated this week

Input Parameter allows you to create custom fields that can change the flow result. These fields display in the Properties palette.

The input parameter can be configured to many different types of data, and makes it possible to expose variables from a flow for easier modification.

Outputs

Name

Abbreviation

Type

Access

Description

Value

V

Any

Item

The value of the input

How to

  1. Enter a name

    The Name field is how the parameter will appear in the Properties palette. Give it a descriptive name

  2. Enter a description

    The description is a tooltip text for the property. Give your end-user some more instructions on how to use this node.

  3. Size

    Choose single or list.

    Single allows one unique input value

    List adds a UI to manage a list of items.

  4. Type

    The Type determines the input’s format. This is important for nodes that require specific data types.

    1. String - a simple text box

    2. Number - a number spinner, precision, optional min and max, and distance type.

      1. Precision: The number of decimal places

      2. Min - the lowest allowed value in the spinner

      3. The highest allowed value in the spinner

      4. Dimension - select dimensionless, or metric/imperial units

    3. Vector - x, y, z coordinates

    4. Color - A color selector

    5. Boolean - a toggle

    6. Feature - select or create a geometry of the project to use as in input

      Useful for geometric operations like boolean difference or creating complex geometries with Generative nodes like Apartment. Select the allowed feature types - Point, polyline, or enclosed polygon. By default, all shape types are allowed. Click a type to unselect.

      The feature parameter displays in the Properties UI as a list manager. Click "manage {{parameter name}} to add geometries to the flow.

      1. The Feature list

        1. Move feature up/down

        2. Duplicate

        3. Remove (removes from the flow, but does not delete the feature from the project)

      2. Pick - pick an existing feature from the map to add to the input list

      3. Draw - draw a new feature. Select from the allowed types.

      4. Clear - Remove all features from the list (removes from the flow, but does not delete the feature from the project)

      5. Select All - Select all of the features to move/adjust

    7. Group - select groups to use as flow inputs

      In the property palette, type a group name, or click pick to select a group from the map.

  5. Default Value

    If you input a default value, the flow will inherit that setting on every new geometry it’s added to. Otherwise, the default will be empty or 0.

Example:

Set the property value of a geometry via a flow.

Did this answer your question?