OOConcreteTexture(Private) Category Reference

Instance Methods
(void)	- setUpTexture
(void)	- uploadTexture
(void)	- uploadTextureDataWithMipMap:format:
(GLenum)	- glTextureTarget
(BOOL)	- isReloadable
(void)	- forceRebind [implementation]

Detailed Description

Definition at line 54 of file OOConcreteTexture.m.

Method Documentation

forceRebind

- (void) forceRebind

implementation

Extends class OOConcreteTexture.

Definition at line 671 of file OOConcreteTexture.m.

{
    if (_loaded && _uploaded && _valid)
    {
        OO_ENTER_OPENGL();
        
        _uploaded = NO;
        OOGL(glDeleteTextures(1, &_textureName));
        _textureName = 0;
        
#if OOTEXTURE_RELOADABLE
        if ([self isReloadable])
        {
            OOLog(@"texture.reload", @"Reloading texture %@", self);
            
            free(_bytes);
            _bytes = NULL;
            _loaded = NO;
            _uploaded = NO;
            _valid = NO;
            
            _loader = [[OOTextureLoader loaderWithPath:_path options:_options] retain];
        }
#endif
    }
}

glTextureTarget

- (GLenum) glTextureTarget

Extends class OOConcreteTexture.

Definition at line 671 of file OOConcreteTexture.m.

{
    GLenum texTarget = GL_TEXTURE_2D;
#if OO_TEXTURE_CUBE_MAP
    if (_isCubeMap)
    {
        texTarget = GL_TEXTURE_CUBE_MAP;
    }
#endif
    return texTarget;
}

isReloadable

- (BOOL) isReloadable

Extends class OOConcreteTexture.

Definition at line 671 of file OOConcreteTexture.m.

{
    return _path != nil;
}

setUpTexture

- (void) setUpTexture

Extends class OOConcreteTexture.

Definition at line 671 of file OOConcreteTexture.m.

{
    OOPixMap        pm;
    
    // This will block until loading is completed, if necessary.
    if ([_loader getResult:&pm format:&_format originalWidth:&_originalWidth originalHeight:&_originalHeight])
    {
        _bytes = pm.pixels;
        _width = pm.width;
        _height = pm.height;
        
#if OO_TEXTURE_CUBE_MAP
        if (_options & kOOTextureAllowCubeMap && _height == _width * 6 && gOOTextureInfo.cubeMapAvailable)
        {
            _isCubeMap = YES;
        }
#endif
        
#if !defined(NDEBUG) && OOTEXTURE_RELOADABLE
        if (_trace)
        {
            static unsigned dumpID = 0;
            NSString *name = [NSString stringWithFormat:@"tex dump %u \"%@\"", ++dumpID,[self name]];
            OOLog(@"texture.trace.dump", @"Dumped traced texture %@ to \'%@.png\'", self, name);
            OODumpPixMap(pm, name);
        }
#endif
        
        [self uploadTexture];
    }
    else
    {
        _textureName = 0;
        _valid = NO;
        _uploaded = YES;
    }
    
    _loaded = YES;
    
    DESTROY(_loader);
}

uploadTexture

- (void) uploadTexture

Extends class OOConcreteTexture.

Definition at line 671 of file OOConcreteTexture.m.

{
    GLint                   filter;
    BOOL                    mipMap = NO;
    
    OO_ENTER_OPENGL();
    
    if (!_uploaded)
    {
        GLenum texTarget = [self glTextureTarget];
        
        OOGL(glGenTextures(1, &_textureName));
        OOGL(glBindTexture(texTarget, _textureName));
        
        // Select wrap mode
        GLint clampMode = gOOTextureInfo.clampToEdgeAvailable ? GL_CLAMP_TO_EDGE : GL_CLAMP;
        GLint wrapS = (_options & kOOTextureRepeatS) ? GL_REPEAT : clampMode;
        GLint wrapT = (_options & kOOTextureRepeatT) ? GL_REPEAT : clampMode;
        
#if OO_TEXTURE_CUBE_MAP
        if (texTarget == GL_TEXTURE_CUBE_MAP)
        {
            wrapS = wrapT = clampMode;
            OOGL(glTexParameteri(texTarget, GL_TEXTURE_WRAP_R, clampMode));
        }
#endif
        
        OOGL(glTexParameteri(texTarget, GL_TEXTURE_WRAP_S, wrapS));
        OOGL(glTexParameteri(texTarget, GL_TEXTURE_WRAP_T, wrapT));
        
        // Select min filter
        filter = _options & kOOTextureMinFilterMask;
        if (filter == kOOTextureMinFilterNearest)  filter = GL_NEAREST;
        else if (filter == kOOTextureMinFilterMipMap)
        {
            mipMap = YES;
            filter = GL_LINEAR_MIPMAP_LINEAR;
        }
        else  filter = GL_LINEAR;
        OOGL(glTexParameteri(texTarget, GL_TEXTURE_MIN_FILTER, filter));
        
#if GL_EXT_texture_filter_anisotropic
        if (gOOTextureInfo.anisotropyAvailable && mipMap && 1.0 < _anisotropy)
        {
            OOGL(glTexParameterf(texTarget, GL_TEXTURE_MAX_ANISOTROPY_EXT, _anisotropy));
        }
#endif
        
        // Select mag filter
        filter = _options & kOOTextureMagFilterMask;
        if (filter == kOOTextureMagFilterNearest)  filter = GL_NEAREST;
        else  filter = GL_LINEAR;
        OOGL(glTexParameteri(texTarget, GL_TEXTURE_MAG_FILTER, filter));
        
    //  if (gOOTextureInfo.clientStorageAvailable)  EnableClientStorage();
        
        if (texTarget == GL_TEXTURE_2D)
        {
            [self uploadTextureDataWithMipMap:mipMap format:_format];
            OOLog(@"texture.upload", @"Uploaded texture %u (%ux%u pixels, %@)", _textureName, _width, _height, _key);
        }
#if OO_TEXTURE_CUBE_MAP
        else if (texTarget == GL_TEXTURE_CUBE_MAP)
        {
            [self uploadTextureCubeMapDataWithMipMap:mipMap format:_format];
            OOLog(@"texture.upload", @"Uploaded cube map texture %u (%ux%ux6 pixels, %@)", _textureName, _width, _width, _key);
        }
#endif
        else
        {
            [NSException raise:NSInternalInconsistencyException format:@"Unhandled texture target 0x%X.", texTarget];
        }
        
        _valid = YES;
        _uploaded = YES;
        
#if OOTEXTURE_RELOADABLE
        if ([self isReloadable])
        {
            free(_bytes);
            _bytes = NULL;
        }
#endif
    }
}

uploadTextureDataWithMipMap:format:

- (void) uploadTextureDataWithMipMap:		(BOOL)	mipMap
format:		(OOTextureDataFormat)	format

Extends class OOConcreteTexture.

Definition at line 671 of file OOConcreteTexture.m.

                                   :(BOOL)mipMap format:(OOTextureDataFormat)format
{
    GLenum                  glFormat = 0, internalFormat = 0, type = 0;
    unsigned                w = _width,
                            h = _height,
                            level = 0;
    char                    *bytes = _bytes;
    uint8_t                 components = OOTextureComponentsForFormat(format);
    
    OO_ENTER_OPENGL();
    
    if (!DecodeFormat(format, _options, &glFormat, &internalFormat, &type))  return;
    
    while (0 < w && 0 < h)
    {
        OOGL(glTexImage2D(GL_TEXTURE_2D, level++, internalFormat, w, h, 0, glFormat, type, bytes));
        if (!mipMap)  return;
        bytes += w * components * h;
        w >>= 1;
        h >>= 1;
    }
    
    // Note: we only reach here if (mipMap).
    _mipLevels = level - 1;
    OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAX_LEVEL, _mipLevels));
}

---

The documentation for this category was generated from the following file:

• src/Core/Materials/OOConcreteTexture.m