-----------------------------------------------------
BlitzPlus Game Library: Vorwort
-----------------------------------------------------
Die Game Library zu BlitzPlus basiert auf der Game
Library für PureBasic.

Diese ist als Userlib in BlitzPlus einzubinden damit
man deren Funktionen benutzen kann.

Von dieser Userlib gibt es Zwei versionen. Eine für
den Debug Modus und eine für den Release Modus.

Im Release Modus gibt es keine Fehlererkennung. Bei
einen großen Fehler kann also das ganze System
abstürzen.

Der Debug Modus stopt bei Fehler. Jedoch läuft die
Game Library in diesen Modus langsamer. Die Debug
DLL sollte also nur bei der Programmierung eingesetzt
werden.


-----------------------------------------------------
BlitzPlus Game Library: Einrichten
-----------------------------------------------------
Zunächst muss der BlitzPlus Kompiler wissen welche
Funktionen in der Game Library DLL vorhanden sind.

Dazu gibt es eine Datei namens "gamelib.decls". Je
nach Release oder Debug Mode lässt sich diese Datei
in den Userlib Ordner des Game Library
verzeichnisses finden.

Diese Datei und die "gamelib.dll" müssen in den
BlitzPlus Userlib Ordner Kopiert werden. Also z.B.
nach "C:\BlitzPlus\Userlibs".


-----------------------------------------------------
BlitzPlus Game Library: Worauf man achten sollte ...
-----------------------------------------------------
Wenn man in BlitzPlus eine DLL per Userlib benutzt,
dann wird die DLL in den BlitzPlus Userlib Ordner
ausgeführt.

Will man also ein Bild mit der Game Library Laden,
dann wird versucht das Bild im Userlib Ordner zu
finden. Dies schlägt natürlich fehl, denn das Bild
ist im Projekt Ordner - so wie es auch sein soll.

Dieser Fehler tritt aber nicht auf wenn man von
seinen Projekt eine EXE Kompiliert hat und die
DLL im Projekt Ordner gesucht und ausgeführt wird.

Um diese tücke zu umgehen erstellt man im Projekt
eine Variable die den Pfad zum Projekt speichert.

So kann man eine Media Datei mit Pfadangabe sicher
Laden.


-----------------------------------------------------
BlitzPlus Game Library: FAQ
-----------------------------------------------------
' Ich habe einen Fehler gefunden und kann dazu keine
' Hilfe finden. Was tun?
Zunächst sollte noch einmal festgestellt werden das
die BlitzPlus Game Library auf die der PureBasic
Library basiert. Vieleicht Hilft ihnen da die FAQ
dessen Library weiter.

Sollten sie trotzdem keine Hilfe gefunden haben,
dann gibt es immer noch das Support Forum. Dort
können Sie von anderen oder von mir Hilfestellung
bekommen.

Sollte dies alles nicht Helfen, dann gibt es noch
die möglichkeit sich den Quellcode der Library
anzuschauen und nötenfalls nach belieben zu
ändern.

Vergessen sie aber nicht die Library dann neu als
DLL zu Kompilieren damit diese auch in z.B.
BlitzPlus ihre wirkung zeigt.


' Ich hatte versucht eine Media Datei (z.B. ein
' Bild) mit der Game Library zu Laden. Jedoch
' geschehen da merkwürdige Fehler oder es
' kommen Fehlermeldungen des Debugers.
Das liegt daran das die Game Library in einen
anderen Ordner ausgeführt wird.

Mehr dazu weiter oben in Kapitel "Worauf man
achten sollte ...".