Class Path

Definition

Namespace:
Tizen.NUI
Assembly:
Tizen.NUI.dll
API Level:
3

A 3D parametric curve.
Paths can be used to animate the position and orientation of actors.

public class Path : BaseHandle, INotifyPropertyChanged, IDynamicResourceHandler, IElement, INameScope, IElementController, IDisposable
Inheritance
Object
Tizen.NUI.Binding.BindableObject
Tizen.NUI.Binding.Element
BaseHandle
Path
Implements
INotifyPropertyChanged
IDisposable

Constructors

View Source

Path()

Creates an initialized path handle.

Declaration
public Path()
API Level: 3

Properties

View Source

ControlPoints

Enumeration for the ControlPoints.

Declaration
public PropertyArray ControlPoints { get; set; }
Property Value
Type Description
PropertyArray
API Level: 3
View Source

Points

Enumeration for the Points.

Declaration
public PropertyArray Points { get; set; }
Property Value
Type Description
PropertyArray
API Level: 3

Methods

View Source

AddControlPoint(Vector3)

Adds a control point.

Declaration
public void AddControlPoint(Vector3 point)
Parameters
Type Name Description
Vector3 point

The new control point to be added.
API Level: 3
View Source

AddPoint(Position)

Adds an interpolation point.

Declaration
public void AddPoint(Position point)
Parameters
Type Name Description
Position point

The new interpolation point to be added.
API Level: 3
View Source

GenerateControlPoints(Single)

Automatic generation of control points. Generated control points which result in a smooth join between the splines of each segment.
The generating algorithm is as follows:
For a given knot point K[N], find the vector that bisects K[N-1],[N] and [N],[N+1].
Calculate the tangent vector by taking the normal of this bisector.
The in control point is the length of the preceding segment back along this bisector multiplied by the curvature.
The out control point is the length of the succeeding segment forward along this bisector multiplied by the curvature.

Declaration
public void GenerateControlPoints(float curvature)
Parameters
Type Name Description
Single curvature

The curvature of the spline. 0 gives straight lines between the knots, negative values means the spline contains loops, positive values up to 0.5 result in a smooth curve, positive values between 0.5 and 1 result in looped curves where the loops are not distinct (i.e., the curve appears to be non-continuous), positive values higher than 1 result in looped curves.
API Level: 3
View Source

GetControlPoint(UInt32)

An accessor for the control points.

Declaration
public Vector3 GetControlPoint(uint index)
Parameters
Type Name Description
UInt32 index

The index of the control point.
Returns
Type Description
Vector3
API Level: 3
View Source

GetPoint(UInt32)

An accessor for the interpolation points.

Declaration
public Vector3 GetPoint(uint index)
Parameters
Type Name Description
UInt32 index

The index of the interpolation point.
Returns
Type Description
Vector3
API Level: 3
View Source

GetPointCount()

Gets the number of interpolation points in the path.

Declaration
public uint GetPointCount()
Returns
Type Description
UInt32

The number of interpolation points in the path.
API Level: 3
View Source

Sample(Single, Vector3, Vector3)

Sample path at a given progress. Calculates the position and tangent at that point of the curve.

Declaration
public void Sample(float progress, Vector3 position, Vector3 tangent)
Parameters
Type Name Description
Single progress

A floating point value between 0.0 and 1.0.
Vector3 position

The interpolated position at that progress.
Vector3 tangent

The interpolated tangent at that progress.
API Level: 3

Implements