#include <OOProbabilisticTextureManager.h>

Inheritance diagram for OOProbabilisticTextureManager:

Collaboration diagram for OOProbabilisticTextureManager:

Instance Methods
(id)	- initWithPListName:options:anisotropy:lodBias:
(id)	- initWithPListName:options:anisotropy:lodBias:seed:
(OOTexture *)	- selectTexture
(unsigned)	- textureCount
(void)	- ensureTexturesLoaded
(RANROTSeed)	- seed
(void)	- setSeed:
(void)	- dealloc `[implementation]`
(NSString *)	- description `[implementation]`

Private Attributes
unsigned	_count
OOTexture **	_textures
float *	_prob
int *	_galaxy
float	_probMax
float *	_probMaxGal
RANROTSeed	_seed

Detailed Description

Definition at line 37 of file OOProbabilisticTextureManager.h.

Method Documentation

◆ dealloc

- (void) dealloc

implementation

Definition at line 160 of file OOProbabilisticTextureManager.m.

{
    unsigned                i;
    
    if (_textures != NULL)
    {
        for (i = 0; i != _count; ++i)
        {
            [_textures[i] release];
        }
        free(_textures);
    }
    
    if (_prob != NULL)  free(_prob);
    if (_galaxy != NULL)  free(_galaxy);
    if (_probMaxGal != NULL)  free(_probMaxGal);
 
    [super dealloc];
}

References _count, _galaxy, _prob, _probMaxGal, _textures, dealloc, and OOTexture::release.

Referenced by dealloc.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ description

- (NSString *) description

implementation

Definition at line 181 of file OOProbabilisticTextureManager.m.

182{

183 return [NSString stringWithFormat:@"<%@ %p>{%u textures, cumulative probability=%g}", [self class], self, _count, _probMax];

184}

References description.

Referenced by description.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensureTexturesLoaded

- (void) ensureTexturesLoaded

Definition at line 227 of file OOProbabilisticTextureManager.m.

{
    unsigned                i;
    
    for (i = 0; i != _count; ++i)
    {
        [_textures[i] ensureFinishedLoading];
    }
}

References _count, OOTexture::ensureFinishedLoading, and ensureTexturesLoaded.

Referenced by ensureTexturesLoaded, and OOSkyDrawable(OOPrivate)::ensureTexturesLoaded.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initWithPListName:options:anisotropy:lodBias:

- (id) initWithPListName:	(NSString *)	plistName
options:	(uint32_t)	options
anisotropy:	(GLfloat)	anisotropy
lodBias:	(GLfloat)	lodBias

Definition at line 37 of file OOProbabilisticTextureManager.m.

                       :(NSString *)plistName 
                options:(uint32_t)options
             anisotropy:(GLfloat)anisotropy
                lodBias:(GLfloat)lodBias
{
    return [self initWithPListName:plistName
                           options:options
                        anisotropy:anisotropy
                           lodBias:lodBias
                              seed:RANROTGetFullSeed()];
}

References initWithPListName:options:anisotropy:lodBias:seed:.

Here is the call graph for this function:

◆ initWithPListName:options:anisotropy:lodBias:seed:

- (id) initWithPListName:	(NSString *)	plistName
options:	(uint32_t)	options
anisotropy:	(GLfloat)	anisotropy
lodBias:	(GLfloat)	lodBias
seed:	(RANROTSeed)	seed

Definition at line 50 of file OOProbabilisticTextureManager.m.

                       :(NSString *)plistName 
                options:(uint32_t)options
             anisotropy:(GLfloat)anisotropy
                lodBias:(GLfloat)lodBias
                   seed:(RANROTSeed)seed
{
    BOOL                OK = YES;
    NSArray             *config = nil;
    NSUInteger          i, count, j;
    id                  entry = nil;
    NSString            *name = nil;
    float               probability;
    OOTexture           *texture = nil;
    int                 galID = -1;
    id                  object = nil;
 
    self = [super init];
    if (self == nil)  OK = NO;
    
    if (OK)
    {
        config = [ResourceManager arrayFromFilesNamed:plistName inFolder:@"Config" andMerge:YES];
        if (config == nil)  OK = NO;
    }
    
    if (OK)
    {
        count = [config count];
        
        _textures = malloc(sizeof *_textures * count);
        _prob = malloc(sizeof *_prob * count);
        _galaxy = malloc(sizeof *_galaxy * count);
        _probMaxGal = malloc(sizeof *_probMaxGal * (kOOMaximumGalaxyID + 1));
 
        if (_textures == NULL || _prob == NULL || _galaxy == NULL)  OK = NO;
    }
    
    if (OK)
    {
        for (i = 0; i <= kOOMaximumGalaxyID; i++) _probMaxGal[i] = 0;
 
        //  Go through list and load textures.
        for (i = 0; i != count; ++i)
        {
            entry = [config objectAtIndex:i];
            galID = -1;
            if ([entry isKindOfClass:[NSDictionary class]])
            {
                name = [(NSDictionary *)entry oo_stringForKey:@"texture"];
                probability = [entry oo_floatForKey:@"probability" defaultValue:1.0f];
                object = [entry objectForKey:@"galaxy"];
                if ([object isKindOfClass:[NSString class]])  
                {
                    galID = [object intValue];
                }
                else if (object != nil)
                {
                    OOLog(@"textures.load", @"***** ERROR: %@ for texture %@ is not a string.", @"galaxy", name);
                }
            }
            else if ([entry isKindOfClass:[NSString class]])
            {
                name = entry;
                probability = 1.0f;
            }
            else
            {
                name = nil;
            }
            
            if (name != nil && 0.0f < probability)
            {
                texture = [OOTexture textureWithName:name
                                            inFolder:@"Textures"
                                             options:options
                                          anisotropy:anisotropy
                                             lodBias:lodBias];
                if (texture != nil)
                {
                    _textures[_count] = [texture retain];
                    _prob[_count] = probability + (galID >= 0 ? _probMaxGal[galID] : _probMax);
                    _galaxy[_count] = (galID >= 0 ? galID : -1);
                    if (galID >= 0) {
                        _probMaxGal[galID] += probability;
                    }
                    else
                    {
                        for (j = 0; j <= kOOMaximumGalaxyID; j++) _probMaxGal[j] += probability;
                        _probMax += probability;
                    }
                    ++_count;
                }
            }
        }
        
        if (_count == 0) OK = NO;
    }
    
    if (OK)  _seed = seed;
    
    if (!OK)
    {
        [self release];
        self = nil;
    }
 
    return self;
}

References _count, _galaxy, _prob, _probMax, _probMaxGal, _seed, _textures, ResourceManager::arrayFromFilesNamed:inFolder:andMerge:, count, kOOMaximumGalaxyID, nil, OOLog, OOTexture::retain, seed, and OOTexture::textureWithName:inFolder:options:anisotropy:lodBias:.

Referenced by initWithPListName:options:anisotropy:lodBias:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ seed

- (RANROTSeed) seed

Definition at line 238 of file OOProbabilisticTextureManager.m.

239{

240 return _seed;

241}

References _seed, and seed.

Referenced by initWithPListName:options:anisotropy:lodBias:seed:, seed, and setSeed:.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ selectTexture

- (OOTexture *) selectTexture

Definition at line 187 of file OOProbabilisticTextureManager.m.

{
    float                   selection;
    unsigned                i;
    int                     hold = -1;
    int                     galID = (int)[PLAYER currentGalaxyID];
 
    selection = randfWithSeed(&_seed);
    
    selection *= _probMaxGal[galID];
    
    for (i = 0; i != _count; ++i)
    {
        if (_galaxy[i] == -1 || _galaxy[i] == galID)
        {
            // make a note of the index of the first texture that meets the galaxy list criteria (but only if _galaxy is set)
            if (hold == -1 && _prob[i] > 0 && _galaxy[i] == galID) hold = i;
            if (selection <= _prob[i])  return _textures[i];
        }
    }
    
    // first catch point if loop above fails to return a texture
    // return first texture that meets the galaxy list criteria and has a probability > 0
    if (hold >= 0) 
    {
        OOLog(@"probabilisticTextureManager.internalWarning", @"%s: overrun! Galaxy List requirements not met. Choosing first texture available for galaxy.", __PRETTY_FUNCTION__);
        return _textures[hold];
    }
 
    OOLog(@"probabilisticTextureManager.internalFailure", @"%s: overrun! Choosing last texture.", __PRETTY_FUNCTION__);
    return _textures[_count - 1];
}