OOTextureLoader(OOPrivate) Category Reference

Instance Methods
(void)	- applySettings
(void)	- getDesiredWidth:andHeight:

Class Methods
(void)	+ setUp

Detailed Description

Definition at line 63 of file OOTextureLoader.m.

Method Documentation

applySettings

- (void) applySettings

Extends class OOTextureLoader.

Definition at line 60 of file OOTextureLoader.m.

{
    OOPixMapDimension   desiredWidth, desiredHeight;
    BOOL                rescale;
    size_t              newSize;
    uint8_t             components;
    OOPixMap            pixMap;
    
    components = OOTextureComponentsForFormat(_format);
    
    // Apply defaults.
    if (_originalWidth == 0)  _originalWidth = _width;
    if (_originalHeight == 0)  _originalHeight = _height;
    if (_rowBytes == 0)  _rowBytes = _width * components;
    
    pixMap = OOMakePixMap(_data, _width, _height, components, _rowBytes, 0);
    
    if (_extractChannel)
    {
        if (OOExtractPixMapChannel(&pixMap, _extractChannelIndex, NO))
        {
            _format = kOOTextureDataGrayscale;
            components = 1;
        }
        else
        {
            OOLogWARN(@"texture.load.extractChannel.invalid", @"Cannot extract channel from texture \"%@\"", [_path lastPathComponent]);
        }
    }
    
    [self getDesiredWidth:&desiredWidth andHeight:&desiredHeight];
    
    if (_isCubeMap && !OOCubeMapsAvailable())
    {
        OOPixMapToRGBA(&pixMap);
        desiredHeight = MIN(desiredWidth * 2, 512U);
        if (sReducedDetail && desiredHeight > kCubeShrinkThreshold)  desiredHeight /= 2;
        desiredWidth = desiredHeight * 2;
        
        OOPixMap converted = OOConvertCubeMapToLatLong(pixMap, desiredHeight, _generateMipMaps);
        OOFreePixMap(&pixMap);
        pixMap = converted;
        _isCubeMap = NO;
        
#if DUMP_CONVERTED_CUBE_MAPS
        OODumpPixMap(pixMap, [NSString stringWithFormat:@"converted cube map %@", [[_path lastPathComponent] stringByDeletingPathExtension]]);
#endif
    }
    
    // Rescale if needed.
    rescale = (_width != desiredWidth || _height != desiredHeight);
    if (rescale)
    {
        BOOL leaveSpaceForMipMaps = _generateMipMaps;
#if OO_TEXTURE_CUBE_MAP
        if (_isCubeMap)  leaveSpaceForMipMaps = NO;
#endif
        
        OOLog(@"texture.load.rescale", @"Rescaling texture \"%@\" from %u x %u to %u x %u.", [_path lastPathComponent], pixMap.width, pixMap.height, desiredWidth, desiredHeight);
        
        pixMap = OOScalePixMap(pixMap, desiredWidth, desiredHeight, leaveSpaceForMipMaps);
        if (EXPECT_NOT(!OOIsValidPixMap(pixMap)))  return;
        
        _data = pixMap.pixels;
        _width = pixMap.width;
        _height = pixMap.height;
        _rowBytes = pixMap.rowBytes;
    }
    
#if OO_TEXTURE_CUBE_MAP
    if (_isCubeMap)
    {
        if (_generateMipMaps)
        {
            [self generateMipMapsForCubeMap];
        }
        return;
    }
#endif
    
    // Generate mip maps if needed.
    if (_generateMipMaps)
    {
        // Make space if needed.
        newSize = desiredWidth * components * desiredHeight;
        newSize = (newSize * 4) / 3;
        // +1 to fix overrun valgrind spotted - CIM
        _generateMipMaps = OOExpandPixMap(&pixMap, newSize+1);
        
        _data = pixMap.pixels;
        _width = pixMap.width;
        _height = pixMap.height;
        _rowBytes = pixMap.rowBytes;
    }
    if (_generateMipMaps)
    {
        OOGenerateMipMaps(_data, _width, _height, _format);
    }
    
    // All done.
}

getDesiredWidth:andHeight:

- (void) getDesiredWidth:		(OOPixMapDimension *)	outDesiredWidth
andHeight:		(OOPixMapDimension *)	outDesiredHeight

Extends class OOTextureLoader.

Definition at line 60 of file OOTextureLoader.m.

                       :(OOPixMapDimension *)outDesiredWidth andHeight:(OOPixMapDimension *)outDesiredHeight
{
    OOPixMapDimension   desiredWidth, desiredHeight;
    
    // Work out appropriate final size for textures.
    if (!_noScalingWhatsoever)
    {
        // Cube maps are six times as high as they are wide, and we need to preserve that.
        if (_allowCubeMap && _height == _width * 6)
        {
            _isCubeMap = YES;
            
            desiredWidth = OORoundUpToPowerOf2_PixMap((2 * _width) / 3);
            desiredWidth = MIN(desiredWidth, sGLMaxSize / 8);
            if (sReducedDetail)
            {
                if (256 < desiredWidth)  desiredWidth /= 2;
            }
            desiredWidth = MIN(desiredWidth, sUserMaxSize / 4);
            
            desiredHeight = desiredWidth * 6;
        }
        else
        {
            if (!sHaveNPOTTextures)
            {
                // Round to nearest power of two. NOTE: this is duplicated in OOTextureVerifierStage.m.
                desiredWidth = OORoundUpToPowerOf2_PixMap((2 * _width) / 3);
                desiredHeight = OORoundUpToPowerOf2_PixMap((2 * _height) / 3);
            }
            else
            {
                desiredWidth = _width;
                desiredHeight = _height;
            }
            
            desiredWidth = MIN(desiredWidth, sGLMaxSize);
            desiredHeight = MIN(desiredHeight, sGLMaxSize);
            
            if (!_avoidShrinking)
            {
                if (sReducedDetail)
                {
                    if (_shrinkThreshold < desiredWidth)  desiredWidth /= 2;
                    if (_shrinkThreshold < desiredHeight)  desiredHeight /= 2;
                }
                
                desiredWidth = MIN(desiredWidth, _maxSize);
                desiredHeight = MIN(desiredHeight, _maxSize);
            }
        }
    }
    else
    {
        desiredWidth = _width;
        desiredHeight = _height;
    }
    
    if (outDesiredWidth != NULL)  *outDesiredWidth = desiredWidth;
    if (outDesiredHeight != NULL)  *outDesiredHeight = desiredHeight;
}

setUp

+ (void) setUp

Extends class OOTextureLoader.

---

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

• src/Core/Materials/OOTextureLoader.m