OOCombinedEmissionMapGenerator(Private) Category Reference

Instance Methods
(id)	- initWithEmissionMapSpec:emissionColor:diffuseMap:diffuseColor:illuminationMapSpec:illuminationColor:isCombinedMap:optionsSpecifier:
(NSString *)	- constructCacheKey

Detailed Description

Definition at line 45 of file OOCombinedEmissionMapGenerator.m.

Method Documentation

constructCacheKey

- (NSString *) constructCacheKey

Extends class OOCombinedEmissionMapGenerator.

Definition at line 463 of file OOCombinedEmissionMapGenerator.m.

{
    NSMutableString *cacheKey = [NSMutableString string];
    
    if (_isCombinedMap)  [cacheKey appendString:@"combined emission and illumination map;"];
    else  if (_emissionSpec == nil)  [cacheKey appendString:@"illumination map;"];
    else  if (_illuminationSpec == nil)  [cacheKey appendString:@"emission map;"];
    else [cacheKey appendString:@"merged emission and illumination map;"];
    
    NSString *emissionDesc = nil;
    if (_emissionSpec != nil)
    {
        emissionDesc = OOTextureCacheKeyForSpecifier(_emissionSpec);
        [cacheKey appendFormat:@"emission:{%@}", emissionDesc];
        if (_emissionColor != nil)  [cacheKey appendFormat:@"*%@", [_emissionColor rgbaDescription]];
        [cacheKey appendString:@";"];
    }
    
    NSString *illuminationDesc = nil;
    if (_isCombinedMap)
    {
        illuminationDesc = [NSString stringWithFormat:@"%@:a", emissionDesc];
    }
    else if (_illuminationSpec != nil)
    {
        illuminationDesc = OOTextureCacheKeyForSpecifier(_illuminationSpec);
    }
    
    if (illuminationDesc != nil)
    {
        [cacheKey appendFormat:@"illumination:{%@}*{%@}", illuminationDesc, [_diffuseMap cacheKey]];
        if (_illuminationColor != nil)  [cacheKey appendFormat:@"*%@", [_illuminationColor rgbaDescription]];
        [cacheKey appendString:@";"];
    }
    
    return cacheKey;
}

initWithEmissionMapSpec:emissionColor:diffuseMap:diffuseColor:illuminationMapSpec:illuminationColor:isCombinedMap:optionsSpecifier:

- (id) initWithEmissionMapSpec:		(NSDictionary *)	emissionMapSpec
emissionColor:		(OOColor *)	emissionColor
diffuseMap:		(OOTexture *)	diffuseMap
diffuseColor:		(OOColor *)	diffuseColor
illuminationMapSpec:		(NSDictionary *)	illuminationMapSpec
illuminationColor:		(OOColor *)	illuminationColor
isCombinedMap:		(BOOL)	isCombinedMap
optionsSpecifier:		(NSDictionary *)	spec

Extends class OOCombinedEmissionMapGenerator.

Definition at line 463 of file OOCombinedEmissionMapGenerator.m.

                              :(NSDictionary *)emissionMapSpec
                 emissionColor:(OOColor *)emissionColor
                    diffuseMap:(OOTexture *)diffuseMap
                  diffuseColor:(OOColor *)diffuseColor
           illuminationMapSpec:(NSDictionary *)illuminationMapSpec
             illuminationColor:(OOColor *)illuminationColor
                 isCombinedMap:(BOOL)isCombinedMap
              optionsSpecifier:(NSDictionary *)spec
{
    if (emissionMapSpec == nil && illuminationMapSpec == nil)
    {
        [self release];
        return nil;
    }
    
    NSParameterAssert(illuminationMapSpec == nil || !isCombinedMap);
    
    uint32_t options;
    GLfloat anisotropy;
    GLfloat lodBias;
    OOInterpretTextureSpecifier(spec, NULL, &options, &anisotropy, &lodBias, YES);
    options = OOApplyTextureOptionDefaults(options);
    
    if ((self = [super initWithPath:@"<generated emission map>" options:options]))
    {
        /*  Illumination contribution is:
            illuminationMap * illuminationColor * diffuseMap * diffuseColor
            Since illuminationColor and diffuseColor aren't used otherwise,
            we may as well combine them up front.
        */
        illuminationColor = ModulateColor(diffuseColor, illuminationColor);
                                          
        if ([emissionColor isWhite])  emissionColor = nil;
        if ([illuminationColor isWhite])  illuminationColor = nil;
        if (!isCombinedMap && illuminationMapSpec == nil)  diffuseMap = nil;    // Diffuse map is only used with illumination
        
        // Insert extraShrink flag here instead of using extraOptions later because we need it in cache key too.
        NSMutableDictionary *emissionSpec = [emissionMapSpec mutableCopy];
        [emissionSpec oo_setBool:YES forKey:kOOTextureSpecifierExtraShrinkKey];
        _emissionSpec = emissionSpec;
        
        NSMutableDictionary *illuminationSpec = [illuminationMapSpec mutableCopy];
        [illuminationSpec oo_setBool:YES forKey:kOOTextureSpecifierExtraShrinkKey];
        _illuminationSpec = illuminationSpec;
        
        _diffuseMap = [diffuseMap retain];
        
        _emissionColor = [emissionColor retain];
        _illuminationColor = [illuminationColor retain];
        _isCombinedMap = isCombinedMap;
        
        _textureOptions = options;
        _anisotropy = anisotropy;
        _lodBias = lodBias;
        
        _cacheKey = [self constructCacheKey];
        
        if ([OOTexture existingTextureForKey:_cacheKey] == nil)
        {
            /*  Extract pixmap from diffuse map. This must be done in the main
                thread even if scheduling is fixed, because it might involve
                reading back pixels from OpenGL.
            */
            if (diffuseMap != nil)
            {
                _diffusePx = [diffuseMap copyPixMapRepresentation];
#ifndef NDEBUG
                _diffuseDesc = [[diffuseMap shortDescription] copy];
#endif
            }
            
            /*  Extract emission and illumination pixmaps from loaders. Ideally,
                this would be done asynchronously, but that requires dependency
                management in OOAsyncWorkManager.
            */
            OOTextureDataFormat format;
            if (_emissionSpec != nil)
            {
                OOTextureLoader *emissionMapLoader = [OOTextureLoader loaderWithTextureSpecifier:_emissionSpec
                                                                                    extraOptions:0
                                                                                          folder:@"Textures"];
                [emissionMapLoader getResult:&_emissionPx format:&format originalWidth:NULL originalHeight:NULL];
#ifndef NDEBUG
                _emissionDesc = [[emissionMapLoader shortDescription] copy];
#endif
            }
            if (_illuminationSpec != nil)
            {
                OOTextureLoader *illuminationMapLoader = [OOTextureLoader loaderWithTextureSpecifier:_illuminationSpec
                                                                                        extraOptions:0
                                                                                              folder:@"Textures"];
                [illuminationMapLoader getResult:&_illuminationPx format:&format originalWidth:NULL originalHeight:NULL];
#ifndef NDEBUG
                _illuminationDesc = [[illuminationMapLoader shortDescription] copy];
#endif
            }
        }
    }
    
    return self;
}

---

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

• src/Core/Materials/OOCombinedEmissionMapGenerator.m