Class LineCurve3

A curve representing a 3d line segment.

Hierarchy

  • Curve<Vector3>
    • LineCurve3

Constructors

constructor

Properties

arcLengthDivisions isArcCurve isCatmullRomCurve3 isCubicBezierCurve isCubicBezierCurve3 isEllipseCurve isLineCurve isLineCurve3 isQuadraticBezierCurve isQuadraticBezierCurve3 isSplineCurve type v1 v2

Methods

clone computeFrenetFrames copy fromJSON getLength getLengths getPoint getPointAt getPoints getSpacedPoints getTangent getTangentAt getUtoTmapping toJSON updateArcLengths

Constructors

constructor

Properties

arcLengthDivisions

arcLengthDivisions: number

Determines the amount of divisions when calculating the cumulative segment lengths of a curve via .getLengths. To ensure precision when using methods like .getSpacedPoints, it is recommended to increase .arcLengthDivisions if the curve is very large.

Default

200

Readonly isArcCurve

isArcCurve: boolean

subclass should override

Default Value

false

Readonly isCatmullRomCurve3

isCatmullRomCurve3: boolean

subclass should override

Default Value

true

Readonly isCubicBezierCurve

isCubicBezierCurve: boolean

subclass should override

Default Value

false

Readonly isCubicBezierCurve3

isCubicBezierCurve3: boolean

subclass should override

Default Value

false

Readonly isEllipseCurve

isEllipseCurve: boolean

subclass should override

Default Value

false

Readonly isLineCurve

isLineCurve: boolean

subclass should override

Default Value

false

Readonly isLineCurve3

isLineCurve3: boolean

Default Value

true

Readonly isQuadraticBezierCurve

isQuadraticBezierCurve: boolean

subclass should override

Default Value

false

Readonly isQuadraticBezierCurve3

isQuadraticBezierCurve3: boolean

subclass should override

Default Value

false

Readonly isSplineCurve

isSplineCurve: boolean

subclass should override

Default Value

false

Readonly type

type: string

The print name of the LineCurve3.

Default Value

'LineCurve3'

v1

v1: Vector3

The start point.

v2

v2: Vector3

The end point.

Methods

clone

  • Creates a new instance with same property values as this curve.

    Returns

    A new Curve instance exactly like this curve.

    Returns Curve<Vector3>

computeFrenetFrames

  • Generates the Frenet frames. Learn more at http://www.cs.indiana.edu/pub/techreports/TR425.pdf

    Returns

    An object with shape: { tangents: Vector3[]; normals: Vector3[]; binormals: Vector3[]; }

    Parameters

    • segments: number

      Number of segments

    • Optional closed: boolean

      True if this curve is closed.

    Returns { binormals: Vector3[]; normals: Vector3[]; tangents: Vector3[] }

    • binormals: Vector3[]
    • normals: Vector3[]
    • tangents: Vector3[]

copy

fromJSON

getLength

getLengths

  • Get list of cumulative segment lengths.

    Returns

    Array of points

    Parameters

    • Optional divisions: number

    Returns number[]

getPoint

  • Find the point (vector) for point t of the curve where t is between 0 and 1.

    Returns

    The point.

    Parameters

    • t: number

      A position on the curve. Must be in the range [ 0, 1 ].

    • Optional optionalTarget: Vector3

      (optional) If specified, the result will be copied into this Vector, otherwise a new Vector will be created.

    Returns Vector3

getPointAt

  • Find a vector for point at relative position in curve according to arc length

    Returns

    The point.

    Parameters

    • u: number

      A position on the curve according to the arc length. Must be in the range [ 0, 1 ].

    • Optional optionalTarget: Vector3

      (optional) If specified, the result will be copied into this Vector, otherwise a new Vector will be created.

    Returns Vector3

getPoints

  • Compute a set of divisions + 1 points using getPoint( t ).

    Returns

    Array of point vectors.

    Parameters

    • Optional divisions: number

      number of pieces to divide the curve into. Default is 5.

    Returns Vector3[]

getSpacedPoints

  • Compute a set of divisions + 1 equi-spaced points using getPointAt( u ).

    Returns

    Array of point vectors.

    Parameters

    • Optional divisions: number

      number of pieces to divide the curve into. Default is 5.

    Returns Vector3[]

getTangent

  • Compute a unit vector tangent at t. If the subclassed curve do not implement its tangent derivation, 2 points a small delta apart will be used to find its gradient which seems to give a reasonable approximation getTangent(t: number, optionalTarget?: T): T;

    Returns

    A vector tangent to t.

    Parameters

    • t: number

      A position on the curve. Must be in the range [ 0, 1 ].

    • Optional optionalTarget: Vector3

      — (optional) If specified, the result will be copied into this Vector, otherwise a new Vector will be created.

    Returns Vector3

getTangentAt

  • Compute the tangent at a point which is equidistant to the ends of the curve from the point given in getTangent().

    Returns

    a vector tangent to u.

    Parameters

    • u: number

      A position on the curve according to the arc length. Must be in the range [ 0, 1 ].

    • Optional optionalTarget: Vector3

      (optional) If specified, the result will be copied into this Vector, otherwise a new Vector will be created.

    Returns Vector3

getUtoTmapping

  • Given u ( 0 .. 1 ), get a t to find p. This gives you points which are equi distance

    Parameters

    • u: number
    • distance: number

    Returns number

toJSON

  • Create a JSON object representation of this instance.

    Returns

    A JSON object

    Returns object

updateArcLengths

Settings

Member Visibility

Theme