Hilfe

LoadSprite

B3D

Aufruf

Sprite = LoadSprite (Datei [,Modus] [,Parent])

Parameter

Datei Dateiname einer Grafikdatei (bmp, jpg, png)
Modus Optionale Textur-Einstellungen:
+1=Color
+2=Alpha
+4=Masked
+8=Mipmapped
+16=Clamp U
+32=Clamp V
+64=Spherical Reflection Map
+128=Cubic Environment Mapping
+256=Speichert Textur in VRAM
+512=HighColor-Textur
Parent Identität des Objekts zu dem es hinzugefügt werden soll


Rückgabewert

Es wird die Identität des Sprites zurückgeliefert. Wenn eine Null zurückgeliefert wird, dann konnte die Grafikdatei nicht geladen werden.


Beschreibung

Der Befehl LoadSpirte erstellt ein Sprite, lädt danach eine Textur und texturiert das Objekt.
Ein Sprite ist nichts anderes als ein Objekt, welches aus nur 2 Dreiecken (triangles) besteht. Über diese Dreiecke wird eine Textur gezogen. Solche Objekte können sehr schnell gerendert werden - z.B. für Partikeleffekte.
Der Parameter "Datei" ist der Pfad zu einer Grafikdatei, die die Textur enthält.
Der optionale Parameter "Modus" stellt Textureffekte ein. Mehrere Effekte können kombiniert werden, indem die Zahlen addiert werden.
Hier kurze Beschreibung:
[1] Color Map = Die Textur wird so eingezeichnet wie man die sieht
[2] Alpha Map = Die Textur benutzt Alpha Map für Transparenz. Wenn Alpha Map nicht vorhanden ist, dann erscheinen dunkle Stellen transparenter.
[4] Masked = Schwarze Flächen werden nicht eingezeichnet.
[8] Mipmapped = für weite Entfernungen wird eine Textur mit weniger Details benutzt.
[16] Clamp U = Textur-Koordinate U wird fixiert.
[32] Clamp V = Textur-Koordinate V wird fixiert.
[64] Spherical Reflection Map = Reflektionseffekt
[128] Cubic Environment Mapping = Echtzeitreflektion
[256] Speichert Textur in VRAM = schneller
[512] Erstellt HighColor-Textur. So kann die Textur auch bei 16-Bit Farbtiefe weiterhin Alpha-Informationen enthalten.
Wurde der Parameter "Parent" angegeben, dann wird Sprite zu einem Objekt hinzugefügt. Falls nun ein Parent-Objekt bewegt wird, dann werden alle hinzugefügten Objekte automatisch verschoben. Ein Child-Objekt verschiebt dagegen kein Parent-Objekt mit.
Das geladene Gitterobjekt wird normalerweise an der Position 0,0,0 erstellt. Wurde Parent angegeben, dann wird es an der Position des Parent-Objekts erstellt.


Zusatzinformation

Warnung: Die Grafikkarte kann nur Texturen mit folgender Breite/Höhe verarbeiten: 1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024. Wenn ein Bild eine andere Größe hat, dann wird es von BlitzBasic automatisch gestreckt. Dies bedeutet dann:
-Geschwindigkeitsverlust
-Unnötiger Speicherverbrauch
-Qualitätsverlust


Beispiel

Standardbeispiel:

Graphics3D 640, 480, 16, 2
SetBuffer BackBuffer()
camera = CreateCamera()

sprite = LoadSprite("bild.bmp")
PositionEntity sprite, 0, 0, 5

While Not KeyHit(1)
   RenderWorld
   Flip
Wend
End


Siehe auch

CreateSprite, HandleSprite, RotateSprite, ScaleSprite, SpriteViewMode

Übersicht 3D Grafik Sprite