This page has been translated automatically.
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Landscape Tool
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Warning
The scope of applications for UnigineScript is limited to implementing materials-related logic (material expressions, scriptable materials, brush materials). Do not use UnigineScript as a language for application logic, please consider C#/C++ instead, as these APIs are the preferred ones. Availability of new Engine features in UnigineScipt (beyond its scope of applications) is not guaranteed, as the current level of support assumes only fixing critical issues.

This class is used to manage individual segments of the world spline graph.

SplineSegment Class

Members


void setStartPoint ( SplinePoint point ) #

Sets the specified spline point as a start point of the segment.

Arguments

  • SplinePoint point - Spline point to be set as a start point of the segment.

SplinePoint getStartPoint ( ) #

Returns the current start point of the segment.

Return value

Start point of the segment.

void setEndPoint ( SplinePoint point ) #

Sets the specified spline point as an end point of the segment.

Arguments

  • SplinePoint point - Spline point to be set as an end point of the segment.

SplinePoint getEndPoint ( ) #

Returns the current end point of the segment.

Return value

End point of the segment.

void setStartTangent ( vec3 tangent ) #

Sets the tangent coordinates for the start point of the spline segment.

Arguments

  • vec3 tangent - Start point tangent coordinates to be set.

vec3 getStartTangent ( ) #

Returns the current tangent coordinates for the start point of the spline segment.

Return value

Start point tangent coordinates.

void setStartUp ( vec3 up ) #

Sets the "up" vector coordinates for the start point of the segment.

Arguments

  • vec3 up - Start point "up" vector coordinates to be set.

vec3 getStartUp ( ) #

Returns the current "up" vector coordinates for the start point of the spline segment.

Return value

Start point "up" vector coordinates.

void setEndTangent ( vec3 tangent ) #

Sets the tangent coordinates for the end point of the spline segment.

Arguments

  • vec3 tangent - End point tangent coordinates to be set.

vec3 getEndTangent ( ) #

Returns the current tangent coordinates for the end point of the spline segment.

Return value

End point tangent coordinates.

void setEndUp ( vec3 up ) #

Sets the "up" vector coordinates for the end point of the segment.

Arguments

  • vec3 up - End point "up" vector coordinates.

vec3 getEndUp ( ) #

Returns the current "up" vector coordinates for the end point of the spline segment.

Return value

End point "up" vector coordinates to be set.

void setEnabled ( int enable, int with_points = 1 ) #

Sets a value indicating whether the spline segment is enabled.

Arguments

  • int enable - 1 to enable the spline segment, 0 to disable.
  • int with_points - Use 1 to enable all points that belong to it as well, 0 to enable the spline point only.

int isEnabled ( ) #

Returns a value indicating whether the spline segment is enabled.

Return value

1 if the spline segment is enabled; otherwise, 0.

Vec3 calcPoint ( float t ) #

Returns the coordinates of the point at the specified position on the segment.

Arguments

  • float t - Position of the point on the segment, in increments of the segment's length normalized to 1.

Return value

Coordinates of the point.

vec3 calcTangent ( float t ) #

Returns the tangent coordinates for the point at the specified position on the segment.

Arguments

  • float t - Position of the point on the segment, in increments of the segment's length normalized to 1.

Return value

Tangent coordinates for the point at the specified position on the segment.

vec3 calcUpVector ( float t ) #

Returns the "up" vector coordinates for the point at the specified position on the segment.

Arguments

  • float t - Position of the point on the segment, in increments of the segment's length normalized to 1.

Return value

Coordinates of the "up" vector for the point at the specified position on the segment.

float linearToParametric ( float l ) #

Performs conversion of linear position in accordance with the spline segment's length to parametric position.

Arguments

  • float l - Linear position on the spline segment in the range [0.0f, 1.0f].

Return value

Parametric position of the point on the segment, in increments of the segment's length normalized to 1.

float getLength ( ) #

Returns the length of the spline segment.

Return value

Length of the spline segment, in units.

void clearSources ( ) #

Clears the list of source nodes for the spline segment.

void assignSource ( string name, int forward_axis = 0 ) #

Assigns a source node with the given name to the spline segment and sets the specified forward axis for it.

Arguments

  • string name - Source node name.
  • int forward_axis - Forward axis to be set for the source node. One of the FORWARD_ variables. The X axis is used by default.

void removeSource ( string name, int forward_axis = FORWARD_Y ) #

Removes the source node with the given name.

Arguments

  • string name - Name of the source node to be removed.
  • int forward_axis - Forward axis for the source node. One of the FORWARD_ variables. The Y axis is used by default.

void getSources ( ) #

Returns a list of source nodes assigned to the spline segment and puts it to the specified vector.

Arguments

    void setSegmentMode ( string name, int segment_mode = SEGMENT_TILING ) #

    Sets the segment mode for the source node with the given name.

    Arguments

    int getSegmentMode ( string name ) #

    Returns the current segment mode for the source node with the given name.

    Arguments

    Return value

    Mode for the source node with the given name. One of the SEGMENT_* variables. SEGMENT_STRETCH is used by default.

    void setUVTiling ( string name, int enable_uv_tiling = 0 ) #

    Sets a value indicating whether UV tiling for the material textures of the source node with the given name is enabled.

    Arguments

    • string name - Source node name.
    • int enable_uv_tiling - 1 to enable UV tiling for the material textures of the source node, 0 - to stretch textures. The default value is 0.

    int getUVTiling ( string name ) #

    Returns a value indicating whether UV tiling for the material textures of the source node with the given name is enabled.

    Arguments

    Return value

    1 if UV tiling for the material textures of the source node is enabled; otherwise (textures are stretched), 0.

    void setAdaptiveAngleThreshold ( string name, float adaptive_angle_threshold = 1.0f ) #

    Sets the angle threshold value for splitting source node with the given name. If an angle between the tangents for the two subsequent parts of the spline segment exceeds this value, the node will be split.
    Notice
    This parameter is used only for the SEGMENT_ADAPTIVE mode.

    Arguments

    • string name - Source node name.
    • float adaptive_angle_threshold - Angle threshold value for the source node with the given name, in degrees. The default value is 1.0f.

    float getAdaptiveAngleThreshold ( string name ) #

    Returns the current angle threshold value for splitting source node with the given name. If an angle between the tangents for the two subsequent parts of the spline segment exceeds this value, the node will be split.
    Notice
    This parameter is used only for the SEGMENT_ADAPTIVE mode.

    Arguments

    Return value

    Angle threshold value for the source node with the given name, in degrees. The default value is 1.0f.

    void setGap ( string name, float gap = 0.0f ) #

    Sets the size of the gap between the adjacent copies of the source node with the given name tiled along the spline segment.
    Notice
    This parameter is used only for the SEGMENT_TILING mode.

    Arguments

    • string name - Source node name.
    • float gap - Gap size to be set, in units.

    float getGap ( string name ) #

    Returns the current size of the gap between the adjacent copies of the source node with the given name tiled along the spline segment.
    Notice
    This parameter is used only for the SEGMENT_TILING mode.

    Arguments

    Return value

    Current gap size, in units.

    void copy ( const SplineSegment src, int copy_endpoints_data = 1 ) #

    Copies all parameters from the specified source spline segment.

    Arguments

    • const SplineSegment src - Source spline segment.
    • int copy_endpoints_data - Use 1 to copy all parameters of segment's endpoints as well, 0 to use default ones. The default value is 0.

    SplineSegment clone ( int clone_points = 0 ) #

    Returns a clone of the spline segment.

    Arguments

    • int clone_points - Use 1 to copy all parameters of segment's endpoints as well, 0 to use default ones. The default value is 0.

    Return value

    Clone of the spline segment.

    WorldSplineGraph getParent ( ) #

    Returns the WorldSplineGraph node to which the spline segment belongs.

    Return value

    WorldSplineGraph node to which the spline segment belongs.

    int getNumSources ( ) #

    Returns the total number of source nodes assigned to this spline segment.

    Return value

    Total number of source nodes assigned to this spline segment.

    int getNumNodes ( ) #

    Returns the total number of nodes placed along the spline segment.

    Return value

    Total number of nodes placed along the spline segment.

    int getForwardAxis ( string name ) #

    Returns the forward axis used for the source node with the specified name.

    Arguments

    Return value

    Forward axis for the source node. One of the FORWARD_ variables.
    Last update: 2020-07-31
    Build: ()