Proximity Pin options

Note: There are additional controls for the Proximity Pin constraint in the Attribute Editor Proximity Pin tab. They are described in this topic, after the Connections and Coordinate System sections.

Connections

The Connections area contains what transforms will be connected to the input and the output of the node.
Note: Connection options cannot both be set to Existing Transform or a cycle would be created. You can have multiple inputs or outputs on a node.
Input
Sets the input matrix connection on the Proximity Pin node in the Node Editor.
New Locator Duplicates the selected transforms as locators called pinInput andconnects them to the proximityPin node's input. (This is the default.)
Existing Transform Uses the selected transforms and connects them to the proximityPin node's input.
New Transform Duplicates the selected transforms as transforms called pinInput and connects them to the proximityPin node's input.
Matrix Adds input plugs to the node without connecting locators or transforms.
Note: You can also add new input Matrices in the Attribute Editor.
Output
Sets the Output matrix connection.
Existing Transform Uses the selected transforms and connects them to the proximityPin node's output. (This is the default.)
New Locator Creates a new locators at the closest points on the surface and connects them to the node's output.
New Transform Creates new transforms at the closest points on the surface and connects them to the node's output.
Matrix Creates, but does not connect, any input plugs on the node, leaving the connection available.

Coordinate System

The Coordinate System area lets you set how the pin coordinates are derived from the geometry surface. Because Proximity Pin is procedural, you can continue to edit these settings in the Attribute Editor after creation.

Mode
Specifies how the coordinate system is derived from the surface.
UV Set
Specifies a UV set to be used for the coordinate system when the mode is set to UV.
Normal axis

Specifies what axis of the coordinate system of the outputs to align with the surface normal. Cannot be the same as Tangent axis.

Tangent axis
Specifies what axis of the coordinate system of the outputs to align with the surface tangent. Cannot be the same as Normal axis.
Maintain Offset
Preserves the initial offset between the input matrix and the Original Geometry. After creation, the Attribute Editor lets you control the translation and orientation of the offset independently and supports fractional amounts. If you activate Maintain Offset in the Proximity Pin window, they are both initially set to 1. If you disable Maintain Offset, the translation and orientation offsets are both initially set to 0.
Relative space mode
Use the menu to set your node evaluation space: World, Local, or Custom. Setting a different relative space

Relative space modes using UVpin and a Locator: A. World B. Local C. Custom

Space Function
World

(Default) Uses the center of the scene as the origin.

Local

Uses the geometry space for evaluation.

Custom

Use an external matrix as the space for evaluation.

See World space, object space, and local space for descriptions of these spaces.

Attribute Editor options

The Attribute Editor Proximity Pin tab contains extra settings that are not covered in the Connections and Coordinate System sections.

Manage Pins

Attribute Editor: A. Pin Tab, B. Manage Pins menu

Use this menu to manage operations you can apply to pin nodes. Choose from the following actions:
Select Geometry Selects the geometry affected by the UV pin.
Replace Geometry with Selected Switches the pinned geometry with another selected geometry.
Create Pins Creates a new PinOutput node. Select a node (locator/geometry/group, and so on) and the Pin node outputs a pin value, connecting it to the node (depending on the Pin default setting).
Edit Pin Defaults Opens the UV Pin window, where you can set new values for the default pins: Existing Transform, New Transform, New Locator, or Matrix.
Note: It is recommended to use the Attribute Editor Pin Tab while using this menu to keep the current attribute tab displayed when the selection changes.
Envelope
How much transformation to apply. 1.0 is full transformation and 0.0 is no transformation.
Coordinate Mode
Same setting as Mode in the Coordinate System area, above.
Offset Translation
Controls the amount of the original surface offset to use. 1.0 keeps full bind translation offset, and 0.0 forces the object to stay on the surface.
Offset Orientation
Controls the amount of original surface offset to use. A value of 1.0 keeps the full bind orientation offset, and a value of 0.0 uses the orientation derived from the surface.
Normal Override
Set Normal Override to Rail to let you connect the Proximity Pin constraint to Rail Curve geometry.