A class that implements a Texture Atlas. More...
Inherits Ref.
Public Member Functions | |
bool | initWithFile (const std::string &file, ssize_t capacity) |
Initializes a TextureAtlas with a filename and with a certain capacity for Quads. More... | |
bool | initWithTexture (Texture2D *texture, ssize_t capacity) |
Initializes a TextureAtlas with a previously initialized Texture2D object, and with an initial capacity for Quads. More... | |
void | updateQuad (V3F_C4B_T2F_Quad *quad, ssize_t index) |
Updates a Quad (texture, vertex and color) at a certain index. More... | |
void | insertQuad (V3F_C4B_T2F_Quad *quad, ssize_t index) |
Inserts a Quad (texture, vertex and color) at a certain index. More... | |
void | insertQuads (V3F_C4B_T2F_Quad *quads, ssize_t index, ssize_t amount) |
Inserts a c array of quads at a given index. More... | |
void | insertQuadFromIndex (ssize_t fromIndex, ssize_t newIndex) |
Removes the quad that is located at a certain index and inserts it at a new index. More... | |
void | removeQuadAtIndex (ssize_t index) |
Removes a quad at a given index number. More... | |
void | removeQuadsAtIndex (ssize_t index, ssize_t amount) |
Removes a amount of quads starting from index. More... | |
void | removeAllQuads () |
Removes all Quads. More... | |
var | removeAllQuads () |
Removes all Quads. More... | |
local | removeAllQuads () |
Removes all Quads. More... | |
bool | resizeCapacity (ssize_t capacity) |
Resize the capacity of the TextureAtlas. More... | |
void | increaseTotalQuadsWith (ssize_t amount) |
Used internally by ParticleBatchNode. More... | |
var | increaseTotalQuadsWith ( var amount) |
Used internally by ParticleBatchNode. More... | |
local | increaseTotalQuadsWith ( local amount) |
Used internally by ParticleBatchNode. More... | |
void | moveQuadsFromIndex (ssize_t oldIndex, ssize_t amount, ssize_t newIndex) |
Moves an amount of quads from oldIndex at newIndex. More... | |
var | moveQuadsFromIndex ( var oldIndex, var amount, var newIndex) |
Moves an amount of quads from oldIndex at newIndex. More... | |
local | moveQuadsFromIndex ( local oldIndex, local amount, local newIndex) |
Moves an amount of quads from oldIndex at newIndex. More... | |
void | moveQuadsFromIndex (ssize_t index, ssize_t newIndex) |
Moves quads from index till totalQuads to the newIndex. More... | |
void | fillWithEmptyQuadsFromIndex (ssize_t index, ssize_t amount) |
Ensures that after a realloc quads are still empty. More... | |
void | drawNumberOfQuads (ssize_t n) |
Draws n quads. More... | |
local | drawNumberOfQuads ( local n) |
Draws n quads. More... | |
void | drawNumberOfQuads (ssize_t numberOfQuads, ssize_t start) |
Draws n quads from an index (offset). More... | |
var | drawNumberOfQuads ( var numberOfQuads, var start) |
Draws n quads from an index (offset). More... | |
local | drawNumberOfQuads ( local numberOfQuads, local start) |
Draws n quads from an index (offset). More... | |
void | drawQuads () |
Draws all the Atlas's Quads. | |
void | listenRendererRecreated (EventCustom *event) |
Listen the event that renderer was recreated on Android. | |
var | listenRendererRecreated ( var event) |
Listen the event that renderer was recreated on Android. | |
local | listenRendererRecreated ( local event) |
Listen the event that renderer was recreated on Android. | |
bool | isDirty () |
Whether or not the array buffer of the VBO needs to be updated. More... | |
void | setDirty (bool bDirty) |
Specify if the array buffer of the VBO needs to be updated. More... | |
local | setDirty ( local bDirty) |
Specify if the array buffer of the VBO needs to be updated. More... | |
virtual std::string | getDescription () const |
Get quads total amount. | |
ssize_t | getTotalQuads () const |
Gets the quantity of quads that are going to be drawn. More... | |
local | getTotalQuads () |
Gets the quantity of quads that are going to be drawn. More... | |
ssize_t | getCapacity () const |
Gets the quantity of quads that can be stored with the current texture atlas size. More... | |
Texture2D * | getTexture () const |
Gets the texture of the texture atlas. More... | |
local | getTexture () |
Gets the texture of the texture atlas. More... | |
void | setTexture (Texture2D *texture) |
Sets the texture for the texture atlas. More... | |
var | setTexture ( var texture) |
Sets the texture for the texture atlas. More... | |
local | setTexture ( local texture) |
Sets the texture for the texture atlas. More... | |
V3F_C4B_T2F_Quad * | getQuads () |
Gets the quads that are going to be rendered. More... | |
local | getQuads () |
Gets the quads that are going to be rendered. More... | |
void | setQuads (V3F_C4B_T2F_Quad *quads) |
Sets the quads that are going to be rendered. More... | |
var | setQuads ( var quads) |
Sets the quads that are going to be rendered. More... | |
local | setQuads ( local quads) |
Sets the quads that are going to be rendered. More... | |
Public Member Functions inherited from Ref | |
void | retain () |
Retains the ownership. More... | |
void | release () |
Releases the ownership immediately. More... | |
local | release () |
Releases the ownership immediately. More... | |
Ref * | autorelease () |
Releases the ownership sometime soon automatically. More... | |
unsigned int | getReferenceCount () const |
Returns the Ref's current reference count. More... | |
local | getReferenceCount () |
Returns the Ref's current reference count. More... | |
virtual | ~Ref () |
Destructor. More... | |
Static Public Member Functions | |
static TextureAtlas * | create (const std::string &file, ssize_t capacity) |
Creates a TextureAtlas with an filename and with an initial capacity for Quads. More... | |
static TextureAtlas * | createWithTexture (Texture2D *texture, ssize_t capacity) |
Creates a TextureAtlas with a previously initialized Texture2D object, and with an initial capacity for n Quads. More... | |
Additional Inherited Members | |
Public Attributes inherited from Ref | |
unsigned int | _ID |
object id, ScriptSupport need public _ID | |
local | _ID |
object id, ScriptSupport need public _ID | |
int | _luaID |
Lua reference id. | |
local | _luaID |
Lua reference id. | |
void * | _scriptObject |
scriptObject, support for swift | |
local | _scriptObject |
scriptObject, support for swift | |
bool | _rooted |
When true, it means that the object was already rooted. | |
local | _rooted |
When true, it means that the object was already rooted. | |
A class that implements a Texture Atlas.
Supported features: The atlas file can be a PVRTC, PNG or any other format supported by Texture2D Quads can be updated 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
|
static |
Creates a TextureAtlas with an filename and with an initial capacity for Quads.
The TextureAtlas capacity can be increased in runtime.
file | A null terminated string contains the file path. |
capacity | Capacity for Quads. |
|
static |
Creates a TextureAtlas with an filename and with an initial capacity for Quads.
The TextureAtlas capacity can be increased in runtime.
file | A null terminated string contains the file path. |
capacity | Capacity for Quads. |
|
static |
Creates a TextureAtlas with an filename and with an initial capacity for Quads.
The TextureAtlas capacity can be increased in runtime.
file | A null terminated string contains the file path. |
capacity | Capacity for Quads. |
|
static |
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.
texture | A texture2D object pointer. |
capacity | Capacity for Quads. |
|
static |
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.
texture | A texture2D object pointer. |
capacity | Capacity for Quads. |
|
static |
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.
texture | A texture2D object pointer. |
capacity | Capacity for Quads. |
bool initWithFile | ( | const std::string & | file, |
ssize_t | capacity | ||
) |
Initializes a TextureAtlas with a filename and with a certain capacity for Quads.
The TextureAtlas capacity can be increased in runtime.
file | A null terminated string contains the file path. |
capacity | Capacity for Quads. |
var initWithFile | ( | var | file, |
var | capacity | ||
) |
Initializes a TextureAtlas with a filename and with a certain capacity for Quads.
The TextureAtlas capacity can be increased in runtime.
file | A null terminated string contains the file path. |
capacity | Capacity for Quads. |
local initWithFile | ( | local | file, |
local | capacity | ||
) |
Initializes a TextureAtlas with a filename and with a certain capacity for Quads.
The TextureAtlas capacity can be increased in runtime.
file | A null terminated string contains the file path. |
capacity | Capacity for Quads. |
bool initWithTexture | ( | Texture2D * | texture, |
ssize_t | 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.
texture | A texture2D object pointer. |
capacity | Capacity for Quads. |
var initWithTexture | ( | var | texture, |
var | 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.
texture | A texture2D object pointer. |
capacity | Capacity for Quads. |
local initWithTexture | ( | local | texture, |
local | 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.
texture | A texture2D object pointer. |
capacity | Capacity for Quads. |
void updateQuad | ( | V3F_C4B_T2F_Quad * | quad, |
ssize_t | index | ||
) |
Updates a Quad (texture, vertex and color) at a certain index.
quad | Quad that are going to be rendered. |
index | Index must be between 0 and the atlas capacity - 1. |
var updateQuad | ( | var | quad, |
var | index | ||
) |
Updates a Quad (texture, vertex and color) at a certain index.
quad | Quad that are going to be rendered. |
index | Index must be between 0 and the atlas capacity - 1. |
local updateQuad | ( | local | quad, |
local | index | ||
) |
Updates a Quad (texture, vertex and color) at a certain index.
quad | Quad that are going to be rendered. |
index | Index must be between 0 and the atlas capacity - 1. |
void insertQuad | ( | V3F_C4B_T2F_Quad * | quad, |
ssize_t | index | ||
) |
Inserts a Quad (texture, vertex and color) at a certain index.
quad | Quad that are going to be rendered. |
index | Index must be between 0 and the atlas capacity - 1. |
var insertQuad | ( | var | quad, |
var | index | ||
) |
Inserts a Quad (texture, vertex and color) at a certain index.
quad | Quad that are going to be rendered. |
index | Index must be between 0 and the atlas capacity - 1. |
local insertQuad | ( | local | quad, |
local | index | ||
) |
Inserts a Quad (texture, vertex and color) at a certain index.
quad | Quad that are going to be rendered. |
index | Index must be between 0 and the atlas capacity - 1. |
void insertQuads | ( | V3F_C4B_T2F_Quad * | quads, |
ssize_t | index, | ||
ssize_t | amount | ||
) |
Inserts a c array of quads at a given index.
quads | Quad that are going to be rendered. |
index | Index must be between 0 and the atlas capacity - 1. |
amount | The quads array amount. |
var insertQuads | ( | var | quads, |
var | index, | ||
var | amount | ||
) |
Inserts a c array of quads at a given index.
quads | Quad that are going to be rendered. |
index | Index must be between 0 and the atlas capacity - 1. |
amount | The quads array amount. |
local insertQuads | ( | local | quads, |
local | index, | ||
local | amount | ||
) |
Inserts a c array of quads at a given index.
quads | Quad that are going to be rendered. |
index | Index must be between 0 and the atlas capacity - 1. |
amount | The quads array amount. |
void insertQuadFromIndex | ( | ssize_t | fromIndex, |
ssize_t | newIndex | ||
) |
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.
var insertQuadFromIndex | ( | var | fromIndex, |
var | newIndex | ||
) |
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.
local insertQuadFromIndex | ( | local | fromIndex, |
local | newIndex | ||
) |
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.
void removeQuadAtIndex | ( | ssize_t | index | ) |
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.
var removeQuadAtIndex | ( | var | index | ) |
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.
local removeQuadAtIndex | ( | local | index | ) |
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.
void removeQuadsAtIndex | ( | ssize_t | index, |
ssize_t | amount | ||
) |
Removes a amount of quads starting from index.
var removeQuadsAtIndex | ( | var | index, |
var | amount | ||
) |
Removes a amount of quads starting from index.
local removeQuadsAtIndex | ( | local | index, |
local | amount | ||
) |
Removes a amount of quads starting from index.
void removeAllQuads | ( | ) |
Removes all Quads.
The TextureAtlas capacity remains untouched. No memory is freed. The total number of quads to be drawn will be 0.
var removeAllQuads | ( | ) |
Removes all Quads.
The TextureAtlas capacity remains untouched. No memory is freed. The total number of quads to be drawn will be 0.
local removeAllQuads | ( | ) |
Removes all Quads.
The TextureAtlas capacity remains untouched. No memory is freed. The total number of quads to be drawn will be 0.
bool resizeCapacity | ( | ssize_t | capacity | ) |
Resize the capacity of the TextureAtlas.
The new capacity can be lower or higher than the current one. It returns true if the resize was successful. If it fails to resize the capacity it will return false with a new capacity of 0.
capacity | Capacity for Quads. |
var resizeCapacity | ( | var | capacity | ) |
Resize the capacity of the TextureAtlas.
The new capacity can be lower or higher than the current one. It returns true if the resize was successful. If it fails to resize the capacity it will return false with a new capacity of 0.
capacity | Capacity for Quads. |
local resizeCapacity | ( | local | capacity | ) |
Resize the capacity of the TextureAtlas.
The new capacity can be lower or higher than the current one. It returns true if the resize was successful. If it fails to resize the capacity it will return false with a new capacity of 0.
capacity | Capacity for Quads. |
void increaseTotalQuadsWith | ( | ssize_t | amount | ) |
var increaseTotalQuadsWith | ( | var | amount | ) |
local increaseTotalQuadsWith | ( | local | amount | ) |
void moveQuadsFromIndex | ( | ssize_t | oldIndex, |
ssize_t | amount, | ||
ssize_t | newIndex | ||
) |
Moves an amount of quads from oldIndex at newIndex.
var moveQuadsFromIndex | ( | var | oldIndex, |
var | amount, | ||
var | newIndex | ||
) |
Moves an amount of quads from oldIndex at newIndex.
local moveQuadsFromIndex | ( | local | oldIndex, |
local | amount, | ||
local | newIndex | ||
) |
Moves an amount of quads from oldIndex at newIndex.
void moveQuadsFromIndex | ( | ssize_t | index, |
ssize_t | newIndex | ||
) |
Moves quads from index till totalQuads to the newIndex.
Used internally by ParticleBatchNode. This method doesn't enlarge the array if newIndex + quads to be moved > capacity.
var moveQuadsFromIndex | ( | var | index, |
var | newIndex | ||
) |
Moves quads from index till totalQuads to the newIndex.
Used internally by ParticleBatchNode. This method doesn't enlarge the array if newIndex + quads to be moved > capacity.
local moveQuadsFromIndex | ( | local | index, |
local | newIndex | ||
) |
Moves quads from index till totalQuads to the newIndex.
Used internally by ParticleBatchNode. This method doesn't enlarge the array if newIndex + quads to be moved > capacity.
void fillWithEmptyQuadsFromIndex | ( | ssize_t | index, |
ssize_t | amount | ||
) |
var fillWithEmptyQuadsFromIndex | ( | var | index, |
var | amount | ||
) |
local fillWithEmptyQuadsFromIndex | ( | local | index, |
local | amount | ||
) |
void drawNumberOfQuads | ( | ssize_t | n | ) |
Draws n quads.
N can't be greater than the capacity of the Atlas.
var drawNumberOfQuads | ( | var | n | ) |
Draws n quads.
N can't be greater than the capacity of the Atlas.
local drawNumberOfQuads | ( | local | n | ) |
Draws n quads.
N can't be greater than the capacity of the Atlas.
void drawNumberOfQuads | ( | ssize_t | numberOfQuads, |
ssize_t | start | ||
) |
Draws n quads from an index (offset).
N + start can't be greater than the capacity of the atlas.
var drawNumberOfQuads | ( | var | numberOfQuads, |
var | start | ||
) |
Draws n quads from an index (offset).
N + start can't be greater than the capacity of the atlas.
local drawNumberOfQuads | ( | local | numberOfQuads, |
local | start | ||
) |
Draws n quads from an index (offset).
N + start can't be greater than the capacity of the atlas.
|
inline |
Whether or not the array buffer of the VBO needs to be updated.
|
inline |
Whether or not the array buffer of the VBO needs to be updated.
|
inline |
Whether or not the array buffer of the VBO needs to be updated.
|
inline |
Specify if the array buffer of the VBO needs to be updated.
|
inline |
Specify if the array buffer of the VBO needs to be updated.
|
inline |
Specify if the array buffer of the VBO needs to be updated.
ssize_t getTotalQuads | ( | ) | const |
Gets the quantity of quads that are going to be drawn.
var getTotalQuads | ( | ) |
Gets the quantity of quads that are going to be drawn.
local getTotalQuads | ( | ) |
Gets the quantity of quads that are going to be drawn.
ssize_t getCapacity | ( | ) | const |
Gets the quantity of quads that can be stored with the current texture atlas size.
var getCapacity | ( | ) |
Gets the quantity of quads that can be stored with the current texture atlas size.
local getCapacity | ( | ) |
Gets the quantity of quads that can be stored with the current texture atlas size.
Texture2D* getTexture | ( | ) | const |
Gets the texture of the texture atlas.
var getTexture | ( | ) |
Gets the texture of the texture atlas.
local getTexture | ( | ) |
Gets the texture of the texture atlas.
void setTexture | ( | Texture2D * | texture | ) |
Sets the texture for the texture atlas.
var setTexture | ( | var | texture | ) |
Sets the texture for the texture atlas.
local setTexture | ( | local | texture | ) |
Sets the texture for the texture atlas.
V3F_C4B_T2F_Quad* getQuads | ( | ) |
Gets the quads that are going to be rendered.
var getQuads | ( | ) |
Gets the quads that are going to be rendered.
local getQuads | ( | ) |
Gets the quads that are going to be rendered.
void setQuads | ( | V3F_C4B_T2F_Quad * | quads | ) |
Sets the quads that are going to be rendered.
var setQuads | ( | var | quads | ) |
Sets the quads that are going to be rendered.
local setQuads | ( | local | quads | ) |
Sets the quads that are going to be rendered.