Bezeichnung
DisplayTextObjectFX -- lässt ein Textobjekt mit einem Übergangseffekt erscheinen
Übersicht
[handle] = DisplayTextObjectFX(id, x, y[, table])
Beschreibung
Dieser Befehl ist eine erweiterte Version des Befehls DisplayTextObject(). Sie stellt das durch id angegebene Textobjekt an der durch x/y angegebenen Position dar und benutzt dazu einen der vielen Übergangseffekte, die Hollywood besitzt. Sie müssen außerdem die Übergangsgeschwindigkeit angeben.

Wenn Ebenen aktiviert sind, fügt dieser Befehl eine neue Ebene des Typs #TEXTOBJECT dem Ebenenstapel hinzu.

Ab Hollywood 4.0 verwendet dieser Befehl eine neue Syntax mit nur einer einzigen Tabelle als optionales Argument. Die alte Syntax wird aus Kompatibilitätsgründen weiterhin unterstützt. Das optionale Tabellenargument table kann verwendet werden, um den Übergangseffekt zu konfigurieren. Folgende Optionen sind möglich:

Type:
Gibt den gewünschten Effekt für den Übergang 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 dieses Feld verwenden, um ein asynchrones Zeichnungsobjekt für diesen Übergang zu erstellen. Wenn Sie hier True angeben, wird DisplayTextObjectFX() 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.

Eingaben
id
Identifikator des darzustellenden Textobjekts
x
gewünschte X-Position für das Textobjekt
y
gewünschte Y-Position für das Textobjekt
table
optional: Einstellungen für den Übergangseffekt
Rückgabewerte
handle
optional: Handler auf ein asynchrones Zeichnungsobjekt; wird nur zurückgegeben, wenn Async auf True gesetzt wurde (siehe oben)
Beispiel
DisplayTextObjectFX(1, 0, 0, #VLINES, 10)   ; alte Syntax

oder

DisplayTextObjectFX(1, 0, 0, {Type = #VLINES, Speed = 10})  ; neue Syntax
Diese Zeile stellt Textobjekt 1 an Position 0:0 dar und benutzt zum Einblenden einen #VLINES-Effekt mit Geschwindigkeit 10.
Navigation zeigen