game_save

game_save(STRING* name, var num, var mode)

Speichert den aktuellen Zustand des Spiels im savedir-Ordner für eine spätere Wiederaufnahme des Spiels an der gegenwärtigen Position.

Parameter:

name

Name der zu speichernden Datei ohne Extension und Pfad

num

STRING* oder char*, maximal dreistellige Nummer, die dem Dateinamen zugefügt wird. Die Extension ".sav" wird automatisch angehängt.

mode

Speicher-Modus; kann durch Hinzufügen oder Wegnehmen der folgenden Modi kombiniert werden:

SV_VARS	speichert alle globalen, benutzerdefinierten Variablen, mit Ausnahme von var_info und var_nsave-Variablen (C-Skript) bzw. ausser Variablen, die auf _i or _n enden (lite-C).
SV_INFO	speichert alle globalen var_info-Variablen (C-Skript) bzw. alle globalen Variablen, die auf _i enden (lite-C).
SV_SYS	speichert alle vordefinierten Engine-Variablen.
SV_STRINGS	speichert alle modifizierten Strings.
SV_POINTERS	speichert alle Pointer (nur in C-Skript). Unter lite-C nehmen Sie als Speicherverweise auf Objekte Handles.
SV_BMAPS	speichert alle per bmap_for_screen modifizierten bmaps. Andere Bitmap-Manipulationen werden nicht gespeichert.
SV_KEYS	speichert alle Funktionen, die Tastatur, Maus, Joystick oder anderen Events zugewiesen wurden.
SV_FUNCTIONS	speichert den Zustand aller laufender Funktionen und aller lokaler Variablen.
SV_PANELS	speichert alle Panel- und Text-Objekte.
SV_VIEWS	speichert alle Views.
SV_SKY	speichert alle Sky-Entities,
SV_LEVEL	speichert den aktuellen Level und alle Level Entities. Die Ausrichtung von Modell-Bones und die Deformationen von Modell- oder Terrain-Meshes wird nicht gespeichert.
SV_MATERIAL	speichert alle Materialien. Effekt-Code wird nicht gespeichert.
SV_PATH	speichert alle Pfade die durch path_setnode oder path_setedge verändert wurden.
SV_STRUCT	speichewrt alle durch add_struct markierten Speicherbereiche.
SV_PHYSICS	speichert den Zustand der Physik-Engine. Benutzen Sie dies in Kombination mit SV_LEVEL, wenn Ihr Level Physik-Entities enthält.
SV_ALL	speichert alles.

Rückgabewert:

> 0 - erfolgreich gespeichert, <= 0 - Speichern fehlgeschlagen.

Geschwindigkeit:

Langsam

Bemerkungen:

Objekte werden nach ihren Indices gespeichert. Daher dürfen Level, Skripte und Objekte sich mit Ausnahme von Level-Entities zwischen game_save und game_load nicht verändern. Sämtliche .._create und .._remove-Aufrufe mit Ausnahme des Erstellens und Entfernens von Level-Entities, müssen vor dem ersten game_save- oder game_load-Aufruf ausgeführt werden. Die Anzahl von Engine-Objekten wie Panels oder Texte muß zur Speicher- und Ladezeit dieselbe sein. Wurde das Skript in irgendeiner Weise geändert oder unterscheidet sich die Anzahl von Objekten, wird game_load fehlschlagen.
Die Anzahl an Physik-Objekten darf sich zwischen game_save und game_load nicht verändern. In einem Spiel mit Physik, muß der Level geladen und sämtliche Physik-Objekte müssen ordnungsgemäß initialisiert sein, ehe game_save und game_load ausgeführt werden.
Mit SV_FUNCTIONS nehmen alle Funktionen mit Ausnahme des aktuellen Prozesses, der die game_save-Funktion aufgerufen hat, ihren Arbeitsprozess an ihren momentanen wait()-Positionen wieder auf. Dieser Vorgang wird nicht wiederholt und sollte keinen wait- oder sleep-Call enthalten.
Lokale Variablen und die my- und you-Pointer werden mit Funktionen gespeichert. Andere lokale Pointer werden nicht gespeichert. Daher sollten lokale Pointer auf Engine-Objekte, wie Entities oder Bmaps in einem Handle abgelegt werden, damit sie während des wait()-Zyklus´ einer Speichern-/Laden-Operation zurückgeholt werden können. Unter ptr_for_handle() gibt es ein Beispiel.
Event-Zuweisungen werden nur für Skript-Funktionen gespeichert. Externe Sprachfunktionen müssen vor der ersten game_save-Anweisung zugewiesen sein und dürfen danach nicht mehr verändert werden.
Die Ausrichtung von Modell-Bones wird nicht gespeichert. Um den Status eines Modell-Skelettes zu speichern, verwenden Sie Entity-Skills für den Prozentsatz, den Sie an ent_animate übergeben. Entity-Skills werden automatisch gespeichert.
Partikelzustände werden nicht gespeichert. Deswegen sollten alle Partikel eine begrenzte Lebenszeit (lifespan) haben.
Die Deformation von Entities und Terrain durch vec_to_mesh wird nicht gespeichert. Wenn notwendig, kann die Deformation in einem Variablen-Array abgespeichert werden.
Um die Speicherdatei nicht unnötig aufzublähen, speichert SV_STRINGS nur geänderte Strings. Ändern Sie einen String nach game_save, wurde das nicht gespeichert und der ursprüngliche bei game_load bestehende Inhalt demnach nicht überschrieben. Ändern Sie also sämtliche Strings, die gespeichert und geladen werden sollen vor game_save; setzen Sie sie z. B. auf ihren ursprünglichen Inhalt zurück.

Beispiel

// Save everything except the var_info variables
// is doing the same as the save() instruction of older versions
result = game_save("test",7,SV_ALL-SV_INFO);
if (result <= 0) { error("Save Error!"); } 

// save var_info, strings and bitmap after"info0.sav"
// is doing the same as the save_info() instruction of older versions
game_save("info",0,SV_INFO+SV_STRINGS+SV_BMAPS);

Siehe auch:

game_load, savedir, add_struct

► Aktuelle Version Online