Bezeichnung
DisplayBGPicPartFX -- stellt einen Teil eines Hintergrundbildes mit einem Effekt dar
Übersicht
[handle] = DisplayBGPicPartFX(id, x, y, width, height[, table])
Beschreibung
Dies ist eine erweiterte Version des Befehls DisplayBGPicPart(). Er tut das gleiche, allerdings mit einem zusätzlichen Übergangseffekt.

Wenn Ebenen aktiviert sind, wird dieser Befehl eine neue Ebene des Typs #BGPICPART dem Ebenenstapel hinzuzufügen.

Ab Hollywood 4.5 verwendet dieser Befehl eine neue Syntax. Die alte Syntax wird aus Kompatibilitätsgründen weiterhin unterstützt. Das optionale Tabellenargument kann den Übergangseffekt konfigurieren. Folgende Optionen sind möglich:

Type:
Hier geben Sie den gewünschten Übergangseffekt an. Siehe DisplayTransitionFX für eine Liste aller unterstützten Übergangseffekte. (Voreingestellt ist #RANDOMEFFECT)

Speed:
Legt die gewünschte Geschwindigkeit für den Übergang fest. Je höher der Wert, den Sie hier angeben, desto schneller wird der Effekt angezeigt werden. (Standardeinstellung ist #NORMALSPEED)

Parameter:
Einige Übergangseffekte akzeptieren einen zusätzlichen Parameter, der hier angegeben werden kann. (Standardeinstellung ist #RANDOMPARAMETER)

Async:
Sie können diesen Tag verwenden, um ein asynchrones Zeichnungsobjekt für diesen Übergang zu erstellen. Wenn Sie hier True angeben, wird DisplayBGPicPartFX() sofort verlassen und es wird ein Handler für das asynchrone Zeichnungsobjekt kreiert, den Sie dann mit dem Befehl AsyncDrawFrame() verwenden können. Ein Beispielskript finden Sie unter dem Befehl AsyncDrawFrame(). Siehe AsyncDrawFrame für weitere Informationen über asynchrone Zeichnungsobjekte.

DX:
Zielposition des Ausschnitts in x-Richtung. (voreingestellt ist x als Parameter 2)

DY:
Zielposition des Ausschnitts in y-Richtung. (voreingestellt ist y als Parameter 3)

Layers:
Bei True werden die Ebenen des Hintergrundbildes auch angezeigt (erfordert aktivierte Ebenen). (Standardeinstellung False)

Eingaben
id
ID des Quellhintergrundbildes
x
linke Ecke
y
obere Ecke
width
Breite des Ausschnittes
height
Höhe des Ausschnittes
table
optional: Konfiguration der Übergangseffekte
Rückgabewerte
handle
optional: Handler auf ein asynchrones Zeichnungsobjekt; wird nur zurückgegeben, wenn Async auf True gesetzt wurde (siehe oben)
Beispiel
DisplayBGPicPartFX(2, 0, 0, 100, 100, #HSTRIPES32, 10)   ; alte Syntax

ODER

DisplayBGPicPartFX(2, 0, 0, 100, 100, {Type = #HSTRIPES32,
     Speed = 10})  ; neue Syntax
Zeigt die ersten 100 Pixel und Zeilen aus dem Hintergrundbild 2 auf dem Bildschirm mit dem Übergangseffekt #HSTRIPES32 bei der Geschwindigkeit 10.

Navigation zeigen