OOSkyDrawable(OOPrivate) Category Reference

Inheritance diagram for OOSkyDrawable(OOPrivate):

Collaboration diagram for OOSkyDrawable(OOPrivate):

Instance Methods
(void)	- setUpStarsWithColor1:color2:
(void)	- setUpNebulaeWithColor1:color2:clusterFactor:nebulaHueFix:alpha:scale:
(void)	- loadStarTextures
(void)	- loadNebulaTextures
(void)	- addQuads:count:
(void)	- ensureTexturesLoaded
(void)	- resetGraphicsState [implementation]

Detailed Description

Definition at line 110 of file OOSkyDrawable.m.

Method Documentation

addQuads:count:

- (void) addQuads:		(OOSkyQuadDesc *)	quads
count:		(unsigned)	count

Extends class OOSkyDrawable.

Definition at line 444 of file OOSkyDrawable.m.

                :(OOSkyQuadDesc *)quads count:(unsigned)count
{
    if (_quadSets == nil)  _quadSets = [[NSMutableArray alloc] init];
    
    [OOSkyQuadSet addQuads:quads count:count toArray:_quadSets];
}

References OOSkyQuadSet::addQuads:count:toArray:, and nil.

Here is the call graph for this function:

ensureTexturesLoaded

- (void) ensureTexturesLoaded

Extends class OOSkyDrawable.

Definition at line 492 of file OOSkyDrawable.m.

{
    [sStarTextures ensureTexturesLoaded];
    [sNebulaTextures ensureTexturesLoaded];
}

References OOProbabilisticTextureManager::ensureTexturesLoaded, and ensureTexturesLoaded.

Referenced by ensureTexturesLoaded.

Here is the call graph for this function:

Here is the caller graph for this function:

loadNebulaTextures

- (void) loadNebulaTextures

Extends class OOSkyDrawable.

Definition at line 472 of file OOSkyDrawable.m.

{
    if (sNebulaTextures == nil)
    {
        sNebulaTextures = [[OOProbabilisticTextureManager alloc]
                            initWithPListName:@"nebulatextures.plist"
                                      options:kOOTextureDefaultOptions | kOOTextureAlphaMask
                                   anisotropy:0.0f
                                      lodBias:0.0f];
        if (sNebulaTextures == nil)
        {
            [NSException raise:OOLITE_EXCEPTION_DATA_NOT_FOUND format:@"No nebula textures could be loaded."];
        }
    }
    
    [sNebulaTextures setSeed:RANROTGetFullSeed()];
    
}

References loadNebulaTextures, nil, OOProbabilisticTextureManager::setSeed:, and sNebulaTextures.

Referenced by loadNebulaTextures.

Here is the call graph for this function:

Here is the caller graph for this function:

loadStarTextures

- (void) loadStarTextures

Extends class OOSkyDrawable.

Definition at line 452 of file OOSkyDrawable.m.

{
    if (sStarTextures == nil)
    {
        sStarTextures = [[OOProbabilisticTextureManager alloc]
                            initWithPListName:@"startextures.plist"
                                      options:kOOTextureMinFilterMipMap | kOOTextureMagFilterLinear | kOOTextureAlphaMask
                                   anisotropy:0.0f
                                      lodBias:-0.0f];
        if (sStarTextures == nil)
        {
            [NSException raise:OOLITE_EXCEPTION_DATA_NOT_FOUND format:@"No star textures could be loaded."];
        }
    }
    
    [sStarTextures setSeed:RANROTGetFullSeed()];
    
}

References loadStarTextures, nil, OOProbabilisticTextureManager::setSeed:, and sStarTextures.

Referenced by loadStarTextures.

Here is the call graph for this function:

Here is the caller graph for this function:

resetGraphicsState

- (void) resetGraphicsState

implementation

Extends class OOSkyDrawable.

Definition at line 499 of file OOSkyDrawable.m.

{
    OO_ENTER_OPENGL();
    
    if (_displayListName != 0)
    {
        glDeleteLists(_displayListName, 1);
        _displayListName = 0;
    }
}

References OO_ENTER_OPENGL, and resetGraphicsState.

Referenced by resetGraphicsState.

Here is the call graph for this function:

Here is the caller graph for this function:

setUpNebulaeWithColor1:color2:clusterFactor:nebulaHueFix:alpha:scale:

- (void) setUpNebulaeWithColor1:		(OOColor *)	color1
color2:		(OOColor *)	color2
clusterFactor:		(float)	nebulaClusterFactor
nebulaHueFix:		(BOOL)	nebulaHueFix
alpha:		(float)	nebulaAlpha
scale:		(float)	nebulaScale

Extends class OOSkyDrawable.

Definition at line 351 of file OOSkyDrawable.m.

                              :(OOColor *)color1
                        color2:(OOColor *)color2
                 clusterFactor:(float)nebulaClusterFactor
                  nebulaHueFix:(BOOL)nebulaHueFix
                         alpha:(float)nebulaAlpha
                         scale:(float)nebulaScale
{
    OOSkyQuadDesc      *quads = NULL, *currQuad = NULL;
    unsigned            i, actualCount = 0, clusters = 0;
    OOColor             *color;
    Quaternion          q;
    Vector              vi, vj, vk;
    double              size, r2;
    Vector              middle, offset;
    int                 r1;
    
    [self loadNebulaTextures];
    
    quads = malloc(sizeof *quads * _nebulaCount);
    if (quads == NULL)  return;
    
    currQuad = quads;
    for (i = 0; i < _nebulaCount; ++i)
    {
        color = SaturatedColorInRange(color1, color2, nebulaHueFix);
        
        // Select a direction and rotation.
        q = OORandomQuaternion();
        
        // Create a cluster of nebula quads.
        while ((i < _nebulaCount) && (randf() < nebulaClusterFactor))
        {
            // Select size.
            r1 = 1 + (ranrot_rand() & 15);
            size = nebulaScale * r1 * SKY_ELEMENT_SCALE_FACTOR;
            
            // Calculate centre position and offset to first corner.
            basis_vectors_from_quaternion(q, &vi, &vj, &vk);
            
            // Select colour and texture. Smaller nebula quads are dimmer.
#if DEBUG_COLORS
            currQuad->color = DebugColor(vk);
#else
            currQuad->color = [color colorWithBrightnessFactor:nebulaAlpha * (0.5f + (float)r1 / 32.0f)];
#endif
            currQuad->texture = [sNebulaTextures selectTexture];    // Not retained, since sStarTextures is never released.
            
            middle = vector_multiply_scalar(vk, BILLBOARD_DEPTH);
            offset = vector_multiply_scalar(vector_add(vi, vj), 0.5f * size);
            
            // Rotate vi and vj by a random angle
            r2 = randf() * M_PI * 2.0;
            quaternion_rotate_about_axis(&q, vk, r2);
            vi = vector_right_from_quaternion(q);
            vj = vector_up_from_quaternion(q);
            
            // Scale the "side" vectors.
            vj = vector_multiply_scalar(vj, size);
            vi = vector_multiply_scalar(vi, size);
            
            // Set up corners.
            currQuad->corners[0] = vector_subtract(middle, offset);
            currQuad->corners[1] = vector_add(currQuad->corners[0], vj);
            currQuad->corners[2] = vector_add(currQuad->corners[1], vi);
            currQuad->corners[3] = vector_add(currQuad->corners[0], vi);
            
            // Shuffle direction quat around a bit to spread the cluster out.
            size = NEBULA_SHUFFLE_FACTOR / (nebulaScale * SKY_ELEMENT_SCALE_FACTOR);
            q.x += size * (randf() - 0.5);
            q.y += size * (randf() - 0.5);
            q.z += size * (randf() - 0.5);
            q.w += size * (randf() - 0.5);
            quaternion_normalize(&q);
            
            ++i;
            ++currQuad;
            ++actualCount;
        }
        ++clusters;
    }
    
    /*  The above code generates less than _nebulaCount quads, because i is
        incremented once in the outer loop as well as in the inner loop. To
        keep skies looking the same, we leave the bug in and fill in the
        actual generated count here.
    */
    _nebulaCount = actualCount;
    
    [self addQuads:quads count:_nebulaCount];
    free(quads);
}

References OOSkyDrawable::addQuads:count:, basis_vectors_from_quaternion(), BILLBOARD_DEPTH, OOColor::colorWithBrightnessFactor:, OOSkyDrawable::loadNebulaTextures, M_PI, NEBULA_SHUFFLE_FACTOR, quaternion_rotate_about_axis(), randf(), ranrot_rand, SaturatedColorInRange(), OOProbabilisticTextureManager::selectTexture, SKY_ELEMENT_SCALE_FACTOR, vector_right_from_quaternion(), and vector_up_from_quaternion().

Here is the call graph for this function:

setUpStarsWithColor1:color2:

- (void) setUpStarsWithColor1:		(OOColor *)	color1
color2:		(OOColor *)	color2

Extends class OOSkyDrawable.

Definition at line 299 of file OOSkyDrawable.m.

                            :(OOColor *)color1 color2:(OOColor *)color2
{
    OOSkyQuadDesc      *quads = NULL, *currQuad = NULL;
    unsigned            i;
    Quaternion          q;
    Vector              vi, vj, vk;
    float               size;
    Vector              middle, offset;
    
    [self loadStarTextures];
    
    quads = malloc(sizeof *quads * _starCount);
    if (quads == NULL)  return;
    
    currQuad = quads;
    for (i = 0; i != _starCount; ++i)
    {
        // Select a direction and rotation.
        q = OORandomQuaternion();
        basis_vectors_from_quaternion(q, &vi, &vj, &vk);
        
        // Select colour and texture.
#if DEBUG_COLORS
        currQuad->color = DebugColor(vk);
#else
        currQuad->color = [color1 blendedColorWithFraction:randf() ofColor:color2];
#endif
        currQuad->texture = [sStarTextures selectTexture];    // Not retained, since sStarTextures is never released.
        
        // Select scale; calculate centre position and offset to first corner.
        size = (1 + (ranrot_rand() % 6)) * SKY_ELEMENT_SCALE_FACTOR;
        middle = vector_multiply_scalar(vk, BILLBOARD_DEPTH);
        offset = vector_multiply_scalar(vector_add(vi, vj), 0.5f * size);
        
        // Scale the "side" vectors.
        Vector vj2 = vector_multiply_scalar(vj, size);
        Vector vi2 = vector_multiply_scalar(vi, size);
        
        // Set up corners.
        currQuad->corners[0] = vector_subtract(middle, offset);
        currQuad->corners[1] = vector_add(currQuad->corners[0], vj2);
        currQuad->corners[2] = vector_add(currQuad->corners[1], vi2);
        currQuad->corners[3] = vector_add(currQuad->corners[0], vi2);
        
        ++currQuad;
    }
    
    [self addQuads:quads count:_starCount];
    free(quads);
}

References OOSkyDrawable::addQuads:count:, basis_vectors_from_quaternion(), BILLBOARD_DEPTH, OOColor::blendedColorWithFraction:ofColor:, OOSkyDrawable::loadStarTextures, ranrot_rand, OOProbabilisticTextureManager::selectTexture, and SKY_ELEMENT_SCALE_FACTOR.

Here is the call graph for this function:

---

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

• src/Core/OOSkyDrawable.m