2023.1.116.1 DSpline

1 Overview
2 Where to Find
3 Feature overview
4 How to use

Overview

This feature lets you draw a Spline in the scene, which is can be used in other Prespective features.

Example of a Spline with three control points.

Where to Find

Create a DSpline on a selected GameObject by selecting Utilities > Add DSpline from the Prespective Menu. If no game object is selected a new GameObject with a DSpline is added to the scene.

By default, a DSpline with two control points will be created in the scene, or added to as a child element to the selected GameObject.

Feature overview

Spline Specifications

Spline Specifications
Spline ID	Unique identifier for this spline.
Close Spline	Make the Spline closed-loop, leave unchecked for end-to-end.
Transform Precision	Set float transforms or double transforms to determine position and rotation (Floating Point, Double).
Spline Length	Displays the current Spline Length in meters.
Maximum Tolerance	not implemented correctly
Reanalyze Tolerance	not implemented correctly
Spline Modifications
Invert Spline	Inverts the spline.
Auto-name Control Points	Used to automatically rename control points from 1 to n (where n is the number of points) if their order in the Hierarchy has changed.
Add/Insert Control Points
Target Control Point	The control point the add/insert is aimed at (Control Point 1….).
Position	Set new control point compared to the target. (After, Before).
Translation Space	Type of space the translation is done in (Local, Global).
Translation	The distance the new control point is translated from its target (x,y,z).
Spline Segment Settings	Default Segment settings define the settings new segments will be created with.
Default Color	Changes the color of a default segment in the scene.
Default Tesselation Angle	The default tessellation per angle difference.
Default Rotation Direction	The default direction the rotation is set to when there is a rotation difference between 2 spline points.
Apply Default To All Segments	Applies default settings to all segments.
Spline Segments
#0: ‘Point[1]' → 'Point[2]’
Color	Changes the color of this segment in the scene.
Tessellation Angle	The tessellation per angle in this segment.
Rotation Direction	The direction the rotation is set to when there is a difference in rotation between 2 spline points in this segment.
Maximum Tolerance	not implemented correctly
Reanalyze Tolerance	not implemented correctly
Scene View Settings
Level of Detail	Define the level of detail.
Control Point Label Mode	Defines the type of labels used for the control points. (none, name only, full info).
Control Point Label Background	Changes the color of the control point labels background.
Control Point Label Text Color	Changes the color of the control point labels text.
Show Normal Line	Whether or not to show the normal line for each point on the spline.
Normal Line Color	Changes the color of the normal line.
Show Forward Line	Whether or not to show the forward line for each point on the spline.
Forward Line Color	Changes the color of the forward line.
Show Right Line	Whether or not to show the right line for each point on the spline.
Right Line Color	Changes the color of the right line.
Show When not Selected	Whether or not show the Spline when it is currently not selected in the hierarchy.
Normal Display Modifier	The distance in units from the spline to the spline normal.

Select one of the Control Points in the Hierarchy to change specific Control Point values.

Control Point Handle Settings

Control Point Handle Settings
Handle Type	NONE: No handles and therefore no curvature; IN_ONLY: A handle for in-direction tangency. Adds curvature in the direction of the previous control point; OUT_ONLY: A handle for out-direction tangency. Adds curvature in the direction of the next control point; CONTINUOUS: A handle for in-, and out-direction tangency. Adds curvature through this control point in the direction of both the previous- and next control point, with the out-direction handle being the inverse of the in-direction handle; BROKEN: A handle for in-, and out-direction tangency. Adds curvature through this control point in the direction of both the previous- and next control point, with the both handles individually definable.
Handle Gizmo	Type of gizmo to control the handles in scene (Free Position)
Handle Space	Sets the space (LOCAL or GLOBAL) in which to set the handle.
Handle In	Incoming handle described from control point.
Handle Out	Outgoing handle described from control point.
Handle Length	The length of the handle from control point.
Handle Limits
Activate Limiting	Constrains the handles to a single plane.
Handle Limit Space	Sets the space (LOCAL or GLOBAL) in which to set the handle limit plane.
Handle OUT	Sets the up-direction of the constraining plane.
Transform Tracking
Active Transform Tracking	not implemented correctly
Track Transform Position	not implemented correctly
Track Transform Rotation	not implemented correctly
Tracking Transform	not implemented correctly
Control Points Rotation Setting
Match Rotation Space	Sets the direction relative to which the control point normal is set. Spline: Determined by making a plane with the control points before and after it. Local: The local up direction of control point. Global: The global up direction. Free: The entire rotation is determined by the control point rotation.
Rotation Offset (Deg)	Sets the rotation (in degrees) of the control point normal relative to the Match up direction.
Leading And Trailing Segment Settings
Leading: Point[1] → Point[2]
Color	Changes the color of this segment in the scene.
Tessellation Angle	The tessellation per angle in this segment.
Rotation Direction	The direction the rotation is set to when there is a rotation difference between 2 spline points in this segment.
Maximum Tolerance	not implemented correctly
Reanalyze Tolerance	not implemented correctly
Scene View Settings
show Normal X axis	Show the Normal X axis of the control point normal.
show Normal Y axis	Show the Normal Y axis of the control point normal.
show Normal Z axis	Show the Normal Z axis of the control point normal.
show Gizmo when not in Selection	Show the control point gizmo when the point is not selected in the hierarchy.
Normal Display Modifier	The distance in units from the spline to the spline normal.
Show Handle Limit Axis	Show the Limiting normal.

How to use

To change the shape of the DSpline, first select one (or more) control points in the scene by dragging a box around them with your cursor, or by directly selecting them in the Hierarchy. Then, you can move them as you would any other object in the scene.
To add curvature to the Spline, select one (or more) control points, and select a Handle Type

Handle Type:

After selecting a handle type, either drag a handle through the scene or manually set a position in the inspector to add curvature to the Spline.