InitEngine3D()
Syntax
Ergebnis = InitEngine3D([Flags [, LibraryName$])Beschreibung
Initialisiert die 3D-Umgebung zur späteren Benutzung. Sie müssen diesen Befehl zu Beginn Ihres Sourcecodes aufrufen, wenn Sie irgendeinen der 3D-Befehle verwenden möchten.
Parameter
Flags (optional) Dies kann eine Kombination der folgenden Werte sein: #PB_Engine3D_NoLog : Es wird kein Protokoll (Log) auf Disk oder in die Konsolenausgabe geschrieben (Standard). #PB_Engine3D_DebugLog : Eine Debug-Protokolldatei names 'Ogre.log' wird im aktuellen Verzeichnis erstellt, um beim Debuggen oder bei Anwender-Reports zu helfen. Eine Menge an Aktionen werden in dieser Datei festgehalten, was aber die Performance nicht beeinträchtigen sollte, weshalb es sogar bei einem fertigen (Release-) Produkt aktiviert bleiben kann. #PB_Engine3D_DebugOutput: Die Aktionen werden in der Konsole ausgegeben. Sie müssen hier daran denken, das Executable-Format auf 'Console' zu setzen, wenn Sie Ihr Excecutable kompilieren.LibraryName$ (optional) Name der Engine3D-Datei, welche geladen werden soll. Wenn diese an einer anderen Stelle als im aktuellen Verzeichnis gespeichert wurde, kann dies hier angegeben werden.
Rückgabewert
Gibt einen Wert ungleich Null, wenn die Bibliothek erfolgreich geladen wurde, andernfalls Null. Wenn die Initialisierung fehlgeschlagen ist, sollte das Programm beendet oder der Aufruf aller 3D-Funktionen deaktiviert werden.
Anmerkungen
InitEngine3D() versucht, die Engine3D-Bibliothek (namens 'Engine3D.dll' auf Windows, 'engine3d.so' auf Linux und 'engine3d.dylib' auf OS X, zu finden im PureBasic/Compilers/ Verzeichnis) zu laden. Wenn dies fehlschlägt, dann liegt dies möglicherweise daran, dass die Bibliothek nicht gefunden wurde oder nicht mit aktuellen PureBasic-Version zusammenpasst.
Auf Windows muss eine aktuelle Version der OpenGL-Treiber installiert sein.
Siehe auch
OpenScreen(), OpenWindowedScreen(), Add3DArchive()
Unterstützte OS
Alle