Aufruf


Parameter

file$	Name der Grafikdatei/Texturfont
mode	Zum auswählen des Zeichenmodus (Standard = 2) 1 - Color Map, die Textur wird so eingezeichnet wie man die sieht. 2 - Alpha Map, die Textur benutzt Alpha Map für Transparenz. 3 - Set Alpha, der komplette Aplhachannel wird auf 1 gesetzt. 4 - Masked, schwarze Flächen werden nicht eingezeichnet.
blend	Zum einstellen des Blendmodus (Standard = 2) 1 - eine Textur 2 - Multitextur 3 - addierte Multitextur 4 - Dot 3 Mapping 5 - Multiply Blend
pivot	Pivotauswahl (Standard = 0) 0 - Vordergrundpivot (HUD) 1 - Hintergrundpivot (World)

Rückgabewert

HANDLE = Identität des geladenen Texturfonts

Beschreibung

Dieser Befehl lädt ein Bitmapfont und gibt ihr Draw3D - Internes Handle zurück, welches später für Text3D und DrawMouse3D benötigt wird. Das Font muss dabei als quadratische Grafik mit einer Zweierpotenz als Seitenlänge (wie 128, 256, 512 etc.) vorliegen, welches nach Möglichkeit alle 224 Zeichen (nach ISO/IEC 8859-1 und Windows-1252) einer Schriftart enthält.

''mode'' Zeichenmodus bestimmt, auf welche Art die Textur geladen werden soll. Bei ''mode = 1'' wird die Textur so eingezeichnet wie sie als Bild vorliegt. Das heisst aber auch, dass keine zusätzliche Transparanz über ColorT3D zugewiesen werden kann (dafür Mode 3 nutzen). Bei ''mode = 2'' wird die Alphamap der Textur benutzt. Ist keine vorhanden, so wird anstatt die Colourmap für Alpha verwendet (dunklere Stellen erscheinen dabei transparenter). Bei ''mode = 3'' wird der Textur automatisch ein Vollalpha zugewiesen. Das ist dann Sinnvoll, wenn die Textur kein eigenes Alpha gespeichert hat, aber die Textur denoch mit ColorT3D einfärbar und transparent machbar sein soll. Bei (mode = 4) werden der Textur schwarze Stellen komplett maskiert (transparent) angezeigt.

''blend'' legt fest, wie die Textur auf der internen Surface behandelt werden soll. Bei ''blend = 1'' wird nur eine Textur benutzt. Bei ''blend = 2'' kann Multitexturing benutzt werden. Bei ''blend = 3'' wird addiertes Multitexturing verwendet. Bei ''blend = 4'' wird Dot3 - Mapping eingeschaltet. Bei ''blend = 5'' wird multipliziertes Multitexturing verwendet. Für genauere Informationen dazu sollte man sich die Blitz - Befehle CreateTexture und TextureBlend anschauen.

''pivot'' gibt vor, welcher Pivot zur Positionierung des Textes verwendet wird, wenn Text3D mit dieser Schriftart aufgerufen wird. Ist er auf ''pivot = 0'' gesetzt, so wird der Text stets direkt vor der Kamera gezeichnet. Ist er jedoch auf ''pivot = 1'' gesetzt, so bewegt sich der Text nicht mit der Kamera mit und 'schwebt' in der Landschaft, wenn sich die Kamera bewegt. Für normale Anwendungen kann man Mode, Blend und meist auch Pivot ignorieren.

Beispiel

Standardbeispiel: