[handle] = ShowLayerFX(id[, table])

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. Die optionale Tabelle kann den Übergangseffekt konfigurieren. Folgende Optionen sind möglich:

Type

Stellt den gewünschten Übergangseffekt ein. Siehe DisplayTransitionFX für eine Liste von allen unterstützten Transition-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 dieses Feld verwenden, um ein asynchrones Zeichnungsobjekt für diesen Übergang zu erstellen. Wenn Sie hier True angeben, wird ShowLayerFX() 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.

NoBorderFade

Wenn die Ebene, welche gezeigt wird, einen Rahmen hat, wird er nicht allmählich erscheinen, sondern am Ende des Übergangseffekts in einem Rutsch angezeigt. (V5.0)

BorderFX:

Wenn die anzuzeigende Ebene einen Rahmen hat, wendet Hollywood den Übergangseffekt nur dann auf den Rahmen an, wenn es sich bei der Ebene um eine transparente Ebene mit Text- oder Pixelgrafiken handelt. Für nicht-transparente und Vektorgrafikebenen wird stattdessen ein allgemeiner Überblendungseffekt verwendet, da es sonst aufgrund von Unterschieden in den Rahmenalgorithmen 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 Einführung in die Ebenentechnik für Details.

id

Identifikator der Ebene oder Ebenengruppe, die gezeigt werden soll

table

optional: Tabelle, welche den Übergangseffekt angibt

handle

optional: Handler auf ein asynchrones Zeichnungsobjekt; wird nur zurückgegeben, wenn Async auf True gesetzt wurde (siehe oben)

ShowLayerFX(5, #CROSSFADE)              ; alte Syntax

OR

ShowLayerFX(5, {Type = #CROSSFADE})     ; neue Syntax