Bezeichnung
DisplayBrushFX -- zeigt einen Pinsel mit einem Übergangseffekt an
Übersicht
[handle] = DisplayBrushFX(id, x, y[, table])
Beschreibung
Dieser Befehl ist eine erweiterte Version des DisplayBrush() Befehls. Sie zeigt den durch id angegebenen Pinsel an der durch x/y angegebenen Position an und benutzt dazu einen der vielen Übergangseffekte, die Hollywood besitzt (angegeben in Type). Sie müssen ebenfalls die Übergangsgeschwindigkeit angeben.

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

Ab Hollywood 4.0 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. (Standardeinstellung ist #RANDOMPARAMETER)

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 asynchronen 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.

Siehe auch DisplayBrush(), DisplayBrushPart() und MoveBrush().

Eingaben
id
ID des Pinsels
x
x-Koordinaten des Pinsels
y
y-Koordinaten des Pinsels
table
optional: Konfigurationen 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
DisplayBrushFX(1, 0, 0, #VLINES, 10)   ; alte Syntax

OR

DisplayBrushFX(1, 0, 0, {Type = #VLINES, Speed = 10})  ; neue Syntax
Der obige Code zeigt den Pinsel 1 bei 0:0 mit einem #VLINES Übergang mit der Geschwindigkeit 10 an.
Navigation zeigen