Point Connector

The Point Connector component defines a position and orientation at which an entity can be connected to another point or curve connector.

Point connectors are useful for fixed mounting interfaces, such as attaching an industrial robot to a pedestal, mounting a gripper on a robot flange or connecting the end of one conveyor to the beginning of another. For more information, please see the API documentation.

Properties

The point connector component properties that are accessible through the inspector.

Position

The position of the connector in the local space of the entity.

Rotation

The rotation of the connector in the local space of the entity.

Tag

The tag assigned to the connector. For example, a robot pedestal could use robot.pedestal or a robot flange could use robot.flange. Please see the built-in connector tags that you can use. You may also create a tag provided that it has a unique name. Using a name before the . can be used to categorize the tag.

Targets

The tags that this point connector can snap to. For example, the connector on the base of a robot could target the robot.pedestal tag.

Snap Mode

The snap mode controls which parts of the connector pose are aligned. The Position, X Axis, Y Axis and Z axis can be enabled independently. A mode is only applied when it is enabled on both connectors.

Snap Entity

The optional entity that should be reparented when a connection is created. Reparenting only occurs when both connectors have a snap entity set.

Snap Radius

The screen-space radius used for interactive snapping, measured in viewport pixels. A connection is created if the distance between the two connectors is less than the snap radius.

Snap Angle

The maximum angular difference for snapping axes, measured in radians. For a connection to be created, the angle between the axes of each connector must be less than the snap angle.

Scripting

The underlying PointConnector is available through the connector property on the component. For example, a source point connector can be snapped to a target point connector using:

world.connectors.snapPointPoint(source, target);