PlayerEntity(OOLoadSavePrivate) Category Reference

Instance Methods
(void)	- setGuiToLoadCommanderScreen
(void)	- setGuiToSaveCommanderScreen:
(void)	- setGuiToOverwriteScreen:
(void)	- lsCommanders:directory:pageNumber:highlightName:
(void)	- showCommanderShip:
(int)	- findIndexOfCommander:
(void)	- nativeSavePlayer:
(BOOL)	- existingNativeSave:
(void)	- writePlayerToPath:
(NSComparisonResult)	- sortCommanders [implementation]

Detailed Description

Definition at line 72 of file PlayerEntityLoadSave.m.

Method Documentation

existingNativeSave:

- (BOOL) existingNativeSave:

(NSString *)

cdrName

Definition at line 1011 of file PlayerEntityLoadSave.m.

                           : (NSString *)cdrName
{
    NSString*   dir = [[UNIVERSE gameController] playerFileDirectory];
    
    NSString *savePath=[dir stringByAppendingPathComponent:[cdrName stringByAppendingPathExtension:@"oolite-save"]];
    return [[NSFileManager defaultManager] fileExistsAtPath:savePath];
}

findIndexOfCommander:

- (int) findIndexOfCommander:

(NSString *)

cdrName

Definition at line 1011 of file PlayerEntityLoadSave.m.

                            : (NSString *)cdrName
{
    unsigned i;
    for (i=0; i < [cdrDetailArray count]; i++)
    {
        NSString *currentName = [[cdrDetailArray oo_dictionaryAtIndex: i] oo_stringForKey:@"player_save_name" defaultValue:[[cdrDetailArray oo_dictionaryAtIndex: i] oo_stringForKey:@"player_name"]];
        if([cdrName compare: currentName] == NSOrderedSame)
        {
            return i;
        }
    }
    
    // not found!
    return -1;
}

lsCommanders:directory:pageNumber:highlightName:

- (void) lsCommanders:		(GuiDisplayGen *)	gui
directory:		(NSString*)	directory
pageNumber:		(int)	page
highlightName:		(NSString *)	highlightName

Definition at line 1011 of file PlayerEntityLoadSave.m.

                     : (GuiDisplayGen *)gui
            directory: (NSString*) directory
           pageNumber: (int)page
        highlightName: (NSString *)highlightName
{
    NSFileManager *cdrFileManager=[NSFileManager defaultManager];
    int rangeStart=STARTROW;
    unsigned lastIndex;
    unsigned i;
    int row=STARTROW;
    
    // cdrArray defined in PlayerEntity.h
    NSArray *cdrArray=[cdrFileManager commanderContentsOfPath: directory];
    
    // get commander details so a brief rundown of the commander's details may
    // be displayed.
    if (!cdrDetailArray)
        cdrDetailArray=[[NSMutableArray alloc] init];   // alloc retains this so the retain further on in the code was unnecessary
    else
        [cdrDetailArray removeAllObjects];
    
    [cdrDetailArray addObject:[NSMutableDictionary dictionaryWithObjectsAndKeys:
        @"YES", @"isParentFolder",
        [directory stringByDeletingLastPathComponent], @"saved_game_path", nil]];
    
    for(i = 0; i < [cdrArray count]; i++)
    {
        NSString*   path = [cdrArray objectAtIndex:i];
        BOOL        exists, isDirectory = NO;
        
        exists = [cdrFileManager fileExistsAtPath:path isDirectory:&isDirectory];
        
        if (exists)
        {
            if (!isDirectory && [[[path pathExtension] lowercaseString] isEqualToString:@"oolite-save"])
            {
                NSDictionary *cdr = OODictionaryFromFile(path);
                if(cdr)
                {
                    // okay use the same dictionary but add a 'saved_game_path' attribute
                    NSMutableDictionary* cdr1 = [NSMutableDictionary dictionaryWithDictionary:cdr];
                    [cdr1 setObject: @"YES" forKey:@"isSavedGame"];
                    [cdr1 setObject: path forKey:@"saved_game_path"];
                    [cdrDetailArray addObject: cdr1];
                }
            }
            if (isDirectory && ![[path lastPathComponent] hasPrefix:@"."])
            {
                [cdrDetailArray addObject: [NSDictionary dictionaryWithObjectsAndKeys: @"YES", @"isFolder", path, @"saved_game_path", nil]];
            }
        }
    }
    
    if(![cdrDetailArray count])
    {
        // Empty directory; tell the user and exit immediately.
        [gui setText:DESC(@"loadsavescreen-no-commanders-found") forRow:STARTROW align:GUI_ALIGN_CENTER];
        return;
    }
 
    [cdrDetailArray sortUsingFunction:sortCommanders context:NULL];
    
    // Do we need to highlight a name?
    int highlightRowOnPage=STARTROW;
    int highlightIdx=0;
    if(highlightName)
    {
        highlightIdx=[self findIndexOfCommander: highlightName];
        if(highlightIdx < 0)
        {
            OOLog(@"save.list.commanders.commanderNotFound", @"Commander %@ doesn't exist, very bad", highlightName);
            highlightIdx=0;
        }
        
        // figure out what page we need to be on
        page=highlightIdx/NUMROWS;
        highlightRowOnPage=highlightIdx % NUMROWS + STARTROW;
    }
    
    // We now know for certain what page we're on - 
    // set the first index of the first commander on this page.
    unsigned firstIndex=page * NUMROWS;
    
    // Set up the GUI.
    OOGUITabSettings tabStop;
    tabStop[0]=0;
    tabStop[1]=160;
    tabStop[2]=270;
    [gui setTabStops: tabStop];
    
    // clear text lines here
    for (i = EXITROW ; i < ENDROW + 1; i++)
    {
        [gui setText:@"" forRow:i align:GUI_ALIGN_LEFT];
        [gui setColor: [OOColor yellowColor] forRow: i];
        [gui setKey:GUI_KEY_SKIP forRow:i];
    }
 
    [gui setColor: [OOColor greenColor] forRow: LABELROW];
    [gui setArray: [NSArray arrayWithObjects: DESC(@"loadsavescreen-commander-name"), DESC(@"loadsavescreen-rating"), nil]
           forRow:LABELROW];
 
    if (page)
    {
        [gui setColor:[OOColor greenColor] forRow:STARTROW-1];
        [gui setArray:[NSArray arrayWithObjects:DESC(@"gui-back"), @" <-- ", nil]
               forRow:STARTROW-1];
        [gui setKey:GUI_KEY_OK forRow:STARTROW-1];
        rangeStart=STARTROW-1;
    }
 
    if ([self status] == STATUS_START_GAME)
    {
        [gui setArray:[NSArray arrayWithObjects:DESC(@"oolite-loadsave-exit"), @" <----- ", nil] forRow:EXITROW];
        [gui setColor:[OOColor redColor] forRow:EXITROW];
        [gui setKey:GUI_KEY_OK forRow:EXITROW];
        rangeStart = EXITROW;
    }
 
    
    if (firstIndex + NUMROWS >= [cdrDetailArray count])
    {
        lastIndex=[cdrDetailArray count];
        [gui setSelectableRange: NSMakeRange(rangeStart, rangeStart + NUMROWS + 2)];
    }
    else
    {
        lastIndex=(page * NUMROWS) + NUMROWS;
        [gui setColor:[OOColor greenColor] forRow:ENDROW];
        [gui setArray:[NSArray arrayWithObjects:DESC(@"gui-more"), @" --> ", nil]
               forRow:ENDROW];
        [gui setKey:GUI_KEY_OK forRow:ENDROW];
        [gui setSelectableRange: NSMakeRange(rangeStart, MOREROW)];
    }
    
    for (i=firstIndex; i < lastIndex; i++)
    {
        NSDictionary *cdr=[cdrDetailArray objectAtIndex: i];
        if ([cdr oo_boolForKey:@"isSavedGame"])
        {
            NSString *ratingDesc = OODisplayRatingStringFromKillCount([cdr oo_unsignedIntForKey:@"ship_kills"]);
            [gui setArray:[NSArray arrayWithObjects:
                [NSString stringWithFormat:@" %@ ",[cdr oo_stringForKey:@"player_save_name" defaultValue:[cdr oo_stringForKey:@"player_name"]]],
                [NSString stringWithFormat:@" %@ ",ratingDesc],
                nil]
                   forRow:row];
            if ([[self lastsaveName] isEqualToString:[cdr oo_stringForKey:@"player_save_name" defaultValue:[cdr oo_stringForKey:@"player_name"]]])
            {
                highlightRowOnPage = row;
            }
            
            [gui setKey:GUI_KEY_OK forRow:row];
            row++;
        }
        if ([cdr oo_boolForKey:@"isParentFolder"])
        {
            [gui setArray:[NSArray arrayWithObjects:
                [NSString stringWithFormat:@" (..) %@ ", [[cdr oo_stringForKey:@"saved_game_path"] lastPathComponent]],
                @"",
                nil]
                   forRow:row];
            [gui setColor: [OOColor orangeColor] forRow: row];
            [gui setKey:GUI_KEY_OK forRow:row];
            row++;
        }
        if ([cdr oo_boolForKey:@"isFolder"])
        {
            [gui setArray:[NSArray arrayWithObjects:
                [NSString stringWithFormat:@" >> %@ ", [[cdr oo_stringForKey:@"saved_game_path"] lastPathComponent]],
                @"",
                nil]
                   forRow:row];
            [gui setColor: [OOColor orangeColor] forRow: row];
            [gui setKey:GUI_KEY_OK forRow:row];
            row++;
        }
    }
    [gui setSelectedRow: highlightRowOnPage];
    highlightIdx = (highlightRowOnPage - STARTROW) + (currentPage * NUMROWS);
    // show the first ship, this will be the selected row
    [self showCommanderShip: highlightIdx];
}

nativeSavePlayer:

- (void) nativeSavePlayer:

(NSString *)

cdrName

Definition at line 1420 of file PlayerEntityLoadSave.m.

                        :(NSString *)cdrName
{
    NSString*   dir = [[UNIVERSE gameController] playerFileDirectory];
    NSString *savePath = [dir stringByAppendingPathComponent:[cdrName stringByAppendingPathExtension:@"oolite-save"]];
    
    ShipScriptEventNoCx(self, "playerWillSaveGame", OOJSSTR("STANDARD_SAVE"));
    
    [self setLastsaveName:cdrName];
    
    [self writePlayerToPath:savePath];
}

setGuiToLoadCommanderScreen

- (void) setGuiToLoadCommanderScreen

Definition at line 1420 of file PlayerEntityLoadSave.m.

{
    GuiDisplayGen *gui=[UNIVERSE gui];
    NSString*   dir = [[UNIVERSE gameController] playerFileDirectory];
    
    gui_screen = GUI_SCREEN_LOAD;
    
    [gui clear];
    [gui setTitle:DESC(@"loadscreen-title")];
    
    currentPage = 0;
    [self lsCommanders:gui directory:dir pageNumber: currentPage highlightName:nil];
    
    [gui setForegroundTextureKey:@"docked_overlay"];
    [gui setBackgroundTextureKey:@"load_save"];
    
    [[UNIVERSE gameView] suppressKeysUntilKeyUp];
    
    [self setShowDemoShips:YES];
    [UNIVERSE enterGUIViewModeWithMouseInteraction:YES];
}

setGuiToOverwriteScreen:

- (void) setGuiToOverwriteScreen:

(NSString *)

cdrName

Definition at line 1420 of file PlayerEntityLoadSave.m.

                                :(NSString *)cdrName
{
    GuiDisplayGen *gui=[UNIVERSE gui];
    MyOpenGLView*   gameView = [UNIVERSE gameView];
    
    // Don't poll controls
    pollControls=NO;
    
    gui_screen = GUI_SCREEN_SAVE_OVERWRITE;
    
    [gui clear];
    [gui setTitle:[NSString stringWithFormat:DESC(@"overwrite-save-commander-@"), cdrName]];
    
    [gui setText:[NSString stringWithFormat:DESC(@"overwritescreen-commander-@-already-exists-overwrite-query"), cdrName]
                                forRow:SAVE_OVERWRITE_WARN_ROW align: GUI_ALIGN_CENTER];
    
    [gui setText:DESC(@"overwritescreen-yes") forRow: SAVE_OVERWRITE_YES_ROW align: GUI_ALIGN_CENTER];
    [gui setKey:GUI_KEY_OK forRow: SAVE_OVERWRITE_YES_ROW];
    
    [gui setText:DESC(@"overwritescreen-no") forRow: SAVE_OVERWRITE_NO_ROW align: GUI_ALIGN_CENTER];
    [gui setKey:GUI_KEY_OK forRow: SAVE_OVERWRITE_NO_ROW];
    
    [gui setSelectableRange: NSMakeRange(SAVE_OVERWRITE_YES_ROW, 2)];
    [gui setSelectedRow: SAVE_OVERWRITE_NO_ROW];
    
    // We can only leave this screen by answering yes or no, or esc. Therefore
    // use a specific overlay, to allow visual reminders of the available options.
    [gui setForegroundTextureKey:@"overwrite_overlay"];
    [gui setBackgroundTextureKey:@"load_save"];
    
    [self setShowDemoShips:NO];
    [gameView setStringInput:gvStringInputNo];
    [UNIVERSE enterGUIViewModeWithMouseInteraction:NO]; // FIXME: should be YES, but was NO before introducing new mouse mode stuff. If set to YES, choices can be selected but not activated.
}

setGuiToSaveCommanderScreen:

- (void) setGuiToSaveCommanderScreen:

(NSString *)

cdrName

Definition at line 1420 of file PlayerEntityLoadSave.m.

                                    :(NSString *)cdrName
{
    GuiDisplayGen *gui=[UNIVERSE gui];
    MyOpenGLView *gameView = [UNIVERSE gameView];
    NSString *dir = [[UNIVERSE gameController] playerFileDirectory];
    
    pollControls = NO;
    gui_screen = GUI_SCREEN_SAVE;
    
    [gui clear];
    [gui setTitle:DESC(@"savescreen-title")];
    
    currentPage = 0;
    [self lsCommanders:gui directory:dir pageNumber: currentPage highlightName:nil];
    
    [gui setText:DESC(@"savescreen-commander-name") forRow: INPUTROW];
    [gui setColor:[OOColor cyanColor] forRow:INPUTROW];
    [gui setShowTextCursor: YES];
    [gui setCurrentRow: INPUTROW];
    
    [gui setForegroundTextureKey:@"docked_overlay"];
    [gui setBackgroundTextureKey:@"load_save"];
    
    [gameView setTypedString:cdrName];
    [gameView suppressKeysUntilKeyUp];
    
    [self setShowDemoShips:YES];
    [UNIVERSE enterGUIViewModeWithMouseInteraction:YES];
}

showCommanderShip:

- (void) showCommanderShip:

(int)

cdrArrayIndex

Definition at line 1011 of file PlayerEntityLoadSave.m.

                          :(int)cdrArrayIndex
{
    GuiDisplayGen *gui=[UNIVERSE gui];
    [UNIVERSE removeDemoShips];
    NSDictionary *cdr=[cdrDetailArray objectAtIndex: cdrArrayIndex];
    
    [gui setText:@"" forRow:CDRDESCROW align:GUI_ALIGN_LEFT];
    [gui setText:@"" forRow:CDRDESCROW + 1 align:GUI_ALIGN_LEFT];
    [gui setText:@"" forRow:CDRDESCROW + 2 align:GUI_ALIGN_LEFT];
    
    if ([cdr oo_boolForKey:@"isFolder"])
    {
        NSString *folderDesc=[NSString stringWithFormat: DESC(@"loadsavescreen-hold-@-and-press-return-to-open-folder-@"), @COMMAND_MODIFIER_KEY, [[cdr oo_stringForKey:@"saved_game_path"] lastPathComponent]];
        [gui setColor: [OOColor orangeColor] forRow: CDRDESCROW];
        [gui addLongText: folderDesc startingAtRow: CDRDESCROW align: GUI_ALIGN_LEFT];
        return;
    }
    
    if ([cdr oo_boolForKey:@"isParentFolder"])
    {
        NSString *folderDesc=[NSString stringWithFormat: DESC(@"loadsavescreen-hold-@-and-press-return-to-open-parent-folder-@"), @COMMAND_MODIFIER_KEY, [[cdr oo_stringForKey:@"saved_game_path"] lastPathComponent]];
        [gui setColor: [OOColor orangeColor] forRow: CDRDESCROW];
        [gui addLongText: folderDesc startingAtRow: CDRDESCROW align: GUI_ALIGN_LEFT];
        return;
    }
    [gui setColor:[gui colorFromSetting:nil defaultValue:nil] forRow: CDRDESCROW];
 
    if (![cdr oo_boolForKey:@"isSavedGame"])  return;   // don't show things that aren't saved games
    
    if ([self dockedStation] == nil)  [self setDockedAtMainStation];
    
    // Display the commander's ship.
    NSString            *shipDesc = [cdr oo_stringForKey:@"ship_desc"];
    NSString            *shipName = nil;
    NSDictionary        *shipDict = nil;
    NSString            *rating = nil;
    uint16_t            personality = PersonalityForCommanderDict(cdr);
    
    shipDict = [[OOShipRegistry sharedRegistry] shipInfoForKey:shipDesc];
    if(shipDict != nil)
    {
        NSMutableDictionary * dict = [[NSMutableDictionary alloc] initWithCapacity:[shipDict count] + 1];
        [dict setDictionary:shipDict];
        id subEntStatus = [cdr objectForKey:@"subentities_status"];
        // don't add it to the dictionary if there's no subentities_status key
        if (subEntStatus != nil) [dict setObject:subEntStatus forKey:@"subentities_status"];
        [self showShipyardModel:shipDesc shipData:dict personality:personality];
        [dict release];
        shipName = [shipDict oo_stringForKey:@"display_name"];
        if (shipName == nil) shipName = [shipDict oo_stringForKey:KEY_NAME];
    }
    else
    {
        [self showShipyardModel:@"oolite-unknown-ship" shipData:nil personality:personality];
        shipName = [cdr oo_stringForKey:@"ship_name" defaultValue:@"unknown"];
        if (![[UNIVERSE useAddOns] isEqualToString:SCENARIO_OXP_DEFINITION_ALL])
        {
            shipName = [shipName stringByAppendingString:@" - OXPs disabled or not installed"];
        }
        else
        {
            shipName = [shipName stringByAppendingString:@" - OXP not installed"];
        }
    }
    
    // Make a short description of the commander
    NSString *legalDesc = OODisplayStringFromLegalStatus([cdr oo_intForKey:@"legal_status"]);
    
    rating = KillCountToRatingAndKillString([cdr oo_unsignedIntForKey:@"ship_kills"]);
    OOCreditsQuantity money = OODeciCreditsFromObject([cdr objectForKey:@"credits"]);
    
    // Nikos - Add some more information in the load game screen (current location, galaxy number and timestamp).
    //-------------------------------------------------------------------------------------------------------------------------
    
    int         galNumber;
    NSString        *timeStamp  = nil;
    NSString        *locationName = [cdr oo_stringForKey:@"current_system_name"];
 
    // If there is no key containing the name of the current system in
    // the savefile, calculating what it should have been is going to
    // be tricky now that system generation isn't seed based - but
    // this implies a save game well over 5 years old.
    if (locationName == nil)
    {   
        // Leaving the location blank in this case is probably okay
        locationName = @"";
    }
    
    galNumber = [cdr oo_intForKey:@"galaxy_number"] + 1;    // Galaxy numbering starts at 0.
 
    NSString *locationGov = @"";
    NSString *locationEco = @"";
    NSString *locationTL = [cdr objectForKey:@"current_system_techlevel"] ? [NSString stringWithFormat:@"%u", [cdr oo_unsignedIntForKey:@"current_system_techlevel"] + 1] : nil;
    if (locationTL)
    {
        locationGov = [NSString stringWithFormat:@"%c", [cdr oo_unsignedCharForKey:@"current_system_government"]];
        locationEco = [NSString stringWithFormat:@" %c", (7 - [cdr oo_unsignedCharForKey:@"current_system_economy"]) + 16];
    }
    else  locationTL = @"";
    
    timeStamp = ClockToString([cdr oo_doubleForKey:@"ship_clock" defaultValue:PLAYER_SHIP_CLOCK_START], NO);
    
    //-------------------------------------------------------------------------------------------------------------------------
    
    NSString        *cdrDesc = nil;
    
    cdrDesc = [NSString stringWithFormat:DESC(@"loadsavescreen-commander-@-rated-@-has-@-legal-status-@-ship-@-location-@-g-@-eco-@-gov-@-tl-@-timestamp-@"),
        [cdr oo_stringForKey:@"player_name"],
        rating,
        OOCredits(money),
        legalDesc,
        shipName,
        locationName,
        galNumber,
        locationEco,
        locationGov,
        locationTL,
        timeStamp];
    
    //-------------------------------------------------------------------------------------------------------------------------
    
    [gui addLongText:cdrDesc startingAtRow:CDRDESCROW align:GUI_ALIGN_LEFT];
    
}

sortCommanders

- (NSComparisonResult) sortCommanders (id)  cdr1 (id)  cdr2 (void *)  context

implementation

Definition at line 1011 of file PlayerEntityLoadSave.m.

{
    return [[cdr1 objectForKey:@"saved_game_path"] localizedCompare:[cdr2 objectForKey:@"saved_game_path"]];
}

writePlayerToPath:

- (void) writePlayerToPath:

(NSString *)

path

Definition at line 1420 of file PlayerEntityLoadSave.m.

                          :(NSString *)path
{
    NSString        *errDesc = nil;
    NSDictionary    *dict = nil;
    BOOL            didSave = NO;
    [[UNIVERSE gameView] resetTypedString];
    
    if (!path)
    {
        OOLog(@"save.failed", @"***** SAVE ERROR: %s called with nil path.", __PRETTY_FUNCTION__);
        return;
    }
    
    dict = [self commanderDataDictionary];
    if (dict == nil)  errDesc = @"could not construct commander data dictionary.";
    else  didSave = [dict writeOOXMLToFile:path atomically:YES errorDescription:&errDesc];
    if (didSave)
    {
        [UNIVERSE clearPreviousMessage];    // allow this to be given time and again
        [UNIVERSE addMessage:DESC(@"game-saved") forCount:2];
        [save_path autorelease];
        save_path = [path copy];
        [[UNIVERSE gameController] setPlayerFileToLoad:save_path];
        [[UNIVERSE gameController] setPlayerFileDirectory:save_path];
        // no duplicated autosave immediately after a save.
        [UNIVERSE setAutoSaveNow:NO];
    }
    else
    {
        OOLog(@"save.failed", @"***** SAVE ERROR: %@", errDesc);
        [NSException raise:@"OoliteException"
                    format:@"Attempt to save game to file '%@' failed: %@", path, errDesc];
    }
    [[UNIVERSE gameView] suppressKeysUntilKeyUp];
    [self setGuiToStatusScreen];
}

---

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

• src/Core/Entities/PlayerEntityLoadSave.m