mirror of
https://github.com/cocos/cocos4.git
synced 2026-11-20 23:52:40 +08:00
398 lines
14 KiB
JavaScript
398 lines
14 KiB
JavaScript
/****************************************************************************
|
|
Copyright (c) 2013-2016 Chukong Technologies Inc.
|
|
|
|
http://www.cocos.com
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated engine source code (the "Software"), a limited,
|
|
worldwide, royalty-free, non-assignable, revocable and non-exclusive license
|
|
to use Cocos Creator solely to develop games on your target platforms. You shall
|
|
not use Cocos Creator software for developing other software or tools that's
|
|
used for developing games. You are not granted to publish, distribute,
|
|
sublicense, and/or sell copies of Cocos Creator.
|
|
|
|
The software or tools in this License Agreement are licensed, not sold.
|
|
Chukong Aipu reserves all rights not expressly granted to you.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
THE SOFTWARE.
|
|
****************************************************************************/
|
|
|
|
var JS = require('../platform/js');
|
|
var game = require('../CCGame');
|
|
var Texture2D = require('./CCTexture2D');
|
|
|
|
/**
|
|
* cc.textureCache is a singleton object, it's the global cache for cc.Texture2D
|
|
* @class textureCache
|
|
*/
|
|
var textureCache = /** @lends cc.textureCache# */{
|
|
_textures: {},
|
|
_textureColorsCache: {},
|
|
_textureKeySeq: (0 | Math.random() * 1000),
|
|
|
|
_loadedTexturesBefore: {},
|
|
|
|
handleLoadedTexture: null,
|
|
|
|
_initializingRenderer: function () {
|
|
var selPath;
|
|
//init texture from _loadedTexturesBefore
|
|
var locLoadedTexturesBefore = this._loadedTexturesBefore, locTextures = this._textures;
|
|
for (selPath in locLoadedTexturesBefore) {
|
|
var tex2d = locLoadedTexturesBefore[selPath];
|
|
tex2d.handleLoadedTexture();
|
|
locTextures[selPath] = tex2d;
|
|
}
|
|
this._loadedTexturesBefore = {};
|
|
},
|
|
|
|
/**
|
|
* Description
|
|
* @method description
|
|
* @return {String}
|
|
*/
|
|
description: function () {
|
|
return "<TextureCache | Number of textures = " + this._textures.length + ">";
|
|
},
|
|
|
|
/**
|
|
* Returns an already created texture. Returns null if the texture doesn't exist.
|
|
* @method textureForKey
|
|
* @param {String} textureKeyName
|
|
* @return {Texture2D|Null}
|
|
* @deprecated
|
|
* @example {@link utils/api/engine/docs/cocos2d/core/textures/textureForKey.js}
|
|
*/
|
|
textureForKey: function (textureKeyName) {
|
|
cc.log(cc._LogInfos.textureCache.textureForKey);
|
|
return this.getTextureForKey(textureKeyName);
|
|
},
|
|
|
|
/**
|
|
* Returns an already created texture. Returns null if the texture doesn't exist.
|
|
* @method getTextureForKey
|
|
* @param {String} textureKeyName
|
|
* @return {Texture2D|Null}
|
|
* @example {@link utils/api/engine/docs/cocos2d/core/textures/getTextureForKey.js}
|
|
*/
|
|
getTextureForKey: function(textureKeyName){
|
|
return this._textures[textureKeyName];
|
|
},
|
|
|
|
/**
|
|
* @method getKeyByTexture
|
|
* @param {Image} texture
|
|
* @return {String|Null}
|
|
* @example {@link utils/api/engine/docs/cocos2d/core/textures/getKeyByTexture.js}
|
|
*/
|
|
getKeyByTexture: function (texture) {
|
|
for (var key in this._textures) {
|
|
if (this._textures[key] === texture) {
|
|
return key;
|
|
}
|
|
}
|
|
return null;
|
|
},
|
|
|
|
_generalTextureKey: function (id) {
|
|
return "_textureKey_" + id;
|
|
},
|
|
|
|
/**
|
|
* @method getTextureColors
|
|
* @param {Image} texture
|
|
* @return {Array}
|
|
* @example {@link utils/api/engine/docs/cocos2d/core/textures/getTextureColors.js}
|
|
*/
|
|
getTextureColors: function (texture) {
|
|
var image = texture._htmlElementObj;
|
|
var key = this.getKeyByTexture(image);
|
|
if (!key) {
|
|
if (image instanceof HTMLImageElement)
|
|
key = image.src;
|
|
else
|
|
key = this._generalTextureKey(texture.__instanceId);
|
|
}
|
|
|
|
if (!this._textureColorsCache[key])
|
|
this._textureColorsCache[key] = texture._generateTextureCacheForColor();
|
|
return this._textureColorsCache[key];
|
|
},
|
|
|
|
/**
|
|
* <p>Purges the dictionary of loaded textures. <br />
|
|
* Call this method if you receive the "Memory Warning" <br />
|
|
* In the short term: it will free some resources preventing your app from being killed <br />
|
|
* In the medium term: it will allocate more resources <br />
|
|
* In the long term: it will be the same</p>
|
|
* @method removeAllTextures
|
|
* @example {@link utils/api/engine/docs/cocos2d/core/textures/removeAllTextures.js}
|
|
*/
|
|
removeAllTextures: function () {
|
|
var locTextures = this._textures;
|
|
for (var selKey in locTextures) {
|
|
if (locTextures[selKey])
|
|
locTextures[selKey].releaseTexture();
|
|
}
|
|
this._textures = {};
|
|
},
|
|
|
|
/**
|
|
* Deletes a texture from the cache given a texture.
|
|
* @method removeTexture
|
|
* @param {Image} texture
|
|
* @example {@link utils/api/engine/docs/cocos2d/core/textures/removeTexture.js}
|
|
*/
|
|
removeTexture: function (texture) {
|
|
if (!texture)
|
|
return;
|
|
|
|
var locTextures = this._textures;
|
|
for (var selKey in locTextures) {
|
|
if (locTextures[selKey] === texture) {
|
|
locTextures[selKey].releaseTexture();
|
|
delete(locTextures[selKey]);
|
|
}
|
|
}
|
|
},
|
|
|
|
/**
|
|
* Deletes a texture from the cache given a its key name.
|
|
* @method removeTextureForKey
|
|
* @param {String} textureKeyName
|
|
* @example {@link utils/api/engine/docs/cocos2d/core/textures/removeTextureForKey.js}
|
|
*/
|
|
removeTextureForKey: function (textureKeyName) {
|
|
if (typeof textureKeyName !== 'string')
|
|
return;
|
|
var locTextures = this._textures;
|
|
if (locTextures[textureKeyName]) {
|
|
locTextures[textureKeyName].releaseTexture();
|
|
delete(locTextures[textureKeyName]);
|
|
}
|
|
},
|
|
|
|
/**
|
|
* <p>Returns a Texture2D object given an file image <br />
|
|
* If the file image was not previously loaded, it will create a new Texture2D <br />
|
|
* object and it will return it. It will use the filename as a key.<br />
|
|
* Otherwise it will return a reference of a previously loaded image. <br />
|
|
* Supported image extensions: .png, .jpg, .gif</p>
|
|
* @method addImage
|
|
* @param {String} url
|
|
* @param {Function} cb
|
|
* @param {Object} target
|
|
* @return {Texture2D}
|
|
* @example {@link utils/api/engine/docs/cocos2d/core/textures/addImage.js}
|
|
*/
|
|
addImage: null,
|
|
addImageAsync: null,
|
|
|
|
/**
|
|
* Cache the image data.
|
|
* @method cacheImage
|
|
* @param {String} path
|
|
* @param {Image|HTMLImageElement|HTMLCanvasElement} texture
|
|
*/
|
|
cacheImage: function (path, texture) {
|
|
cc.assert(path, cc._LogInfos.textureCache.invalidKey);
|
|
|
|
if (texture instanceof Texture2D) {
|
|
this._textures[path] = texture;
|
|
return;
|
|
}
|
|
var texture2d = new Texture2D();
|
|
texture2d.initWithElement(texture);
|
|
texture2d.handleLoadedTexture();
|
|
this._textures[path] = texture2d;
|
|
},
|
|
|
|
/**
|
|
* <p>Returns a Texture2D object given an UIImage image<br />
|
|
* If the image was not previously loaded, it will create a new Texture2D object and it will return it.<br />
|
|
* Otherwise it will return a reference of a previously loaded image<br />
|
|
* The "key" parameter will be used as the "key" for the cache.<br />
|
|
* If "key" is null, then a new texture will be created each time.</p>
|
|
* @method addUIImage
|
|
* @param {HTMLImageElement|HTMLCanvasElement} image
|
|
* @param {String} key
|
|
* @return {Texture2D}
|
|
*/
|
|
addUIImage: function (image, key) {
|
|
cc.assert(image, cc._LogInfos.textureCache.addUIImage_2);
|
|
|
|
if (key && this._textures[key]) {
|
|
return this._textures[key];
|
|
}
|
|
|
|
// prevents overloading the autorelease pool
|
|
var texture = new Texture2D();
|
|
texture.initWithImage(image);
|
|
if (key != null)
|
|
this._textures[key] = texture;
|
|
else
|
|
cc.log(cc._LogInfos.textureCache.addUIImage);
|
|
return texture;
|
|
},
|
|
|
|
/**
|
|
* <p>Output to cc.log the current contents of this TextureCache <br />
|
|
* This will attempt to calculate the size of each texture, and the total texture memory in use. </p>
|
|
*/
|
|
dumpCachedTextureInfo: function () {
|
|
var count = 0;
|
|
var totalBytes = 0, locTextures = this._textures;
|
|
|
|
for (var key in locTextures) {
|
|
var selTexture = locTextures[key];
|
|
count++;
|
|
if (selTexture.getHtmlElementObj() instanceof HTMLImageElement)
|
|
cc.log(cc._LogInfos.textureCache.dumpCachedTextureInfo, key, selTexture.getHtmlElementObj().src, selTexture.getPixelWidth(), selTexture.getPixelHeight());
|
|
else {
|
|
cc.log(cc._LogInfos.textureCache.dumpCachedTextureInfo_2, key, selTexture.getPixelWidth(), selTexture.getPixelHeight());
|
|
}
|
|
totalBytes += selTexture.getPixelWidth() * selTexture.getPixelHeight() * 4;
|
|
}
|
|
|
|
var locTextureColorsCache = this._textureColorsCache;
|
|
for (key in locTextureColorsCache) {
|
|
var selCanvasColorsArr = locTextureColorsCache[key];
|
|
for (var selCanvasKey in selCanvasColorsArr) {
|
|
var selCanvas = selCanvasColorsArr[selCanvasKey];
|
|
count++;
|
|
cc.log(cc._LogInfos.textureCache.dumpCachedTextureInfo_2, key, selCanvas.width, selCanvas.height);
|
|
totalBytes += selCanvas.width * selCanvas.height * 4;
|
|
}
|
|
|
|
}
|
|
cc.log(cc._LogInfos.textureCache.dumpCachedTextureInfo_3, count, totalBytes / 1024, (totalBytes / (1024.0 * 1024.0)).toFixed(2));
|
|
},
|
|
|
|
_clear: function () {
|
|
this._textures = {};
|
|
this._textureColorsCache = {};
|
|
this._textureKeySeq = (0 | Math.random() * 1000);
|
|
this._loadedTexturesBefore = {};
|
|
}
|
|
};
|
|
|
|
game.once(game.EVENT_RENDERER_INITED, function () {
|
|
var _p = textureCache;
|
|
if (cc._renderType === game.RENDER_TYPE_CANVAS) {
|
|
_p.handleLoadedTexture = function (url) {
|
|
var locTexs = this._textures;
|
|
//remove judge
|
|
var tex = locTexs[url];
|
|
if (!tex) {
|
|
cc.assert(url, cc._LogInfos.textureCache.invalidKey);
|
|
tex = locTexs[url] = new Texture2D();
|
|
tex.url = url;
|
|
}
|
|
tex.handleLoadedTexture();
|
|
};
|
|
|
|
_p.addImage = function (url, cb, target) {
|
|
|
|
cc.assert(url, cc._LogInfos.Texture2D.addImage);
|
|
|
|
var locTexs = this._textures;
|
|
//remove judge
|
|
var tex = locTexs[url];
|
|
if (tex) {
|
|
if(tex.isLoaded()) {
|
|
cb && cb.call(target, tex);
|
|
return tex;
|
|
}
|
|
else
|
|
{
|
|
tex.once("load", function(){
|
|
cb && cb.call(target, tex);
|
|
}, target);
|
|
return tex;
|
|
}
|
|
}
|
|
|
|
tex = locTexs[url] = new Texture2D();
|
|
tex.url = url;
|
|
cc.loader.load(url, function (err, texture) {
|
|
if (err) {
|
|
return cb && cb.call(target, err || new Error('Unknown error'));
|
|
}
|
|
|
|
textureCache.handleLoadedTexture(url);
|
|
|
|
cb && cb.call(target, tex);
|
|
});
|
|
|
|
return tex;
|
|
};
|
|
|
|
_p.addImageAsync = _p.addImage;
|
|
|
|
} else if (cc._renderType === game.RENDER_TYPE_WEBGL) {
|
|
|
|
_p.handleLoadedTexture = function (url) {
|
|
var locTexs = this._textures, tex, premultiplied;
|
|
//remove judge(webgl)
|
|
if (!cc.game._rendererInitialized) {
|
|
locTexs = this._loadedTexturesBefore;
|
|
}
|
|
tex = locTexs[url];
|
|
if (!tex) {
|
|
cc.assert(url, cc._LogInfos.textureCache.invalidKey);
|
|
tex = locTexs[url] = new Texture2D();
|
|
tex.url = url;
|
|
}
|
|
premultiplied = cc.macro.AUTO_PREMULTIPLIED_ALPHA_FOR_PNG && (cc.path.extname(url) === ".png");
|
|
tex.handleLoadedTexture(premultiplied);
|
|
};
|
|
|
|
_p.addImage = function (url, cb, target) {
|
|
cc.assert(url, cc._LogInfos.Texture2D.addImage_2);
|
|
|
|
var locTexs = this._textures;
|
|
//remove judge(webgl)
|
|
if (!cc.game._rendererInitialized) {
|
|
locTexs = this._loadedTexturesBefore;
|
|
}
|
|
var tex = locTexs[url];
|
|
if (tex) {
|
|
if(tex.isLoaded()) {
|
|
cb && cb.call(target, tex);
|
|
return tex;
|
|
}
|
|
else
|
|
{
|
|
tex.once("load", function(){
|
|
cb && cb.call(target, tex);
|
|
}, target);
|
|
return tex;
|
|
}
|
|
}
|
|
|
|
tex = locTexs[url] = new Texture2D();
|
|
tex.url = url;
|
|
cc.loader.load(url, function (err, texture) {
|
|
if (err) {
|
|
return cb && cb.call(target, err || new Error('Unknown error'));
|
|
}
|
|
|
|
textureCache.handleLoadedTexture(url);
|
|
|
|
cb && cb.call(target, tex);
|
|
});
|
|
|
|
return tex;
|
|
};
|
|
|
|
_p.addImageAsync = _p.addImage;
|
|
}
|
|
});
|
|
|
|
cc.textureCache = module.exports = textureCache; |