/**
* 返回数据类型
* @param {*} val
* @return {String} 数据类型
*/
function _rt(val) {
return Object.prototype.toString.call(val);
}
/**
* Utils 引擎工具箱
*
* @namespace JC.Utils
*/
export const Utils = {
/**
* 简单拷贝纯数据的JSON对象
*
* @static
* @memberof JC.Utils
* @param {JSON} json 待拷贝的纯数据JSON
* @return {JSON} 拷贝后的纯数据JSON
*/
copyJSON: function(json) {
return JSON.parse(JSON.stringify(json));
},
/**
* 将角度转化成弧度的乘法因子
*
* @static
* @memberof JC.Utils
* @param {number} degree 角度数
* @return {number} 弧度数
*/
DTR(degree) {
return degree * Math.PI / 180;
},
/**
* 将弧度转化成角度的乘法因子
*
* @static
* @memberof JC.Utils
* @param {number} radian 角度数
* @return {number} 弧度数
*/
RTD(radian) {
return radian * 180 / Math.PI;
},
/**
* 判断变量是否为数组类型
*
* @static
* @method
* @memberof JC.Utils
* @param {Array} variable 待判断的变量
* @return {Boolean} 判断的结果
*/
isArray: (function() {
let ks = _rt([]);
return function(variable) {
return _rt(variable) === ks;
};
})(),
/**
* 判断变量是否为对象类型
*
* @static
* @method
* @memberof JC.Utils
* @param {Object} variable 待判断的变量
* @return {Boolean} 判断的结果
*/
isObject: (function() {
let ks = _rt({});
return function(variable) {
return _rt(variable) === ks;
};
})(),
/**
* 判断变量是否为字符串类型
*
* @static
* @method
* @memberof JC.Utils
* @param {String} variable 待判断的变量
* @return {Boolean} 判断的结果
*/
isString: (function() {
let ks = _rt('s');
return function(variable) {
return _rt(variable) === ks;
};
})(),
/**
* 判断变量是否为数字类型
*
* @static
* @method
* @memberof JC.Utils
* @param {Number} variable 待判断的变量
* @return {Boolean} 判断的结果
*/
isNumber: (function() {
let ks = _rt(1);
return function(variable) {
return _rt(variable) === ks;
};
})(),
/**
* 判断变量是否为函数类型
*
* @static
* @method
* @memberof JC.Utils
* @param {Function} variable 待判断的变量
* @return {Boolean} 判断的结果
*/
isFunction: (function() {
let ks = _rt(function() {});
return function(variable) {
return _rt(variable) === ks;
};
})(),
/**
* 判断变量是否为undefined
*
* @static
* @method
* @memberof JC.Utils
* @param {Function} variable 待判断的变量
* @return {Boolean} 判断的结果
*/
isUndefined: function(variable) {
return typeof variable === 'undefined';
},
/**
* 判断变量是否为布尔型
*
* @static
* @method
* @memberof JC.Utils
* @param {Function} variable 待判断的变量
* @return {Boolean} 判断的结果
*/
isBoolean: (function() {
let ks = _rt(true);
return function(variable) {
return _rt(variable) === ks;
};
})(),
/**
* 强化的随机数，可以随机产生给定区间内的数字、随机输出数字内的项
*
* @static
* @method
* @memberof JC.Utils
* @param {Array | Number} min 当只传入一个变量时变量应该为数字，否则为所给定区间较小的数字
* @param {Number} max 所给定区间较大的数字
* @return {ArrayItem | Number} 返回数组中大一项或者给定区间内的数字
*/
random: function(min, max) {
if (this.isArray(min)) return min[~~(Math.random() * min.length)];
if (!this.isNumber(max)) max = min || 1, min = 0;
return min + Math.random() * (max - min);
},
/**
* 阿基米德求模
*
* @static
* @method
* @memberof JC.Utils
* @param {Number} n 当前值
* @param {Number} m 模
* @return {Number} 映射到模长内的值
*/
euclideanModulo: function(n, m) {
return ((n % m) + m) % m;
},
/**
* 边界值域镜像
*
* @static
* @method
* @memberof JC.Utils
* @param {Number} n 当前值
* @param {Number} min 值域下边界
* @param {Number} max 值域上边界
* @return {Number} 值域内反射到的值
*/
codomainBounce: function(n, min, max) {
if (n < min) return 2 * min - n;
if (n > max) return 2 * max - n;
return n;
},
/**
* 数字区间闭合，避免超出区间
*
* @static
* @method
* @memberof JC.Utils
* @param {Number} x 待闭合到值
* @param {Number} a 闭合区间左边界
* @param {Number} b 闭合区间右边界
* @return {Number} 闭合后的值
*/
clamp: function(x, a, b) {
return (x < a) ? a : ((x > b) ? b : x);
},
/**
* 线性插值
*
* @static
* @method
* @memberof JC.Utils
* @param {Number} x 输入的值
* @param {Number} min 输入值的下区间
* @param {Number} max 输入值的上区间
* @return {Number} 返回的值在区间[0,1]内
*/
linear: function( x, min, max ) {
if ( x <= min ) return 0;
if ( x >= max ) return 1;
x = ( x - min ) / ( max - min );
return x;
},
/**
* 平滑插值
*
* @static
* @method
* @memberof JC.Utils
* @param {Number} x 输入的值
* @param {Number} min 输入值的下区间
* @param {Number} max 输入值的上区间
* @return {Number} 返回的值在区间[0,1]内
*/
smoothstep: function( x, min, max ) {
if ( x <= min ) return 0;
if ( x >= max ) return 1;
x = ( x - min ) / ( max - min );
return x * x * ( 3 - 2 * x );
},
/**
* 更平滑的插值
*
* @static
* @method
* @memberof JC.Utils
* @param {Number} x 输入的值
* @param {Number} min 输入值的下区间
* @param {Number} max 输入值的上区间
* @return {Number} 返回的值在区间[0,1]内
*/
smootherstep: function( x, min, max ) {
if ( x <= min ) return 0;
if ( x >= max ) return 1;
x = ( x - min ) / ( max - min );
return x * x * x * ( x * ( x * 6 - 15 ) + 10 );
},
};