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 der Identifier des neuen Sprite 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 sollte ein Bildschirm mit OpenScreen() oder OpenWindowedScreen() geöffnet sein.

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()
UsePNGImageDecoder()
UseTIFFImageDecoder()
UseTGAImageDecoder()

Der 'Modus' Parameter ist optional und kann folgende Werte 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.

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

All