Phaser.Math - 2.3.0

new Math()

A collection of useful mathematical functions.

These are normally accessed through game.math.

Source code: math/Math.js (Line 17)

See

Public Properties

<static> PI2
This method is deprecated and should not be used. It may be removed in the future.

Name	Type	Description
`Phaser.Math#PI2`	number

Public Methods

angleBetween(x1, y1, x2, y2) → {number}

Find the angle of a segment from (x1, y1) -> (x2, y2).

Parameters

Name	Type	Description
`x1`	number
`y1`	number
`x2`	number
`y2`	number

Returns

number -

The angle, in radians.

Source code: math/Math.js (Line 326)

angleBetweenPoints(point1, point2) → {number}

Find the angle of a segment from (point1.x, point1.y) -> (point2.x, point2.y).

Parameters

Name	Type	Description
`point1`	Phaser.Point
`point2`	Phaser.Point

Returns

number -

The angle, in radians.

Source code: math/Math.js (Line 355)

angleBetweenPointsY(point1, point2) → {number}

Find the angle of a segment from (point1.x, point1.y) -> (point2.x, point2.y).

Parameters

Name	Type	Description
`point1`	Phaser.Point
`point2`	Phaser.Point

Returns

number -

The angle, in radians.

Source code: math/Math.js (Line 366)

angleBetweenY(x1, y1, x2, y2) → {number}

Find the angle of a segment from (x1, y1) -> (x2, y2). Note that the difference between this method and Math.angleBetween is that this assumes the y coordinate travels down the screen.

Parameters

Name	Type	Description
`x1`	number
`y1`	number
`x2`	number
`y2`	number

Returns

number -

The angle, in radians.

Source code: math/Math.js (Line 339)

angleLimit(angle, min, max) → {number}

This method is deprecated and should not be used. It may be removed in the future.

Keeps an angle value between the given min and max values.

Parameters

Name	Type	Description
`angle`	number	The angle value to check. Must be between -180 and +180.
`min`	number	The minimum angle that is allowed (must be -180 or greater).
`max`	number	The maximum angle that is allowed (must be 180 or less).

Returns

number -

The new angle value, returns the same as the input angle if it was within bounds

Deprecated:

2.2.0 - Use Phaser.Math#clamp instead

Source code: math/Math.js (Line 737)

average() → {number}

Averages all values passed to the function and returns the result.

Returns

number -

The average of all given values.

Source code: math/Math.js (Line 93)

<internal> bernstein(n, i) → {number}

Parameters

Name	Type	Description
`n`	number
`i`	number

Returns

number -

Internal:

This member is internal (protected) and may be modified or removed in the future.

Source code: math/Math.js (Line 867)

bezierInterpolation(v, k) → {number}

A Bezier Interpolation Method, mostly used by Phaser.Tween.

Parameters

Name	Type	Description
`v`	Array	The input array of values to interpolate between.
`k`	number	The percentage of interpolation, between 0 and 1.

Returns

number -

The interpolated value

Source code: math/Math.js (Line 792)

<internal> catmullRom(p0, p1, p2, p3, t) → {number}

Calculates a catmum rom value.

Parameters

Name	Type	Description
`p0`	number
`p1`	number
`p2`	number
`p3`	number
`t`	number

Returns

number -

Internal:

This member is internal (protected) and may be modified or removed in the future.

Source code: math/Math.js (Line 901)

catmullRomInterpolation(v, k) → {number}

A Catmull Rom Interpolation Method, mostly used by Phaser.Tween.

Parameters

Name	Type	Description
`v`	Array	The input array of values to interpolate between.
`k`	number	The percentage of interpolation, between 0 and 1.

Returns

number -

The interpolated value

Source code: math/Math.js (Line 814)

ceil(value) → {integer}

This method is deprecated and should not be used. It may be removed in the future.

Do not use this function.

Round to the next whole number away from zero.

E.g. ceil(1.3) == 2, and ceil(-2.3) == -3.

Parameters

Name	Type	Description
`value`	number	Any number.

Returns

integer -

The rounded value of that number.

Deprecated:

2.2.0 - Use Phaser.Math#roundAwayFromZero instead.

Source code: math/Math.js (Line 983)

ceilTo(value, place, base) → {number}

Parameters

Name	Type	Description
`value`	number	The value to round.
`place`	number	The place to round to.
`base`	number	The base to round in... default is 10 for decimal.

Returns

number -

Source code: math/Math.js (Line 295)

chanceRoll(chance) → {boolean}

Generate a random bool result based on the chance value.

Returns true or false based on the chance value (default 50%). For example if you wanted a player to have a 30% chance of getting a bonus, call chanceRoll(30) - true means the chance passed, false means it failed.

Parameters

Name	Type	Description
`chance`	number	The chance of receiving the value. A number between 0 and 100 (effectively 0% to 100%).

Returns

boolean -

True if the roll passed, or false otherwise.

Source code: utils/Utils.js (Line 77)

chanceRoll(chance) → {boolean}

This method is deprecated and should not be used. It may be removed in the future.

Generate a random bool result based on the chance value.

Parameters

Name	Type	Description
`chance`	number	The chance of receiving the value. A number between 0 and 100 (effectively 0% to 100%).

Returns

boolean -

True if the roll passed, or false otherwise.

Deprecated:

2.2.0 - Use Phaser.Utils.chanceRoll

Source code: math/Math.js (Line 422)

clamp(x, a, b) → {number}

Force a value within the boundaries by clamping x to the range [a, b].

Parameters

Name	Type	Description
`x`	number
`a`	number
`b`	number

Returns

number -

Source code: math/Math.js (Line 1132)

clampBottom(x, a) → {number}

Clamp x to the range [a, Infinity). Roughly the same as Math.max(x, a), except for NaN handling.

Parameters

Name	Type	Description
`x`	number
`a`	number

Returns

number -

Source code: math/Math.js (Line 1145)

degToRad(degrees) → {number}

Convert degrees to radians.

Parameters

Name	Type	Description
`degrees`	number	Angle in degrees.

Returns

number -

Angle in radians.

Source code: math/Math.js (Line 1261)

difference(a, b) → {number}

The (absolute) difference between two values.

Parameters

Name	Type	Description
`a`	number
`b`	number

Returns

number -

Source code: math/Math.js (Line 921)

distance(x1, y1, x2, y2) → {number}

Returns the euclidian distance between the two given set of coordinates.

Parameters

Name	Type	Description
`x1`	number
`y1`	number
`x2`	number
`y2`	number

Returns

number -

The distance between the two sets of coordinates.

Source code: math/Math.js (Line 1079)

distancePow(x1, y1, x2, y2, pow) → {number}

Returns the distance between the two given set of coordinates at the power given.

Parameters

Name	Type	Argument	Default
`x1`	number
`y1`	number
`x2`	number
`y2`	number
`pow`	number	<optional>	2

Returns

number -

The distance between the two sets of coordinates.

Source code: math/Math.js (Line 1098)

distanceRounded(x1, y1, x2, y2) → {number}

This method is deprecated and should not be used. It may be removed in the future.

Returns the rounded distance between the two given set of coordinates.

Parameters

Name	Type	Description
`x1`	number
`y1`	number
`x2`	number
`y2`	number

Returns

number -

The distance between this Point object and the destination Point object.

Deprecated:

2.2.0 - Do the rounding locally.

Source code: math/Math.js (Line 1117)

factorial(value) → {number}

Parameters

Name	Type	Description
`value`	number	the number you want to evaluate

Returns

number -

Source code: math/Math.js (Line 878)

floor(value) → {integer}

This method is deprecated and should not be used. It may be removed in the future.

Do not use this function.

Round to the next whole number towards zero.

E.g. floor(1.7) == 1, and floor(-2.7) == -2.

Parameters

Name	Type	Description
`value`	number	Any number.

Returns

integer -

The rounded value of that number.

Deprecated:

2.2.0 - Use Phaser.Math#truncate or `Math.trunc` instead.

Source code: math/Math.js (Line 967)

floorTo(value, place, base) → {number}

Parameters

Name	Type	Description
`value`	number	The value to round.
`place`	number	The place to round to.
`base`	number	The base to round in... default is 10 for decimal.

Returns

number -

Source code: math/Math.js (Line 277)

fuzzyCeil(val, epsilon) → {boolean}

Parameters

Name	Type	Argument	Default	Description
`val`	number
`epsilon`	number	<optional>	(small value)

Returns

boolean -

ceiling(val-epsilon)

Source code: math/Math.js (Line 69)

fuzzyEqual(a, b, epsilon) → {boolean}

Two number are fuzzyEqual if their difference is less than epsilon.

Parameters

Name	Type	Argument	Default
`a`	number
`b`	number
`epsilon`	number	<optional>	(small value)

Returns

boolean -

True if | a-b | <epsilon

Source code: math/Math.js (Line 27)

fuzzyFloor(val, epsilon) → {boolean}

Parameters

Name	Type	Argument	Default	Description
`val`	number
`epsilon`	number	<optional>	(small value)

Returns

boolean -

floor(val-epsilon)

Source code: math/Math.js (Line 81)

fuzzyGreaterThan(a, b, epsilon) → {boolean}

a is fuzzyGreaterThan b if it is more than b - epsilon.

Parameters

Name	Type	Argument	Default
`a`	number
`b`	number
`epsilon`	number	<optional>	(small value)

Returns

boolean -

True if a>b+epsilon

Source code: math/Math.js (Line 55)

fuzzyLessThan(a, b, epsilon) → {boolean}

a is fuzzyLessThan b if it is less than b + epsilon.

Parameters

Name	Type	Argument	Default
`a`	number
`b`	number
`epsilon`	number	<optional>	(small value)

Returns

boolean -

True if a<b+epsilon

Source code: math/Math.js (Line 41)

getRandom(objects, startIndex, length) → {object}

This method is deprecated and should not be used. It may be removed in the future.

Fetch a random entry from the given array.

Will return null if there are no array items that fall within the specified range or if there is no item for the randomly choosen index.

Parameters

Name	Type	Description
`objects`	Array.<any>	An array of objects.
`startIndex`	integer	Optional offset off the front of the array. Default value is 0, or the beginning of the array.
`length`	integer	Optional restriction on the number of values you want to randomly select from.

Returns

object -

The random object that was selected.

Deprecated:

2.2.0 - Use Phaser.ArrayUtils.getRandomItem

Source code: math/Math.js (Line 933)

interpolateFloat(a, b, weight) → {number}

This method is deprecated and should not be used. It may be removed in the future.

A one dimensional linear interpolation of a value.

Parameters

Name	Type	Description
`a`	number
`b`	number
`weight`	number

Returns

number -

Deprecated:

2.2.0 - See Phaser.Math#linear

Source code: math/Math.js (Line 313)

isEven(n) → {boolean}

Returns true if the number given is even.

Parameters

Name	Type	Description
`n`	integer	The number to check.

Returns

boolean -

True if the given number is even. False if the given number is odd.

Source code: math/Math.js (Line 587)

isOdd(n) → {boolean}

Returns true if the number given is odd.

Parameters

Name	Type	Description
`n`	integer	The number to check.

Returns

boolean -

True if the given number is odd. False if the given number is even.

Source code: math/Math.js (Line 575)

limitValue(value, min, max) → {number}

This method is deprecated and should not be used. It may be removed in the future.

Ensures the given value is between min and max inclusive.

Parameters

Name	Type	Description
`value`	number	The value to limit.
`min`	number	The minimum the value can be.
`max`	number	The maximum the value can be.

Returns

number -

The limited value.

Deprecated:

2.2.0 - Use Phaser.Math#clamp

Source code: math/Math.js (Line 550)

linear(p0, p1, t) → {number}

Calculates a linear (interpolation) value over t.

Parameters

Name	Type	Description
`p0`	number
`p1`	number
`t`	number

Returns

number -

Source code: math/Math.js (Line 854)

linearInterpolation(v, k) → {number}

A Linear Interpolation Method, mostly used by Phaser.Tween.

Parameters

Name	Type	Description
`v`	Array	The input array of values to interpolate between.
`k`	number	The percentage of interpolation, between 0 and 1.

Returns

number -

The interpolated value

Source code: math/Math.js (Line 764)

mapLinear(x, a1, a2, b1, b2) → {number}

Linear mapping from range to range

Parameters

Name	Type	Description
`x`	number	the value to map
`a1`	number	first endpoint of the range
`a2`	number	final endpoint of the range
`b1`	number	first endpoint of the range
`b2`	number	final endpoint of the range

Returns

number -

Source code: math/Math.js (Line 1172)

max() → {number}

Variation of Math.max that can be passed either an array of numbers or the numbers as parameters.

Prefer the standard Math.max function when appropriate.

Returns

number -

The largest value from those given.

Source code: math/Math.js (Line 631)

See

http://jsperf.com/math-s-min-max-vs-homemade

maxAdd(value, amount, max) → {number}

Adds the given amount to the value, but never lets the value go over the specified maximum.

Parameters

Name	Type	Description
`value`	number	The value to add the amount to.
`amount`	number	The amount to add to the value.
`max`	number	The maximum the value is allowed to be.

Returns

number -

Source code: math/Math.js (Line 470)

maxProperty() → {number}

Variation of Math.max that can be passed a property and either an array of objects or the objects as parameters. It will find the largest matching property value from the given objects.

Returns

number -

The largest value from those given.

Source code: math/Math.js (Line 693)

min() → {number}

Variation of Math.min that can be passed either an array of numbers or the numbers as parameters.

Prefer the standard Math.min function when appropriate.

Returns

number -

The lowest value from those given.

Source code: math/Math.js (Line 599)

See

http://jsperf.com/math-s-min-max-vs-homemade

minProperty() → {number}

Variation of Math.min that can be passed a property and either an array of objects or the objects as parameters. It will find the lowest matching property value from the given objects.

Returns

number -

The lowest value from those given.

Source code: math/Math.js (Line 663)

minSub(value, amount, min) → {number}

Subtracts the given amount from the value, but never lets the value go below the specified minimum.

Parameters

Name	Type	Description
`value`	number	The base value.
`amount`	number	The amount to subtract from the base value.
`min`	number	The minimum the value is allowed to be.

Returns

number -

The new value.

Source code: math/Math.js (Line 483)

normalizeAngle(angleRad) → {number}

Normalizes an angle to the [0,2pi) range.

Parameters

Name	Type	Description
`angleRad`	number	The angle to normalize, in radians.

Returns

number -

Returns the angle, fit within the [0,2pi] range, in radians.

Source code: math/Math.js (Line 387)

normalizeLatitude(lat) → {number}

This method is deprecated and should not be used. It may be removed in the future.

Normalizes a latitude to the [-90,90] range. Latitudes above 90 or below -90 are capped, not wrapped.

Parameters

Name	Type	Description
`lat`	number	The latitude to normalize, in degrees.

Returns

number -

Returns the latitude, fit within the [-90,90] range.

Deprecated:

2.2.0 - Use Phaser.Math#clamp.

Source code: math/Math.js (Line 400)

normalizeLongitude(lng) → {number}

This method is deprecated and should not be used. It may be removed in the future.

Normalizes a longitude to the [-180,180] range. Longitudes above 180 or below -180 are wrapped.

Parameters

Name	Type	Description
`lng`	number	The longitude to normalize, in degrees.

Returns

number -

Returns the longitude, fit within the [-180,180] range.

Deprecated:

2.2.0 - Use Phaser.Math#wrap.

Source code: math/Math.js (Line 411)

numberArray(start, end) → {Array.<number>}

This method is deprecated and should not be used. It may be removed in the future.

Create an array representing the inclusive range of numbers (usually integers) in [start, end].

Parameters

Name	Type	Description
`start`	number	The minimum value the array starts with.
`end`	number	The maximum value the array contains.

Returns

Array.<number> -

The array of number values.

Deprecated:

2.2.0 - See Phaser.ArrayUtils.numberArray

Source code: math/Math.js (Line 437)

numberArrayStep(start, end, step) → {Array}

This method is deprecated and should not be used. It may be removed in the future.

Create an array of numbers (positive and/or negative) progressing from start up to but not including end by advancing by step.

If start is less than stop a zero-length range is created unless a negative step is specified.

Certain values for start and end (eg. NaN/undefined/null) are coerced to 0; for forward compatibility make sure to pass in actual numbers.

Parameters

Name	Type	Argument	Default	Description
`start`	number			The start of the range.
`end`	number			The end of the range.
`step`	number	<optional>	1	The value to increment or decrement by.

Returns

Array -

Returns the new array of numbers.

Deprecated:

2.2.0 - See Phaser.ArrayUtils.numberArrayStep

Source code: math/Math.js (Line 450)

percent(a, b, base) → {number}

Work out what percentage value a is of value b using the given base.

Parameters

Name	Type	Argument	Default	Description
`a`	number			The value to work out the percentage for.
`b`	number			The value you wish to get the percentage of.
`base`	number	<optional>	0	The base value.

Returns

number -

The percentage a is of b, between 0 and 1.

Source code: math/Math.js (Line 1228)

radToDeg(radians) → {number}

Convert degrees to radians.

Parameters

Name	Type	Description
`radians`	number	Angle in radians.

Returns

number -

Angle in degrees

Source code: math/Math.js (Line 1272)

randomSign() → {number}

This method is deprecated and should not be used. It may be removed in the future.

Randomly returns either a 1 or -1.

Returns

number -

Either 1 or -1

Deprecated:

2.2.0 - Use Phaser.Utils.randomChoice or other

Source code: math/Math.js (Line 564)

removeRandom(objects, startIndex, length) → {object}

This method is deprecated and should not be used. It may be removed in the future.

Removes a random object from the given array and returns it.

Will return null if there are no array items that fall within the specified range or if there is no item for the randomly choosen index.

Parameters

Name	Type	Description
`objects`	Array.<any>	An array of objects.
`startIndex`	integer	Optional offset off the front of the array. Default value is 0, or the beginning of the array.
`length`	integer	Optional restriction on the number of values you want to randomly select from.

Returns

object -

The random object that was removed.

Deprecated:

2.2.0 - Use Phaser.ArrayUtils.removeRandomItem

Source code: math/Math.js (Line 950)

reverseAngle(angleRad) → {number}

Reverses an angle.

Parameters

Name	Type	Description
`angleRad`	number	The angle to reverse, in radians.

Returns

number -

Returns the reverse angle, in radians.

Source code: math/Math.js (Line 377)

roundAwayFromZero(value) → {integer}

Round to the next whole number away from zero.

Parameters

Name	Type	Description
`value`	number	Any number.

Returns

integer -

The rounded value of that number.

Source code: math/Math.js (Line 999)

roundTo(value, place, base) → {number}

Round to some place comparative to a base, default is 10 for decimal place. The place is represented by the power applied to base to get that place.

e.g. 2000/7 ~= 285.714285714285714285714 ~= (bin)100011101.1011011011011011

roundTo(2000/7,3) === 0
roundTo(2000/7,2) == 300
roundTo(2000/7,1) == 290
roundTo(2000/7,0) == 286
roundTo(2000/7,-1) == 285.7
roundTo(2000/7,-2) == 285.71
roundTo(2000/7,-3) == 285.714
roundTo(2000/7,-4) == 285.7143
roundTo(2000/7,-5) == 285.71429

roundTo(2000/7,3,2)  == 288       -- 100100000
roundTo(2000/7,2,2)  == 284       -- 100011100
roundTo(2000/7,1,2)  == 286       -- 100011110
roundTo(2000/7,0,2)  == 286       -- 100011110
roundTo(2000/7,-1,2) == 285.5     -- 100011101.1
roundTo(2000/7,-2,2) == 285.75    -- 100011101.11
roundTo(2000/7,-3,2) == 285.75    -- 100011101.11
roundTo(2000/7,-4,2) == 285.6875  -- 100011101.1011
roundTo(2000/7,-5,2) == 285.71875 -- 100011101.10111

Note what occurs when we round to the 3rd space (8ths place), 100100000, this is to be assumed because we are rounding 100011.1011011011011011 which rounds up.

Parameters

Name	Type	Description
`value`	number	The value to round.
`place`	number	The place to round to.
`base`	number	The base to round in... default is 10 for decimal.

Returns

number -

Source code: math/Math.js (Line 231)

shear(n) → {number}

Parameters

Name	Type	Description
`n`	number

Returns

number -

n mod 1

Source code: math/Math.js (Line 122)

shift(array) → {any}

This method is deprecated and should not be used. It may be removed in the future.

Moves the element from the start of the array to the end, shifting all items in the process.

Parameters

Name	Type	Description
`array`	Array.<any>	The array to shift/rotate. The array is modified.

Returns

any -

The shifted value.

Deprecated:

2.2.0 - Use Phaser.ArrayUtils.rotate instead

Source code: math/Math.js (Line 1051)

shuffleArray(array) → {Array.<any>}

This method is deprecated and should not be used. It may be removed in the future.

Shuffles the data in the given array into a new order.

Parameters

Name	Type	Description
`array`	Array.<any>	The array to shuffle

Returns

Array.<any> -

The array

Deprecated:

2.2.0 - Use Phaser.ArrayUtils.shuffle

Source code: math/Math.js (Line 1068)

sign(x) → {integer}

A value representing the sign of the value: -1 for negative, +1 for positive, 0 if value is 0.

This works differently from Math.sign for values of NaN and -0, etc.

Parameters

Name	Type	Description
`x`	number

Returns

integer -

An integer in {-1, 0, 1}

Source code: math/Math.js (Line 1215)

sinCosGenerator(length, sinAmplitude, cosAmplitude, frequency) → {Object}

Generate a sine and cosine table simultaneously and extremely quickly. The parameters allow you to specify the length, amplitude and frequency of the wave. This generator is fast enough to be used in real-time. Code based on research by Franky of scene.at

Parameters

Name	Type	Description
`length`	number	The length of the wave
`sinAmplitude`	number	The amplitude to apply to the sine table (default 1.0) if you need values between say -+ 125 then give 125 as the value
`cosAmplitude`	number	The amplitude to apply to the cosine table (default 1.0) if you need values between say -+ 125 then give 125 as the value
`frequency`	number	The frequency of the sine and cosine table data

Returns

Object -

Returns the table data.

Source code: math/Math.js (Line 1011)

smootherstep(x, min, max) → {number}

Smootherstep function as detailed at http://en.wikipedia.org/wiki/Smoothstep

Parameters

Name	Type	Description
`x`	number
`min`	number
`max`	number

Returns

number -

Source code: math/Math.js (Line 1201)

smoothstep(x, min, max) → {number}

Smoothstep function as detailed at http://en.wikipedia.org/wiki/Smoothstep

Parameters

Name	Type	Description
`x`	number
`min`	number
`max`	number

Returns

number -

Source code: math/Math.js (Line 1187)

snapTo(input, gap, start) → {number}

Snap a value to nearest grid slice, using rounding.

Example: if you have an interval gap of 5 and a position of 12... you will snap to 10 whereas 14 will snap to 15.

Parameters

Name	Type	Argument	Description
`input`	number		The value to snap.
`gap`	number		The interval gap of the grid.
`start`	number	<optional>	Optional starting offset for gap.

Returns

number -

Source code: math/Math.js (Line 131)

snapToCeil(input, gap, start) → {number}

Snap a value to nearest grid slice, using ceil.

Example: if you have an interval gap of 5 and a position of 12... you will snap to 15. As will 14 will snap to 15... but 16 will snap to 20.

Parameters

Name	Type	Argument	Description
`input`	number		The value to snap.
`gap`	number		The interval gap of the grid.
`start`	number	<optional>	Optional starting offset for gap.

Returns

number -

Source code: math/Math.js (Line 183)

snapToFloor(input, gap, start) → {number}

Snap a value to nearest grid slice, using floor.

Example: if you have an interval gap of 5 and a position of 12... you will snap to 10. As will 14 snap to 10... but 16 will snap to 15

Parameters

Name	Type	Argument	Description
`input`	number		The value to snap.
`gap`	number		The interval gap of the grid.
`start`	number	<optional>	Optional starting offset for gap.

Returns

number -

Source code: math/Math.js (Line 157)

snapToInArray(input, arr, sort) → {number}

This method is deprecated and should not be used. It may be removed in the future.

Snaps a value to the nearest value in an array.

Parameters

Name	Type	Description
`input`	number
`arr`	Array.<number>
`sort`	boolean	True if the array needs to be sorted.

Returns

number -

Deprecated:

2.2.0 - See Phaser.ArrayUtils.findClosest for an alternative.

Source code: math/Math.js (Line 209)

truncate(n) → {integer}

This method is deprecated and should not be used. It may be removed in the future.

Parameters

Name	Type	Description
`n`	number

Returns

integer -

Deprecated:

2.2.0 - Use `Math.trunc` (now with polyfill)

Source code: math/Math.js (Line 112)

within(a, b, tolerance) → {boolean}

Checks if two values are within the given tolerance of each other.

Parameters

Name	Type	Description
`a`	number	The first number to check
`b`	number	The second number to check
`tolerance`	number	The tolerance. Anything equal to or less than this is considered within the range.

Returns

boolean -

True if a is <= tolerance of b.

Source code: math/Math.js (Line 1158)

See

Phaser.Math.fuzzyEqual

wrap(value, min, max) → {number}

Ensures that the value always stays between min and max, by wrapping the value around.

If max is not larger than min the result is 0.

Parameters

Name	Type	Description
`value`	number	The value to wrap.
`min`	number	The minimum the value is allowed to be.
`max`	number	The maximum the value is allowed to be, should be larger than `min`.

Returns

number -

The wrapped value.

Source code: math/Math.js (Line 496)

wrapAngle(angle, radians) → {number}

Keeps an angle value between -180 and +180; or -PI and PI if radians.

Parameters

Name	Type	Argument	Default	Description
`angle`	number			The angle value to wrap
`radians`	boolean	<optional>	false	Set to `true` if the angle is given in radians, otherwise degrees is expected.

Returns

number -

The new angle value; will be the same as the input angle if it was within bounds.

Source code: math/Math.js (Line 723)

wrapValue(value, amount, max) → {number}

Adds value to amount and ensures that the result always stays between 0 and max, by wrapping the value around.

Values must be positive integers, and are passed through Math.abs. See Phaser.Math#wrap for an alternative.

Parameters

Name	Type	Description
`value`	number	The value to add the amount to.
`amount`	number	The amount to add to the value.
`max`	number	The maximum the value is allowed to be.

Returns

number -

The wrapped value.

Source code: math/Math.js (Line 527)

Navigation

Constructor

new Math()

Public Properties

<static> PI2

Properties:

Public Methods

angleBetween(x1, y1, x2, y2) → {number}

Parameters

Returns

angleBetweenPoints(point1, point2) → {number}

Parameters

Returns

angleBetweenPointsY(point1, point2) → {number}

Parameters

Returns

angleBetweenY(x1, y1, x2, y2) → {number}

Parameters

Returns

angleLimit(angle, min, max) → {number}

Parameters

Returns

average() → {number}

Returns

<internal> bernstein(n, i) → {number}

Parameters

Returns

bezierInterpolation(v, k) → {number}

Parameters

Returns

<internal> catmullRom(p0, p1, p2, p3, t) → {number}

Parameters

Returns

catmullRomInterpolation(v, k) → {number}

Parameters

Returns

ceil(value) → {integer}

Parameters

Returns

ceilTo(value, place, base) → {number}

Parameters

Returns

chanceRoll(chance) → {boolean}

Parameters

Returns

chanceRoll(chance) → {boolean}

Parameters

Returns

clamp(x, a, b) → {number}

Parameters

Returns

clampBottom(x, a) → {number}

Parameters

Returns

degToRad(degrees) → {number}

Parameters

Returns

difference(a, b) → {number}

Parameters

Returns

distance(x1, y1, x2, y2) → {number}

Parameters

Returns

distancePow(x1, y1, x2, y2, pow) → {number}

Parameters

Returns

distanceRounded(x1, y1, x2, y2) → {number}

Parameters

Returns

factorial(value) → {number}

Parameters

Returns

floor(value) → {integer}

Parameters

Returns

floorTo(value, place, base) → {number}

Parameters

Returns

fuzzyCeil(val, epsilon) → {boolean}

Parameters