phaser/src/utils/object/GetMinMaxValue.js
2019-01-15 16:20:22 +00:00

33 lines
1.2 KiB
JavaScript

/**
* @author Richard Davey <rich@photonstorm.com>
* @copyright 2019 Photon Storm Ltd.
* @license {@link https://github.com/photonstorm/phaser/blob/master/license.txt|MIT License}
*/
var GetValue = require('./GetValue');
var Clamp = require('../../math/Clamp');
/**
* Retrieves and clamps a numerical value from an object.
*
* @function Phaser.Utils.Objects.GetMinMaxValue
* @since 3.0.0
*
* @param {object} source - The object to retrieve the value from.
* @param {string} key - The name of the property to retrieve from the object. If a property is nested, the names of its preceding properties should be separated by a dot (`.`).
* @param {number} min - The minimum value which can be returned.
* @param {number} max - The maximum value which can be returned.
* @param {number} defaultValue - The value to return if the property doesn't exist. It's also constrained to the given bounds.
*
* @return {number} The clamped value from the `source` object.
*/
var GetMinMaxValue = function (source, key, min, max, defaultValue)
{
if (defaultValue === undefined) { defaultValue = min; }
var value = GetValue(source, key, defaultValue);
return Clamp(value, min, max);
};
module.exports = GetMinMaxValue;