Universe(OOPrivate) Category Reference

Instance Methods
(void)	- initTargetFramebufferWithViewSize:
(void)	- deleteOpenGLObjects
(void)	- resizeTargetFramebufferWithViewSize:
(void)	- prepareToRenderIntoDefaultFramebuffer
(void)	- drawTargetTextureIntoDefaultFramebuffer
(BOOL)	- doRemoveEntity:
(void)	- setUpCargoPods
(void)	- setUpInitialUniverse
(HPVector)	- fractionalPositionFrom:to:withFraction:
(void)	- populateSpaceFromActiveWormholes
(NSString *)	- chooseStringForKey:inDictionary:
(void)	- addNumericRefsInString:toGraphViz:fromNode:nodeCount:
(void)	- runLocalizationTools
(void)	- setShaderEffectsLevelDirectly:
(void)	- setFirstBeacon:
(void)	- setLastBeacon:
(void)	- verifyDescriptions
(void)	- loadDescriptions
(void)	- loadScenarios
(void)	- verifyEntitySessionIDs
(float)	- randomDistanceWithinScanner
(Vector)	- randomPlaceWithinScannerFrom:alongRoute:withOffset:
(void)	- setDetailLevelDirectly:
(NSDictionary *)	- demoShipData
(void)	- setLibraryTextForDemoShip

Detailed Description

Definition at line 200 of file Universe.m.

Method Documentation

addNumericRefsInString:toGraphViz:fromNode:nodeCount:

- (void) addNumericRefsInString:		(NSString *)	string
toGraphViz:		(NSMutableString *)	graphViz
fromNode:		(NSString *)	fromNode
nodeCount:		(NSUInteger)	nodeCount

Extends class Universe.

Definition at line 10697 of file Universe.m.

                               :(NSString *)string toGraphViz:(NSMutableString *)graphViz fromNode:(NSString *)fromNode nodeCount:(NSUInteger)nodeCount
{
    NSString                    *index = nil;
    NSInteger                   start, end;
    NSRange                     remaining, subRange;
    unsigned                    i;
    
    remaining = NSMakeRange(0, [string length]);
    
    for (;;)
    {
        subRange = [string rangeOfString:@"[" options:NSLiteralSearch range:remaining];
        if (subRange.location == NSNotFound)  break;
        start = subRange.location + subRange.length;
        remaining.length -= start - remaining.location;
        remaining.location = start;
        
        subRange = [string rangeOfString:@"]" options:NSLiteralSearch range:remaining];
        if (subRange.location == NSNotFound)  break;
        end = subRange.location;
        remaining.length -= end - remaining.location;
        remaining.location = end;
        
        index = [string substringWithRange:NSMakeRange(start, end - start)];
        i = [index intValue];
        
        // Each node gets a colour for its incoming edges. The multiplication and mod shuffle them to avoid adjacent nodes having similar colours.
        [graphViz appendFormat:@"\t%@ -> n%u_0 [color=\"%f,0.75,0.8\" lhead=cluster_%u]\n", fromNode, i, ((float)(i * 511 % nodeCount)) / ((float)nodeCount), i];
    }
    
    if ([string rangeOfString:@"%I"].location != NSNotFound)
    {
        [graphViz appendFormat:@"\t%@ -> percent_I [color=\"0,0,0.25\"]\n", fromNode];
    }
    if ([string rangeOfString:@"%H"].location != NSNotFound)
    {
        [graphViz appendFormat:@"\t%@ -> percent_H [color=\"0,0,0.45\"]\n", fromNode];
    }
    if ([string rangeOfString:@"%R"].location != NSNotFound || [string rangeOfString:@"%N"].location != NSNotFound)
    {
        [graphViz appendFormat:@"\t%@ -> percent_RN [color=\"0,0,0.65\"]\n", fromNode];
    }
    
    // TODO: test graphViz output for @"%Jxxx" and @"%Gxxxxxx"
    if ([string rangeOfString:@"%J"].location != NSNotFound)
    {
        [graphViz appendFormat:@"\t%@ -> percent_J [color=\"0,0,0.75\"]\n", fromNode];
    }
    
    if ([string rangeOfString:@"%G"].location != NSNotFound)
    {
        [graphViz appendFormat:@"\t%@ -> percent_G [color=\"0,0,0.85\"]\n", fromNode];
    }
}

chooseStringForKey:inDictionary:

- (NSString *) chooseStringForKey:		(NSString *)	key
inDictionary:		(NSDictionary *)	dictionary

Extends class Universe.

Definition at line 10697 of file Universe.m.

                                :(NSString *)key inDictionary:(NSDictionary *)dictionary
{
    id object = [dictionary objectForKey:key];
    if ([object isKindOfClass:[NSString class]])  return object;
    else if ([object isKindOfClass:[NSArray class]] && [object count] > 0)  return [object oo_stringAtIndex:Ranrot() % [object count]];
    return nil;
}

deleteOpenGLObjects

- (void) deleteOpenGLObjects

Extends class Universe.

Definition at line 273 of file Universe.m.

{
    OOGL(glDeleteTextures(1, &msaaTextureID));
    OOGL(glDeleteTextures(1, &targetTextureID));
    OOGL(glDeleteTextures(2, passthroughTextureID));
    OOGL(glDeleteTextures(2, pingpongColorbuffers));
    OOGL(glDeleteRenderbuffers(1, &msaaDepthBufferID));
    OOGL(glDeleteRenderbuffers(1, &targetDepthBufferID));
    OOGL(glDeleteFramebuffers(1, &msaaFramebufferID));
    OOGL(glDeleteFramebuffers(1, &targetFramebufferID));
    OOGL(glDeleteFramebuffers(2, pingpongFBO));
    OOGL(glDeleteFramebuffers(1, &passthroughFramebufferID));
    OOGL(glDeleteVertexArrays(1, &quadTextureVAO));
    OOGL(glDeleteBuffers(1, &quadTextureVBO));
    OOGL(glDeleteBuffers(1, &quadTextureEBO));
    [textureProgram release];
    [blurProgram release];
    [finalProgram release];
}

demoShipData

- (NSDictionary *) demoShipData

Extends class Universe.

Definition at line 273 of file Universe.m.

{
    return [[demo_ships oo_arrayAtIndex:demo_ship_index] oo_dictionaryAtIndex:demo_ship_subindex];
}

doRemoveEntity:

- (BOOL) doRemoveEntity:

(Entity *)

entity

Extends class Universe.

Definition at line 9471 of file Universe.m.

                      :(Entity *)entity
{
    // remove reference to entity in linked lists
    if ([entity canCollide])    // filter only collidables disappearing
    {
        doLinkedListMaintenanceThisUpdate = YES;
    }
    
    [entity removeFromLinkedLists];
    
    // moved forward ^^
    // remove from the reference dictionary
    int old_id = [entity universalID];
    entity_for_uid[old_id] = nil;
    [entity setUniversalID:NO_TARGET];
    [entity wasRemovedFromUniverse];
    
    // maintain sorted lists
    int index = entity->zero_index;
    
    int n = 1;
    if (index >= 0)
    {
        if (sortedEntities[index] != entity)
        {
            OOLog(kOOLogInconsistentState, @"DEBUG: Universe removeEntity:%@ ENTITY IS NOT IN THE RIGHT PLACE IN THE ZERO_DISTANCE SORTED LIST -- FIXING...", entity);
            unsigned i;
            index = -1;
            for (i = 0; (i < n_entities)&&(index == -1); i++)
                if (sortedEntities[i] == entity)
                    index = i;
            if (index == -1)
                 OOLog(kOOLogInconsistentState, @"DEBUG: Universe removeEntity:%@ ENTITY IS NOT IN THE ZERO_DISTANCE SORTED LIST -- CONTINUING...", entity);
        }
        if (index != -1)
        {
            while ((unsigned)index < n_entities)
            {
                while (((unsigned)index + n < n_entities)&&(sortedEntities[index + n] == entity))
                {
                    n++;    // ie there's a duplicate entry for this entity
                }
                
                /*
                    BUG: when n_entities == UNIVERSE_MAX_ENTITIES, this read
                    off the end of the array and copied (Entity *)n_entities =
                    0x800 into the list. The subsequent update of zero_index
                    derferenced 0x800 and crashed.
                    FIX: add an extra unused slot to sortedEntities, which is
                    always nil.
                    EFFICIENCY CONCERNS: this could have been an alignment
                    issue since UNIVERSE_MAX_ENTITIES == 2048, but it isn't
                    really. sortedEntities is part of the object, not malloced,
                    it isn't aligned, and the end of it is only live in
                    degenerate cases.
                    -- Ahruman 2012-07-11
                */
                sortedEntities[index] = sortedEntities[index + n];  // copy entity[index + n] -> entity[index] (preserves sort order)
                if (sortedEntities[index])
                {
                    sortedEntities[index]->zero_index = index;              // give it its correct position
                }
                index++;
            }
            if (n > 1)
                 OOLog(kOOLogInconsistentState, @"DEBUG: Universe removeEntity: REMOVED %d EXTRA COPIES OF %@ FROM THE ZERO_DISTANCE SORTED LIST", n - 1, entity);
            while (n--)
            {
                n_entities--;
                sortedEntities[n_entities] = nil;
            }
        }
        entity->zero_index = -1;    // it's GONE!
    }
    
    // remove from the definitive list
    if ([entities containsObject:entity])
    {
        // FIXME: better approach needed for core break patterns - CIM
        if ([entity isBreakPattern] && ![entity isVisualEffect])
        {
            breakPatternCounter--;
        }
        
        if ([entity isShip])
        {
            ShipEntity *se = (ShipEntity*)entity;
            [self clearBeacon:se];
        }
        if ([entity isWaypoint])
        {
            OOWaypointEntity *wp = (OOWaypointEntity*)entity;
            [self clearBeacon:wp];
        }
        if ([entity isVisualEffect])
        {
            OOVisualEffectEntity *ve = (OOVisualEffectEntity*)entity;
            [self clearBeacon:ve];
        }
        
        if ([entity isWormhole])
        {
            [activeWormholes removeObject:entity];
        }
        else if ([entity isPlanet])
        {
            [allPlanets removeObject:entity];
        }
        
        [entities removeObject:entity];
        return YES;
    }
    
    return NO;
}

drawTargetTextureIntoDefaultFramebuffer

- (void) drawTargetTextureIntoDefaultFramebuffer

Extends class Universe.

Definition at line 273 of file Universe.m.

{
    // save previous bindings state
    GLint previousFBO;
    OOGL(glGetIntegerv(GL_DRAW_FRAMEBUFFER_BINDING, &previousFBO));
    GLint previousProgramID;
    OOGL(glGetIntegerv(GL_CURRENT_PROGRAM, &previousProgramID));
    GLint previousTextureID;
    OOGL(glGetIntegerv(GL_TEXTURE_BINDING_2D, &previousTextureID));
    GLint previousVAO;
    OOGL(glGetIntegerv(GL_VERTEX_ARRAY_BINDING, &previousVAO));
    GLint previousActiveTexture;
    OOGL(glGetIntegerv(GL_ACTIVE_TEXTURE, &previousActiveTexture)); 
    
    OOGL(glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT));
    // fixes transparency issue for some reason
    OOGL(glDisable(GL_BLEND));
    
    GLhandleARB program = [textureProgram program];
    GLhandleARB blur = [blurProgram program];
    GLhandleARB final = [finalProgram program];
    NSSize viewSize = [gameView viewSize];
    float fboResolution[2] = {viewSize.width, viewSize.height};
 
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, passthroughFramebufferID));
    OOGL(glClear(GL_COLOR_BUFFER_BIT));
 
    OOGL(glUseProgram(program));
    OOGL(glBindTexture(GL_TEXTURE_2D, targetTextureID));
    OOGL(glUniform1i(glGetUniformLocation(program, "image"), 0));
    
    
    OOGL(glBindVertexArray(quadTextureVAO));
    OOGL(glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0));
    OOGL(glBindVertexArray(0));
    
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
    
        
    BOOL horizontal = YES, firstIteration = YES;
    unsigned int amount = [self bloom] ? 10 : 0; // if not blooming, why bother with the heavy calculations?
    OOGL(glUseProgram(blur));
    for (unsigned int i = 0; i < amount; i++)
    {
        OOGL(glBindFramebuffer(GL_FRAMEBUFFER, pingpongFBO[horizontal]));
        OOGL(glUniform1i(glGetUniformLocation(blur, "horizontal"), horizontal));
        OOGL(glActiveTexture(GL_TEXTURE0));
        // bind texture of other framebuffer (or scene if first iteration)
        OOGL(glBindTexture(GL_TEXTURE_2D, firstIteration ? passthroughTextureID[1] : pingpongColorbuffers[!horizontal]));  
        OOGL(glUniform1i(glGetUniformLocation([blurProgram program], "imageIn"), 0));
        OOGL(glBindVertexArray(quadTextureVAO));
        OOGL(glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0));
        OOGL(glBindVertexArray(0));
        horizontal = !horizontal;
        firstIteration = NO;
    }
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
    
    
    OOGL(glUseProgram(final));
 
    OOGL(glActiveTexture(GL_TEXTURE0));
    OOGL(glBindTexture(GL_TEXTURE_2D, passthroughTextureID[0]));
    OOGL(glUniform1i(glGetUniformLocation(final, "scene"), 0));
    OOGL(glUniform1i(glGetUniformLocation(final, "bloom"), [self bloom]));
    OOGL(glUniform1f(glGetUniformLocation(final, "uTime"), [self getTime]));
    OOGL(glUniform2fv(glGetUniformLocation(final, "uResolution"), 1, fboResolution));
    OOGL(glUniform1i(glGetUniformLocation(final, "uPostFX"), [self currentPostFX]));
#if OOLITE_WINDOWS
    if([gameView hdrOutput])
    {
        OOGL(glUniform1f(glGetUniformLocation(final, "uMaxBrightness"), [gameView hdrMaxBrightness]));
        OOGL(glUniform1f(glGetUniformLocation(final, "uPaperWhiteBrightness"), [gameView hdrPaperWhiteBrightness]));
    }
#endif
    
    OOGL(glActiveTexture(GL_TEXTURE1));
    OOGL(glBindTexture(GL_TEXTURE_2D, pingpongColorbuffers[!horizontal]));
    OOGL(glUniform1i(glGetUniformLocation(final, "bloomBlur"), 1));
    OOGL(glUniform1f(glGetUniformLocation(final, "uSaturation"), [gameView colorSaturation]));
    
    OOGL(glBindVertexArray(quadTextureVAO));
    OOGL(glDrawElements(GL_TRIANGLES, 6, GL_UNSIGNED_INT, 0));
    
    // restore GL_TEXTURE1 to 0, just in case we are returning from a
    // DETAIL_LEVEL_NORMAL to DETAIL_LEVEL_SHADERS
    OOGL(glBindTexture(GL_TEXTURE_2D, 0));
 
    // restore previous bindings
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, previousFBO));
    OOGL(glActiveTexture(previousActiveTexture));
    OOGL(glBindTexture(GL_TEXTURE_2D, previousTextureID));
    OOGL(glUseProgram(previousProgramID));
    OOGL(glBindVertexArray(previousVAO));
    OOGL(glEnable(GL_BLEND));
}

fractionalPositionFrom:to:withFraction:

- (HPVector) fractionalPositionFrom:		(HPVector)	point0
to:		(HPVector)	point1
withFraction:		(double)	routeFraction

Extends class Universe.

Definition at line 9471 of file Universe.m.

                                   :(HPVector)point0 to:(HPVector)point1 withFraction:(double)routeFraction
{
    if (routeFraction == NSNotFound) routeFraction = randf();
    
    point1 = OOHPVectorInterpolate(point0, point1, routeFraction);
    
    point1.x += 2 * SCANNER_MAX_RANGE * (randf() - 0.5);
    point1.y += 2 * SCANNER_MAX_RANGE * (randf() - 0.5);
    point1.z += 2 * SCANNER_MAX_RANGE * (randf() - 0.5);
    
    return point1;
}

initTargetFramebufferWithViewSize:

- (void) initTargetFramebufferWithViewSize:

(NSSize)

viewSize

Extends class Universe.

Definition at line 273 of file Universe.m.

                                          :(NSSize)viewSize
{
    // liberate us from the 0.0 to 1.0 rgb range!
    OOGL(glClampColor(GL_CLAMP_VERTEX_COLOR, GL_FALSE));
    OOGL(glClampColor(GL_CLAMP_READ_COLOR, GL_FALSE));
    OOGL(glClampColor(GL_CLAMP_FRAGMENT_COLOR, GL_FALSE));
 
    // have to do this because on my machine the default framebuffer is not zero
    OOGL(glGetIntegerv(GL_DRAW_FRAMEBUFFER_BINDING, &defaultDrawFBO));
 
    GLint previousProgramID;
    OOGL(glGetIntegerv(GL_CURRENT_PROGRAM, &previousProgramID));
    GLint previousTextureID;
    OOGL(glGetIntegerv(GL_TEXTURE_BINDING_2D, &previousTextureID));
    GLint previousVAO;
    OOGL(glGetIntegerv(GL_VERTEX_ARRAY_BINDING, &previousVAO));
    GLint previousArrayBuffer;
    OOGL(glGetIntegerv(GL_ARRAY_BUFFER_BINDING, &previousArrayBuffer));
    GLint previousElementBuffer;
    OOGL(glGetIntegerv(GL_ELEMENT_ARRAY_BUFFER_BINDING, &previousElementBuffer));
 
    // create MSAA framebuffer and attach MSAA texture and depth buffer to framebuffer
    OOGL(glGenFramebuffers(1, &msaaFramebufferID));
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, msaaFramebufferID));
    
    // creating MSAA texture that should be rendered into
    OOGL(glGenTextures(1, &msaaTextureID));
    OOGL(glBindTexture(GL_TEXTURE_2D_MULTISAMPLE, msaaTextureID));
    OOGL(glTexImage2DMultisample(GL_TEXTURE_2D_MULTISAMPLE, 4, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, GL_TRUE));
    OOGL(glBindTexture(GL_TEXTURE_2D_MULTISAMPLE, 0));
    OOGL(glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D_MULTISAMPLE, msaaTextureID, 0));
    
    // create necessary MSAA depth render buffer
    OOGL(glGenRenderbuffers(1, &msaaDepthBufferID));
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, msaaDepthBufferID));
    OOGL(glRenderbufferStorageMultisample(GL_RENDERBUFFER, 4, GL_DEPTH_COMPONENT32F, (GLsizei)viewSize.width, (GLsizei)viewSize.height));
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, 0));
    OOGL(glFramebufferRenderbuffer(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_RENDERBUFFER, msaaDepthBufferID));
    
    if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE)
    {
        OOLogERR(@"initTargetFramebufferWithViewSize.result", @"%@", @"***** Error: Multisample framebuffer not complete");
    }
    
    // create framebuffer and attach texture and depth buffer to framebuffer
    OOGL(glGenFramebuffers(1, &targetFramebufferID));
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, targetFramebufferID));
    
    // creating texture that should be rendered into
    OOGL(glGenTextures(1, &targetTextureID));
    OOGL(glBindTexture(GL_TEXTURE_2D, targetTextureID));
    OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
    OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR));
    OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR));
    OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE));
    OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE));
    OOGL(glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, targetTextureID, 0));
    
    // create necessary depth render buffer
    OOGL(glGenRenderbuffers(1, &targetDepthBufferID));
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, targetDepthBufferID));
    OOGL(glRenderbufferStorage(GL_RENDERBUFFER, GL_DEPTH_COMPONENT32F, (GLsizei)viewSize.width, (GLsizei)viewSize.height));
    OOGL(glFramebufferRenderbuffer(GL_FRAMEBUFFER, GL_DEPTH_ATTACHMENT, GL_RENDERBUFFER, targetDepthBufferID));
    
    GLenum attachment[1] = { GL_COLOR_ATTACHMENT0 };
    OOGL(glDrawBuffers(1, attachment));
    
    if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE)
    {
        OOLogERR(@"initTargetFramebufferWithViewSize.result", @"%@", @"***** Error: Framebuffer not complete");
    }
    
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
    
    targetFramebufferSize = viewSize;
    
    // passthrough buffer
    // This is a framebuffer whose sole purpose is to pass on the texture rendered from the game to the blur and the final bloom
    // shaders. We need it in order to be able to use the OpenGL 3.3 layout (location = x) out vec4 outVector; construct, which allows
    // us to perform multiple render target operations needed for bloom. The alternative would be to not use this and change all our
    // shaders to be OpenGL 3.3 compatible, but given how Oolite synthesizes them and the work needed to port them over, well yeah no,
    // not doing it at this time - Nikos 20220814.
    OOGL(glGenFramebuffers(1, &passthroughFramebufferID));
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, passthroughFramebufferID));
    
    // creating textures that should be rendered into
    OOGL(glGenTextures(2, passthroughTextureID));
    for (unsigned int i = 0; i < 2; i++)
    {
        OOGL(glBindTexture(GL_TEXTURE_2D, passthroughTextureID[i]));
        OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE));
        OOGL(glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0 + i, GL_TEXTURE_2D, passthroughTextureID[i], 0));
    }
    
    GLenum attachments[2] = { GL_COLOR_ATTACHMENT0, GL_COLOR_ATTACHMENT1 };
    OOGL(glDrawBuffers(2, attachments));
    
    if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE)
    {
        OOLogERR(@"initTargetFramebufferWithViewSize.result", @"%@", @"***** Error: Passthrough framebuffer not complete");
    }
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
    
    // ping-pong-framebuffer for blurring
    OOGL(glGenFramebuffers(2, pingpongFBO));
    OOGL(glGenTextures(2, pingpongColorbuffers));
    for (unsigned int i = 0; i < 2; i++)
    {
        OOGL(glBindFramebuffer(GL_FRAMEBUFFER, pingpongFBO[i]));
        OOGL(glBindTexture(GL_TEXTURE_2D, pingpongColorbuffers[i]));
        OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR));
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE)); // we clamp to the edge as the blur filter would otherwise sample repeated texture values!
        OOGL(glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE));
        OOGL(glFramebufferTexture2D(GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, pingpongColorbuffers[i], 0));
        // check if framebuffers are complete (no need for depth buffer)
        if (glCheckFramebufferStatus(GL_FRAMEBUFFER) != GL_FRAMEBUFFER_COMPLETE)
        {
            OOLogERR(@"initTargetFramebufferWithViewSize.result", @"%@", @"***** Error: Pingpong framebuffers not complete");
        }
    }
    OOGL(glBindFramebuffer(GL_FRAMEBUFFER, defaultDrawFBO));
    
    _bloom = [self detailLevel] >= DETAIL_LEVEL_EXTRAS;
    _currentPostFX = _colorblindMode = OO_POSTFX_NONE;
 
    /* TODO: in OOEnvironmentCubeMap.m call these bind functions not with 0 but with "previousXxxID"s:
      - OOGL(glBindTexture(GL_TEXTURE_CUBE_MAP, 0));
      - OOGL(glBindFramebufferEXT(GL_FRAMEBUFFER_EXT, 0));
      - OOGL(glBindRenderbufferEXT(GL_RENDERBUFFER_EXT, 0));
    */
    
    // shader for drawing a textured quad on the passthrough framebuffer and preparing it for bloom using MRT
    if (![[OOOpenGLExtensionManager sharedManager] shadersForceDisabled])
    {
        textureProgram = [[OOShaderProgram shaderProgramWithVertexShaderName:@"oolite-texture.vertex"
                                                    fragmentShaderName:@"oolite-texture.fragment"
                                                    prefix:@"#version 330\n"
                                                    attributeBindings:[NSDictionary dictionary]] retain];
        // shader for blurring the over-threshold brightness image generated from the previous step using Gaussian filter
        blurProgram = [[OOShaderProgram shaderProgramWithVertexShaderName:@"oolite-blur.vertex"
                                                    fragmentShaderName:@"oolite-blur.fragment"
                                                    prefix:@"#version 330\n"
                                                    attributeBindings:[NSDictionary dictionary]] retain];
        // shader for applying bloom and any necessary post-proc fx, tonemapping and gamma correction
        finalProgram = [[OOShaderProgram shaderProgramWithVertexShaderName:@"oolite-final.vertex"
#if OOLITE_WINDOWS
                                                    fragmentShaderName:[[UNIVERSE gameView] hdrOutput] ? @"oolite-final-hdr.fragment" : @"oolite-final.fragment"
#else
                                                    fragmentShaderName:@"oolite-final.fragment"
#endif
                                                    prefix:@"#version 330\n"
                                                    attributeBindings:[NSDictionary dictionary]] retain];
    }
    
    OOGL(glGenVertexArrays(1, &quadTextureVAO));
    OOGL(glGenBuffers(1, &quadTextureVBO));
    OOGL(glGenBuffers(1, &quadTextureEBO));
 
    OOGL(glBindVertexArray(quadTextureVAO));
 
    OOGL(glBindBuffer(GL_ARRAY_BUFFER, quadTextureVBO));
    OOGL(glBufferData(GL_ARRAY_BUFFER, sizeof(framebufferQuadVertices), framebufferQuadVertices, GL_STATIC_DRAW));
 
    OOGL(glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, quadTextureEBO));
    OOGL(glBufferData(GL_ELEMENT_ARRAY_BUFFER, sizeof(framebufferQuadIndices), framebufferQuadIndices, GL_STATIC_DRAW));
 
    OOGL(glEnableVertexAttribArray(0));
    // position attribute
    OOGL(glVertexAttribPointer(0, 2, GL_FLOAT, GL_FALSE, 4 * sizeof(float), (void*)0));
    OOGL(glEnableVertexAttribArray(1));
    // texture coord attribute
    OOGL(glVertexAttribPointer(1, 2, GL_FLOAT, GL_FALSE, 4 * sizeof(float), (void*)(2 * sizeof(float))));
 
 
    // restoring previous bindings
    OOGL(glUseProgram(previousProgramID));
    OOGL(glBindTexture(GL_TEXTURE_2D, previousTextureID));
    OOGL(glBindVertexArray(previousVAO));
    OOGL(glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, previousElementBuffer));
    OOGL(glBindBuffer(GL_ARRAY_BUFFER, previousArrayBuffer));
 
}

loadDescriptions

- (void) loadDescriptions

Extends class Universe.

Definition at line 7996 of file Universe.m.

{
    [_descriptions autorelease];
    _descriptions = [[ResourceManager dictionaryFromFilesNamed:@"descriptions.plist" inFolder:@"Config" andMerge:YES] retain];
    [self verifyDescriptions];
}

loadScenarios

- (void) loadScenarios

Extends class Universe.

Definition at line 7996 of file Universe.m.

{
    [_scenarios autorelease];
    _scenarios = [[ResourceManager arrayFromFilesNamed:@"scenarios.plist" inFolder:@"Config" andMerge:YES] retain];
}

populateSpaceFromActiveWormholes

- (void) populateSpaceFromActiveWormholes

Extends class Universe.

Definition at line 10697 of file Universe.m.

{
    NSAutoreleasePool   *pool = nil;
    
    while ([activeWormholes count])
    {
        pool = [[NSAutoreleasePool alloc] init];
        @try
        {
            WormholeEntity* whole = [activeWormholes objectAtIndex:0];      
            // If the wormhole has been scanned by the player then the
            // PlayerEntity will take care of it
            if (![whole isScanned] &&
                NSEqualPoints([PLAYER galaxy_coordinates], [whole destinationCoordinates]) )
            {
                // this is a wormhole to this system
                [whole disgorgeShips];
            }
            [activeWormholes removeObjectAtIndex:0];    // empty it out
        }
        @catch (NSException *exception)
        {
            OOLog(kOOLogException, @"Squashing exception during wormhole unpickling (%@: %@).", [exception name], [exception reason]);
        }
        [pool release];
    }
}

prepareToRenderIntoDefaultFramebuffer

- (void) prepareToRenderIntoDefaultFramebuffer

Extends class Universe.

Definition at line 4630 of file Universe.m.

{
    NSSize viewSize = [gameView viewSize];
    if([self useShaders])
    {
        if ([gameView msaa])
        {
            // resolve MSAA framebuffer to target framebuffer
            OOGL(glBindFramebuffer(GL_READ_FRAMEBUFFER, msaaFramebufferID));
            OOGL(glBindFramebuffer(GL_DRAW_FRAMEBUFFER, targetFramebufferID));
            OOGL(glBlitFramebuffer(0, 0, (GLint)viewSize.width, (GLint)viewSize.height, 0, 0, (GLint)viewSize.width, (GLint)viewSize.height, GL_COLOR_BUFFER_BIT, GL_NEAREST));
        }
    }
}

randomDistanceWithinScanner

- (float) randomDistanceWithinScanner

Extends class Universe.

Definition at line 9471 of file Universe.m.

{
    return SCANNER_MAX_RANGE * ((Ranrot() & 255) / 256.0 - 0.5);
}

randomPlaceWithinScannerFrom:alongRoute:withOffset:

- (Vector) randomPlaceWithinScannerFrom:		(Vector)	pos
alongRoute:		(Vector)	route
withOffset:		(double)	offset

Extends class Universe.

Definition at line 9471 of file Universe.m.

                                       :(Vector)pos alongRoute:(Vector)route withOffset:(double)offset
{
    pos.x += offset * route.x + [self randomDistanceWithinScanner];
    pos.y += offset * route.y + [self randomDistanceWithinScanner];
    pos.z += offset * route.z + [self randomDistanceWithinScanner];
    
    return pos;
}

resizeTargetFramebufferWithViewSize:

- (void) resizeTargetFramebufferWithViewSize:

(NSSize)

viewSize

Extends class Universe.

Definition at line 273 of file Universe.m.

                                            :(NSSize)viewSize
{
    int i;
    // resize MSAA color attachment
    OOGL(glBindTexture(GL_TEXTURE_2D_MULTISAMPLE, msaaTextureID));
    OOGL(glTexImage2DMultisample(GL_TEXTURE_2D_MULTISAMPLE, 4, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, GL_TRUE));
    OOGL(glBindTexture(GL_TEXTURE_2D_MULTISAMPLE, 0));
    
    // resize MSAA depth attachment
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, msaaDepthBufferID));
    OOGL(glRenderbufferStorageMultisample(GL_RENDERBUFFER, 4, GL_DEPTH_COMPONENT32F, (GLsizei)viewSize.width, (GLsizei)viewSize.height));
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, 0));
    
    // resize color attachments
    OOGL(glBindTexture(GL_TEXTURE_2D, targetTextureID));
    OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
    OOGL(glBindTexture(GL_TEXTURE_2D, 0));
    
    for (i = 0; i < 2; i++)
    {
        OOGL(glBindTexture(GL_TEXTURE_2D, pingpongColorbuffers[i]));
        OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
        OOGL(glBindTexture(GL_TEXTURE_2D, 0));
    }
    
    for (i = 0; i < 2; i++)
    {
        OOGL(glBindTexture(GL_TEXTURE_2D, passthroughTextureID[i]));
        OOGL(glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA16F, (GLsizei)viewSize.width, (GLsizei)viewSize.height, 0, GL_RGBA, GL_FLOAT, NULL));
        OOGL(glBindTexture(GL_TEXTURE_2D, 0));
    }
    
    // resize depth attachment
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, targetDepthBufferID));
    OOGL(glRenderbufferStorage(GL_RENDERBUFFER, GL_DEPTH_COMPONENT32F, (GLsizei)viewSize.width, (GLsizei)viewSize.height));
    OOGL(glBindRenderbuffer(GL_RENDERBUFFER, 0));
    
    targetFramebufferSize.width = viewSize.width;
    targetFramebufferSize.height = viewSize.height;
}

setDetailLevelDirectly:

- (void) setDetailLevelDirectly:

(OOGraphicsDetail)

value

Extends class Universe.

Definition at line 9471 of file Universe.m.

                               :(OOGraphicsDetail)value
{
    if (value >= DETAIL_LEVEL_MAXIMUM)
    {
        value = DETAIL_LEVEL_MAXIMUM;
    }
    else if (value <= DETAIL_LEVEL_MINIMUM)
    {
        value = DETAIL_LEVEL_MINIMUM;
    }
    if (![[OOOpenGLExtensionManager sharedManager] shadersSupported])
    {
        value = DETAIL_LEVEL_MINIMUM;
    }
    detailLevel = value;
}

setFirstBeacon:

- (void) setFirstBeacon:

(Entity< OOBeaconEntity > *)

beacon

Extends class Universe.

Definition at line 3616 of file Universe.m.

                       :(Entity <OOBeaconEntity> *)beacon
{
    if (beacon != [self firstBeacon])
    {
        [beacon setPrevBeacon:nil];
        [beacon setNextBeacon:[self firstBeacon]];
        [[self firstBeacon] setPrevBeacon:beacon];
        [_firstBeacon release];
        _firstBeacon = [beacon weakRetain];
    }
}

setLastBeacon:

- (void) setLastBeacon:

(Entity< OOBeaconEntity > *)

beacon

Extends class Universe.

Definition at line 3616 of file Universe.m.

                      :(Entity <OOBeaconEntity> *)beacon
{
    if (beacon != [self lastBeacon])
    {
        [beacon setNextBeacon:nil];
        [beacon setPrevBeacon:[self lastBeacon]];
        [[self lastBeacon] setNextBeacon:beacon];
        [_lastBeacon release];
        _lastBeacon = [beacon weakRetain];
    }
}

setLibraryTextForDemoShip

- (void) setLibraryTextForDemoShip

Extends class Universe.

Definition at line 273 of file Universe.m.

{
    OOGUITabSettings tab_stops;
    tab_stops[0] = 0;
    tab_stops[1] = 170;
    tab_stops[2] = 340;
    [gui setTabStops:tab_stops];
 
/*  [gui setText:[demo_ship displayName] forRow:19 align:GUI_ALIGN_CENTER];
    [gui setColor:[OOColor whiteColor] forRow:19]; */
 
    NSDictionary *librarySettings = [self demoShipData];
    
    OOGUIRow descRow = 7;
 
    NSString *field1 = nil;
    NSString *field2 = nil;
    NSString *field3 = nil;
    NSString *override = nil;
 
    // clear rows
    for (NSUInteger i=1;i<=26;i++)
    {
        [gui setText:@"" forRow:i];
    }
    
    /* Row 1: ScanClass, Name, Summary */
    override = [librarySettings oo_stringForKey:kOODemoShipClass defaultValue:@"ship"];
    field1 = OOShipLibraryCategorySingular(override);
 
 
    field2 = [demo_ship shipClassName];
 
 
    override = [librarySettings oo_stringForKey:kOODemoShipSummary defaultValue:nil];
    if (override != nil)
    {
        field3 = OOExpand(override);
    }
    else
    {
        field3 = @"";
    }
    [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:1];
    [gui setColor:[OOColor greenColor] forRow:1];
 
    // ship_data defaults to true for "ship" class, false for everything else
    if (![librarySettings oo_boolForKey:kOODemoShipShipData defaultValue:[[librarySettings oo_stringForKey:kOODemoShipClass defaultValue:@"ship"] isEqualToString:@"ship"]])
    {
        descRow = 3;
    }
    else
    {
        /* Row 2: Speed, Turn Rate, Cargo */
 
        override = [librarySettings oo_stringForKey:kOODemoShipSpeed defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field1 = @"";
            }
            else
            {
                field1 = [NSString stringWithFormat:DESC(@"oolite-ship-library-speed-custom"),OOExpand(override)];
            }
        }
        else
        {
            field1 = OOShipLibrarySpeed(demo_ship);
        }
        
 
        override = [librarySettings oo_stringForKey:kOODemoShipTurnRate defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field2 = @"";
            }
            else
            {
                field2 = [NSString stringWithFormat:DESC(@"oolite-ship-library-turn-custom"),OOExpand(override)];
            }
        }
        else
        {
            field2 = OOShipLibraryTurnRate(demo_ship);
        }
 
 
        override = [librarySettings oo_stringForKey:kOODemoShipCargo defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field3 = @"";
            }
            else
            {
                field3 = [NSString stringWithFormat:DESC(@"oolite-ship-library-cargo-custom"),OOExpand(override)];
            }
        }
        else
        {
            field3 = OOShipLibraryCargo(demo_ship);
        }
    
 
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:3];
 
        /* Row 3: recharge rate, energy banks, witchspace */
        override = [librarySettings oo_stringForKey:kOODemoShipGenerator defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field1 = @"";
            }
            else
            {
                field1 = [NSString stringWithFormat:DESC(@"oolite-ship-library-generator-custom"),OOExpand(override)];
            }
        }
        else
        {
            field1 = OOShipLibraryGenerator(demo_ship);
        }
 
 
        override = [librarySettings oo_stringForKey:kOODemoShipShields defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field2 = @"";
            }
            else
            {
                field2 = [NSString stringWithFormat:DESC(@"oolite-ship-library-shields-custom"),OOExpand(override)];
            }
        }
        else
        {
            field2 = OOShipLibraryShields(demo_ship);
        }
 
 
        override = [librarySettings oo_stringForKey:kOODemoShipWitchspace defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field3 = @"";
            }
            else
            {
                field3 = [NSString stringWithFormat:DESC(@"oolite-ship-library-witchspace-custom"),OOExpand(override)];
            }
        }
        else
        {
            field3 = OOShipLibraryWitchspace(demo_ship);
        }
 
 
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:4];
 
 
        /* Row 4: weapons, turrets, size */
        override = [librarySettings oo_stringForKey:kOODemoShipWeapons defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field1 = @"";
            }
            else
            {
                field1 = [NSString stringWithFormat:DESC(@"oolite-ship-library-weapons-custom"),OOExpand(override)];
            }
        }
        else
        {
            field1 = OOShipLibraryWeapons(demo_ship);
        }
 
        override = [librarySettings oo_stringForKey:kOODemoShipTurrets defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field2 = @"";
            }
            else
            {
                field2 = [NSString stringWithFormat:DESC(@"oolite-ship-library-turrets-custom"),OOExpand(override)];
            }
        }
        else
        {
            field2 = OOShipLibraryTurrets(demo_ship);
        }
 
        override = [librarySettings oo_stringForKey:kOODemoShipSize defaultValue:nil];
        if (override != nil)
        {
            if ([override length] == 0)
            {
                field3 = @"";
            }
            else
            {
                field3 = [NSString stringWithFormat:DESC(@"oolite-ship-library-size-custom"),OOExpand(override)];
            }
        }
        else
        {
            field3 = OOShipLibrarySize(demo_ship);
        }
 
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:5];
    }
 
    override = [librarySettings oo_stringForKey:kOODemoShipDescription defaultValue:nil];
    if (override != nil)
    {
        [gui addLongText:OOExpand(override) startingAtRow:descRow align:GUI_ALIGN_LEFT];
    }
 
    
    // line 19: ship categories
    field1 = [NSString stringWithFormat:@"<-- %@",OOShipLibraryCategoryPlural([[[demo_ships objectAtIndex:((demo_ship_index+[demo_ships count]-1)%[demo_ships count])] objectAtIndex:0] oo_stringForKey:kOODemoShipClass])];
    field2 = OOShipLibraryCategoryPlural([[[demo_ships objectAtIndex:demo_ship_index] objectAtIndex:0] oo_stringForKey:kOODemoShipClass]);
    field3 = [NSString stringWithFormat:@"%@ -->",OOShipLibraryCategoryPlural([[[demo_ships objectAtIndex:((demo_ship_index+1)%[demo_ships count])] objectAtIndex:0] oo_stringForKey:kOODemoShipClass])];
    
    [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:19];
    [gui setColor:[OOColor greenColor] forRow:19];
 
    // lines 21-25: ship names
    NSArray *subList = [demo_ships objectAtIndex:demo_ship_index];
    NSUInteger i,start = demo_ship_subindex - (demo_ship_subindex%5);
    NSUInteger end = start + 4;
    if (end >= [subList count])
    {
        end = [subList count] - 1;
    }
    OOGUIRow row = 21;
    field1 = @"";
    field3 = @"";
    for (i = start ; i <= end ; i++)
    {
        field2 = [[subList objectAtIndex:i] oo_stringForKey:kOODemoShipName];
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:row];
        if (i == demo_ship_subindex)
        {
            [gui setColor:[OOColor yellowColor] forRow:row];
        }
        else
        {
            [gui setColor:[OOColor whiteColor] forRow:row];
        }
        row++;
    }
 
    field2 = @"...";
    if (start > 0)
    {
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:20];
        [gui setColor:[OOColor whiteColor] forRow:20];
    }
    if (end < [subList count]-1)
    {
        [gui setArray:[NSArray arrayWithObjects:field1,field2,field3,nil] forRow:26];
        [gui setColor:[OOColor whiteColor] forRow:26];
    }
 
}

setShaderEffectsLevelDirectly:

- (void) setShaderEffectsLevelDirectly:

(OOShaderSetting)

value

Extends class Universe.

setUpCargoPods

- (void) setUpCargoPods

Extends class Universe.

Definition at line 9471 of file Universe.m.

{
    NSMutableDictionary *tmp = [[NSMutableDictionary alloc] initWithCapacity:[commodities count]];
    OOCommodityType type = nil;
    foreach (type, [commodities goods])
    {
        ShipEntity *container = [self newShipWithRole:@"oolite-template-cargopod"];
        [container setScanClass:CLASS_CARGO];
        [container setCommodity:type andAmount:1];
        [tmp setObject:container forKey:type];
        [container release];
    }
    [cargoPods release];
    cargoPods = [[NSDictionary alloc] initWithDictionary:tmp];
    [tmp release];
}

setUpInitialUniverse

- (void) setUpInitialUniverse

Extends class Universe.

Definition at line 9471 of file Universe.m.

{
    PlayerEntity* player = PLAYER;
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"Wormhole and character reset");
    if (activeWormholes) [activeWormholes autorelease];
    activeWormholes = [[NSMutableArray arrayWithCapacity:16] retain];
    if (characterPool) [characterPool autorelease];
    characterPool = [[NSMutableArray arrayWithCapacity:256] retain];
    OO_DEBUG_POP_PROGRESS();
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"Galaxy reset");
    [self setGalaxyTo: [player galaxyNumber] andReinit:YES];
    systemID = [player systemID];
    OO_DEBUG_POP_PROGRESS();
    
    OO_DEBUG_PUSH_PROGRESS(@"%@", @"Player init: setUpShipFromDictionary");
    [player setUpShipFromDictionary:[[OOShipRegistry sharedRegistry] shipInfoForKey:[player shipDataKey]]]; // the standard cobra at this point
    [player baseMass]; // bootstrap the base mass used in all fuel charge calculations.
    OO_DEBUG_POP_PROGRESS();
    
    // Player init above finishes initialising all standard player ship properties. Now that the base mass is set, we can run setUpSpace! 
    [self setUpSpace];
    
    [self setDockingClearanceProtocolActive:
              [[self currentSystemData] oo_boolForKey:@"stations_require_docking_clearance" defaultValue:YES]];
 
    [self enterGUIViewModeWithMouseInteraction:NO];
    [player setPosition:[[self station] position]];
    [player setOrientation:kIdentityQuaternion];
}

verifyDescriptions

- (void) verifyDescriptions

Extends class Universe.

Definition at line 7996 of file Universe.m.

{
    /*
        Ensure that no descriptions.plist entries contain the %n format code,
        which can be used to smash the stack and potentially call arbitrary
        functions.
        
        %n is deliberately not supported in Foundation/CoreFoundation under
        Mac OS X, but unfortunately GNUstep implements it.
        -- Ahruman 2011-05-05
    */
    
    NSString *key = nil;
    if (_descriptions == nil)
    {
        OOLog(@"descriptions.verify", @"%@", @"***** FATAL: Tried to verify descriptions, but descriptions was nil - unable to load any descriptions.plist file.");
        exit(EXIT_FAILURE);
    }
    foreachkey (key, _descriptions)
    {
        VerifyDesc(key, [_descriptions objectForKey:key]);
    }
}

verifyEntitySessionIDs

- (void) verifyEntitySessionIDs

Extends class Universe.

Definition at line 9471 of file Universe.m.

{
#ifndef NDEBUG
    NSMutableArray *badEntities = nil;
    Entity *entity = nil;
    
    unsigned i;
    for (i = 0; i < n_entities; i++)
    {
        entity = sortedEntities[i];
        if ([entity sessionID] != _sessionID)
        {
            OOLogERR(@"universe.sessionIDs.verify.failed", @"Invalid entity %@ (came from session %lu, current session is %lu).", [entity shortDescription], [entity sessionID], _sessionID);
            if (badEntities == nil)  badEntities = [NSMutableArray array];
            [badEntities addObject:entity];
        }
    }
    
    foreach (entity, badEntities)
    {
        [self removeEntity:entity];
    }
#endif
}

---

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

• src/Core/Universe.m