Hilfe

LoadImage3D

B3D

Aufruf

HANDLE = LoadImage3D (file$ [, mode] [, blend] [, pivot])

Parameter

file$ Name der Grafikdatei
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 der geladenen Textur


Beschreibung

Dieser Befehl lädt eine Textur und gibt ihr Draw3D - Internes Handle zurück, welches später für DrawImage3D etc. benötigt wird. Die Textur muss dabei als quadratische Grafik mit einer Zweierpotenz als Seitenlänge (wie 128, 256, 512 etc.) vorliegen.

Mit ''mode'' wird der Zeichenmodus bestimmt, auf welche Art die Textur geladen werden soll. Bei ''mode = 1'' wird die Textur so eingezeichnet wie sie als Bild vorliegt. Das heißt aber auch, dass keine zusätzliche Transparenz über ColorG3D 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 dennoch mit ColorG3D einfärbbar 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 der Textur verwendet wird. Ist er auf ''pivot = 0'' gesetzt, so wird die Textur stets direkt vor der Kamera gezeichnet. Ist er jedoch auf ''pivot = 1'' gesetzt, so bewegt sich die Textur 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.

Ich empfehle stets das laden von quadratischen Texturen mit einer 2^n Kantenlänge.


Beispiel

Standardbeispiel:

Siehe dazu ''Draw3D, DrawImage3D.bb''

Übersicht Draw3D Grafik