Bezeichnung
DisplayTransitionFX -- ändert das Hintergrundbild mit einem Übergangseffekt
Übersicht
[handle] = DisplayTransitionFX(id[, table])
Beschreibung
Dieser Befehl stellt ein neues Hintergrundbild mit einem Übergangseffekt dar. Eine Liste aller verfügbaren Effekte ist weiter unten. Sie müssen auch die Geschwindigkeit des Übergangs angeben, die entweder eine der speziellen Geschwindigkeitskonstanten sein kann (#SLOWSPEED, #NORMALSPEED, #FASTSPEED) oder eine benutzerdefinierte Feinabstimmung mit numerischem Wert. Als Faustregel für den Geschwindigkeitsparameter: Je höher der Wert, desto schneller läuft der Übergang.

Für die beste Wirkung sollte das neue Hintergrundbild die gleichen Abmessungen haben wie das alte. Ist dies nicht der Fall ist, wird das alte Hintergrundbild auf die Größe des neuen skaliert werden.

Beachten Sie, dass transparente BGPics nicht mit einen Übergangseffekt angezeigt werden können. Es ist auch nicht möglich, ein BGPic ohne Transparenz mit einem Übergangseffekt anzuzeigen, wenn das aktuelle BGPic eine Transparenz besitzt. Damit dieser Befehl funktioniert, dürfen das aktuelle und das neue BGPic nicht transparent sein.

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. Beachten Sie die Liste unten mit den möglichen Effekten. (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 für diesen Übergang ein asynchrones Zeichnungsobjekt 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.

X:
Zielposition des neuen Hintergrundbildes in x-Richtung. Wenn das Display seine aktuelle x-Position beibehalten soll, geben Sie die spezielle Konstante #KEEPPOSITION an. Der Standardwert ist #CENTER.

Y:
Zielposition des neuen Hintergrundbildes in y-Richtung. Wenn das Display seine aktuelle y-Position beibehalten soll, geben Sie die spezielle Konstante #KEEPPOSITION an. Der Standardwert ist #CENTER.

Folgende Effekte sind derzeit verfügbar:

Ab Hollywood 1.5 kamen neue Effekte dazu:

Hollywood 1.9 bringt folgende neue Effekte mit:

Wenn Sie #RANDOMEFFECT wählen, sucht sich Hollywood zufällig irgendeinen Effekt aus allen möglichen aus. Sehr nützlich, wenn Sie eine Diashow darstellen. Wenn Sie #RANDOMEFFECT in der 68k-Version aufrufen, wird Hollywood keinen der High-End Effekte auswählen, um Ihr Skript nicht lahmzulegen.

Legende:

(B):
Effekt kann nur mit Hintergrundbildern verwendet werden.

(O):
Effekt kann nur mit Objekten verwendet werden (Pinsel, Ebenen usw., aber nicht mit Hintergrundbilder).

(T):
Effekt kann nur mit Textobjekten benutzt werden.

(!):
High-End-Effekt und das bedeutet, dass er sehr viel Rechenleistung benötigt, um reibungslos abzulaufen. Sie können ihn auf 68k laufen lassen, aber es ist kein Spaß, weil er etwa 4 Minuten oder so für den Übergang braucht. Sie sollten "!" nur mit schnellen Rechnern verwenden.

Eingaben
id
Identifikator des darzustellenden Hintergrundbildes
table
optional: Konfiguration des Übergangseffektes
Rückgabewerte
handle
optional: Handler auf ein asynchrones Zeichnungsobjekt; wird nur zurückgegeben, wenn Async auf True gesetzt wurde (siehe oben)
Beispiel
DisplayTransitionFX(2, #HSTRIPES32, 10)   ; alte Syntax

ODER

DisplayTransitionFX(2, {Type = #HSTRIPES32, Speed = 10})  ; neue Syntax
Stellt Hintergrundbild 2 mit dem #HSTRIPES32 Effekt bei einer Geschwindigkeit von 10 dar.

Navigation zeigen