#include <CCTexture2D.h>
Classes | |
struct | PixelFormatInfo |
Public Types | |
enum | PixelFormat { AUTO, BGRA8888, RGBA8888, RGB888, RGB565, A8, I8, AI88, RGBA4444, RGB5A1, PVRTC4, PVRTC4A, PVRTC2, PVRTC2A, ETC, S3TC_DXT1, S3TC_DXT3, S3TC_DXT5, ATC_RGB, ATC_EXPLICIT_ALPHA, ATC_INTERPOLATED_ALPHA, DEFAULT = AUTO, NONE = -1 } |
Possible texture pixel formats. More... | |
typedef std::map < Texture2D::PixelFormat, const PixelFormatInfo > | PixelFormatInfoMap |
Public Member Functions | |
Texture2D () | |
ctor () | |
Texture2D () | |
virtual | ~Texture2D () |
virtual std::string | getDescription () const |
void | releaseData (void *data) |
These functions are needed to create mutable textures. More... | |
void * | keepData (void *data, unsigned int length) |
bool | initWithData (const void *data, ssize_t dataLen, Texture2D::PixelFormat pixelFormat, int pixelsWide, int pixelsHigh, const Size &contentSize) |
Initializes with a texture2d with data. More... | |
bool | initWithMipmaps (MipmapInfo *mipmaps, int mipmapsNum, Texture2D::PixelFormat pixelFormat, int pixelsWide, int pixelsHigh) |
Initializes with mipmaps. More... | |
void | drawAtPoint (const Point &point) |
Drawing extensions to make it easy to draw basic quads using a Texture2D object. More... | |
void | drawInRect (const Rect &rect) |
draws a texture inside a rect More... | |
bool | initWithImage (Image *image) |
Extensions to make it easy to create a Texture2D object from an image file. More... | |
bool | initWithImage (Image *image, PixelFormat format) |
Initializes a texture from a UIImage object. More... | |
bool | initWithString (const char *text, const char *fontName, float fontSize, const Size &dimensions=Size(0, 0), TextHAlignment hAlignment=TextHAlignment::CENTER, TextVAlignment vAlignment=TextVAlignment::TOP) |
Initializes a texture from a string with dimensions, alignment, font name and font size. More... | |
var | initWithString ( var text, var fontName, var fontSize, var 0, var CENTER, var TOP) |
Initializes a texture from a string with dimensions, alignment, font name and font size. More... | |
local | initWithString ( local text, local fontName, local fontSize, local 0, local CENTER, local TOP) |
Initializes a texture from a string with dimensions, alignment, font name and font size. More... | |
bool | initWithString (const char *text, const FontDefinition &textDefinition) |
Initializes a texture from a string using a text definition. More... | |
var | initWithString ( var text, var textDefinition) |
Initializes a texture from a string using a text definition. More... | |
local | initWithString ( local text, local textDefinition) |
Initializes a texture from a string using a text definition. More... | |
void | setTexParameters (const TexParams &texParams) |
sets the min filter, mag filter, wrap s and wrap t texture parameters. More... | |
CC_DEPRECATED_ATTRIBUTE void | setTexParameters (const TexParams *texParams) |
void | setAntiAliasTexParameters () |
sets antialias texture parameters: More... | |
var | setAntiAliasTexParameters () |
sets antialias texture parameters: More... | |
local | setAntiAliasTexParameters () |
sets antialias texture parameters: More... | |
void | setAliasTexParameters () |
sets alias texture parameters: More... | |
void | generateMipmap () |
Generates mipmap images for the texture. More... | |
const char * | getStringForFormat () const |
returns the pixel format. More... | |
local | getStringForFormat () |
returns the pixel format. More... | |
CC_DEPRECATED_ATTRIBUTE const char * | stringForFormat () const |
local | stringForFormat () |
unsigned int | getBitsPerPixelForFormat () const |
returns the bits-per-pixel of the in-memory OpenGL texture More... | |
CC_DEPRECATED_ATTRIBUTE unsigned int | bitsPerPixelForFormat () const |
local | bitsPerPixelForFormat () |
unsigned int | getBitsPerPixelForFormat (Texture2D::PixelFormat format) const |
Helper functions that returns bits per pixels for a given format. More... | |
CC_DEPRECATED_ATTRIBUTE unsigned int | bitsPerPixelForFormat (Texture2D::PixelFormat format) const |
local | bitsPerPixelForFormat ( local format) |
const Size & | getContentSizeInPixels () |
content size More... | |
var | getContentSizeInPixels () |
content size More... | |
local | getContentSizeInPixels () |
content size More... | |
bool | hasPremultipliedAlpha () const |
var | hasPremultipliedAlpha () |
local | hasPremultipliedAlpha () |
bool | hasMipmaps () const |
var | hasMipmaps () |
local | hasMipmaps () |
Texture2D::PixelFormat | getPixelFormat () const |
Gets the pixel format of the texture. More... | |
var | getPixelFormat () |
Gets the pixel format of the texture. More... | |
local | getPixelFormat () |
Gets the pixel format of the texture. More... | |
int | getPixelsWide () const |
Gets the width of the texture in pixels. More... | |
local | getPixelsWide () |
Gets the width of the texture in pixels. More... | |
int | getPixelsHigh () const |
Gets the height of the texture in pixels. More... | |
var | getPixelsHigh () |
Gets the height of the texture in pixels. More... | |
local | getPixelsHigh () |
Gets the height of the texture in pixels. More... | |
GLuint | getName () const |
Gets the texture name. More... | |
var | getName () |
Gets the texture name. More... | |
local | getName () |
Gets the texture name. More... | |
GLfloat | getMaxS () const |
Gets max S. More... | |
var | getMaxS () |
Gets max S. More... | |
local | getMaxS () |
Gets max S. More... | |
void | setMaxS (GLfloat maxS) |
Sets max S. More... | |
local | setMaxS ( local maxS) |
Sets max S. More... | |
GLfloat | getMaxT () const |
Gets max T. More... | |
local | getMaxT () |
Gets max T. More... | |
void | setMaxT (GLfloat maxT) |
Sets max T. More... | |
var | setMaxT ( var maxT) |
Sets max T. More... | |
local | setMaxT ( local maxT) |
Sets max T. More... | |
Size | getContentSize () const |
var | getContentSize () |
local | getContentSize () |
void | setShaderProgram (GLProgram *program) |
var | setShaderProgram ( var program) |
local | setShaderProgram ( local program) |
GLProgram * | getShaderProgram () const |
Public Member Functions inherited from Ref | |
void | retain () |
Retains the ownership. More... | |
void | release () |
Release the ownership immediately. More... | |
Ref * | autorelease () |
Release the ownership sometime soon automatically. More... | |
unsigned int | getReferenceCount () const |
Returns the Ref's current reference count. More... | |
virtual | ~Ref () |
Static Public Member Functions | |
static void | setDefaultAlphaPixelFormat (Texture2D::PixelFormat format) |
sets the default pixel format for UIImagescontains alpha channel. More... | |
local | setDefaultAlphaPixelFormat ( local format) |
sets the default pixel format for UIImagescontains alpha channel. More... | |
static Texture2D::PixelFormat | getDefaultAlphaPixelFormat () |
returns the alpha pixel format More... | |
static CC_DEPRECATED_ATTRIBUTE Texture2D::PixelFormat | defaultAlphaPixelFormat () |
var | defaultAlphaPixelFormat () |
local | defaultAlphaPixelFormat () |
static void | PVRImagesHavePremultipliedAlpha (bool haveAlphaPremultiplied) |
treats (or not) PVR files as if they have alpha premultiplied. More... | |
local | PVRImagesHavePremultipliedAlpha ( local haveAlphaPremultiplied) |
treats (or not) PVR files as if they have alpha premultiplied. More... | |
static const PixelFormatInfoMap & | getPixelFormatInfoMap () |
var | getPixelFormatInfoMap () |
local | getPixelFormatInfoMap () |
Protected Attributes | |
Texture2D::PixelFormat | _pixelFormat |
pixel format of the texture More... | |
var | _pixelFormat |
pixel format of the texture More... | |
int | _pixelsWide |
width in pixels More... | |
int | _pixelsHigh |
height in pixels More... | |
var | _pixelsHigh |
height in pixels More... | |
local | _pixelsHigh |
height in pixels More... | |
GLuint | _name |
texture name More... | |
var | _name |
texture name More... | |
local | _name |
texture name More... | |
GLfloat | _maxS |
texture max S More... | |
var | _maxS |
texture max S More... | |
local | _maxS |
texture max S More... | |
GLfloat | _maxT |
texture max T More... | |
var | _maxT |
texture max T More... | |
local | _maxT |
texture max T More... | |
Size | _contentSize |
content size More... | |
var | _contentSize |
content size More... | |
local | _contentSize |
content size More... | |
bool | _hasPremultipliedAlpha |
whether or not the texture has their Alpha premultiplied More... | |
var | _hasPremultipliedAlpha |
whether or not the texture has their Alpha premultiplied More... | |
local | _hasPremultipliedAlpha |
whether or not the texture has their Alpha premultiplied More... | |
bool | _hasMipmaps |
var | _hasMipmaps |
local | _hasMipmaps |
GLProgram * | _shaderProgram |
shader program used by drawAtPoint and drawInRect More... | |
var | _shaderProgram |
shader program used by drawAtPoint and drawInRect More... | |
local | _shaderProgram |
shader program used by drawAtPoint and drawInRect More... | |
Protected Attributes inherited from Ref | |
unsigned int | _referenceCount |
count of references More... | |
Static Protected Attributes | |
static const PixelFormatInfoMap | _pixelFormatInfoTables |
Additional Inherited Members | |
Protected Member Functions inherited from Ref | |
Ref () | |
Constructor. More... | |
Texture2D class.
This class allows to easily create OpenGL 2D textures from images, text or raw data. The created Texture2D object will always have power-of-two dimensions. Depending on how you create the Texture2D object, the actual image area of the texture might be smaller than the texture dimensions i.e. "contentSize" != (pixelsWide, pixelsHigh) and (maxS, maxT) != (1.0, 1.0). Be aware that the content of the generated textures will be upside-down!
typedef std::map <Texture2D::PixelFormat, const PixelFormatInfo> PixelFormatInfoMap |
local PixelFormatInfoMap |
|
strong |
Possible texture pixel formats.
|
strong |
Possible texture pixel formats.
|
strong |
Possible texture pixel formats.
Texture2D | ( | ) |
var ctor | ( | ) |
local Texture2D | ( | ) |
|
virtual |
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
|
inlinestatic |
|
inlinestatic |
|
inlinestatic |
void drawAtPoint | ( | const Point & | point) |
Drawing extensions to make it easy to draw basic quads using a Texture2D object.
These functions require GL_TEXTURE_2D and both GL_VERTEX_ARRAY and GL_TEXTURE_COORD_ARRAY client states to be enabled.draws a texture at a given point
var drawAtPoint | ( | var | point) |
Drawing extensions to make it easy to draw basic quads using a Texture2D object.
These functions require GL_TEXTURE_2D and both GL_VERTEX_ARRAY and GL_TEXTURE_COORD_ARRAY client states to be enabled.draws a texture at a given point
local drawAtPoint | ( | local | point) |
Drawing extensions to make it easy to draw basic quads using a Texture2D object.
These functions require GL_TEXTURE_2D and both GL_VERTEX_ARRAY and GL_TEXTURE_COORD_ARRAY client states to be enabled.draws a texture at a given point
void drawInRect | ( | const Rect & | rect) |
draws a texture inside a rect
var drawInRect | ( | var | rect) |
draws a texture inside a rect
local drawInRect | ( | local | rect) |
draws a texture inside a rect
void generateMipmap | ( | ) |
Generates mipmap images for the texture.
It only works if the texture size is POT (power of 2).
var generateMipmap | ( | ) |
Generates mipmap images for the texture.
It only works if the texture size is POT (power of 2).
local generateMipmap | ( | ) |
Generates mipmap images for the texture.
It only works if the texture size is POT (power of 2).
unsigned int getBitsPerPixelForFormat |
( | ) | const |
returns the bits-per-pixel of the in-memory OpenGL texture
var getBitsPerPixelForFormat | ( | ) |
returns the bits-per-pixel of the in-memory OpenGL texture
local getBitsPerPixelForFormat | ( | ) |
returns the bits-per-pixel of the in-memory OpenGL texture
unsigned int getBitsPerPixelForFormat |
( | Texture2D::PixelFormat | format) | const |
Helper functions that returns bits per pixels for a given format.
var getBitsPerPixelForFormat | ( | var | format) |
Helper functions that returns bits per pixels for a given format.
local getBitsPerPixelForFormat | ( | local | format) |
Helper functions that returns bits per pixels for a given format.
Size getContentSize | ( | ) | const |
var getContentSize | ( | ) |
local getContentSize | ( | ) |
const Size& getContentSizeInPixels | ( | ) |
content size
var getContentSizeInPixels | ( | ) |
content size
local getContentSizeInPixels | ( | ) |
content size
|
static |
returns the alpha pixel format
|
static |
returns the alpha pixel format
|
static |
returns the alpha pixel format
|
virtual |
GLfloat getMaxS | ( | ) | const |
Gets max S.
var getMaxS | ( | ) |
Gets max S.
local getMaxS | ( | ) |
Gets max S.
GLfloat getMaxT | ( | ) | const |
Gets max T.
var getMaxT | ( | ) |
Gets max T.
local getMaxT | ( | ) |
Gets max T.
GLuint getName | ( | ) | const |
Gets the texture name.
var getName | ( | ) |
Gets the texture name.
local getName | ( | ) |
Gets the texture name.
Texture2D::PixelFormat getPixelFormat |
( | ) | const |
Gets the pixel format of the texture.
var getPixelFormat | ( | ) |
Gets the pixel format of the texture.
local getPixelFormat | ( | ) |
Gets the pixel format of the texture.
|
static |
|
static |
|
static |
int getPixelsHigh | ( | ) | const |
Gets the height of the texture in pixels.
var getPixelsHigh | ( | ) |
Gets the height of the texture in pixels.
local getPixelsHigh | ( | ) |
Gets the height of the texture in pixels.
int getPixelsWide | ( | ) | const |
Gets the width of the texture in pixels.
var getPixelsWide | ( | ) |
Gets the width of the texture in pixels.
local getPixelsWide | ( | ) |
Gets the width of the texture in pixels.
GLProgram* getShaderProgram | ( | ) | const |
var getShaderProgram | ( | ) |
local getShaderProgram | ( | ) |
const char* getStringForFormat | ( | ) | const |
returns the pixel format.
var getStringForFormat | ( | ) |
returns the pixel format.
local getStringForFormat | ( | ) |
returns the pixel format.
bool hasMipmaps | ( | ) | const |
var hasMipmaps | ( | ) |
local hasMipmaps | ( | ) |
bool hasPremultipliedAlpha | ( | ) | const |
var hasPremultipliedAlpha | ( | ) |
local hasPremultipliedAlpha | ( | ) |
bool initWithData | ( | const void * | data, |
ssize_t | dataLen, | ||
Texture2D::PixelFormat | pixelFormat, | ||
int | pixelsWide, | ||
int | pixelsHigh, | ||
const Size & | contentSize | ||
) |
Initializes with a texture2d with data.
bool initWithImage | ( | Image * | image) |
Extensions to make it easy to create a Texture2D object from an image file.
Initializes a texture from a UIImage object. We will use the format you specified with setDefaultAlphaPixelFormat to convert the image for texture. NOTE: It will not convert the pvr image file.
var initWithImage | ( | var | image) |
Extensions to make it easy to create a Texture2D object from an image file.
Initializes a texture from a UIImage object. We will use the format you specified with setDefaultAlphaPixelFormat to convert the image for texture. NOTE: It will not convert the pvr image file.
local initWithImage | ( | local | image) |
Extensions to make it easy to create a Texture2D object from an image file.
Initializes a texture from a UIImage object. We will use the format you specified with setDefaultAlphaPixelFormat to convert the image for texture. NOTE: It will not convert the pvr image file.
bool initWithImage | ( | Image * | image, |
PixelFormat | format | ||
) |
Initializes a texture from a UIImage object.
we will use the format you passed to the function to convert the image format to the texture format. If you pass PixelFormat::Automatic, we will auto detect the image render type and use that type for texture to render.
var initWithImage | ( | var | image, |
var | format | ||
) |
Initializes a texture from a UIImage object.
we will use the format you passed to the function to convert the image format to the texture format. If you pass PixelFormat::Automatic, we will auto detect the image render type and use that type for texture to render.
local initWithImage | ( | local | image, |
local | format | ||
) |
Initializes a texture from a UIImage object.
we will use the format you passed to the function to convert the image format to the texture format. If you pass PixelFormat::Automatic, we will auto detect the image render type and use that type for texture to render.
bool initWithMipmaps | ( | MipmapInfo * | mipmaps, |
int | mipmapsNum, | ||
Texture2D::PixelFormat | pixelFormat, | ||
int | pixelsWide, | ||
int | pixelsHigh | ||
) |
Initializes with mipmaps.
var initWithMipmaps | ( | var | mipmaps, |
var | mipmapsNum, | ||
var | pixelFormat, | ||
var | pixelsWide, | ||
var | pixelsHigh | ||
) |
Initializes with mipmaps.
local initWithMipmaps | ( | local | mipmaps, |
local | mipmapsNum, | ||
local | pixelFormat, | ||
local | pixelsWide, | ||
local | pixelsHigh | ||
) |
Initializes with mipmaps.
bool initWithString | ( | const char * | text, |
const char * | fontName, | ||
float | fontSize, | ||
const Size & | dimensions = Size(0, 0) , |
||
TextHAlignment | hAlignment = TextHAlignment::CENTER , |
||
TextVAlignment | vAlignment = TextVAlignment::TOP |
||
) |
Initializes a texture from a string with dimensions, alignment, font name and font size.
var initWithString | ( | var | text, |
var | fontName, | ||
var | fontSize, | ||
var | dimensions = Size(0, 0) , |
||
var | hAlignment = TextHAlignment::CENTER , |
||
var | vAlignment = TextVAlignment::TOP |
||
) |
Initializes a texture from a string with dimensions, alignment, font name and font size.
local initWithString | ( | local | text, |
local | fontName, | ||
local | fontSize, | ||
local | dimensions = Size(0, 0) , |
||
local | hAlignment = TextHAlignment::CENTER , |
||
local | vAlignment = TextVAlignment::TOP |
||
) |
Initializes a texture from a string with dimensions, alignment, font name and font size.
bool initWithString | ( | const char * | text, |
const FontDefinition & | textDefinition | ||
) |
Initializes a texture from a string using a text definition.
var initWithString | ( | var | text, |
var | textDefinition | ||
) |
Initializes a texture from a string using a text definition.
local initWithString | ( | local | text, |
local | textDefinition | ||
) |
Initializes a texture from a string using a text definition.
void* keepData | ( | void * | data, |
unsigned int | length | ||
) |
|
static |
treats (or not) PVR files as if they have alpha premultiplied.
Since it is impossible to know at runtime if the PVR images have the alpha channel premultiplied, it is possible load them as if they have (or not) the alpha channel premultiplied.
By default it is disabled.
|
static |
treats (or not) PVR files as if they have alpha premultiplied.
Since it is impossible to know at runtime if the PVR images have the alpha channel premultiplied, it is possible load them as if they have (or not) the alpha channel premultiplied.
By default it is disabled.
|
static |
treats (or not) PVR files as if they have alpha premultiplied.
Since it is impossible to know at runtime if the PVR images have the alpha channel premultiplied, it is possible load them as if they have (or not) the alpha channel premultiplied.
By default it is disabled.
void releaseData | ( | void * | data) |
These functions are needed to create mutable textures.
void setAliasTexParameters | ( | ) |
sets alias texture parameters:
var setAliasTexParameters | ( | ) |
sets alias texture parameters:
local setAliasTexParameters | ( | ) |
sets alias texture parameters:
void setAntiAliasTexParameters | ( | ) |
sets antialias texture parameters:
var setAntiAliasTexParameters | ( | ) |
sets antialias texture parameters:
local setAntiAliasTexParameters | ( | ) |
sets antialias texture parameters:
|
static |
sets the default pixel format for UIImagescontains alpha channel.
If the UIImage contains alpha channel, then the options are:
How does it work ?
This parameter is not valid for PVR / PVR.CCZ images.
|
static |
sets the default pixel format for UIImagescontains alpha channel.
If the UIImage contains alpha channel, then the options are:
How does it work ?
This parameter is not valid for PVR / PVR.CCZ images.
|
static |
sets the default pixel format for UIImagescontains alpha channel.
If the UIImage contains alpha channel, then the options are:
How does it work ?
This parameter is not valid for PVR / PVR.CCZ images.
void setMaxS | ( | GLfloat | maxS) |
Sets max S.
var setMaxS | ( | var | maxS) |
Sets max S.
local setMaxS | ( | local | maxS) |
Sets max S.
void setMaxT | ( | GLfloat | maxT) |
Sets max T.
var setMaxT | ( | var | maxT) |
Sets max T.
local setMaxT | ( | local | maxT) |
Sets max T.
void setShaderProgram | ( | GLProgram * | program) |
var setShaderProgram | ( | var | program) |
local setShaderProgram | ( | local | program) |
void setTexParameters | ( | const TexParams & | texParams) |
sets the min filter, mag filter, wrap s and wrap t texture parameters.
If the texture size is NPOT (non power of 2), then in can only use GL_CLAMP_TO_EDGE in GL_TEXTURE_WRAP_{S,T}.
var setTexParameters | ( | var | texParams) |
sets the min filter, mag filter, wrap s and wrap t texture parameters.
If the texture size is NPOT (non power of 2), then in can only use GL_CLAMP_TO_EDGE in GL_TEXTURE_WRAP_{S,T}.
local setTexParameters | ( | local | texParams) |
sets the min filter, mag filter, wrap s and wrap t texture parameters.
If the texture size is NPOT (non power of 2), then in can only use GL_CLAMP_TO_EDGE in GL_TEXTURE_WRAP_{S,T}.
|
inline |
|
inline |
|
inline |
|
inline |
|
protected |
content size
|
protected |
content size
|
protected |
content size
|
protected |
|
protected |
|
protected |
|
protected |
whether or not the texture has their Alpha premultiplied
|
protected |
whether or not the texture has their Alpha premultiplied
|
protected |
whether or not the texture has their Alpha premultiplied
|
protected |
texture max S
|
protected |
texture max S
|
protected |
texture max S
|
protected |
texture max T
|
protected |
texture max T
|
protected |
texture max T
|
protected |
texture name
|
protected |
texture name
|
protected |
texture name
|
protected |
pixel format of the texture
|
protected |
pixel format of the texture
|
staticprotected |
|
staticprotected |
|
staticprotected |
|
protected |
height in pixels
|
protected |
height in pixels
|
protected |
height in pixels
|
protected |
width in pixels
|
protected |
width in pixels
|
protected |
width in pixels
|
protected |
shader program used by drawAtPoint and drawInRect
|
protected |
shader program used by drawAtPoint and drawInRect
|
protected |
shader program used by drawAtPoint and drawInRect