2010-08-02 10:58:00 +08:00
|
|
|
/****************************************************************************
|
2012-06-08 14:11:48 +08:00
|
|
|
Copyright (c) 2010-2012 cocos2d-x.org
|
2011-03-19 10:59:01 +08:00
|
|
|
Copyright (C) 2008 Apple Inc. All Rights Reserved.
|
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 __CCTEXTURE2D_H__
|
|
|
|
#define __CCTEXTURE2D_H__
|
|
|
|
|
|
|
|
#include <string>
|
2012-06-19 13:50:11 +08:00
|
|
|
#include "cocoa/CCObject.h"
|
|
|
|
#include "cocoa/CCGeometry.h"
|
2010-08-16 15:02:17 +08:00
|
|
|
#include "ccTypes.h"
|
2010-07-15 18:15:00 +08:00
|
|
|
|
2012-04-18 18:43:45 +08:00
|
|
|
NS_CC_BEGIN
|
|
|
|
|
2011-03-07 17:11:57 +08:00
|
|
|
class CCImage;
|
2010-07-26 17:32:23 +08:00
|
|
|
|
2012-06-20 18:09:11 +08:00
|
|
|
/**
|
|
|
|
* @addtogroup textures
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
2010-07-15 18:15:00 +08:00
|
|
|
//CONSTANTS:
|
|
|
|
|
|
|
|
/** @typedef CCTexture2DPixelFormat
|
|
|
|
Possible texture pixel formats
|
|
|
|
*/
|
|
|
|
typedef enum {
|
2012-06-08 14:11:48 +08:00
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
//! 32-bit texture: RGBA8888
|
|
|
|
kCCTexture2DPixelFormat_RGBA8888,
|
|
|
|
//! 24-bit texture: RGBA888
|
|
|
|
kCCTexture2DPixelFormat_RGB888,
|
|
|
|
//! 16-bit texture without Alpha channel
|
|
|
|
kCCTexture2DPixelFormat_RGB565,
|
|
|
|
//! 8-bit textures used as masks
|
|
|
|
kCCTexture2DPixelFormat_A8,
|
|
|
|
//! 8-bit intensity texture
|
|
|
|
kCCTexture2DPixelFormat_I8,
|
|
|
|
//! 16-bit textures used as masks
|
|
|
|
kCCTexture2DPixelFormat_AI88,
|
|
|
|
//! 16-bit textures: RGBA4444
|
|
|
|
kCCTexture2DPixelFormat_RGBA4444,
|
|
|
|
//! 16-bit textures: RGB5A1
|
|
|
|
kCCTexture2DPixelFormat_RGB5A1,
|
|
|
|
//! 4-bit PVRTC-compressed texture: PVRTC4
|
|
|
|
kCCTexture2DPixelFormat_PVRTC4,
|
|
|
|
//! 2-bit PVRTC-compressed texture: PVRTC2
|
|
|
|
kCCTexture2DPixelFormat_PVRTC2,
|
|
|
|
|
|
|
|
//! Default texture format: RGBA8888
|
|
|
|
kCCTexture2DPixelFormat_Default = kCCTexture2DPixelFormat_RGBA8888,
|
|
|
|
|
|
|
|
// backward compatibility stuff
|
|
|
|
kTexture2DPixelFormat_RGBA8888 = kCCTexture2DPixelFormat_RGBA8888,
|
|
|
|
kTexture2DPixelFormat_RGB888 = kCCTexture2DPixelFormat_RGB888,
|
|
|
|
kTexture2DPixelFormat_RGB565 = kCCTexture2DPixelFormat_RGB565,
|
|
|
|
kTexture2DPixelFormat_A8 = kCCTexture2DPixelFormat_A8,
|
|
|
|
kTexture2DPixelFormat_RGBA4444 = kCCTexture2DPixelFormat_RGBA4444,
|
|
|
|
kTexture2DPixelFormat_RGB5A1 = kCCTexture2DPixelFormat_RGB5A1,
|
|
|
|
kTexture2DPixelFormat_Default = kCCTexture2DPixelFormat_Default
|
2010-07-15 18:15:00 +08:00
|
|
|
|
|
|
|
} CCTexture2DPixelFormat;
|
|
|
|
|
2012-03-14 14:55:17 +08:00
|
|
|
class CCGLProgram;
|
|
|
|
|
2010-07-15 18:15:00 +08:00
|
|
|
/**
|
|
|
|
Extension to set the Min / Mag filter
|
|
|
|
*/
|
|
|
|
typedef struct _ccTexParams {
|
2012-04-19 14:35:52 +08:00
|
|
|
GLuint minFilter;
|
|
|
|
GLuint magFilter;
|
|
|
|
GLuint wrapS;
|
|
|
|
GLuint wrapT;
|
2010-07-15 18:15:00 +08:00
|
|
|
} ccTexParams;
|
|
|
|
|
|
|
|
//CLASS INTERFACES:
|
|
|
|
|
2010-09-29 09:44:57 +08:00
|
|
|
/** @brief CCTexture2D class.
|
2010-07-15 18:15:00 +08:00
|
|
|
* This class allows to easily create OpenGL 2D textures from images, text or raw data.
|
|
|
|
* The created CCTexture2D object will always have power-of-two dimensions.
|
|
|
|
* Depending on how you create the CCTexture2D 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!
|
|
|
|
*/
|
2011-03-07 17:11:57 +08:00
|
|
|
class CC_DLL CCTexture2D : public CCObject
|
2010-07-15 18:15:00 +08:00
|
|
|
{
|
|
|
|
public:
|
2012-04-19 14:35:52 +08:00
|
|
|
CCTexture2D();
|
|
|
|
virtual ~CCTexture2D();
|
|
|
|
|
|
|
|
const char* description(void);
|
|
|
|
|
|
|
|
/** These functions are needed to create mutable textures */
|
|
|
|
void releaseData(void *data);
|
|
|
|
void* keepData(void *data, unsigned int length);
|
|
|
|
|
|
|
|
/** Intializes with a texture2d with data */
|
|
|
|
bool initWithData(const void* data, CCTexture2DPixelFormat pixelFormat, unsigned int pixelsWide, unsigned int pixelsHigh, const CCSize& contentSize);
|
|
|
|
|
|
|
|
/**
|
|
|
|
Drawing extensions to make it easy to draw basic quads using a CCTexture2D 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 drawAtPoint(const CCPoint& point);
|
|
|
|
/** draws a texture inside a rect */
|
|
|
|
void drawInRect(const CCRect& rect);
|
|
|
|
|
|
|
|
/**
|
|
|
|
Extensions to make it easy to create a CCTexture2D object from an image file.
|
|
|
|
Note that RGBA type textures will have their alpha premultiplied - use the blending mode (GL_ONE, GL_ONE_MINUS_SRC_ALPHA).
|
|
|
|
*/
|
|
|
|
/** Initializes a texture from a UIImage object */
|
|
|
|
|
|
|
|
bool initWithImage(CCImage * uiImage);
|
|
|
|
|
|
|
|
bool initWithImage(CCImage *uiImage, ccResolutionType resolution);
|
|
|
|
|
|
|
|
/** Initializes a texture from a string with dimensions, alignment, font name and font size */
|
2012-06-08 14:11:48 +08:00
|
|
|
bool initWithString(const char *text, const CCSize& dimensions, CCTextAlignment hAlignment, CCVerticalTextAlignment vAlignment, const char *fontName, float fontSize);
|
2012-04-19 14:35:52 +08:00
|
|
|
/** Initializes a texture from a string with font name and font size */
|
|
|
|
bool initWithString(const char *text, const char *fontName, float fontSize);
|
|
|
|
|
|
|
|
#ifdef CC_SUPPORT_PVRTC
|
|
|
|
/**
|
|
|
|
Extensions to make it easy to create a CCTexture2D object from a PVRTC file
|
|
|
|
Note that the generated textures don't have their alpha premultiplied - use the blending mode (GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA).
|
|
|
|
*/
|
|
|
|
/** Initializes a texture from a PVRTC buffer */
|
2011-07-19 15:14:59 +08:00
|
|
|
bool initWithPVRTCData(const void *data, int level, int bpp, bool hasAlpha, int length, CCTexture2DPixelFormat pixelFormat);
|
|
|
|
#endif // CC_SUPPORT_PVRTC
|
|
|
|
|
|
|
|
/** Initializes a texture from a PVR file */
|
2012-04-19 14:35:52 +08:00
|
|
|
bool initWithPVRFile(const char* file);
|
2010-07-15 18:15:00 +08:00
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
/** 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}.
|
2012-06-08 14:11:48 +08:00
|
|
|
|
|
|
|
@warning Calling this method could allocate additional texture memory.
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
@since v0.8
|
|
|
|
*/
|
|
|
|
void setTexParameters(ccTexParams* texParams);
|
2010-07-15 18:15:00 +08:00
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
/** sets antialias texture parameters:
|
|
|
|
- GL_TEXTURE_MIN_FILTER = GL_LINEAR
|
|
|
|
- GL_TEXTURE_MAG_FILTER = GL_LINEAR
|
2010-07-15 18:15:00 +08:00
|
|
|
|
2012-06-08 14:11:48 +08:00
|
|
|
@warning Calling this method could allocate additional texture memory.
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
@since v0.8
|
|
|
|
*/
|
|
|
|
void setAntiAliasTexParameters();
|
2010-07-15 18:15:00 +08:00
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
/** sets alias texture parameters:
|
|
|
|
- GL_TEXTURE_MIN_FILTER = GL_NEAREST
|
|
|
|
- GL_TEXTURE_MAG_FILTER = GL_NEAREST
|
2010-07-15 18:15:00 +08:00
|
|
|
|
2012-06-08 14:11:48 +08:00
|
|
|
@warning Calling this method could allocate additional texture memory.
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
@since v0.8
|
|
|
|
*/
|
|
|
|
void setAliasTexParameters();
|
2010-07-15 18:15:00 +08:00
|
|
|
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
/** Generates mipmap images for the texture.
|
|
|
|
It only works if the texture size is POT (power of 2).
|
|
|
|
@since v0.99.0
|
|
|
|
*/
|
|
|
|
void generateMipmap();
|
2010-07-15 18:15:00 +08:00
|
|
|
|
2012-06-13 16:20:58 +08:00
|
|
|
/** returns the pixel format.
|
|
|
|
@since v2.0
|
|
|
|
*/
|
|
|
|
const char* stringForFormat();
|
|
|
|
|
2012-06-11 21:58:04 +08:00
|
|
|
/** returns the bits-per-pixel of the in-memory OpenGL texture
|
|
|
|
@since v1.0
|
|
|
|
*/
|
2012-06-13 16:20:58 +08:00
|
|
|
unsigned int bitsPerPixelForFormat();
|
|
|
|
|
|
|
|
/** Helper functions that returns bits per pixels for a given format.
|
|
|
|
@since v2.0
|
|
|
|
*/
|
2012-06-08 14:11:48 +08:00
|
|
|
unsigned int bitsPerPixelForFormat(CCTexture2DPixelFormat format);
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
/** sets the default pixel format for UIImagescontains alpha channel.
|
|
|
|
If the UIImage contains alpha channel, then the options are:
|
|
|
|
- generate 32-bit textures: kCCTexture2DPixelFormat_RGBA8888 (default one)
|
|
|
|
- generate 24-bit textures: kCCTexture2DPixelFormat_RGB888
|
|
|
|
- generate 16-bit textures: kCCTexture2DPixelFormat_RGBA4444
|
|
|
|
- generate 16-bit textures: kCCTexture2DPixelFormat_RGB5A1
|
|
|
|
- generate 16-bit textures: kCCTexture2DPixelFormat_RGB565
|
|
|
|
- generate 8-bit textures: kCCTexture2DPixelFormat_A8 (only use it if you use just 1 color)
|
|
|
|
|
|
|
|
How does it work ?
|
|
|
|
- If the image is an RGBA (with Alpha) then the default pixel format will be used (it can be a 8-bit, 16-bit or 32-bit texture)
|
2012-06-13 16:20:58 +08:00
|
|
|
- If the image is an RGB (without Alpha) then: If the default pixel format is RGBA8888 then a RGBA8888 (32-bit) will be used. Otherwise a RGB565 (16-bit texture) will be used.
|
|
|
|
|
2012-06-08 14:11:48 +08:00
|
|
|
This parameter is not valid for PVR / PVR.CCZ images.
|
2012-04-19 14:35:52 +08:00
|
|
|
|
|
|
|
@since v0.8
|
|
|
|
*/
|
|
|
|
static void setDefaultAlphaPixelFormat(CCTexture2DPixelFormat format);
|
|
|
|
|
|
|
|
/** returns the alpha pixel format
|
|
|
|
@since v0.8
|
|
|
|
*/
|
|
|
|
static CCTexture2DPixelFormat defaultAlphaPixelFormat();
|
|
|
|
|
|
|
|
/** 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.
|
|
|
|
|
|
|
|
@since v0.99.5
|
|
|
|
*/
|
|
|
|
static void PVRImagesHavePremultipliedAlpha(bool haveAlphaPremultiplied);
|
|
|
|
|
|
|
|
/** content size */
|
|
|
|
const CCSize& getContentSizeInPixels();
|
2012-06-15 15:10:40 +08:00
|
|
|
|
|
|
|
bool hasPremultipliedAlpha();
|
|
|
|
bool hasMipmaps();
|
2010-07-15 18:15:00 +08:00
|
|
|
private:
|
2012-04-19 14:35:52 +08:00
|
|
|
bool initPremultipliedATextureWithImage(CCImage * image, unsigned int pixelsWide, unsigned int pixelsHigh);
|
2011-07-19 15:14:59 +08:00
|
|
|
|
|
|
|
// By default PVR images are treated as if they don't have the alpha channel premultiplied
|
|
|
|
bool m_bPVRHaveAlphaPremultiplied;
|
2010-07-15 18:15:00 +08:00
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
/** pixel format of the texture */
|
|
|
|
CC_PROPERTY_READONLY(CCTexture2DPixelFormat, m_ePixelFormat, PixelFormat)
|
|
|
|
/** width in pixels */
|
|
|
|
CC_PROPERTY_READONLY(unsigned int, m_uPixelsWide, PixelsWide)
|
|
|
|
/** hight in pixels */
|
|
|
|
CC_PROPERTY_READONLY(unsigned int, m_uPixelsHigh, PixelsHigh)
|
|
|
|
|
|
|
|
/** texture name */
|
|
|
|
CC_PROPERTY_READONLY(GLuint, m_uName, Name)
|
|
|
|
|
|
|
|
/** texture max S */
|
|
|
|
CC_PROPERTY(GLfloat, m_fMaxS, MaxS)
|
|
|
|
/** texture max T */
|
|
|
|
CC_PROPERTY(GLfloat, m_fMaxT, MaxT)
|
|
|
|
/** content size */
|
|
|
|
CC_PROPERTY_READONLY(CCSize, m_tContentSize, ContentSize)
|
|
|
|
|
|
|
|
/** whether or not the texture has their Alpha premultiplied */
|
2012-06-15 15:10:40 +08:00
|
|
|
bool m_bHasPremultipliedAlpha;
|
2012-04-19 14:35:52 +08:00
|
|
|
|
2012-06-15 15:10:40 +08:00
|
|
|
bool m_bHasMipmaps;
|
2012-06-08 14:11:48 +08:00
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
/** shader program used by drawAtPoint and drawInRect */
|
|
|
|
CC_PROPERTY(CCGLProgram*, m_pShaderProgram, ShaderProgram);
|
|
|
|
|
|
|
|
|
|
|
|
/** Returns the resolution type of the texture.
|
|
|
|
Is it a RetinaDisplay texture, an iPad texture or an standard texture ?
|
|
|
|
Only valid on iOS. Not valid on OS X.
|
|
|
|
|
|
|
|
Should be a readonly property. It is readwrite as a hack.
|
|
|
|
|
|
|
|
@since v1.1
|
|
|
|
*/
|
|
|
|
CC_SYNTHESIZE(ccResolutionType, m_eResolutionType, ResolutionType);
|
2010-07-15 18:15:00 +08:00
|
|
|
};
|
2012-04-18 18:43:45 +08:00
|
|
|
|
2012-06-20 18:09:11 +08:00
|
|
|
// end of textures group
|
|
|
|
/// @}
|
|
|
|
|
2012-04-18 18:43:45 +08:00
|
|
|
NS_CC_END
|
2010-08-02 10:58:00 +08:00
|
|
|
|
|
|
|
#endif //__CCTEXTURE2D_H__
|
|
|
|
|