2010-08-02 10:58:00 +08:00
|
|
|
/****************************************************************************
|
2011-03-19 10:59:01 +08:00
|
|
|
Copyright (c) 2010-2011 cocos2d-x.org
|
|
|
|
Copyright (c) 2008-2010 Ricardo Quesada
|
2011-07-05 10:47:25 +08:00
|
|
|
Copyright (c) 2011 Zynga Inc.
|
2010-08-02 10:58:00 +08:00
|
|
|
|
|
|
|
http://www.cocos2d-x.org
|
|
|
|
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
|
|
in the Software without restriction, including without limitation the rights
|
|
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
|
|
all copies or substantial portions of the Software.
|
|
|
|
|
|
|
|
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.
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
#ifndef __CCTEXTURE_ATLAS_H__
|
|
|
|
#define __CCTEXTURE_ATLAS_H__
|
|
|
|
|
2010-07-16 14:15:06 +08:00
|
|
|
#include "ccTypes.h"
|
2012-06-19 13:50:11 +08:00
|
|
|
#include "cocoa/CCObject.h"
|
2010-07-16 14:15:06 +08:00
|
|
|
#include "ccConfig.h"
|
2012-06-19 13:50:11 +08:00
|
|
|
#include <string>
|
2010-07-16 14:15:06 +08:00
|
|
|
|
2012-03-26 18:44:28 +08:00
|
|
|
NS_CC_BEGIN
|
|
|
|
|
2010-07-22 18:39:40 +08:00
|
|
|
class CCTexture2D;
|
|
|
|
|
2010-09-29 09:44:57 +08:00
|
|
|
/** @brief A class that implements a Texture Atlas.
|
2010-07-16 14:15:06 +08:00
|
|
|
Supported features:
|
|
|
|
* The atlas file can be a PVRTC, PNG or any other fomrat supported by Texture2D
|
|
|
|
* Quads can be udpated in runtime
|
|
|
|
* Quads can be added in runtime
|
|
|
|
* Quads can be removed in runtime
|
|
|
|
* Quads can be re-ordered in runtime
|
|
|
|
* The TextureAtlas capacity can be increased or decreased in runtime
|
|
|
|
* OpenGL component: V3F, C4B, T2F.
|
|
|
|
The quads are rendered using an OpenGL ES VBO.
|
|
|
|
To render the quads using an interleaved vertex array list, you should modify the ccConfig.h file
|
|
|
|
*/
|
2011-03-07 17:11:57 +08:00
|
|
|
class CC_DLL CCTextureAtlas : public CCObject
|
2010-07-16 14:15:06 +08:00
|
|
|
{
|
|
|
|
protected:
|
2012-04-19 14:35:52 +08:00
|
|
|
GLushort* m_pIndices;
|
2012-03-26 18:44:28 +08:00
|
|
|
#if CC_TEXTURE_ATLAS_USE_VAO
|
2012-04-19 14:35:52 +08:00
|
|
|
GLuint m_uVAOname;
|
2012-03-26 18:44:28 +08:00
|
|
|
#endif
|
2012-04-19 14:35:52 +08:00
|
|
|
GLuint m_pBuffersVBO[2]; //0: vertex 1: indices
|
|
|
|
bool m_bDirty; //indicates whether or not the array buffer of the VBO needs to be updated
|
2012-03-14 14:55:17 +08:00
|
|
|
|
2010-07-16 14:15:06 +08:00
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
/** quantity of quads that are going to be drawn */
|
|
|
|
CC_PROPERTY_READONLY(unsigned int, m_uTotalQuads, TotalQuads)
|
|
|
|
/** quantity of quads that can be stored with the current texture atlas size */
|
|
|
|
CC_PROPERTY_READONLY(unsigned int, m_uCapacity, Capacity)
|
|
|
|
/** Texture of the texture atlas */
|
|
|
|
CC_PROPERTY(CCTexture2D *, m_pTexture, Texture)
|
|
|
|
/** Quads that are going to be rendered */
|
|
|
|
CC_PROPERTY(ccV3F_C4B_T2F_Quad *, m_pQuads, Quads)
|
2010-07-16 14:15:06 +08:00
|
|
|
|
|
|
|
public:
|
2010-07-16 16:28:11 +08:00
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
CCTextureAtlas();
|
|
|
|
virtual ~CCTextureAtlas();
|
|
|
|
|
|
|
|
const char* description();
|
|
|
|
|
|
|
|
/** creates a TextureAtlas with an filename and with an initial capacity for Quads.
|
|
|
|
* The TextureAtlas capacity can be increased in runtime.
|
|
|
|
*/
|
|
|
|
static CCTextureAtlas * textureAtlasWithFile(const char* file , unsigned int capacity);
|
|
|
|
|
|
|
|
/** initializes a TextureAtlas with a filename and with a certain capacity for Quads.
|
|
|
|
* The TextureAtlas capacity can be increased in runtime.
|
|
|
|
*
|
|
|
|
* WARNING: Do not reinitialize the TextureAtlas because it will leak memory (issue #706)
|
|
|
|
*/
|
|
|
|
bool initWithFile(const char* file, unsigned int capacity);
|
|
|
|
|
|
|
|
/** creates a TextureAtlas with a previously initialized Texture2D object, and
|
|
|
|
* with an initial capacity for n Quads.
|
|
|
|
* The TextureAtlas capacity can be increased in runtime.
|
|
|
|
*/
|
|
|
|
static CCTextureAtlas * textureAtlasWithTexture(CCTexture2D *texture, unsigned int capacity);
|
|
|
|
|
|
|
|
/** initializes a TextureAtlas with a previously initialized Texture2D object, and
|
|
|
|
* with an initial capacity for Quads.
|
|
|
|
* The TextureAtlas capacity can be increased in runtime.
|
|
|
|
*
|
|
|
|
* WARNING: Do not reinitialize the TextureAtlas because it will leak memory (issue #706)
|
|
|
|
*/
|
|
|
|
bool initWithTexture(CCTexture2D *texture, unsigned int capacity);
|
|
|
|
|
|
|
|
/** updates a Quad (texture, vertex and color) at a certain index
|
|
|
|
* index must be between 0 and the atlas capacity - 1
|
|
|
|
@since v0.8
|
|
|
|
*/
|
|
|
|
void updateQuad(ccV3F_C4B_T2F_Quad* quad, unsigned int index);
|
|
|
|
|
|
|
|
/** Inserts a Quad (texture, vertex and color) at a certain index
|
|
|
|
index must be between 0 and the atlas capacity - 1
|
|
|
|
@since v0.8
|
|
|
|
*/
|
|
|
|
void insertQuad(ccV3F_C4B_T2F_Quad* quad, unsigned int index);
|
|
|
|
|
|
|
|
/** Inserts a c array of quads at a given index
|
|
|
|
index must be between 0 and the atlas capacity - 1
|
|
|
|
this method doesn't enlarge the array when amount + index > totalQuads
|
|
|
|
@since v1.1
|
|
|
|
*/
|
|
|
|
void insertQuads(ccV3F_C4B_T2F_Quad* quads, unsigned int index, unsigned int amount);
|
|
|
|
|
|
|
|
/** Removes the quad that is located at a certain index and inserts it at a new index
|
|
|
|
This operation is faster than removing and inserting in a quad in 2 different steps
|
|
|
|
@since v0.7.2
|
|
|
|
*/
|
|
|
|
void insertQuadFromIndex(unsigned int fromIndex, unsigned int newIndex);
|
|
|
|
|
|
|
|
/** removes a quad at a given index number.
|
|
|
|
The capacity remains the same, but the total number of quads to be drawn is reduced in 1
|
|
|
|
@since v0.7.2
|
|
|
|
*/
|
|
|
|
void removeQuadAtIndex(unsigned int index);
|
|
|
|
|
|
|
|
/** removes a amount of quads starting from index
|
|
|
|
@since 1.1
|
|
|
|
*/
|
|
|
|
void removeQuadsAtIndex(unsigned int index, unsigned int amount);
|
|
|
|
/** removes all Quads.
|
|
|
|
The TextureAtlas capacity remains untouched. No memory is freed.
|
|
|
|
The total number of quads to be drawn will be 0
|
|
|
|
@since v0.7.2
|
|
|
|
*/
|
|
|
|
void removeAllQuads();
|
|
|
|
|
|
|
|
|
|
|
|
/** resize the capacity of the CCTextureAtlas.
|
|
|
|
* The new capacity can be lower or higher than the current one
|
|
|
|
* It returns YES if the resize was successful.
|
|
|
|
* If it fails to resize the capacity it will return NO with a new capacity of 0.
|
|
|
|
*/
|
|
|
|
bool resizeCapacity(unsigned int n);
|
|
|
|
|
|
|
|
/**
|
|
|
|
Used internally by CCParticleBatchNode
|
|
|
|
don't use this unless you know what you're doing
|
|
|
|
@since 1.1
|
|
|
|
*/
|
|
|
|
void increaseTotalQuadsWith(unsigned int amount);
|
|
|
|
|
|
|
|
/** Moves an amount of quads from oldIndex at newIndex
|
|
|
|
@since v1.1
|
|
|
|
*/
|
|
|
|
void moveQuadsFromIndex(unsigned int oldIndex, unsigned int amount, unsigned int newIndex);
|
|
|
|
|
|
|
|
/**
|
|
|
|
Moves quads from index till totalQuads to the newIndex
|
|
|
|
Used internally by CCParticleBatchNode
|
|
|
|
This method doesn't enlarge the array if newIndex + quads to be moved > capacity
|
|
|
|
@since 1.1
|
|
|
|
*/
|
|
|
|
void moveQuadsFromIndex(unsigned int index, unsigned int newIndex);
|
|
|
|
|
|
|
|
/**
|
|
|
|
Ensures that after a realloc quads are still empty
|
|
|
|
Used internally by CCParticleBatchNode
|
|
|
|
@since 1.1
|
|
|
|
*/
|
|
|
|
void fillWithEmptyQuadsFromIndex(unsigned int index, unsigned int amount);
|
|
|
|
|
|
|
|
/** draws n quads
|
|
|
|
* n can't be greater than the capacity of the Atlas
|
|
|
|
*/
|
|
|
|
void drawNumberOfQuads(unsigned int n);
|
|
|
|
|
|
|
|
/** draws n quads from an index (offset).
|
|
|
|
n + start can't be greater than the capacity of the atlas
|
|
|
|
|
|
|
|
@since v1.0
|
|
|
|
*/
|
|
|
|
void drawNumberOfQuads(unsigned int n, unsigned int start);
|
|
|
|
|
|
|
|
/** draws all the Atlas's Quads
|
|
|
|
*/
|
|
|
|
void drawQuads();
|
2012-04-24 15:02:18 +08:00
|
|
|
/** listen the event that coming to foreground on Android
|
|
|
|
*/
|
|
|
|
void listenBackToForeground(CCObject *obj);
|
2012-04-19 14:35:52 +08:00
|
|
|
private:
|
|
|
|
void setupIndices();
|
|
|
|
void mapBuffers();
|
|
|
|
#if CC_TEXTURE_ATLAS_USE_VAO
|
2012-03-26 18:44:28 +08:00
|
|
|
void setupVBOandVAO();
|
|
|
|
#else
|
|
|
|
void setupVBO();
|
|
|
|
#endif
|
2010-08-02 10:58:00 +08:00
|
|
|
};
|
2012-03-26 18:44:28 +08:00
|
|
|
|
|
|
|
NS_CC_END
|
2010-08-02 10:58:00 +08:00
|
|
|
|
|
|
|
#endif //__CCTEXTURE_ATLAS_H__
|
|
|
|
|
|
|
|
|