Gaea Documentation

Gaea Documentation

Node Reference


MacroPort

Utility › Routing
Shortcode
Defines an input or output port inside a macro for passing height, mask, or color data.

A MacroPort defines an external input or output for a Macro source graph. Each MacroPort becomes a port on the exported Macro node, so the port name, direction, type, and optional state should be set before export.

For the full authoring flow, see Building Macros.

When to Use It

Use MacroPort when you are building a Macro and need to declare what data can enter or leave the packaged graph.

Properties

Property Purpose
Direction Sets whether this MacroPort is an Input or Output for the exported Macro.
Display Sets the visible data type for the port, such as Heightfield, Mask, or Color.
Is Optional Allows the exported Macro to build even when this port is not connected.

Rename MacroPort nodes to clear names such as In, Mask, or Out before export. Those names make the Macro source easier to read and help the exported Macro's ports make sense in other graphs.

MacroPort
DirectionSpecifies whether the macro port is used for input or output connections. Determines the flow of data into or out of the macro node.
InputDesignates the port as an input, allowing data to be received by the macro node. OutputDesignates the port as an output, allowing data to be sent from the macro node.
DisplayDefines the type of data visualized or represented by the macro port. This helps users identify the nature of the connection in the node graph.
HeightfieldRepresents terrain elevation data, typically used for heightmaps. MaskRepresents mask data, used for isolating or selecting specific regions in the terrain. ColorRepresents color data, used for visual effects or texture information.
Is Optional
FallbackWhen the given input fails or is intended to short-circuit, return the selected map.
NullReturn a null value. May cause node to be disrupted, but needed for Switch and other mechanisms. BlackA black (0) value map. WhiteA white (1) value map. GreyA grey (0.5) value map.

Created by QuadSpinner QuadSpinner using AngryMonkey
Copyright © 2016-2026 QuadSpinner. All rights reserved.
Documentation is provided under the MIT License.