Document toolboxDocument toolbox

2023.1.1571.2 DSpline



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.

Static

Make spline static. This means that the spline stops updating itself.

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.

Spline Percentage

The percentage the control point is on the spline.

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 IN Length

The length of the handle from control point to handle 1.

Handle OUT Length

The length of the handle from control point to handle 2.

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

 

  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.

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

 

 

Prespective Documentation