new Utils()
- Source - utils/Utils.js, line 11
Classes
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 - 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 - 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 - 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 - 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
orset
functions are created as properties viadefineProperty
except if they also define aclone
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 - 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 - 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 - 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 returnTS025 iratA
.Parameters:
Name Type Description string
string The string to be reversed.
Returns:
string -The reversed string.
- Source - 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 - 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 - 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 - utils/Utils.js, line 106