LoadSprite()

Syntax

Ergebnis = LoadSprite(#Sprite, DateiName$ [, Modus])

Lädt das angegebene Sprite in den Speicher zur sofortigen Verwendung. Wenn #PB_Any als '#Sprite' Parameter verwendet wird, dann wird die Nummer des neuen Sprites als 'Ergebnis' zurückgegeben.

Das Sprite kann im BMP-Format (1 Bit, 4 Bit, 8 Bit, 16 Bit, 24 Bit oder 32 Bit Farbtiefe, in unkomprimierter Form [nicht RLE]) oder in jedem anderen von der ImagePlugin Library unterstützten Format vorliegen.

Vor dem Laden eines Sprites muss ein Bildschirm mit OpenScreen() oder OpenWindowedScreen() geöffnet werden.

Wenn ein Fehler auftrat, wird der Wert 0 zurückgegeben. Andernfalls wurde das Sprite erfolgreich geladen. Ein geladenes Sprite kann mit dem FreeSprite() Befehl freigegeben werden.

Die folgenden Befehle können zum automatischen Aktivieren weiterer Bildformate verwendet werden:

UseJPEGImageDecoder()
UseJPEG2000ImageDecoder()
UsePNGImageDecoder()
UseTIFFImageDecoder()
UseTGAImageDecoder()

Der 'Modus' Parameter ist optional und kann folgende Werte (auch verknüpft mit dem '|' Operator) annehmen:

  0                        : Normaler Modus, das Sprite befindet sich im Video-Speicher (wenn möglich)
  #PB_Sprite_Memory        : das Sprite wird in den PC-Hauptspeicher geladen (für SpecialFX)
  #PB_Sprite_Alpha         : das Sprite ist in 8 Bit, grau und wird mit DisplayAlphaSprite() oder
                             DisplayShadowSprite() benutzt
  #PB_Sprite_Texture       : das Sprite wird mit 3D Unterstützung erstellt, nützlich für den CreateSprite3D()
                             Befehl der Sprite3D Library.
  #PB_Sprite_AlphaBlending : das Sprite wird mit per Pixel Alpha-Kanal Unterstützung erstellt, das Bildformat
                             muss dies unterstützen (derzeit nur PNG und TIFF). #PB_Sprite_Texture muss ebenso
                             angegeben werden und das Sprite muss mittels DisplaySprite3D() angezeigt werden.

Hinweis: Sprites sollten nicht größer als der verwendete Bildschirmmodus sein. Das Verwenden größerer Sprites kann auf mancher Hardware funktionieren, auf anderer nicht. Besser ist das Aufsplitten des großen Sprites in mehrere kleine.

Bei der Verwendung des 8 Bit-Bildschirmmodus (256 Farben, mit Farbpalette), werden nur 8 Bit-BMPs als Spriteformat akzeptiert. Die ImagePlugins oder andere BMP-Farbformate werden nicht unterstützt.

Unterstützte OS

Alle