issue #7 : add CCTexture2D.h and implement CCTexture2D.cpp partly

This commit is contained in:
Walzer 2010-07-15 10:15:00 +00:00
parent 8eff6998dd
commit 63b87af767
8 changed files with 809 additions and 6 deletions

View File

@ -402,7 +402,7 @@ void CCNode::cleanup()
std::string CCNode::description()
{
char des[100];
sprintf_s(des, 100, "<CCNode | Tag = %i>", m_nTag);
sprintf_s(des, 100, "<CCNode | Tag = %d>", m_nTag);
string ret(des);
return ret;

View File

@ -24,7 +24,6 @@ THE SOFTWARE.
#include "CCLayer.h"
using namespace std;
// CCLayer
CCLayer::CCLayer()

View File

@ -24,7 +24,6 @@ THE SOFTWARE.
#include "CCPageTurnTransition.h"
using namespace std;
CCPageTurnTransition::CCPageTurnTransition()
{

View File

@ -24,7 +24,6 @@ THE SOFTWARE.
#include "CCRadialTransition.h"
using namespace std;
//#import "CCDirector.h"

View File

@ -24,7 +24,6 @@ THE SOFTWARE.
#include "CCScene.h"
using namespace std;
CCScene::CCScene()
{

View File

@ -24,7 +24,6 @@ THE SOFTWARE.
#include "CCTransition.h"
using namespace std;
enum {
kSceneFade = 0xFADEFADE,

View File

@ -0,0 +1,600 @@
/****************************************************************************
Copyright (c) 2010 cocos2d-x.org
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.
****************************************************************************/
/*
* Support for RGBA_4_4_4_4 and RGBA_5_5_5_1 was copied from:
* https://devforums.apple.com/message/37855#37855 by a1studmuffin
*/
#include "CCTexture2D.h"
#include <GLES/glext.h>
#include "ccConfig.h"
#include "ccMacros.h"
#include "CCTexture2D.h"
/// @todo #include "CCPVRTexture.h"
#include "../CCConfiguration.h"
#if CC_FONT_LABEL_SUPPORT
// FontLabel support
/// @todo
//#include "FontManager.h"
//#include "FontLabelStringDrawing.h"
#endif// CC_FONT_LABEL_SUPPORT
static unsigned int nextPOT(unsigned int x)
{
x = x - 1;
x = x | (x >> 1);
x = x | (x >> 2);
x = x | (x >> 4);
x = x | (x >> 8);
x = x | (x >>16);
return x + 1;
}
//CLASS IMPLEMENTATIONS:
// If the image has alpha, you can create RGBA8 (32-bit) or RGBA4 (16-bit) or RGB5A1 (16-bit)
// Default is: RGBA8888 (32-bit textures)
static CCTexture2DPixelFormat g_defaultAlphaPixelFormat = kCCTexture2DPixelFormat_Default;
CCTexture2D::CCTexture2D()
{
}
CCTexture2D::~CCTexture2D()
{
CCLOGINFO("cocos2d: deallocing CCTexture2D %u.", m_uName);
if(m_uName)
glDeleteTextures(1, &m_uName);
}
CCTexture2DPixelFormat CCTexture2D::getPixelFormat()
{
return m_ePixelFormat;
}
UINT32 CCTexture2D::getPixelsWide()
{
return m_uPixelsWide;
}
UINT32 CCTexture2D::getPixelsHigh()
{
return m_uPixelsHigh;
}
GLuint CCTexture2D::getName()
{
return m_uName;
}
CGSize CCTexture2D::getContentSize()
{
return m_tContentSize;
}
GLfloat CCTexture2D::getMaxS()
{
return m_fMaxS;
}
void CCTexture2D::setMaxS(GLfloat maxS)
{
m_fMaxS = maxS;
}
GLfloat CCTexture2D::getMaxT()
{
return m_fMaxT;
}
void CCTexture2D::setMaxT(GLfloat maxT)
{
m_fMaxT = maxT;
}
bool CCTexture2D::getHasPremultipliedAlpha()
{
return m_bHasPremultipliedAlpha;
}
CCTexture2D * CCTexture2D::initWithData(const void *data, CCTexture2DPixelFormat pixelFormat, UInt32 pixelsWide, UInt32 pixelsHigh, CGSize contentSize)
{
glGenTextures(1, &m_uName);
glBindTexture(GL_TEXTURE_2D, m_uName);
this->setAntiAliasTexParameters();
// Specify OpenGL texture image
switch(pixelFormat)
{
case kCCTexture2DPixelFormat_RGBA8888:
glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, pixelsWide, pixelsHigh, 0, GL_RGBA, GL_UNSIGNED_BYTE, data);
break;
case kCCTexture2DPixelFormat_RGBA4444:
glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, pixelsWide, pixelsHigh, 0, GL_RGBA, GL_UNSIGNED_SHORT_4_4_4_4, data);
break;
case kCCTexture2DPixelFormat_RGB5A1:
glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, pixelsWide, pixelsHigh, 0, GL_RGBA, GL_UNSIGNED_SHORT_5_5_5_1, data);
break;
case kCCTexture2DPixelFormat_RGB565:
glTexImage2D(GL_TEXTURE_2D, 0, GL_RGB, pixelsWide, pixelsHigh, 0, GL_RGB, GL_UNSIGNED_SHORT_5_6_5, data);
break;
case kCCTexture2DPixelFormat_A8:
glTexImage2D(GL_TEXTURE_2D, 0, GL_ALPHA, pixelsWide, pixelsHigh, 0, GL_ALPHA, GL_UNSIGNED_BYTE, data);
break;
default:;
NSAssert(0, "NSInternalInconsistencyException");
}
m_tContentSize = contentSize;
m_uPixelsWide = pixelsWide;
m_uPixelsHigh = pixelsHigh;
m_ePixelFormat = pixelFormat;
m_fMaxS = contentSize.width / (float)pixelsWide;
m_fMaxT = contentSize.height / (float)pixelsHigh;
m_bHasPremultipliedAlpha = false;
return this;
}
std::string CCTexture2D::description(void)
{
char des[100];
sprintf_s(des, 100, "<CCTexture2D | Name = %u | Dimensions = %u x %u | Coordinates = (%.2f, %.2f)>", m_uName, m_uPixelsWide, m_uPixelsHigh, m_fMaxS, m_fMaxT);
string ret(des);
return ret;
}
// implementation CCTexture2D (Image)
/** @todo
- (id) initWithImage:(UIImage *)uiImage
{
NSUInteger POTWide, POTHigh;
CGImageRef CGImage;
CGImage = uiImage.CGImage;
if(CGImage == NULL) {
CCLOG(@"cocos2d: CCTexture2D. Can't create Texture. UIImage is nil");
[self release];
return nil;
}
CCConfiguration *conf = [CCConfiguration sharedConfiguration];
#if CC_TEXTURE_NPOT_SUPPORT
if( [conf supportsNPOT] ) {
POTWide = CGImageGetWidth(CGImage);
POTHigh = CGImageGetHeight(CGImage);
} else
#endif
{
POTWide = nextPOT(CGImageGetWidth(CGImage));
POTHigh = nextPOT(CGImageGetHeight(CGImage));
}
unsigned maxTextureSize = [conf maxTextureSize];
if( POTHigh > maxTextureSize || POTWide > maxTextureSize ) {
CCLOG(@"cocos2d: WARNING: Image (%u x %u) is bigger than the supported %u x %u", POTWide, POTHigh, maxTextureSize, maxTextureSize);
[self release];
return nil;
}
// always load premultiplied images
self = [self initPremultipliedATextureWithImage:CGImage pixelsWide:POTWide pixelsHigh:POTHigh];
return self;
}
-(id) initPremultipliedATextureWithImage:(CGImageRef)image pixelsWide:(NSUInteger)POTWide pixelsHigh:(NSUInteger)POTHigh
{
NSUInteger i;
CGContextRef context = nil;
void* data = nil;;
CGColorSpaceRef colorSpace;
void* tempData;
unsigned int* inPixel32;
unsigned short* outPixel16;
BOOL hasAlpha;
CGImageAlphaInfo info;
CGSize imageSize;
CCTexture2DPixelFormat pixelFormat;
info = CGImageGetAlphaInfo(image);
hasAlpha = ((info == kCGImageAlphaPremultipliedLast) || (info == kCGImageAlphaPremultipliedFirst) || (info == kCGImageAlphaLast) || (info == kCGImageAlphaFirst) ? YES : NO);
size_t bpp = CGImageGetBitsPerComponent(image);
colorSpace = CGImageGetColorSpace(image);
if(colorSpace) {
if(hasAlpha || bpp >= 8)
pixelFormat = defaultAlphaPixelFormat;
else {
CCLOG(@"cocos2d: CCTexture2D: Using RGB565 texture since image has no alpha");
pixelFormat = kCCTexture2DPixelFormat_RGB565;
}
} else {
// NOTE: No colorspace means a mask image
CCLOG(@"cocos2d: CCTexture2D: Using A8 texture since image is a mask");
pixelFormat = kCCTexture2DPixelFormat_A8;
}
imageSize = CGSizeMake(CGImageGetWidth(image), CGImageGetHeight(image));
// Create the bitmap graphics context
switch(pixelFormat) {
case kCCTexture2DPixelFormat_RGBA8888:
case kCCTexture2DPixelFormat_RGBA4444:
case kCCTexture2DPixelFormat_RGB5A1:
colorSpace = CGColorSpaceCreateDeviceRGB();
data = malloc(POTHigh * POTWide * 4);
info = hasAlpha ? kCGImageAlphaPremultipliedLast : kCGImageAlphaNoneSkipLast;
context = CGBitmapContextCreate(data, POTWide, POTHigh, 8, 4 * POTWide, colorSpace, info | kCGBitmapByteOrder32Big);
CGColorSpaceRelease(colorSpace);
break;
case kCCTexture2DPixelFormat_RGB565:
colorSpace = CGColorSpaceCreateDeviceRGB();
data = malloc(POTHigh * POTWide * 4);
info = kCGImageAlphaNoneSkipLast;
context = CGBitmapContextCreate(data, POTWide, POTHigh, 8, 4 * POTWide, colorSpace, info | kCGBitmapByteOrder32Big);
CGColorSpaceRelease(colorSpace);
break;
case kCCTexture2DPixelFormat_A8:
data = malloc(POTHigh * POTWide);
info = kCGImageAlphaOnly;
context = CGBitmapContextCreate(data, POTWide, POTHigh, 8, POTWide, NULL, info);
break;
default:
[NSException raise:NSInternalInconsistencyException format:@"Invalid pixel format"];
}
CGContextClearRect(context, CGRectMake(0, 0, POTWide, POTHigh));
CGContextTranslateCTM(context, 0, POTHigh - imageSize.height);
CGContextDrawImage(context, CGRectMake(0, 0, CGImageGetWidth(image), CGImageGetHeight(image)), image);
// Repack the pixel data into the right format
if(pixelFormat == kCCTexture2DPixelFormat_RGB565) {
//Convert "RRRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA" to "RRRRRGGGGGGBBBBB"
tempData = malloc(POTHigh * POTWide * 2);
inPixel32 = (unsigned int*)data;
outPixel16 = (unsigned short*)tempData;
for(i = 0; i < POTWide * POTHigh; ++i, ++inPixel32)
*outPixel16++ = ((((*inPixel32 >> 0) & 0xFF) >> 3) << 11) | ((((*inPixel32 >> 8) & 0xFF) >> 2) << 5) | ((((*inPixel32 >> 16) & 0xFF) >> 3) << 0);
free(data);
data = tempData;
}
else if (pixelFormat == kCCTexture2DPixelFormat_RGBA4444) {
//Convert "RRRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA" to "RRRRGGGGBBBBAAAA"
tempData = malloc(POTHigh * POTWide * 2);
inPixel32 = (unsigned int*)data;
outPixel16 = (unsigned short*)tempData;
for(i = 0; i < POTWide * POTHigh; ++i, ++inPixel32)
*outPixel16++ =
((((*inPixel32 >> 0) & 0xFF) >> 4) << 12) | // R
((((*inPixel32 >> 8) & 0xFF) >> 4) << 8) | // G
((((*inPixel32 >> 16) & 0xFF) >> 4) << 4) | // B
((((*inPixel32 >> 24) & 0xFF) >> 4) << 0); // A
free(data);
data = tempData;
}
else if (pixelFormat == kCCTexture2DPixelFormat_RGB5A1) {
//Convert "RRRRRRRRRGGGGGGGGBBBBBBBBAAAAAAAA" to "RRRRRGGGGGBBBBBA"
tempData = malloc(POTHigh * POTWide * 2);
inPixel32 = (unsigned int*)data;
outPixel16 = (unsigned short*)tempData;
for(i = 0; i < POTWide * POTHigh; ++i, ++inPixel32)
*outPixel16++ =
((((*inPixel32 >> 0) & 0xFF) >> 3) << 11) | // R
((((*inPixel32 >> 8) & 0xFF) >> 3) << 6) | // G
((((*inPixel32 >> 16) & 0xFF) >> 3) << 1) | // B
((((*inPixel32 >> 24) & 0xFF) >> 7) << 0); // A
free(data);
data = tempData;
}
self = [self initWithData:data pixelFormat:pixelFormat pixelsWide:POTWide pixelsHigh:POTHigh contentSize:imageSize];
// should be after calling super init
_hasPremultipliedAlpha = (info == kCGImageAlphaPremultipliedLast || info == kCGImageAlphaPremultipliedFirst);
CGContextRelease(context);
free(data);
return self;
}*/
// implementation CCTexture2D (Text)
CCTexture2D * CCTexture2D::initWithString(NSString *str, NSString *fontName, GLfloat fontSize)
{
/** @todo
CGSize dim;
#if CC_FONT_LABEL_SUPPORT
ZFont *zFont = [[FontManager sharedManager] zFontWithName:name pointSize:size];
if (zFont != nil)
dim = [string sizeWithZFont:zFont];
else
#endif
dim = [string sizeWithFont:[UIFont fontWithName:name size:size]];
return [self initWithString:string dimensions:dim alignment:UITextAlignmentCenter fontName:name fontSize:size];
}
- (id) initWithString:(NSString*)string dimensions:(CGSize)dimensions alignment:(UITextAlignment)alignment fontName:(NSString*)name fontSize:(CGFloat)size
{
NSUInteger width,
height,
i;
CGContextRef context;
void* data;
CGColorSpaceRef colorSpace;
id uiFont;
width = dimensions.width;
if((width != 1) && (width & (width - 1))) {
i = 1;
while(i < width)
i *= 2;
width = i;
}
height = dimensions.height;
if((height != 1) && (height & (height - 1))) {
i = 1;
while(i < height)
i *= 2;
height = i;
}
colorSpace = CGColorSpaceCreateDeviceGray();
data = calloc(height, width);
context = CGBitmapContextCreate(data, width, height, 8, width, colorSpace, kCGImageAlphaNone);
CGColorSpaceRelease(colorSpace);
CGContextSetGrayFillColor(context, 1.0f, 1.0f);
CGContextTranslateCTM(context, 0.0f, height);
CGContextScaleCTM(context, 1.0f, -1.0f); //NOTE: NSString draws in UIKit referential i.e. renders upside-down compared to CGBitmapContext referential
UIGraphicsPushContext(context);
#if CC_FONT_LABEL_SUPPORT
uiFont = [[FontManager sharedManager] zFontWithName:name pointSize:size];
if (uiFont != nil)
[string drawInRect:CGRectMake(0, 0, dimensions.width, dimensions.height) withZFont:uiFont lineBreakMode:UILineBreakModeWordWrap alignment:alignment];
else
#endif // CC_FONT_LABEL_SUPPORT
{
uiFont = [UIFont fontWithName:name size:size];
[string drawInRect:CGRectMake(0, 0, dimensions.width, dimensions.height) withFont:uiFont lineBreakMode:UILineBreakModeWordWrap alignment:alignment];
}
if( ! uiFont )
CCLOG(@"cocos2d: Texture2D: Font '%@' not found", name);
UIGraphicsPopContext();
self = [self initWithData:data pixelFormat:kCCTexture2DPixelFormat_A8 pixelsWide:width pixelsHigh:height contentSize:dimensions];
CGContextRelease(context);
free(data);
*/
return this;
}
// implementation CCTexture2D (Drawing)
void CCTexture2D::drawAtPoint(CGPoint point)
{
GLfloat coordinates[] = { 0.0f, m_fMaxT,
m_fMaxS,m_fMaxT,
0.0f, 0.0f,
m_fMaxS,0.0f };
GLfloat width = (GLfloat)m_uPixelsWide * m_fMaxS,
height = (GLfloat)m_uPixelsHigh * m_fMaxT;
#if 0
GLfloat vertices[] = { -width / 2 + point.x, -height / 2 + point.y, 0.0f,
width / 2 + point.x, -height / 2 + point.y, 0.0f,
-width / 2 + point.x, height / 2 + point.y, 0.0f,
width / 2 + point.x, height / 2 + point.y, 0.0f };
#else // anchor is done by cocos2d automagically
GLfloat vertices[] = { point.x, point.y, 0.0f,
width + point.x, point.y, 0.0f,
point.x, height + point.y, 0.0f,
width + point.x, height + point.y, 0.0f };
#endif
glBindTexture(GL_TEXTURE_2D, m_uName);
glVertexPointer(3, GL_FLOAT, 0, vertices);
glTexCoordPointer(2, GL_FLOAT, 0, coordinates);
glDrawArrays(GL_TRIANGLE_STRIP, 0, 4);
}
void CCTexture2D::drawInRect(CGRect rect)
{
GLfloat coordinates[] = { 0.0f, m_fMaxT,
m_fMaxS,m_fMaxT,
0.0f, 0.0f,
m_fMaxS,0.0f };
GLfloat vertices[] = { rect.origin.x, rect.origin.y, /*0.0f,*/
rect.origin.x + rect.size.width, rect.origin.y, /*0.0f,*/
rect.origin.x, rect.origin.y + rect.size.height, /*0.0f,*/
rect.origin.x + rect.size.width, rect.origin.y + rect.size.height, /*0.0f*/ };
glBindTexture(GL_TEXTURE_2D, m_uName);
glVertexPointer(2, GL_FLOAT, 0, vertices);
glTexCoordPointer(2, GL_FLOAT, 0, coordinates);
glDrawArrays(GL_TRIANGLE_STRIP, 0, 4);
}
// implementation CCTexture2D (PVRTC)
CCTexture2D * CCTexture2D::initWithPVRTCData(const void *data, int level, int bpp, bool hasAlpha, int length)
{
if( !(CCConfiguration::sharedConfiguration()->isSupportsPVRTC()) )
{
CCLOG("cocos2d: WARNING: PVRTC images is not supported.");
this->release();
return NULL;
}
glGenTextures(1, &m_uName);
glBindTexture(GL_TEXTURE_2D, m_uName);
this->setAntiAliasTexParameters();
GLenum format;
GLsizei size = length * length * bpp / 8;
if(hasAlpha) {
format = (bpp == 4) ? GL_COMPRESSED_RGBA_PVRTC_4BPPV1_IMG : GL_COMPRESSED_RGBA_PVRTC_2BPPV1_IMG;
} else {
format = (bpp == 4) ? GL_COMPRESSED_RGB_PVRTC_4BPPV1_IMG : GL_COMPRESSED_RGB_PVRTC_2BPPV1_IMG;
}
if(size < 32) {
size = 32;
}
glCompressedTexImage2D(GL_TEXTURE_2D, level, format, length, length, 0, size, data);
m_tContentSize = CGSizeMake((float)length, (float)length);
m_uPixelsWide = length;
m_uPixelsHigh = length;
m_fMaxS = 1.0f;
m_fMaxT = 1.0f;
return this;
}
CCTexture2D * CCTexture2D::initWithPVRTCFile(NSString* file)
{
/** @todo
if( ! [[CCConfiguration sharedConfiguration] supportsPVRTC] ) {
CCLOG(@"cocos2d: WARNING: PVRTC images is not supported");
[self release];
return nil;
}
if( (self = [super init]) ) {
CCPVRTexture *pvr = [[CCPVRTexture alloc] initWithContentsOfFile:file];
if( pvr ) {
pvr.retainName = YES; // don't dealloc texture on release
_name = pvr.name; // texture id
_maxS = 1.0f;
_maxT = 1.0f;
_width = pvr.width; // width
_height = pvr.height; // height
_size = CGSizeMake(_width, _height);
[pvr release];
[self setAntiAliasTexParameters];
} else {
CCLOG(@"cocos2d: Couldn't load PVR image");
[self release];
return nil;
}
}*/
return this;
}
//
// Use to apply MIN/MAG filter
//
// implementation CCTexture2D (GLFilter)
void CCTexture2D::generateMipmap()
{
NSAssert( m_uPixelsWide == nextPOT(m_uPixelsWide) && m_uPixelsHigh == nextPOT(m_uPixelsHigh), "Mimpap texture only works in POT textures");
glBindTexture( GL_TEXTURE_2D, this->m_uName );
/// @todo include what??? glGenerateMipmapOES(GL_TEXTURE_2D);
}
void CCTexture2D::setTexParameters(ccTexParams *texParams)
{
NSAssert( (m_uPixelsWide == nextPOT(m_uPixelsWide) && m_uPixelsHigh == nextPOT(m_uPixelsHigh)) ||
(texParams->wrapS == GL_CLAMP_TO_EDGE && texParams->wrapT == GL_CLAMP_TO_EDGE),
"GL_CLAMP_TO_EDGE should be used in NPOT textures");
glBindTexture( GL_TEXTURE_2D, this->m_uName );
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, texParams->minFilter );
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, texParams->magFilter );
glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, texParams->wrapS );
glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, texParams->wrapT );
}
void CCTexture2D::setAliasTexParameters()
{
ccTexParams texParams = { GL_NEAREST, GL_NEAREST, GL_CLAMP_TO_EDGE, GL_CLAMP_TO_EDGE };
this->setTexParameters(&texParams);
}
void CCTexture2D::setAntiAliasTexParameters()
{
ccTexParams texParams = { GL_LINEAR, GL_LINEAR, GL_CLAMP_TO_EDGE, GL_CLAMP_TO_EDGE };
this->setTexParameters(&texParams);
}
//
// Texture options for images that contains alpha
//
// implementation CCTexture2D (PixelFormat)
void CCTexture2D::setDefaultAlphaPixelFormat(CCTexture2DPixelFormat format)
{
g_defaultAlphaPixelFormat = format;
}
CCTexture2DPixelFormat CCTexture2D::defaultAlphaPixelFormat()
{
return g_defaultAlphaPixelFormat;
}

View File

@ -0,0 +1,208 @@
/****************************************************************************
Copyright (c) 2010 cocos2d-x.org
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 <GLES/gl.h>
#include "Cocos2dDefine.h"
#include "../cocoa/NSObject.h"
#include "../cocoa/CGGeometry.h"
#include <iostream>
using namespace std;
//CONSTANTS:
/** @typedef CCTexture2DPixelFormat
Possible texture pixel formats
*/
typedef enum {
kCCTexture2DPixelFormat_Automatic = 0,
//! 32-bit texture: RGBA8888
kCCTexture2DPixelFormat_RGBA8888,
//! 16-bit texture: used with images that have alpha pre-multiplied
kCCTexture2DPixelFormat_RGB565,
//! 8-bit textures used as masks
kCCTexture2DPixelFormat_A8,
//! 16-bit textures: RGBA4444
kCCTexture2DPixelFormat_RGBA4444,
//! 16-bit textures: RGB5A1
kCCTexture2DPixelFormat_RGB5A1,
//! Default texture format: RGBA8888
kCCTexture2DPixelFormat_Default = kCCTexture2DPixelFormat_RGBA8888,
// backward compatibility stuff
kTexture2DPixelFormat_Automatic = kCCTexture2DPixelFormat_Automatic,
kTexture2DPixelFormat_RGBA8888 = kCCTexture2DPixelFormat_RGBA8888,
kTexture2DPixelFormat_RGB565 = kCCTexture2DPixelFormat_RGB565,
kTexture2DPixelFormat_A8 = kCCTexture2DPixelFormat_A8,
kTexture2DPixelFormat_RGBA4444 = kCCTexture2DPixelFormat_RGBA4444,
kTexture2DPixelFormat_RGB5A1 = kCCTexture2DPixelFormat_RGB5A1,
kTexture2DPixelFormat_Default = kCCTexture2DPixelFormat_Default
} CCTexture2DPixelFormat;
/**
Extension to set the Min / Mag filter
*/
typedef struct _ccTexParams {
GLuint minFilter;
GLuint magFilter;
GLuint wrapS;
GLuint wrapT;
} ccTexParams;
//CLASS INTERFACES:
/** CCTexture2D class.
* 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!
*/
class CCTexture2D : public NSObject
{
/** pixel format of the texture */
CCX_PROPERTY_READONLY(CCTexture2DPixelFormat, m_ePixelFormat, PixelFormat)
/** width in pixels */
CCX_PROPERTY_READONLY(UINT32, m_uPixelsWide, PixelsWide)
/** hight in pixels */
CCX_PROPERTY_READONLY(UINT32, m_uPixelsHigh, PixelsHigh)
/** texture name */
CCX_PROPERTY_READONLY(GLuint, m_uName, Name)
/** content size */
CCX_PROPERTY_READONLY(CGSize, m_tContentSize, ContentSize)
/** texture max S */
CCX_PROPERTY(GLfloat, m_fMaxS, MaxS)
/** texture max T */
CCX_PROPERTY(GLfloat, m_fMaxT, MaxT)
/** whether or not the texture has their Alpha premultiplied */
CCX_PROPERTY_READONLY(bool, m_bHasPremultipliedAlpha, HasPremultipliedAlpha);
public:
CCTexture2D();
~CCTexture2D();
std::string description(void);
/** Intializes with a texture2d with data */
CCTexture2D * initWithData(const void* data, CCTexture2DPixelFormat pixelFormat, UINT32 pixelsWide, UINT32 pixelsHigh, CGSize 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(CGPoint point);
/** draws a texture inside a rect */
void drawInRect(CGRect 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 */
/// @todo CCTexture2D * initWithImage(UIImage * uiImage);
/**
Extensions to make it easy to create a CCTexture2D object from a string of text.
Note that the generated textures are of type A8 - use the blending mode (GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA).
*/
/** Initializes a texture from a string with dimensions, alignment, font name and font size */
/// @todo CCTexture2D * initWithString(NSString* str, CGSize dimensions, UITextAlignment alignment, NSString* fontName, CGFloat fontSize);
/** Initializes a texture from a string with font name and font size */
CCTexture2D * initWithString(NSString* str, NSString* fontName, GLfloat fontSize);
/**
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 */
CCTexture2D * initWithPVRTCData(const void* data, int level, int bpp, bool hasAlpha, int length);
/** Initializes a texture from a PVRTC file */
CCTexture2D * initWithPVRTCFile(NSString* file);
/** 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}.
@since v0.8
*/
void setTexParameters(ccTexParams* texParams);
/** sets antialias texture parameters:
- GL_TEXTURE_MIN_FILTER = GL_LINEAR
- GL_TEXTURE_MAG_FILTER = GL_LINEAR
@since v0.8
*/
void setAntiAliasTexParameters();
/** sets alias texture parameters:
- GL_TEXTURE_MIN_FILTER = GL_NEAREST
- GL_TEXTURE_MAG_FILTER = GL_NEAREST
@since v0.8
*/
void setAliasTexParameters();
/** Generates mipmap images for the texture.
It only works if the texture size is POT (power of 2).
@since v0.99.0
*/
void generateMipmap();
/** sets the default pixel format for UIImages that contains alpha channel.
If the UIImage contains alpha channel, then the options are:
- generate 32-bit textures: kCCTexture2DPixelFormat_RGBA8888 (default one)
- 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)
- If the image is an RGB (without Alpha) then an RGB565 texture will be used (16-bit texture)
@since v0.8
*/
static void setDefaultAlphaPixelFormat(CCTexture2DPixelFormat format);
/** returns the alpha pixel format
@since v0.8
*/
static CCTexture2DPixelFormat defaultAlphaPixelFormat();
private:
/// @todo CCTexture2D * initPremultipliedATextureWithImage(CGImageRef image, UINT32 pixelsWide, UINT32 pixelsHigh);
};
#endif //__CCTEXTURE2D_H__