Publish

Der Publish-Prozess generiert im Work-Directory einen .CD-Ordner und kopiert dort alle fürs Spiel benötigten Dateien hinein. Der Inhalt des .CD-Ordners kann zum Vertrieb auf CD-ROM gebrannt oder auf eine Webseite gestellt werden. In der Gratisversion stehen keine Optionen zur Verfügung, - klicken Sie zum Starten des Publish-Prozesses einfach auf [Ok]. Ansonsten haben Sie folgende Optionen:

Resource	P Eine .WRS-Resource-Datei wird erstellt. Sie enthält alle fürs Spiel gebrauchten Dateien in komprimierter und verschlüsselter Form. Beachten Sie, dass einige Dateitypen wie DLL-Plugins oder Movie-Dateien nicht in einer Resource enthalten sein können sondern physikalisch im .CD-Ordner vorhanden sein müssen.
Starter	P Generiert eine sogenannte window definition file (acknex.wdf) fürs gegenwärtige Skript. Diese Datei bestimmt das Startverhalten der Anwendung: Anzeigen eines Logos, Setzen von Kommandozeilenoptionen, Darstellen von Kompilermeldungen usw. Wurde in der Fenster-Definition ein Syntaxfehler gefunden oder eine dazugehörende Bilddatei nicht gefunden oder ist im falschen Format, wird einer ERRNO-Fehlermeldung ausgegeben und die Datei acknex.wdf wird nicht erstellt.
Level Editor	P Generiert im .CD-Ordner einen zum Weitervertrieb geeigneten Leveleditor, WEDS.EXE (nur wenn eine Recource erstellt wird). WEDS ist eine abgespeckte Version von WED und kann vom Spieleanwender zum Erstellen eigener Level für sein Spiel benutzt werden. Zu diesem Zweck sollten auch die zu den Spieleleveln gehörigen WMP- und WAD-Dateien auf der für den Endverbraucher bestimmten CD-ROM zur Verfügung stehen. WEDS verwendet alle Entities und Aktionen, die sich in der Resource-Datei befinden. Damit Entities im Editor sichtbar sind, müssen sie im selben Ordner wie die Resource-Datei existent sein. Die Level-Skriptdatei lässt sich nicht verändern - sie ist immer die Haupt-Skriptdatei des Spiels. WAD-Dateien können extern geladen, nicht aber editiert werden.
Compile EXE	E Startet die Engine und kompiliert den lite-C-Source-Code in eine ausführbare Datei, die dann in den .CD-Unterordner kopiert wird (nicht in den kostenlosen oder Team-Editionen). Ansonsten wird der Quellcode direkt in den .CD-Unterordner kopiert und erst beim Starten der gepublishten ausführbaren Datei kompiliert.
Engine	Generiert die EXE-Datei (scriptname.exe) sowie die zum Weitervertrieb geeignete Engine-DLL (acknex.dll) zum Starten des Spiels. Ist [Compile EXE] nicht aktiviert, kann der Pfad zu einer EXE-Datei hier angegeben werden (default: acknex.exe). Wird die Engine-DLL von einer externen Anwendung aufgerufen, geben Sie hier den Pfad zur ausführbaren Datei an. Wird das Pfad-Feld leer gelassen, werden weder EXE, noch Engine-DLL generiert. Beachten Sie, dass die Engine-DLL an die EXE-Datei gebunden ist - sie wird kein anderes Spiel, noch ein nachträglich verändertes Skript starten. Anstelle der voreingestellten acknex.exe kann eine andere EXE-Datei benutzt werden. Die Test-, Lite- oder Team-Editionen generieren keine EXE-und DLL-Datei im .CD-Ordner.

EXE-Dateien und Icons:

Die EXE wird nach dem Skript benannt. Der Name darf weder Leerschritte noch exotische Zeichen mit Ausnahme von '-' oder '_' enthalten.
Das Publishen von Projekten im Legacy-Modus oder von C-Skript (.wdl)-Projekten wird nur von E oder höher unterstützt, nicht aber von der Gratisversion.
Die EXE-Datei enthält ein Manifest, das mit dem Windows-Standard für Microsoft-Games kompatibel ist.
Um eine EXE-Datei mit einem individuellen Icon zu verwenden, erstellen Sie in Ihrem Gamestudio-Ordner eine Kopie der Engine acknex.exe, ändern das Icon der Kopie mit einem Icon-Managerprogbramm und geben den Pfad der geänderten EXE im Engine-Feld an (oder Sie kopieren es einfach zurück in acknex.exe). Die ausführbare Datei wird dann aus Ihrer Kopie mit dem geänderten Icon erstellt anstatt aus der Originalengine. Das Icon aus der EXE wird auch für die Aufgabenleiste verwendet. Beachten Sie bitte, dass ein nachträgliches Ändern des Icons einer gepublishten EXE nicht mehr möglich ist.
P Wird eine Icon-Datei namens "32.ico" (Größe 32x32) oder "16.ico" (Größe 16x16) im Work-Ordner gefunden, wird diese automatisch anstelle des Icons aus der EXE geladen und für die Taskleiste benutzt. Alternativ können Sie zum Patchen der EXE mit Ihrem eigenen Icon auch das Plugin SED-ChangeExeIcon
Zum Erstellen eines Screen-Savers, benennen Sie die gepublishte .EXE in .SCR um. Starten Sie es aus dem Windows-Ordner, sorgen Sie dafür, dass PLUGINDIR auf einen anderen Pfad gesetzt ist. Per default scannt die gepublishte Engine im gegenwärtigen Ordner nach PlugIn. Enthält dieser, wie der Windows-Ordner viele DLLs, führt dies zu Problemen.
Der Quellcode für acknex.exe steht im Engine-SDK unter einer Open-Source-Lizenz zur Verfügung. Sie können Ihre eigene EXE-Dateie programmieren, solange Sie eine maschinenlesbare Kopie des kompletten Sourcecodes mit dem Produkt zusammen zur Verfügung stellen. P Besitzen Sie die Pro-Edition oder eine SDK-Lizenz, brauchen Sie den Quellcode nicht zur Verfügung zu stellen.

Projektdateien

Zum Generieren des .CD-Unterordners darf der Work-Ordner nicht schreibgeschützt sein. Erstellen Sie also keine Projekte direkt im Gamestudio-Installationsordner - der ist ab Windows Vista normalerweise nur für Administratoren überschreibbar - sondern im Dokument-Ordner Ihres PCs.
Um festzustellen, welche Dateien zum Projekt gehören, überprüft der Publishprozess die Level, Skripte und sämtliche weiteren WMP-Datein, die im LEVEL-Statement angegeben sind. Alle Dateinamen, die im Skript in Anführungszeichen ("") oder spitzen Klammern (<>) angegeben sind, sowie sämtliche Entity- und Sound-Dateien der Level werden in den .CD-Ordner oder in die Recource aufgenommen. Hierzu dürfen die Dateinamen nicht länger als 32 Zeichen sein und keine Sonderzeichen außer '-', '+', '_' enthalten. Zum Aufnehmen einer zusätzlichen Datei benutzen Sie die BIND-Anweisung.
Um zu verhindern, dass eine bestimmte Datei automatisch eingebunden wird, lassen Sie deren Namen mit einem Unterstrich "_" beginnen (z. B. "_not_me.avi"). Existiert keine Datei dieses Namens, öffnet die Engine die Datei desselben Namens ohne Unterstrich ("not_me.avi"), die Datei wird jedoch nicht gepublished oder den Ressourcen hinzugefügt.
Um alle Dateien mit einer bestimmten Erweiterung aus der Ressource oder vom Publishen überhaupt auszuschliesen, verwenden Sie die Statemens EXCLUDE_RESOURCE oder EXCLUDE_PUBLISH. Diese finden Sie in der Konfigurationsdatei data/options.scr. Dateien mit der Erweiterung AVI, MPG, MOV und DLL werden per Voreinstellung nicht in eine Ressource-Datei aufgenommen und Dateien mit der Erweiterung C, H oder TMP überhaupt nicht gepublished.
Normalerweise überschreiben externe Dateien die Dateien, die in einer Ressource enthalten sind. Um zu verhindern, daß in der Release-Version Entities und Level aus externen Dateien geladen werden, setzen Sie preload_mode auf 16 oder höher. Dies erhöht die Sicherheit von Online-Games.
Die Dateien werden in der Reihenfolge der PATH-Anweisungen gesucht. Unterverzeichnisse im .CD Ordner werden nicht erzeugt.
Gepublishte Projekte sind auf 40 .WDL-Dateien beschränkt. Brauchen Sie mehr als 40, kombinieren Sie diverse Dateien zu einer zusammen. Diese Einschränkung gilt nicht für .c-Dateien oder beim Erstellen einer Quelldatei.
Vergewissern Sie sich, dass Sie in das publizierte Projekt alle benötigten Plugins aus dem Ordner acknex_plugins oder dem Work-Ordner eingefügt haben. Zum Unterstützen älterer DirectX9-Versionen auf den Zielrechnern, stellen Sie entweder ein DirextX-SetUp mit Ihrem Installationsprogram zur Verfügung oder Sie includen d3dx9_42.dll und - sofern nicht-vorkompilierte Shaders verwendet werden - auch d3dcompiler_42.dll. Beide Dateien finden sich im Gamestudio-Ordner. Falls Sie die A8-Physik benutzen, binden sie ausserdem noch ackphysX.dll, PhysXLoader.dll, PhysXCooking.dll und NxCharacter.dll ein.
EXE- und DLL-Datei der Engine werden nur erzeugt, wenn beim Publish-Prozess keine Fehler auftreten. Fehler werden im Publish-Fenster angezeigt (z.B. fehlende Dateien).

WRS-Resourcen

WRS ist ein "Behälter" für alle Arten von Dateien, die zu einem Projekt gehören. Sie werden in einem komprimierten und verschlüsselten Format, das von sämtlichen Gamestudioversionen gelesen werden kann, gespeichert. Generiert werden können sie jedoch nur von der Pro-Edition P.
Beim Enginestart werden sämtliche im Work-Ordner gefundenen WRS-Ressourcen automatisch geöffnet und die darin enthaltenen Dateien stehen dem Projekt zur Verfügung.
Manche Dateien müssen dem Betriebssystem zur Verfügung stehen und können daher nicht direkt aus einer Ressource heraus geöffnet werden. Beispiele sind DLL-Dateien, die Windows benötigt, oder Media-Dateien, die dem Media-Player über die Funktion media_play verfügbar sein müssen. Solche Dateien können zwar immer noch in eine WRS-Ressource gepackt werden, müssen aber zuvor in *.pak umbenannt werden und bei Projektstart über den Befehl file_cpy in den Work-Ordner entpackt werden.
P Zum manuellen Erstellen einer WRS-Quelldatei mit beliebigem Inhalt erstellen Sie eine WDL-Datei, die für sämtliche Dateien, die Sie aufnehmen möchten, BIND-Anweisungen enthält. Publishen Sie diese WDL-Datei direkt mit SED oder per Kommandozeilenoption (beispielsweise wed -r mybind.wdl). Markieren Sie im Publish-Dialog Resource. Die generierte WRS-Datei findet sich dann im .CD-Ordner.

Auslieferung

Wenn alle notwendigen Projekt-Dateien, Ressourcen und DLLs enthalten sind, laufen Gamestudio Anwendungen direkt aus ihrem Ordner und erfordern in der Regel kein Installationsprogramm. Wenn ein Engine-Fenster geöffnet wird (video_screen > 0), ist DirectX 9.0c auf dem Ziel-PC erforderlich. Dies sollte bei allen n ach 2006 hergestellten PCs der Fall sein; wenn Sie ältere Systeme unterstützen wollen, könnte es sinnvoll sein, einen aktuellen DirectX-9-Installer mitzuliefrn. Bei der Verwendung von Physik muss die PhysX System Software auf dem Zielsystem installiert werden; Sie finden Details im PhysX Kapitel. Bei der Verwendung von OpenAL muss die OpenAL Library auf dem Zielsystem installiert werden.

► Aktuelle Version Online