Files
cocos4/cocos2d/deprecated.js
T
2016-04-25 15:03:25 +08:00

591 lines
18 KiB
JavaScript

var js = cc.js;
// Label
js.obsolete(cc.Label.prototype, 'cc.Label.file', 'font', true);
if (CC_DEV) {
var INFO = cc._LogInfos.deprecated;
/**
* Inject all of the properties in source objects to target object and return the target object.
* @param {object} target
* @param {object} *sources
* @name cc.inject
* @memberof cc
* @deprecated
* @returns {object}
*/
js.get(cc, "inject", function () {
cc.warn(INFO + " The first argument should be the destination object", 'cc.inject', 'cc.js.addon');
return js.addon;
});
/**
* Copy all of the properties in source objects to target object and return the target object.
* @param {object} target
* @param {object} *sources
* @name cc.extend
* @memberof cc
* @deprecated
* @returns {object}
*/
js.get(cc, "extend", function () {
cc.warn(INFO, 'cc.extend', 'cc.js.mixin');
return js.mixin;
});
/**
* Create new DOM element by tag name
* @name cc.newElement
* @memberof cc
* @deprecated
* @returns {object}
*/
js.get(cc, "newElement", function () {
cc.warn(INFO, 'cc.newElement', 'document.createElement');
return document.createElement;
});
js.get(cc, "isFunction", function () {
cc.warn(INFO, 'cc.isFunction', '"typeof obj === \'function\'"');
return function(obj) {
return typeof obj === 'function';
};
});
js.get(cc.js, "isFunction", function () {
cc.warn(INFO, 'cc.js.isFunction', '"typeof obj === \'function\'"');
return function(obj) {
return typeof obj === 'function';
};
});
/**
* Check the obj whether is number or not
* @name cc.isNumber
* @memberof cc
* @deprecated
* @param {*} obj
* @returns {boolean}
*/
js.get(cc, "isNumber", function () {
cc.warn(INFO, 'cc.isNumber', 'cc.js.isNumber');
return js.isNumber;
});
/**
* Check the obj whether is string or not
* @name cc.isString
* @memberof cc
* @deprecated
* @param {*} obj
* @returns {boolean}
*/
js.get(cc, "isString", function () {
cc.warn(INFO, 'cc.isString', 'cc.js.isString');
return js.isString;
});
js.get(cc, "isArray", function () {
cc.warn(INFO, 'cc.isArray', 'cc.js.isArray');
return function(obj) {
return Array.isArray(obj);
};
});
js.get(cc.js, "isArray", function () {
cc.warn(INFO, 'cc.js.isArray', '"Array.isArray(obj)"');
return function(obj) {
return Array.isArray(obj);
};
});
js.get(cc, "isUndefined", function () {
cc.warn(INFO, 'cc.isUndefined', '"typeof obj === \'undefined\'"');
return function(obj) {
return typeof obj === 'undefined';
};
});
js.get(cc.js, "isUndefined", function () {
cc.warn(INFO, 'cc.js.isUndefined', '"typeof obj === \'undefined\'"');
return function(obj) {
return typeof obj === 'undefined';
};
});
js.get(cc, "isObject", function () {
cc.warn(INFO, 'cc.isObject', '"typeof obj === \'object\'"');
return function(obj) {
return typeof obj === 'object';
};
});
js.get(cc.js, "isObject", function () {
cc.warn(INFO, 'cc.js.isObject', '"typeof obj === \'object\'"');
return function(obj) {
return typeof obj === "object";
};
});
/**
* cc.Point is the class for point object, please do not use its constructor to create points, use cc.p() alias function instead.
* @class cc.Point
* @memberof cc
* @deprecated
* @param {Number} x
* @param {Number} y
* @see cc.Vec2
*/
js.obsoletes(cc, 'cc', {
'Point': 'Vec2',
'EScene': 'Scene',
'ENode': 'Node',
'_ComponentInSG': '_RendererUnderSG'
});
/**
* Verify Array's Type
* @memberof cc
* @deprecated
* @param {Array} arr
* @param {function} type
* @return {Boolean}
* @function
*/
js.get(cc, 'arrayVerifyType', function () {
cc.warn(INFO, 'cc.arrayVerifyType', 'cc.js.array.verifyType');
return cc.js.array.verifyType;
});
/**
* Searches for the first occurance of object and removes it. If object is not found the function has no effect.
* @function
* @memberof cc
* @deprecated
* @param {Array} arr Source Array
* @param {*} delObj remove object
*/
js.get(cc, 'arrayRemoveObject', function () {
cc.warn(INFO, 'cc.arrayRemoveObject', 'cc.js.array.remove');
return cc.js.array.remove;
});
/**
* Removes from arr all values in minusArr. For each Value in minusArr, the first matching instance in arr will be removed.
* @function
* @memberof cc
* @deprecated
* @param {Array} arr Source Array
* @param {Array} minusArr minus Array
*/
js.get(cc, 'arrayRemoveArray', function () {
cc.warn(INFO, 'cc.arrayRemoveArray', 'cc.js.array.removeArray');
return cc.js.array.removeArray;
});
/**
* Inserts some objects at index
* @function
* @memberof cc
* @deprecated
* @param {Array} arr
* @param {Array} addObjs
* @param {Number} index
* @return {Array}
*/
js.get(cc, 'arrayAppendObjectsToIndex', function() {
cc.warn(INFO, 'cc.arrayAppendObjectsToIndex', 'cc.js.array.appendObjectsAt');
return cc.js.array.appendObjectsAt;
});
/**
* Copy an array's item to a new array (its performance is better than Array.slice)
* @memberof cc
* @deprecated
* @param {Array} arr
* @return {Array}
*/
js.get(cc, 'copyArray', function() {
cc.warn(INFO, 'cc.copyArray', 'cc.js.array.copy');
return cc.js.array.copy;
});
Object.defineProperty(cc._SGComponent.prototype, 'visible', {
get: function () {
cc.warn('The "visible" property of %s is deprecated, use "enabled" instead please.', cc.js.getClassName(this));
return this.enabled;
},
set: function (value) {
var printWarning = this.visible;
this.enabled = value;
}
});
function deprecateEnum (obj, oldPath, newPath, hasTypePrefixBefore) {
hasTypePrefixBefore = hasTypePrefixBefore !== false;
var enumDef = eval(newPath);
var entries = cc.Enum.getList(enumDef);
var delimiter = hasTypePrefixBefore ? '_' : '.';
for (var i = 0; i < entries.length; i++) {
var entry = entries[i].name;
var oldPropName;
if (hasTypePrefixBefore) {
var oldTypeName = oldPath.split('.').slice(-1)[0];
oldPropName = oldTypeName + '_' + entry;
}
else {
oldPropName = entry;
}
js.get(obj, oldPropName, function (entry) {
cc.warn(INFO, oldPath + delimiter + entry, newPath + '.' + entry);
return enumDef[entry];
}.bind(null, entry));
}
}
deprecateEnum(cc, 'cc.TEXT_ALIGNMENT', 'cc.TextAlignment');
deprecateEnum(cc, 'cc.VERTICAL_TEXT_ALIGNMENT', 'cc.VerticalTextAlignment');
deprecateEnum(_ccsg.ParticleSystem, '_ccsg.ParticleSystem.TYPE', '_ccsg.ParticleSystem.Type');
deprecateEnum(_ccsg.ParticleSystem, '_ccsg.ParticleSystem.MODE', '_ccsg.ParticleSystem.Mode');
deprecateEnum(cc.ParticleSystem, 'cc.ParticleSystem.TYPE', 'cc.ParticleSystem.PositionType');
deprecateEnum(cc.ParticleSystem, 'cc.ParticleSystem.MODE', 'cc.ParticleSystem.EmitterMode');
// deprecateEnum(cc.ProgressTimer, 'cc.ProgressTimer.TYPE', 'cc.ProgressTimer.Type');
deprecateEnum(cc.game, 'cc.game.DEBUG_MODE', 'cc.DebugMode');
deprecateEnum(cc, 'cc', 'cc.Texture2D.WrapMode', false);
if (_ccsg.EditBox) {
deprecateEnum(cc, 'cc.KEYBOARD_RETURNTYPE', '_ccsg.EditBox.KeyboardReturnType');
deprecateEnum(cc, 'cc.EDITBOX_INPUT_MODE', '_ccsg.EditBox.InputMode');
deprecateEnum(cc, 'cc.EDITBOX_INPUT_FLAG', '_ccsg.EditBox.InputFlag');
}
function markAsRemoved (ownerCtor, removedProps, ownerName) {
ownerName = ownerName || js.getClassName(ownerCtor);
removedProps.forEach(function (prop) {
function error () {
cc.error('Sorry, %s.%s is removed.', ownerName, prop);
}
js.getset(ownerCtor.prototype, prop, error, error);
});
}
function provideClearError (owner, obj, ownerName) {
var className = ownerName || cc.js.getClassName(owner);
var Info = 'Sorry, ' + className + '.%s is removed, please use %s instead.';
for (var prop in obj) {
function define (prop, getset) {
function accessor (newProp) {
cc.error(Info, prop, newProp);
}
if (!Array.isArray(getset)) {
getset = getset.split(',')
.map(function (x) {
return x.trim();
});
}
js.getset(owner, prop, accessor.bind(null, getset[0]), getset[1] && accessor.bind(null, getset[1]));
}
var getset = obj[prop];
if (prop[0] === '*') {
// get set
var etProp = prop.slice(1);
define('g' + etProp, getset);
define('s' + etProp, getset);
}
else {
prop.split(',')
.map(function (x) {
return x.trim();
})
.forEach(function (x) {
define(x, getset);
});
}
}
}
// cc.loader
markAsRemoved(cc.Pipeline, [
'loadJsWithImg',
'loadCsb',
'getUrl',
'loadAliases',
'register'
], 'cc.loader');
provideClearError(cc.loader, {
loadJs : 'load',
loadTxt : 'load',
loadJson : 'load',
loadImg : 'load'
}, 'cc.loader');
// cc.Node
markAsRemoved(cc.Node, [
'_componentContainer',
'_camera',
'_additionalTransform',
'_scheduler',
'_actionManager',
'actionManager',
'_isTransitionFinished',
'_additionalTransformDirty',
'_shaderProgram',
'shaderProgram',
'_normalizedPositionDirty',
'_normalizedPosition',
'_usingNormalizedPosition',
'_renderCmd',
'_vertexZ',
'_showNode',
'_arrayMakeObjectsPerformSelector',
'getActionManager',
'setActionManager',
'getScheduler',
'setScheduler',
'reorderChild',
'draw',
'transformAncestors',
'onEnter',
'onEnterTransitionDidFinish',
'onExitTransitionDidStart',
'onExit',
'getNumberOfRunningActions',
'scheduleUpdate',
'scheduleUpdateWithPriority',
'unscheduleUpdate',
'schedule',
'scheduleOnce',
'unschedule',
'unscheduleAllCallbacks',
'resumeSchedulerAndActions',
'resume',
'pauseSchedulerAndActions',
'pause',
'setAdditionalTransform',
'updateTransform',
'retain',
'release',
'visit',
'transform',
'getCamera',
'grid',
'getGrid',
'setGrid',
'getShaderProgram',
'setShaderProgram',
'getGLServerState',
'setGLServerState',
'_initRendererCmd',
'_createRenderCmd',
'updateDisplayedOpacity',
'updateDisplayedColor',
'userData',
'userObject',
'_cascadeColorEnabled',
'cascadeColor',
'ignoreAnchor',
'isIgnoreAnchorPointForPosition',
'ignoreAnchorPointForPosition'
]);
provideClearError(cc.Node.prototype, {
arrivalOrder: 'getSiblingIndex, setSiblingIndex',
_visible: '_activeInHierarchy, active',
_running: '_activeInHierarchy, active',
running: 'activeInHierarchy, active',
_realOpacity: '_opacity, _opacity',
_realColor: '_color, _color',
_insertChild: 'addChild',
_addChildHelper: 'addChild',
_detachChild: 'removeChild',
getZOrder: 'getLocalZOrder',
setZOrder: 'setLocalZOrder',
getOrderOfArrival: 'getSiblingIndex',
setOrderOfArrival: 'setSiblingIndex',
boundingBox: 'getBoundingBox',
removeFromParentAndCleanup: 'removeFromParent',
removeAllChildrenWithCleanup: 'removeAllChildren',
parentToNodeTransform: 'getParentToNodeTransform',
nodeToWorldTransform: 'getNodeToWorlshaderProgramdTransform',
worldToNodeTransform: 'getWorldToNodeTransform',
nodeToParentTransform: 'getNodeToParentTransform',
removeAllComponents: 'removeComponent',
getNodeToParentAffineTransform: 'getNodeToParentTransform',
});
// RENDERERS
function shouldNotUseNodeProp (component) {
var compProto = component.prototype;
for (var prop in cc.Node.prototype) {
(function (prop) {
if (!(prop in compProto) && prop[0] !== '_') {
Object.defineProperty(compProto, prop, {
get: function () {
var compName = cc.js.getClassName(this); // 允许继承
var Info = 'Sorry, ' + compName + '.%s is undefined, please use cc.Node.%s instead.';
cc.error(Info, prop, prop);
},
enumerable: false,
configurable: true, // 允许继承
});
}
})(prop);
}
}
shouldNotUseNodeProp(cc._SGComponent);
// cc.Sprite
markAsRemoved(cc.Sprite, [
'textureLoaded',
'setBlendFunc',
'getBlendFunc',
'setState',
'getState',
'resizableSpriteWithCapInsets',
'flippedX',
'flippedY',
'setFlippedX',
'setFlippedY',
'isFlippedX',
'isFlippedY',
'getCapInsets',
'setCapInsets',
]);
provideClearError(cc.Sprite, {
create: 'node.addComponent',
createWithTexture: 'node.addComponent',
createWithSpriteFrameName: 'node.addComponent',
createWithSpriteFrame: 'node.addComponent',
});
provideClearError(cc.Sprite.prototype, {
getPreferredSize: 'node.getContentSize',
setPreferredSize: 'node.setContentSize',
updateWithSprite: 'spriteFrame',
getSpriteFrame: 'spriteFrame',
setSpriteFrame: 'spriteFrame',
useOriginalSize: 'sizeMode',
});
// Particle
markAsRemoved(cc.ParticleSystem, [
'batchNode',
'drawMode',
'getDrawMode',
'setDrawMode',
'shapeType',
'getShapeType',
'setShapeType',
'atlasIndex',
'init',
'initParticle',
'updateWithNoTime',
]);
provideClearError(cc.ParticleSystem, {
initWithFile: 'instance.file',
initWithDictionary: 'instance.file',
initWithTotalParticles: 'instance.totalParticles'
});
provideClearError(cc.ParticleSystem.prototype, {
destroyParticleSystem: 'destroy',
clone: 'cc.instantiate',
isActive: 'active',
'*etParticleCount': 'particleCount',
'*etDuration': 'duration',
'*etSourcePosition': 'sourcePos',
'*etPosVar': 'posVar',
'*etGravity': 'gravity',
'*etSpeed': 'speed',
'*etSpeedVar': 'speedVar',
'*etTangentialAccel': 'tangentialAccel',
'*etTangentialAccelVar': 'tangentialAccelVar',
'*etRadialAccel': 'radialAccel',
'*etRadialAccelVar': 'radialAccelVar',
'*etRotationIsDir': 'rotationIsDir',
'*etStartRadius': 'startRadius',
'*etStartRadiusVar': 'startRadiusVar',
'*etEndRadius': 'endRadius',
'*etEndRadiusVar': 'endRadiusVar',
'*etRotatePerSecond': 'rotatePerS',
'*etRotatePerSecondVar': 'rotatePerSVar',
'*etStartColor': 'startColor',
'*etStartColorVar': 'startColorVar',
'*etEndColor': 'endColor',
'*etEndColorVar': 'endColorVar',
'*etTotalParticles': 'totalParticles',
'*etTexture': 'texture',
});
js.obsoletes(cc.ParticleSystem, 'cc.ParticleSystem', {
Type: 'PositionType',
Mode: 'EmitterMode'
});
// _ccsg.Node
markAsRemoved(_ccsg.Node, [
'_normalizedPositionDirty',
'_normalizedPosition',
'_usingNormalizedPosition',
'grid',
'userData',
'userObject',
'getNormalizedPosition',
'setNormalizedPosition',
'getCamera',
'getUserData',
'setUserData',
'getUserObject',
'setUserObject',
'getComponent',
'addComponent',
'removeComponent',
'removeAllComponents',
'enumerateChildren',
'setCameraMask',
'getCameraMask'
], '_ccsg.Node');
js.obsoletes(cc.Scale9Sprite.prototype, 'cc.Scale9Sprite', {
setPreferredSize: 'setContentSize',
getPreferredSize: 'getContentSize',
});
//ui
js.obsolete(cc.Layout.prototype, 'cc.Layout.layoutType', 'type');
js.obsolete(cc.Layout.prototype, 'cc.Layout.ResizeType', 'ResizeMode');
js.obsolete(cc.Layout.prototype, 'cc.Layout.resize', 'resizeMode');
markAsRemoved(cc.Scale9Sprite, [
'init',
'resizableSpriteWithCapInsets',
'updateWithSprite',
'getOriginalSize',
'setCapInsets',
'getCapInsets',
'setScale9Enabled',
'isScale9Enabled',
'getSprite',
'setFlippedX',
'isFlippedX',
'setFlippedY',
'isFlippedY'
]);
// SPINE
if (typeof sp !== 'undefined') {
deprecateEnum(sp, 'sp.ANIMATION_EVENT_TYPE', 'sp.AnimationEventType');
js.obsolete(sp, 'sp.SkeletonAnimation', 'Skeleton');
provideClearError(sp.Skeleton, {
create: 'node.addComponent',
});
provideClearError(sp.Skeleton.prototype, {
'*etDebugSlotsEnabled': 'debugSlots',
'*etDebugBonesEnabled': 'debugBones',
'setDebugSolots': 'debugSlots',
'setDebugBones': 'debugBones',
'*etTimeScale': 'timeScale',
});
}
}