OOTexture Class Reference

#include <OOTexture.h>

Inheritance diagram for OOTexture:

Collaboration diagram for OOTexture:

Instance Methods
(void)	- apply
(void)	- ensureFinishedLoading
(BOOL)	- isFinishedLoading
(NSString *)	- cacheKey
(NSSize)	- dimensions
(NSSize)	- originalDimensions
(BOOL)	- isMipMapped
(OOPixMap)	- copyPixMapRepresentation
(BOOL)	- isRectangleTexture
(BOOL)	- isCubeMap
(NSSize)	- texCoordsScale
(GLint)	- glTextureName
(void)	- setTrace:
(size_t)	- dataSize
(NSString *)	- name
(id)	- init [implementation]
(void)	- dealloc [implementation]
(void)	- forceRebind [implementation]
(void)	- addToCaches [implementation]
(void)	- removeFromCaches [implementation]
(id)	- retainInContext: [implementation]
(void)	- releaseInContext: [implementation]
(id)	- autoreleaseInContext: [implementation]
(id)	- retain [implementation]
(oneway void)	- release [implementation]
(id)	- autorelease [implementation]
Instance Methods inherited from OOWeakRefObject
(id)	- weakSelf
(id)	- weakRetain [implementation]
(void)	- weakRefDied: [implementation]
Instance Methods inherited from <OOWeakReferenceSupport>
(id)	- OO_RETURNS_RETAINED

Class Methods
(id)	+ textureWithName:inFolder:options:anisotropy:lodBias:
(id)	+ textureWithName:inFolder:
(id)	+ textureWithConfiguration:
(id)	+ textureWithConfiguration:extraOptions:
(id)	+ nullTexture
(id)	+ textureWithGenerator:
(id)	+ textureWithGenerator:enqueue:
(void)	+ applyNone
(void)	+ clearCache
(void)	+ rebindAllTextures
(NSArray *)	+ cachedTexturesByAge
(NSSet *)	+ allTextures
(OOTexture *)	+ existingTextureForKey: [implementation]
(void)	+ checkExtensions [implementation]

Protected Attributes
BOOL	_trace
Protected Attributes inherited from OOWeakRefObject
OOWeakReference *	weakSelf

Detailed Description

Definition at line 116 of file OOTexture.h.

Method Documentation

addToCaches

- (void) addToCaches

implementation

Provided by category OOTexture(SubclassInterface).

Definition at line 444 of file OOTexture.m.

{
#ifndef OOTEXTURE_NO_CACHE
    NSString *cacheKey = [self cacheKey];
    if (cacheKey == nil)  return;
    
    // Add self to in-use textures cache, wrapped in an NSValue so the texture isn't retained by the cache.
    if (EXPECT_NOT(sLiveTextureCache == nil))  sLiveTextureCache = [[NSMutableDictionary alloc] init];
    
    SET_TRACE_CONTEXT(@"in-use textures cache - SHOULD NOT RETAIN");
    [sLiveTextureCache setObject:[NSValue valueWithPointer:self] forKey:cacheKey];
    CLEAR_TRACE_CONTEXT();
    
    // Add self to recent textures cache.
    if (EXPECT_NOT(sRecentTextures == nil))
    {
        sRecentTextures = [[OOCache alloc] init];
        [sRecentTextures setName:@"recent textures"];
        [sRecentTextures setAutoPrune:YES];
        [sRecentTextures setPruneThreshold:kRecentTexturesCount];
    }
    
    SET_TRACE_CONTEXT(@"adding to recent textures cache");
    [sRecentTextures setObject:self forKey:cacheKey];
    CLEAR_TRACE_CONTEXT();
#endif
}

References OOTexture(OOPrivate)::addToCaches, cacheKey, CLEAR_TRACE_CONTEXT, EXPECT_NOT, nil, SET_TRACE_CONTEXT, OOCache::setAutoPrune:, OOCache::setName:, OOCache::setObject:forKey:, OOCache::setPruneThreshold:, sLiveTextureCache, and sRecentTextures.

Referenced by OOTexture(OOPrivate)::addToCaches, and OOConcreteTexture::initWithLoader:key:options:anisotropy:lodBias:.

Here is the call graph for this function:

Here is the caller graph for this function:

allTextures

+ (NSSet *) allTextures

Definition at line 405 of file OOTexture.m.

{
    NSMutableSet *result = [NSMutableSet setWithCapacity:[sAllLiveTextures count]];
    NSValue *box = nil;
    NSEnumerator *texEnum = nil;
    for (texEnum = [sAllLiveTextures objectEnumerator]; (box = [texEnum nextObject]); )
    {
        [result addObject:[box pointerValue]];
    }
    
    return result;
}

References allTextures, nil, and sAllLiveTextures.

Referenced by allTextures, and OODebugMonitor::dumpMemoryStatistics.

Here is the call graph for this function:

Here is the caller graph for this function:

apply

- (void) apply

Reimplemented in OOConcreteTexture, and OONullTexture.

Provided by category OOTexture(SubclassResponsibilities).

Definition at line 269 of file OOTexture.m.

{
    OOLogGenericSubclassResponsibility();
}

References apply, OOLogGenericSubclassResponsibility, and textureWithName:inFolder:options:anisotropy:lodBias:.

Referenced by apply, OOTextureSprite::blitToX:Y:Z:alpha:, OOSingleTextureMaterial::doApply, DustEntity::drawImmediate:translucent:, OOLaserShotEntity::drawImmediate:translucent:, OOLightParticleEntity::drawImmediate:translucent:, OOParticleSystem::drawImmediate:translucent:, HeadUpDisplay(Private)::drawScannerZoomIndicator:, OOExhaustPlumeEntity::drawSubEntityImmediate:translucent:, OOTrumble::drawTrumble:, PlanetEntity::drawUnconditionally, HeadUpDisplay::OODrawPlanetInfo, HeadUpDisplay::OOStartDrawingStrings, and OOSkyQuadSet::render.

Here is the call graph for this function:

Here is the caller graph for this function:

applyNone

+ (void) applyNone

Definition at line 275 of file OOTexture.m.

{
    OO_ENTER_OPENGL();
    OOGL(glBindTexture(GL_TEXTURE_2D, 0));
#if OO_TEXTURE_CUBE_MAP
    if (OOCubeMapsAvailable())  OOGL(glBindTexture(GL_TEXTURE_CUBE_MAP, 0));
#endif
    
#if GL_EXT_texture_lod_bias
    if (gOOTextureInfo.textureLODBiasAvailable)  OOGL(glTexEnvf(GL_TEXTURE_FILTER_CONTROL_EXT, GL_TEXTURE_LOD_BIAS_EXT, 0));
#endif
}

References applyNone, gOOTextureInfo, OO_ENTER_OPENGL, OOCubeMapsAvailable(), and OOGL.

Referenced by OONullTexture::apply, applyNone, OOBasicMaterial::doApply, GuiDisplayGen(Internal)::drawGLDisplay:x:y:z:, HeadUpDisplay(Private)::drawScannerZoomIndicator:, PlanetEntity::drawUnconditionally, HeadUpDisplay::OODrawPlanetInfo, HeadUpDisplay::OOStopDrawingStrings, and OOSingleTextureMaterial::unapplyWithNext:.

Here is the call graph for this function:

Here is the caller graph for this function:

autorelease

- (id) autorelease

implementation

Reimplemented in OONullTexture.

Definition at line 620 of file OOTexture.m.

{
    return [self autoreleaseInContext:sGlobalTraceContext];
}

References autorelease, and autoreleaseInContext:.

Referenced by autorelease.

Here is the call graph for this function:

Here is the caller graph for this function:

autoreleaseInContext:

- (id) autoreleaseInContext: (NSString *) context

implementation

Provided by category OOTexture(OOPrivate).

Definition at line 596 of file OOTexture.m.

                           :(NSString *)context
{
    if (_trace)
    {
        if (context)  OOLog(@"texture.allocTrace.autoreleased", @"Texture %p autoreleased - %@.", self, context);
        else  OOLog(@"texture.allocTrace.autoreleased", @"Texture %p autoreleased.", self);
    }
    
    return [super autorelease];
}

References OOLog.

Referenced by autorelease.

Here is the caller graph for this function:

cachedTexturesByAge

+ (NSArray *) cachedTexturesByAge

Definition at line 399 of file OOTexture.m.

{
    return [sRecentTextures objectsByAge];
}

References cachedTexturesByAge, and OOCache::objectsByAge.

Referenced by cachedTexturesByAge, and OODebugMonitor::dumpMemoryStatistics.

Here is the call graph for this function:

Here is the caller graph for this function:

cacheKey

- (NSString *) cacheKey

Reimplemented in OOConcreteTexture.

Provided by category OOTexture(SubclassOptional).

Definition at line 300 of file OOTexture.m.

{
    return nil;
}

References cacheKey, and nil.

Referenced by OOTexture(OOPrivate)::addToCaches, cacheKey, and OOTexture(SubclassInterface)::removeFromCaches.

Here is the call graph for this function:

Here is the caller graph for this function:

checkExtensions

+ (void) checkExtensions

implementation

Provided by category OOTexture(OOPrivate).

Definition at line 516 of file OOTexture.m.

{
    OO_ENTER_OPENGL();
    
    sCheckedExtensions = YES;
    
    OOOpenGLExtensionManager    *extMgr = [OOOpenGLExtensionManager sharedManager];
    BOOL                        ver120 = [extMgr versionIsAtLeastMajor:1 minor:2];
    BOOL                        ver130 = [extMgr versionIsAtLeastMajor:1 minor:3];
    
#if GL_EXT_texture_filter_anisotropic
    gOOTextureInfo.anisotropyAvailable = [extMgr haveExtension:@"GL_EXT_texture_filter_anisotropic"];
    OOGL(glGetFloatv(GL_MAX_TEXTURE_MAX_ANISOTROPY_EXT, &gOOTextureInfo.anisotropyScale));
    gOOTextureInfo.anisotropyScale *= OOClamp_0_1_f([[NSUserDefaults standardUserDefaults] oo_floatForKey:@"texture-anisotropy-scale" defaultValue:0.5]);
#endif
    
#ifdef GL_CLAMP_TO_EDGE
    gOOTextureInfo.clampToEdgeAvailable = ver120 || [extMgr haveExtension:@"GL_SGIS_texture_edge_clamp"];
#endif
    
#if OO_GL_CLIENT_STORAGE
    gOOTextureInfo.clientStorageAvailable = [extMgr haveExtension:@"GL_APPLE_client_storage"];
#endif
    
    gOOTextureInfo.textureMaxLevelAvailable = ver120 || [extMgr haveExtension:@"GL_SGIS_texture_lod"];
    
#if GL_EXT_texture_lod_bias
    if ([[NSUserDefaults standardUserDefaults] oo_boolForKey:@"use-texture-lod-bias" defaultValue:YES])
    {
        gOOTextureInfo.textureLODBiasAvailable = [extMgr haveExtension:@"GL_EXT_texture_lod_bias"];
    }
    else
    {
        gOOTextureInfo.textureLODBiasAvailable = NO;
    }
#endif
    
#if GL_EXT_texture_rectangle
    gOOTextureInfo.rectangleTextureAvailable = [extMgr haveExtension:@"GL_EXT_texture_rectangle"];
#endif
    
#if OO_TEXTURE_CUBE_MAP
    if (![[NSUserDefaults standardUserDefaults] boolForKey:@"disable-cube-maps"])
    {
        gOOTextureInfo.cubeMapAvailable = ver130 || [extMgr haveExtension:@"GL_ARB_texture_cube_map"];
    }
    else
    {
        gOOTextureInfo.cubeMapAvailable = NO;
    }
 
#endif
}

References checkExtensions, gOOTextureInfo, OOOpenGLExtensionManager::haveExtension:, OO_ENTER_OPENGL, OOGL, sCheckedExtensions, OOOpenGLExtensionManager::sharedManager, and OOOpenGLExtensionManager::versionIsAtLeastMajor:minor:.

Referenced by checkExtensions, and textureWithName:inFolder:options:anisotropy:lodBias:.

Here is the call graph for this function:

Here is the caller graph for this function:

clearCache

+ (void) clearCache

Definition at line 357 of file OOTexture.m.

{
    /*  Does not clear sAllLiveTextures - that really must refer to all
        live texture objects.
    */
    SET_TRACE_CONTEXT(@"clearing sLiveTextureCache");
    [sLiveTextureCache autorelease];
    sLiveTextureCache = nil;
    
    SET_TRACE_CONTEXT(@"clearing sRecentTextures");
    [sRecentTextures autorelease];
    sRecentTextures = nil;
    CLEAR_TRACE_CONTEXT();
}

References CLEAR_TRACE_CONTEXT, clearCache, nil, SET_TRACE_CONTEXT, sLiveTextureCache, and sRecentTextures.

Referenced by clearCache, OODebugController::clearTextureCacheAction:, Universe::reinitAndShowDemo:, and OODebugController::resetAndClearAction:.

Here is the call graph for this function:

Here is the caller graph for this function:

copyPixMapRepresentation

- (struct OOPixMap) copyPixMapRepresentation

Reimplemented in OOConcreteTexture.

Provided by category OOTexture(SubclassOptional).

Definition at line 326 of file OOTexture.m.

{
    return kOONullPixMap;
}

References copyPixMapRepresentation, and kOONullPixMap.

Referenced by copyPixMapRepresentation, and OOCombinedEmissionMapGenerator(Private)::initWithEmissionMapSpec:emissionColor:diffuseMap:diffuseColor:illuminationMapSpec:illuminationColor:isCombinedMap:optionsSpecifier:.

Here is the call graph for this function:

Here is the caller graph for this function:

dataSize

- (size_t) dataSize

Definition at line 419 of file OOTexture.m.

{
    NSSize dimensions = [self dimensions];
    size_t size = dimensions.width * dimensions.height;
    if ([self isCubeMap])  size *= 6;
    if ([self isMipMapped])  size = size * 4 / 3;
    
    return size;
}

References dataSize, dimensions, isCubeMap, and isMipMapped.

Referenced by dataSize, and OODebugMonitor::dumpMemoryStatistics.

Here is the call graph for this function:

Here is the caller graph for this function:

dealloc

- (void) dealloc

implementation

Reimplemented from OOWeakRefObject.

Reimplemented in OOConcreteTexture.

Definition at line 261 of file OOTexture.m.

{
    [sAllLiveTextures removeObject:[NSValue valueWithPointer:self]];
    
    [super dealloc];
}

References dealloc, and OOWeakRefObject::dealloc.

Referenced by OOConcreteTexture::dealloc, and dealloc.

Here is the call graph for this function:

Here is the caller graph for this function:

dimensions

- (NSSize) dimensions

Reimplemented in OOConcreteTexture, and OONullTexture.

Provided by category OOTexture(SubclassResponsibilities).

Definition at line 306 of file OOTexture.m.

{
    OOLogGenericSubclassResponsibility();
    return NSZeroSize;
}

References dimensions, nil, OOLogGenericSubclassResponsibility, and textureWithName:inFolder:options:anisotropy:lodBias:.

Referenced by HeadUpDisplay::addLegend:, dataSize, dimensions, HeadUpDisplay(Private)::drawCustomImage:, and originalDimensions.

Here is the call graph for this function:

Here is the caller graph for this function:

ensureFinishedLoading

- (void) ensureFinishedLoading

Reimplemented in OOConcreteTexture.

Provided by category OOTexture(SubclassOptional).

Definition at line 289 of file OOTexture.m.

{
}

References ensureFinishedLoading, and textureWithName:inFolder:options:anisotropy:lodBias:.

Referenced by PlanetEntity::drawUnconditionally, OOSingleTextureMaterial::ensureFinishedLoading, ensureFinishedLoading, and OOProbabilisticTextureManager::ensureTexturesLoaded.

Here is the call graph for this function:

Here is the caller graph for this function:

existingTextureForKey:

+ (OOTexture *) existingTextureForKey: (NSString *) key

implementation

Provided by category OOTexture(SubclassInterface).

Definition at line 502 of file OOTexture.m.

                                     :(NSString *)key
{
#ifndef OOTEXTURE_NO_CACHE
    if (key != nil)
    {
        return (OOTexture *)[[sLiveTextureCache objectForKey:key] pointerValue];
    }
    return nil;
#else
    return nil;
#endif
}

References nil.

Referenced by textureWithGenerator:enqueue:, and textureWithName:inFolder:options:anisotropy:lodBias:.

Here is the caller graph for this function:

forceRebind

- (void) forceRebind

implementation

Reimplemented in OOConcreteTexture, and OONullTexture.

Provided by category OOTexture(SubclassResponsibilities).

Definition at line 438 of file OOTexture.m.

{
    OOLogGenericSubclassResponsibility();
}

References OOTexture(OOPrivate)::forceRebind, and OOLogGenericSubclassResponsibility.

Referenced by OOTexture(OOPrivate)::existingTextureForKey:, and OOTexture(OOPrivate)::forceRebind.

Here is the call graph for this function:

Here is the caller graph for this function:

glTextureName

- (GLint) glTextureName

Reimplemented in OOConcreteTexture.

Definition at line 350 of file OOTexture.m.

{
    OOLogGenericSubclassResponsibility();
    return 0;
}

References glTextureName, and OOLogGenericSubclassResponsibility.

Referenced by glTextureName.

Here is the call graph for this function:

Here is the caller graph for this function:

init

- (id) init

implementation

Definition at line 249 of file OOTexture.m.

{
    if ((self = [super init]))
    {
        if (EXPECT_NOT(sAllLiveTextures == nil))  sAllLiveTextures = [[NSMutableSet alloc] init];
        [sAllLiveTextures addObject:[NSValue valueWithPointer:self]];
    }
    
    return self;
}

References EXPECT_NOT, init, nil, and sAllLiveTextures.

Referenced by init, and OOConcreteTexture::initWithLoader:key:options:anisotropy:lodBias:.

Here is the call graph for this function:

Here is the caller graph for this function:

isCubeMap

- (BOOL) isCubeMap

Reimplemented in OOConcreteTexture.

Provided by category OOTexture(SubclassOptional).

Definition at line 338 of file OOTexture.m.

{
    return NO;
}

References isCubeMap.

Referenced by dataSize, isCubeMap, and OOSingleTextureMaterial::wantsNormalsAsTextureCoordinates.

Here is the call graph for this function:

Here is the caller graph for this function:

isFinishedLoading

- (BOOL) isFinishedLoading

Reimplemented in OOConcreteTexture.

Provided by category OOTexture(SubclassOptional).

Definition at line 294 of file OOTexture.m.

{
    return YES;
}

References isFinishedLoading, and textureWithConfiguration:extraOptions:.

Referenced by OOSingleTextureMaterial::isFinishedLoading, and isFinishedLoading.

Here is the call graph for this function:

Here is the caller graph for this function:

isMipMapped

- (BOOL) isMipMapped

Reimplemented in OOConcreteTexture, and OONullTexture.

Definition at line 319 of file OOTexture.m.

{
    OOLogGenericSubclassResponsibility();
    return NO;
}

References isMipMapped, and OOLogGenericSubclassResponsibility.

Referenced by dataSize, and isMipMapped.

Here is the call graph for this function:

Here is the caller graph for this function:

isRectangleTexture

- (BOOL) isRectangleTexture

Reimplemented in OOConcreteTexture.

Provided by category OOTexture(SubclassOptional).

Definition at line 332 of file OOTexture.m.

{
    return NO;
}

References isRectangleTexture.

Referenced by isRectangleTexture.

Here is the call graph for this function:

Here is the caller graph for this function:

name

- (NSString *) name

Reimplemented in OOConcreteTexture, and OONullTexture.

Definition at line 430 of file OOTexture.m.

{
    OOLogGenericSubclassResponsibility();
    return nil;
}

References name, nil, and OOLogGenericSubclassResponsibility.

Referenced by name, textureWithConfiguration:extraOptions:, and textureWithName:inFolder:options:anisotropy:lodBias:.

Here is the call graph for this function:

Here is the caller graph for this function:

nullTexture

+ (id) nullTexture

Definition at line 211 of file OOTexture.m.

{
    return [OONullTexture sharedNullTexture];
}

References nullTexture, and OONullTexture::sharedNullTexture.

Referenced by nullTexture.

Here is the call graph for this function:

Here is the caller graph for this function:

originalDimensions

- (NSSize) originalDimensions

Reimplemented in OOConcreteTexture.

Definition at line 313 of file OOTexture.m.

{
    return [self dimensions];
}

References dimensions, and originalDimensions.

Referenced by OOTextureSprite::initWithTexture:, GuiDisplayGen::NewTextureSpriteWithDescriptor, and originalDimensions.

Here is the call graph for this function:

Here is the caller graph for this function:

rebindAllTextures

+ (void) rebindAllTextures

Definition at line 373 of file OOTexture.m.

{
    NSEnumerator            *textureEnum = nil;
    id                      texture = nil;
    
    // Keeping around unused, cached textures is unhelpful at this point.
    DESTROY(sRecentTextures);
    
    for (textureEnum = [sAllLiveTextures objectEnumerator]; (texture = [[textureEnum nextObject] pointerValue]); )
    {
        [texture forceRebind];
    }
}

References DESTROY, nil, rebindAllTextures, sAllLiveTextures, and sRecentTextures.

Referenced by rebindAllTextures, and OOGraphicsResetManager::resetGraphicsState.

Here is the call graph for this function:

Here is the caller graph for this function:

release

- (oneway void) release

implementation

Reimplemented in OONullTexture.

Definition at line 614 of file OOTexture.m.

{
    [self releaseInContext:sGlobalTraceContext];
}

References release, and releaseInContext:.

Referenced by OOProbabilisticTextureManager::dealloc, OOSingleTextureMaterial::dealloc, OOSkyQuadSet::dealloc, OOTextureSprite::dealloc, OOTrumble::dealloc, OOConcreteTexture::initWithLoader:key:options:anisotropy:lodBias:, OOConcreteTexture::initWithPath:key:options:anisotropy:lodBias:, release, OOExhaustPlumeEntity::resetGraphicsState, OOFlashEffectEntity::resetGraphicsState, OOLaserShotEntity::resetGraphicsState, and OOLightParticleEntity::resetGraphicsState.

Here is the call graph for this function:

Here is the caller graph for this function:

releaseInContext:

- (void) releaseInContext: (NSString *) context

implementation

Provided by category OOTexture(OOPrivate).

Definition at line 584 of file OOTexture.m.

                         :(NSString *)context
{
    if (_trace)
    {
        if (context)  OOLog(@"texture.allocTrace.release", @"Texture %p released (retain count -> %lu) - %@.", self, [self retainCount] - 1, context);
        else  OOLog(@"texture.allocTrace.release", @"Texture %p released (retain count -> %lu).", self, [self retainCount] - 1);
    }
    
    [super release];
}

References OOLog.

Referenced by release.

Here is the caller graph for this function:

removeFromCaches

- (void) removeFromCaches

implementation

Provided by category OOTexture(SubclassInterface).

Definition at line 473 of file OOTexture.m.

{
#ifndef OOTEXTURE_NO_CACHE
    NSString *cacheKey = [self cacheKey];
    if (cacheKey == nil)  return;
    
    [sLiveTextureCache removeObjectForKey:cacheKey];
    if (EXPECT_NOT([sRecentTextures objectForKey:cacheKey] == self))
    {
        /* Experimental for now: I think the recent crash problems may
         * be because if the last reference to a texture is in
         * sRecentTextures, and the texture is regenerated, it
         * replaces the texture, causing a release. Therefore, if this
         * texture *isn't* overretained in the texture cache, the 2009
         * crash avoider will delete its replacement from the cache
         * ... possibly before that texture has been fully added to
         * the cache itself. So, the texture is only removed from the
         * cache by key if it was in it with that key. The extra time
         * needed to generate a planet texture compared with loading a
         * standard one may be why this problem shows up.  - CIM 20140122
         */
        NSAssert2(0, @"Texture retain count error for %@; cacheKey is %@.", self, cacheKey); //miscount in autorelease
        // The following line is needed in order to avoid crashes when there's a 'texture retain count error'. Please do not delete. -- Kaks 20091221
        [sRecentTextures removeObjectForKey:cacheKey]; // make sure there's no reference left inside sRecentTexture ( was a show stopper for 1.73)
    }
#endif
}

References cacheKey, EXPECT_NOT, nil, OOTexture(SubclassInterface)::removeFromCaches, OOCache::removeObjectForKey:, and sRecentTextures.

Referenced by OOConcreteTexture::dealloc, and OOTexture(SubclassInterface)::removeFromCaches.

Here is the call graph for this function:

Here is the caller graph for this function:

retain

- (id) retain

implementation

Reimplemented in OONullTexture.

Definition at line 608 of file OOTexture.m.

{
    return [self retainInContext:sGlobalTraceContext];
}

References retain, and retainInContext:.

Referenced by PlanetEntity::initFromDictionary:withAtmosphere:andSeed:, HeadUpDisplay::InitTextEngine(void), OOCombinedEmissionMapGenerator(Private)::initWithEmissionMapSpec:emissionColor:diffuseMap:diffuseColor:illuminationMapSpec:illuminationColor:isCombinedMap:optionsSpecifier:, OOSingleTextureMaterial::initWithName:texture:configuration:, OOProbabilisticTextureManager::initWithPListName:options:anisotropy:lodBias:seed:, OOSkyQuadSet::initWithQuadsWithTexture:inArray:count:, OOTextureSprite::initWithTexture:size:, retain, OOTrumble::setupForPlayer:digram:, and textureWithGenerator:enqueue:.

Here is the call graph for this function:

Here is the caller graph for this function:

retainInContext:

- (id) retainInContext: (NSString *) context

implementation

Provided by category OOTexture(OOPrivate).

Definition at line 572 of file OOTexture.m.

                      :(NSString *)context
{
    if (_trace)
    {
        if (context)  OOLog(@"texture.allocTrace.retain", @"Texture %p retained (retain count -> %lu) - %@.", self, [self retainCount] + 1, context);
        else  OOLog(@"texture.allocTrace.retain", @"Texture %p retained  (retain count -> %lu).", self, [self retainCount] + 1);
    }
    
    return [super retain];
}

References OOLog.

Referenced by retain.

Here is the caller graph for this function:

setTrace:

- (void) setTrace:

(BOOL)

trace

Definition at line 389 of file OOTexture.m.

                 :(BOOL)trace
{
    if (trace && !_trace)
    {
        OOLog(@"texture.allocTrace.begin", @"Started tracing texture %p with retain count %lu.", self, [self retainCount]);
    }
    _trace = trace;
}

References _trace, and OOLog.

texCoordsScale

- (NSSize) texCoordsScale

Reimplemented in OOConcreteTexture.

Provided by category OOTexture(SubclassOptional).

Definition at line 344 of file OOTexture.m.

{
    return NSMakeSize(1.0, 1.0);
}

References texCoordsScale.

Referenced by texCoordsScale.

Here is the call graph for this function:

Here is the caller graph for this function:

textureWithConfiguration:

+ (id) textureWithConfiguration:

(id)

configuration

Definition at line 192 of file OOTexture.m.

                              :(id)configuration
{
    return [self textureWithConfiguration:configuration extraOptions:0];
}

Referenced by OOSingleTextureMaterial::initWithName:configuration:.

Here is the caller graph for this function:

textureWithConfiguration:extraOptions:

+ (id) textureWithConfiguration:		(id)	configuration
extraOptions:		(OOTextureFlags)	extraOptions

Definition at line 198 of file OOTexture.m.

                               :(id)configuration extraOptions:(OOTextureFlags)extraOptions
{
    NSString                *name = nil;
    OOTextureFlags            options = 0;
    GLfloat                 anisotropy = 0.0f;
    GLfloat                 lodBias = 0.0f;
    
    if (!OOInterpretTextureSpecifier(configuration, &name, &options, &anisotropy, &lodBias, NO))  return nil;
    
    return [self textureWithName:name inFolder:@"Textures" options:options | extraOptions anisotropy:anisotropy lodBias:lodBias];
}

References name, and nil.

Referenced by OOTexture(SubclassOptional)::isFinishedLoading, and PlanetEntity(OOPrivate)::loadTexture:.

Here is the call graph for this function:

Here is the caller graph for this function:

textureWithGenerator:

+ (id) textureWithGenerator:

(OOTextureGenerator *)

generator

Definition at line 217 of file OOTexture.m.

                           :(OOTextureGenerator *)generator
{
    return [self textureWithGenerator:generator enqueue: NO];
}

References textureWithGenerator:enqueue:.

Referenced by PlanetEntity(OOPrivate)::cloudTextureWithCloudColor:cloudImpress:cloudBias:, and PlanetEntity(OOPrivate)::planetTextureWithInfo:.

Here is the call graph for this function:

Here is the caller graph for this function:

textureWithGenerator:enqueue:

+ (id) textureWithGenerator:		(OOTextureGenerator *)	generator
enqueue:		(BOOL)	enqueue

Definition at line 223 of file OOTexture.m.

                           :(OOTextureGenerator *)generator enqueue:(BOOL) enqueue
{
    if (generator == nil)  return nil;
    
#ifndef OOTEXTURE_NO_CACHE
    OOTexture *existing = [OOTexture existingTextureForKey:[generator cacheKey]];
    if (existing != nil && !enqueue)  return [[existing retain] autorelease];
#endif
    
    if (![generator enqueue])
    {
        OOLogERR(@"texture.generator.queue.failed", @"Failed to queue generator %@", generator);
        return nil;
    }
    OOLog(@"texture.generator.queue", @"Queued texture generator %@", generator);
    
    OOTexture *result = [[[OOConcreteTexture alloc] initWithLoader:generator
                                                               key:[generator cacheKey]
                                                           options:OOApplyTextureOptionDefaults([generator textureOptions])
                                                        anisotropy:[generator anisotropy]
                                                           lodBias:[generator lodBias]] autorelease];
    
    return result;
}

References OOTextureGenerator::anisotropy, OOTextureGenerator::cacheKey, existingTextureForKey:, OOTextureGenerator::lodBias, nil, OOLog, OOLogERR, retain, and OOTextureGenerator::textureOptions.

Referenced by textureWithGenerator:.

Here is the call graph for this function:

Here is the caller graph for this function:

textureWithName:inFolder:

+ (id) textureWithName:		(NSString *)	name
inFolder:		(NSString*)	directory

Definition at line 181 of file OOTexture.m.

                     :(NSString *)name
             inFolder:(NSString*)directory
{
    return [self textureWithName:name
                        inFolder:directory
                         options:kOOTextureDefaultOptions
                      anisotropy:kOOTextureDefaultAnisotropy
                         lodBias:kOOTextureDefaultLODBias];
}

Referenced by OOMaterial(OOConvenienceCreators)::materialWithName:cacheKey:materialDictionary:shadersDictionary:macros:bindingTarget:forSmoothedMesh:.

Here is the caller graph for this function:

textureWithName:inFolder:options:anisotropy:lodBias:

+ (id) textureWithName:		(NSString *)	name
inFolder:		(NSString *)	directory
options:		(OOTextureFlags)	options
anisotropy:		(GLfloat)	anisotropy
lodBias:		(GLfloat)	lodBias

Definition at line 134 of file OOTexture.m.

                     :(NSString *)name
             inFolder:(NSString*)directory
              options:(OOTextureFlags)options
           anisotropy:(GLfloat)anisotropy
              lodBias:(GLfloat)lodBias
{
    NSString                *key = nil;
    OOTexture               *result = nil;
    NSString                *path = nil;
    BOOL                    noFNF;
    
    if (EXPECT_NOT(name == nil))  return nil;
    if (EXPECT_NOT(!sCheckedExtensions))  [self checkExtensions];
    
    if (!gOOTextureInfo.anisotropyAvailable || (options & kOOTextureMinFilterMask) != kOOTextureMinFilterMipMap)
    {
        anisotropy = 0.0f;
    }
    if (!gOOTextureInfo.textureLODBiasAvailable || (options & kOOTextureMinFilterMask) != kOOTextureMinFilterMipMap)
    {
        lodBias = 0.0f;
    }
    
    noFNF = (options & kOOTextureNoFNFMessage) != 0;
    options = OOApplyTextureOptionDefaults(options & ~kOOTextureNoFNFMessage);
    
    // Look for existing texture
    key = OOGenerateTextureCacheKey(directory, name, options, anisotropy, lodBias);
    result = [OOTexture existingTextureForKey:key];
    if (result == nil)
    {
        path = [ResourceManager pathForFileNamed:name inFolder:directory];
        if (path == nil)
        {
            if (!noFNF)  OOLogWARN(kOOLogFileNotFound, @"Could not find texture file \"%@\".", name);
            return nil;
        }
        
        // No existing texture, load texture.
        result = [[[OOConcreteTexture alloc] initWithPath:path key:key options:options anisotropy:anisotropy lodBias:lodBias] autorelease];
    }
    
    
    return result;
}

References checkExtensions, existingTextureForKey:, EXPECT_NOT, gOOTextureInfo, kOOLogFileNotFound, kOOTextureMinFilterMask, kOOTextureMinFilterMipMap, kOOTextureNoFNFMessage, name, nil, OOApplyTextureOptionDefaults(), OOGenerateTextureCacheKey(), OOLogWARN, ResourceManager::pathForFileNamed:inFolder:, and sCheckedExtensions.

Referenced by HeadUpDisplay::addLegend:, OOTexture(SubclassResponsibilities)::apply, OOTexture(SubclassResponsibilities)::dimensions, HeadUpDisplay(Private)::drawCustomImage:, OOTexture(SubclassOptional)::ensureFinishedLoading, DustEntity::init, OOExplosionCloudEntity(OOPrivate)::initExplosionCloudWithEntity:size:andSettings:, HeadUpDisplay::InitTextEngine(void), OOProbabilisticTextureManager::initWithPListName:options:anisotropy:lodBias:seed:, OOTrumble::setupForPlayer:digram:, OOExhaustPlumeEntity::setUpTexture, OOFlashEffectEntity::setUpTexture, OOLaserShotEntity::setUpTexture, OOLightParticleEntity::setUpTexture, and GuiDisplayGen::TextureForGUITexture.

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

_trace

- (BOOL) _trace

protected

Definition at line 120 of file OOTexture.h.

Referenced by OOConcreteTexture::dealloc, and setTrace:.

---

The documentation for this class was generated from the following files:

• src/Core/Materials/OOTexture.h
• src/Core/Materials/OOTexture.m