Bezeichnung
RemoveLayerFX -- löscht eine Ebene mit Effekt (V3.0)
Übersicht
[handle] = RemoveLayerFX(id[, table])
Beschreibung
Dieser Befehl ist eine erweiterte Version des RemoveLayer() Befehls. Er entfernt die in id angegebene Ebene oder Ebenengruppe und verwendet eine der vielen Übergangseffekte von Hollywood. Sie können auch die Geschwindigkeit für den Übergang und ein optionales Argument angeben.

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

Type
Spezifiziert den gewünschten Effekt für den Übergang. 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, desto schneller wird der Effekt gezeigt. (voreingestellt ist #NORMALSPEED)

Parameter
Einige Übergangseffekte akzeptieren einen zusätzlichen Parameter. Dieser kann hier angegeben werden. (voreingestellt 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 HideLayerFX() sofort verlassen und es wird ein Handler für das asynchrone Zeichnungsobjekt kreiert, den Sie dann mit dem Befehl AsyncDrawFrame() verwenden können. Siehe AsyncDrawFrame für weitere Informationen über asynchrone Zeichnungsobjekte.

NoBorderFade
Wenn die zu verbergende Ebene einen Rahmen hat, wird er nicht allmählich verblassen, sondern am Ende des Übergangseffekts in einem Rutsch entfernt. (V5.0)

BorderFX:
Wenn die Ebene, die entfernt werden soll, einen Rahmen hat, wendet Hollywood den Übergangseffekt nur dann auf den Rahmen an, wenn es sich um eine transparente Ebene mit Text- oder Pixelgrafiken handelt. Für nicht-transparente Ebenen und Vektorgrafikebenen wird stattdessen ein allgemeiner Überblendungseffekt verwendet, da es sonst aufgrund von Unterschieden in den Randalgorithmen zu visuellen Störungen zwischen dem vorletzten und letzten Effekteinzelbild kommen würde. Wenn Ihnen dieser Fehler egal ist und Sie Hollywood zwingen möchten, den Übergangseffekt immer auf den Rahmen anzuwenden, setzen Sie diesen Tag auf True. Um Hollywood zu zwingen, immer den generischen Überblendungsmodus zu verwenden, setzen Sie diesen Tag auf False. (V9.0)

Bevor Sie diesen Befehl verwenden können, müssen Sie zuerst die Ebenen aktivieren. Siehe Ebenen Einführung für Details.

Eingaben
id
Identifikator der Ebene oder Ebenengruppe, die gelöscht wird
table
optional: Tabelle, um den Übergangseffekt zu definieren
Rückgabewerte
handle
optional: Handler auf ein asynchrones Zeichnungsobjekt; wird nur zurückgegeben, wenn Async auf True gesetzt wurde (siehe oben)
Beispiel
RemoveLayerFX(5, #CROSSFADE)             ; alte Syntax

OR

RemoveLayerFX(5, {Type = #CROSSFADE})    ; neue Syntax
Dieser Code löscht die Ebene 5 mit einem schönen Effekt.

Navigation zeigen