Public Methods

<static> extend(deep, target) → {object}

This is a slightly modified version of http://api.jquery.com/jQuery.extend/

Parameters

Name	Type	Description
deep	boolean	Perform a deep copy?
target	object	The target object to copy to.

Returns

object -

The extended object.

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

<static> getProperty(obj, prop) → {*}

Gets an objects property by string.

Parameters

Name	Type	Description
obj	object	The object to traverse.
prop	string	The property whose value will be returned.

Returns

* -

the value of the property or null if property isn't found .

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

<static> isPlainObject(obj) → {boolean}

This is a slightly modified version of jQuery.isPlainObject.
A plain object is an object whose internal class property is [object Object].

Parameters

Name	Type	Description
obj	object	The object to inspect.

Returns

boolean -

• true if the object is plain, otherwise false.

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

<static> mixin(from, to) → {object}

Mixes the source object into the destination object, returning the newly modified destination object.
Based on original code by @mudcube

Parameters

Name	Type	Description
from	object	The object to copy (the source object).
to	object	The object to copy to (the destination object).

Returns

object -

The modified destination object.

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

<static> mixinPrototype(target, mixin, replace)

Mixes in an existing mixin object with the target.

Values in the mixin that have either get or set functions are created as properties via defineProperty
except if they also define a clone method - if a clone method is defined that is called instead and
the result is assigned directly.

Parameters

Name	Type	Argument	Default	Description
target	object			The target object to receive the new functions.
mixin	object			The object to copy the functions from.
replace	boolean	<optional>	false	If the target object already has a matching function should it be overwritten or not?

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

<static> pad(str, len, pad, dir) → {string}

Takes the given string and pads it out, to the length required, using the character
specified. For example if you need a string to be 6 characters long, you can call:

pad('bob', 6, '-', 2)

This would return: bob--- as it has padded it out to 6 characters, using the - on the right.

You can also use it to pad numbers (they are always returned as strings):

pad(512, 6, '0', 1)

Would return: 000512 with the string padded to the left.

If you don't specify a direction it'll pad to both sides:

pad('c64', 7, '*')

Would return: **c64**

Parameters

Name	Type	Argument	Default	Description
str	string			The target string. toString() will be called on the string, which means you can also pass in common data types like numbers.
len	integer	<optional>	0	The number of characters to be added.
pad	string	<optional>	" "	The string to pad it out with (defaults to a space).
dir	integer	<optional>	3	The direction dir = 1 (left), 2 (right), 3 (both).

Returns

string -

The padded string.

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

<static> parseDimension(size, dimension) → {number}

Get a unit dimension from a string.

Parameters

Name	Type	Description
size	string | number	The size to parse.
dimension	number	The window dimension to check.

Returns

number -

The parsed dimension.

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

<static> reverseString(string) → {string}

Takes the given string and reverses it, returning the reversed string.
For example if given the string Atari 520ST it would return TS025 iratA.

Parameters

Name	Type	Description
string	string	The string to be reversed.

Returns

string -

The reversed string.

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

<static> setProperty(obj, prop) → {object}

Sets an objects property by string.

Parameters

Name	Type	Description
obj	object	The object to traverse
prop	string	The property whose value will be changed

Returns

object -

The object on which the property was set.

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

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 91)

randomChoice(choice1, choice2) → {any}

Choose between one of two values randomly.

Parameters

Name	Type	Description
choice1	any
choice2	any

Returns

any -

The randomly selected choice

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