Document toolboxDocument toolbox

2021.1.1208.2 Double Spline



Overview

This feature lets you draw a Spline in the scene, which is required in various other Prespective features.

Example of a Spline with three control points.


Where to Find

Create a DSpline by selecting Utilities > Add DSpline from the Prespective Menu

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

If using 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 (front is back/ back is front)

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

If new control point is set compared to the target (After, Before).

Translation Space

With type of space the translation is done is (Local, Global).

Translation

The amount the new control point is translated from its target.

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 done over when have 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 done in this segment.

Rotation Direction

The direction the rotation is done over when have rotation difference between 2 spline points in this segment.

Maximum Tolerance

not implemented correctly

Reanalyze Tolerance

not implemented correctly

Scene View Settings

 

Level of Detail

How much level of detail the spline is drawn in the scene.

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 that describes the normal for every 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 that describes the forward for every 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 that describes the right for every 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 indivudually 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 (so also forward and right)

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 done in this segment.

Rotation Direction

The direction the rotation is done over when have 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

 

  1. 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.

 

  1. To add curvature to the Spline, select one (or more) control points, and select a

Handle Type:

  1.  

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.

 

 

Prespective Documentation