Ellipse

Phaser.Curves.Ellipse

An Elliptical Curve derived from the Base Curve class.

See https://en.wikipedia.org/wiki/Elliptic_curve for more details.

Constructor

new Ellipse([x], [y], [xRadius], [yRadius], [startAngle], [endAngle], [clockwise], [rotation])

Parameters

name

type

optional

default

description

x

number | Phaser.Types.Curves.EllipseCurveConfig

Yes

0

The x coordinate of the ellipse, or an Ellipse Curve configuration object.

y

number

Yes

0

The y coordinate of the ellipse.

xRadius

number

Yes

0

The horizontal radius of ellipse.

yRadius

number

Yes

0

The vertical radius of ellipse.

startAngle

number

Yes

0

The start angle of the ellipse, in degrees.

endAngle

number

Yes

360

The end angle of the ellipse, in degrees.

clockwise

boolean

Yes

false

Whether the ellipse angles are given as clockwise (true) or counter-clockwise (false).

rotation

number

Yes

0

The rotation of the ellipse, in degrees.


Scope: static

Extends

Phaser.Curves.Curve

Source: src/curves/EllipseCurve.js#L16
Since: 3.0.0

Public Members

active

active: boolean

Description:

For a curve on a Path, false means the Path will ignore this curve.

Inherits: Phaser.Curves.Curve#active

Source: src/curves/Curve.js#L80
Since: 3.0.0


angle

angle: number

Description:

The rotation of the ellipse, relative to the center, in degrees.

Source: src/curves/EllipseCurve.js#L536
Since: 3.14.0


arcLengthDivisions

arcLengthDivisions: number

Description:

The quantity of arc length divisions within the curve.

Inherits: Phaser.Curves.Curve#arcLengthDivisions

Source: src/curves/Curve.js#L50
Since: 3.0.0


cacheArcLengths

cacheArcLengths: Array.<number>

Description:

An array of cached arc length values.

Inherits: Phaser.Curves.Curve#cacheArcLengths

Source: src/curves/Curve.js#L60
Since: 3.0.0


clockwise

clockwise: boolean

Description:

true if the ellipse rotation is clockwise or false if anti-clockwise.

Source: src/curves/EllipseCurve.js#L515
Since: 3.0.0


defaultDivisions

defaultDivisions: number

Description:

The default number of divisions within the curve.

Inherits: Phaser.Curves.Curve#defaultDivisions

Source: src/curves/Curve.js#L40
Since: 3.0.0


endAngle

endAngle: number

Description:

The end angle of the ellipse in degrees.

Source: src/curves/EllipseCurve.js#L494
Since: 3.0.0


needsUpdate

needsUpdate: boolean

Description:

Does the data of this curve need updating?

Inherits: Phaser.Curves.Curve#needsUpdate

Source: src/curves/Curve.js#L70
Since: 3.0.0


p0

p0: Phaser.Math.Vector2

Description:

The center point of the ellipse. Used for calculating rotation.

Source: src/curves/EllipseCurve.js#L71
Since: 3.0.0


rotation

rotation: number

Description:

The rotation of the ellipse, relative to the center, in radians.

Source: src/curves/EllipseCurve.js#L557
Since: 3.0.0


startAngle

startAngle: number

Description:

The start angle of the ellipse in degrees.

Source: src/curves/EllipseCurve.js#L473
Since: 3.0.0


type

type: string

Description:

String based identifier for the type of curve.

Inherits: Phaser.Curves.Curve#type

Source: src/curves/Curve.js#L31
Since: 3.0.0


x

x: number

Description:

The x coordinate of the center of the ellipse.

Source: src/curves/EllipseCurve.js#L389
Since: 3.0.0


xRadius

xRadius: number

Description:

The horizontal radius of the ellipse.

Source: src/curves/EllipseCurve.js#L431
Since: 3.0.0


y

y: number

Description:

The y coordinate of the center of the ellipse.

Source: src/curves/EllipseCurve.js#L410
Since: 3.0.0


yRadius

yRadius: number

Description:

The vertical radius of the ellipse.

Source: src/curves/EllipseCurve.js#L452
Since: 3.0.0


Private Members

_clockwise

_clockwise: boolean

Description:

Anti-clockwise direction.

Access: private

Source: src/curves/EllipseCurve.js#L122
Since: 3.0.0


_endAngle

_endAngle: number

Description:

The end angle of the ellipse in radians.

Access: private

Source: src/curves/EllipseCurve.js#L112
Since: 3.0.0


_rotation

_rotation: number

Description:

The rotation of the arc.

Access: private

Source: src/curves/EllipseCurve.js#L132
Since: 3.0.0


_startAngle

_startAngle: number

Description:

The starting angle of the ellipse in radians.

Access: private

Source: src/curves/EllipseCurve.js#L102
Since: 3.0.0


_tmpVec2A

_tmpVec2A: Phaser.Math.Vector2

Description:

A temporary calculation Vector.

Access: private

Inherits: Phaser.Curves.Curve#_tmpVec2A

Source: src/curves/Curve.js#L90
Since: 3.0.0


_tmpVec2B

_tmpVec2B: Phaser.Math.Vector2

Description:

A temporary calculation Vector.

Access: private

Inherits: Phaser.Curves.Curve#_tmpVec2B

Source: src/curves/Curve.js#L100
Since: 3.0.0


_xRadius

_xRadius: number

Description:

The horizontal radius of the ellipse.

Access: private

Source: src/curves/EllipseCurve.js#L80
Since: 3.0.0


_yRadius

_yRadius: number

Description:

The vertical radius of the ellipse.

Access: private

Source: src/curves/EllipseCurve.js#L90
Since: 3.0.0


Public Methods

draw

<instance> draw(graphics, [pointsTotal])

Description:

Draws this curve on the given Graphics object.

The curve is drawn using Graphics.strokePoints so will be drawn at whatever the present Graphics stroke color is. The Graphics object is not cleared before the draw, so the curve will appear on-top of anything else already rendered to it.

Tags:

  • generic

Parameters:

name

type

optional

default

description

graphics

Phaser.GameObjects.Graphics

No

The Graphics instance onto which this curve will be drawn.

pointsTotal

number

Yes

32

The resolution of the curve. The higher the value the smoother it will render, at the cost of rendering performance.

Returns: Phaser.GameObjects.Graphics - The Graphics object to which the curve was drawn.

Inherits: Phaser.Curves.Curve#draw

Source: src/curves/Curve.js#L111
Since: 3.0.0


fromJSON

<static> fromJSON(data)

Description:

Creates a curve from the provided Ellipse Curve Configuration object.

Parameters:

name

type

optional

description

data

Phaser.Types.Curves.JSONEllipseCurve

No

The JSON object containing this curve data.

Returns: Phaser.Curves.Ellipse - The ellipse curve constructed from the configuration object.

Source: src/curves/EllipseCurve.js#L603
Since: 3.0.0


getBounds

<instance> getBounds([out], [accuracy])

Description:

Returns a Rectangle where the position and dimensions match the bounds of this Curve.

You can control the accuracy of the bounds. The value given is used to work out how many points to plot across the curve. Higher values are more accurate at the cost of calculation speed.

Parameters:

name

type

optional

default

description

out

Phaser.Geom.Rectangle

Yes

The Rectangle to store the bounds in. If falsey a new object will be created.

accuracy

number

Yes

16

The accuracy of the bounds calculations.

Returns: Phaser.Geom.Rectangle - A Rectangle object holding the bounds of this curve. If out was given it will be this object.

Inherits: Phaser.Curves.Curve#getBounds

Source: src/curves/Curve.js#L135
Since: 3.0.0


getDistancePoints

<instance> getDistancePoints(distance)

Description:

Returns an array of points, spaced out X distance pixels apart. The smaller the distance, the larger the array will be.

Parameters:

name

type

optional

description

distance

number

No

The distance, in pixels, between each point along the curve.

Returns: Array.<Phaser.Geom.Point> - An Array of Point objects.

Inherits: Phaser.Curves.Curve#getDistancePoints

Source: src/curves/Curve.js#L169
Since: 3.0.0


getEndPoint

<instance> getEndPoint([out])

Description:

Get a point at the end of the curve.

Parameters:

name

type

optional

description

out

Phaser.Math.Vector2

Yes

Optional Vector object to store the result in.

Returns: Phaser.Math.Vector2 - Vector2 containing the coordinates of the curves end point.

Inherits: Phaser.Curves.Curve#getEndPoint

Source: src/curves/Curve.js#L189
Since: 3.0.0


getLength

<instance> getLength()

Description:

Get total curve arc length

Returns: number - The total length of the curve.

Inherits: Phaser.Curves.Curve#getLength

Source: src/curves/Curve.js#L206
Since: 3.0.0


getLengths

<instance> getLengths([divisions])

Description:

Get a list of cumulative segment lengths.

These lengths are

  • [0] 0
  • [1] The first segment
  • [2] The first and second segment
  • ...
  • [divisions] All segments

Parameters:

name

type

optional

description

divisions

number

Yes

The number of divisions or segments.

Returns: Array.<number> - An array of cumulative lengths.

Inherits: Phaser.Curves.Curve#getLengths

Source: src/curves/Curve.js#L222
Since: 3.0.0


getPoint

<instance> getPoint(t, [out])

Description:

Get point at relative position in curve according to length.

Tags:

  • generic

Parameters:

name

type

optional

description

t

number

No

The position along the curve to return. Where 0 is the start and 1 is the end.

out

Phaser.Math.Vector2

Yes

A Vector2 object to store the result in. If not given will be created.

Returns: Phaser.Math.Vector2 - The coordinates of the point on the curve. If an out object was given this will be returned.

Source: src/curves/EllipseCurve.js#L177
Since: 3.0.0


getPointAt

<instance> getPointAt(u, [out])

Description:

Get a point at a relative position on the curve, by arc length.

Tags:

  • generic

Parameters:

name

type

optional

description

u

number

No

The relative position, [0..1].

out

Phaser.Math.Vector2

Yes

A point to store the result in.

Returns: Phaser.Math.Vector2 - The point.

Inherits: Phaser.Curves.Curve#getPointAt

Source: src/curves/Curve.js#L278
Since: 3.0.0


getPoints

<instance> getPoints([divisions], [stepRate], [out])

Description:

Get a sequence of evenly spaced points from the curve.

You can pass divisions, stepRate, or neither.

The number of divisions will be

  1. divisions, if divisions > 0; or
  2. this.getLength / stepRate, if stepRate > 0; or
  3. this.defaultDivisions

1 + divisions points will be returned.

Tags:

  • generic

Parameters:

name

type

optional

description

divisions

number

Yes

The number of divisions to make.

stepRate

number

Yes

The curve distance between points, implying divisions.

out

array | Array.<Phaser.Math.Vector2>

Yes

An optional array to store the points in.

Returns: array, Array.<Phaser.Math.Vector2> - An array of Points from the curve.

Inherits: Phaser.Curves.Curve#getPoints

Source: src/curves/Curve.js#L300
Since: 3.0.0


getRandomPoint

<instance> getRandomPoint([out])

Description:

Get a random point from the curve.

Tags:

  • generic

Parameters:

name

type

optional

description

out

Phaser.Math.Vector2

Yes

A point object to store the result in.

Returns: Phaser.Math.Vector2 - The point.

Inherits: Phaser.Curves.Curve#getRandomPoint

Source: src/curves/Curve.js#L349
Since: 3.0.0


getResolution

<instance> getResolution(divisions)

Description:

Get the resolution of the curve.

Parameters:

name

type

optional

description

divisions

number

No

Optional divisions value.

Returns: number - The curve resolution.

Source: src/curves/EllipseCurve.js#L162
Since: 3.0.0


getSpacedPoints

<instance> getSpacedPoints([divisions], [stepRate], [out])

Description:

Get a sequence of equally spaced points (by arc distance) from the curve.

1 + divisions points will be returned.

Parameters:

name

type

optional

default

description

divisions

number

Yes

"this.defaultDivisions"

The number of divisions to make.

stepRate

number

Yes

Step between points. Used to calculate the number of points to return when divisions is falsy. Ignored if divisions is positive.

out

array | Array.<Phaser.Math.Vector2>

Yes

An optional array to store the points in.

Returns: Array.<Phaser.Math.Vector2> - An array of points.

Inherits: Phaser.Curves.Curve#getSpacedPoints

Source: src/curves/Curve.js#L370
Since: 3.0.0


getStartPoint

<instance> getStartPoint([out])

Description:

Gets the starting point on the curve.

Tags:

  • generic

Parameters:

name

type

optional

description

out

Phaser.Math.Vector2

Yes

A Vector2 object to store the result in. If not given will be created.

Overrides: Phaser.Curves.Curve#getStartPoint

Returns: Phaser.Math.Vector2 - The coordinates of the point on the curve. If an out object was given this will be returned.

Source: src/curves/EllipseCurve.js#L143
Since: 3.0.0


getTangent

<instance> getTangent(t, [out])

Description:

Get a unit vector tangent at a relative position on the curve. In case any sub curve does 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

Tags:

  • generic

Parameters:

name

type

optional

description

t

number

No

The relative position on the curve, [0..1].

out

Phaser.Math.Vector2

Yes

A vector to store the result in.

Returns: Phaser.Math.Vector2 - Vector approximating the tangent line at the point t (delta +/- 0.0001)

Inherits: Phaser.Curves.Curve#getTangent

Source: src/curves/Curve.js#L430
Since: 3.0.0


getTangentAt

<instance> getTangentAt(u, [out])

Description:

Get a unit vector tangent at a relative position on the curve, by arc length.

Tags:

  • generic

Parameters:

name

type

optional

description

u

number

No

The relative position on the curve, [0..1].

out

Phaser.Math.Vector2

Yes

A vector to store the result in.

Returns: Phaser.Math.Vector2 - The tangent vector.

Inherits: Phaser.Curves.Curve#getTangentAt

Source: src/curves/Curve.js#L472
Since: 3.0.0


getTFromDistance

<instance> getTFromDistance(distance, [divisions])

Description:

Given a distance in pixels, get a t to find p.

Parameters:

name

type

optional

description

distance

number

No

The distance, in pixels.

divisions

number

Yes

Optional amount of divisions.

Returns: number - The distance.

Inherits: Phaser.Curves.Curve#getTFromDistance

Source: src/curves/Curve.js#L492
Since: 3.0.0


getUtoTmapping

<instance> getUtoTmapping(u, distance, [divisions])

Description:

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

Parameters:

name

type

optional

description

u

number

No

A float between 0 and 1.

distance

number

No

The distance, in pixels.

divisions

number

Yes

Optional amount of divisions.

Returns: number - The equidistant value.

Inherits: Phaser.Curves.Curve#getUtoTmapping

Source: src/curves/Curve.js#L513
Since: 3.0.0


setClockwise

<instance> setClockwise(value)

Description:

Sets if this curve extends clockwise or anti-clockwise.

Parameters:

name

type

optional

description

value

boolean

No

The clockwise state of this curve.

Returns: Phaser.Curves.Ellipse - This curve object.

Source: src/curves/EllipseCurve.js#L355
Since: 3.0.0


setEndAngle

<instance> setEndAngle(value)

Description:

Sets the end angle of this curve.

Parameters:

name

type

optional

description

value

number

No

The end angle of this curve, in radians.

Returns: Phaser.Curves.Ellipse - This curve object.

Source: src/curves/EllipseCurve.js#L338
Since: 3.0.0


setHeight

<instance> setHeight(value)

Description:

Sets the height of this curve.

Parameters:

name

type

optional

description

value

number

No

The height of this curve.

Returns: Phaser.Curves.Ellipse - This curve object.

Source: src/curves/EllipseCurve.js#L304
Since: 3.0.0


setRotation

<instance> setRotation(value)

Description:

Sets the rotation of this curve.

Parameters:

name

type

optional

description

value

number

No

The rotation of this curve, in radians.

Returns: Phaser.Curves.Ellipse - This curve object.

Source: src/curves/EllipseCurve.js#L372
Since: 3.0.0


setStartAngle

<instance> setStartAngle(value)

Description:

Sets the start angle of this curve.

Parameters:

name

type

optional

description

value

number

No

The start angle of this curve, in radians.

Returns: Phaser.Curves.Ellipse - This curve object.

Source: src/curves/EllipseCurve.js#L321
Since: 3.0.0


setWidth

<instance> setWidth(value)

Description:

Sets the width of this curve.

Parameters:

name

type

optional

description

value

number

No

The width of this curve.

Returns: Phaser.Curves.Ellipse - This curve object.

Source: src/curves/EllipseCurve.js#L287
Since: 3.0.0


setXRadius

<instance> setXRadius(value)

Description:

Sets the horizontal radius of this curve.

Parameters:

name

type

optional

description

value

number

No

The horizontal radius of this curve.

Returns: Phaser.Curves.Ellipse - This curve object.

Source: src/curves/EllipseCurve.js#L253
Since: 3.0.0


setYRadius

<instance> setYRadius(value)

Description:

Sets the vertical radius of this curve.

Parameters:

name

type

optional

description

value

number

No

The vertical radius of this curve.

Returns: Phaser.Curves.Ellipse - This curve object.

Source: src/curves/EllipseCurve.js#L270
Since: 3.0.0


toJSON

<instance> toJSON()

Description:

JSON serialization of the curve.

Returns: Phaser.Types.Curves.JSONEllipseCurve - The JSON object containing this curve data.

Source: src/curves/EllipseCurve.js#L578
Since: 3.0.0


updateArcLengths

<instance> updateArcLengths()

Description:

Calculate and cache the arc lengths.

Inherits: Phaser.Curves.Curve#updateArcLengths

Source: src/curves/Curve.js#L594
Since: 3.0.0


Updated on