Bezeichnung
LoadAnimFrame -- lädt ein Animationseinzelbild als Pinsel (V1.5)
Übersicht
LoadAnimFrame(id, frame, anim$[, table])
Beschreibung
Dieser Befehl lädt ein einziges Animationseinzelbild (Frame) als Pinsel und weist ihm den Identifikator id zu. Die Animationsdatei wird durch die Zeichenfolge anim$ angegeben. Das Argument frame legt fest, welches Einzelbild geladen wird. Wenn Sie das letzte Bild laden möchten, setzen Sie frame auf -1.

Das vierte Argument table ist optional. Es ist eine Tabelle, die weitere Möglichkeiten für den Ladevorgang bereit hält. Die folgenden Tags können verwendet werden:

Transparency:
Mit diesem Tag können Sie eine Farbe in der RGB-Notation angeben, die in der Animation transparent werden soll.

LoadAlpha:
Setzen Sie diesen Tag auf True, wenn der Alphakanal der Animation auch geladen werden soll. Bitte beachten Sie, dass die meisten Animformate keine Alphakanäle unterstützen. Daher ist es ratsam, dass Sie die Animation manuell aus einem PNG-Bild mit CreateAnim() erstellen, wenn Sie einen Alphakanal in Ihrer Animation haben müssen. Dieser Tag ist standardmäßig auf False gesetzt. (V4.5)

Loader:
Mit diesem Tag können Sie ein oder mehrere Formatlademodule angeben, die diese Animation laden sollen. Dies muss als eine Zeichenfolge festgelegt werden, die den/die Namen eines oder mehreren Lademodulen enthält. Standardmäßig wird der mit SetDefaultLoader() eingestellte Lader verwendet. Siehe Lade- und Adaptermodule für Details. (V6.0)

Adapter:
Mit diesem Tag können Sie ein oder mehrere Dateiadapter angeben, die die angegebene Datei öffnen sollen. Dies muss als eine Zeichenfolge festgelegt werden, die den/die Namen eines oder mehreren Adaptermodulen enthält. Standardmäßig wird der mit SetDefaultAdapter() eingestellte Adapter verwendet. Siehe Lade- und Adaptermodule für Details. (V6.0)

LoadTransparency:
Ist dieser Tag auf True gesetzt, wird die monochrome Transparenz der Animation geladen. Bitte beachten Sie, dass dieser Tag speziell für monochrome Transparenzkanäle ausgelegt ist, die einen transparenten Stift in einer palettenbasierten Animation haben. Wenn Sie den Alphakanal einer Animation laden möchten, stellen Sie den Tag LoadAlpha auf True. Dieser LoadTransparency-Tag ist standardmäßig auf False gesetzt. (V6.0)

UserTags:
Dieser Tag kann verwendet werden, um zusätzliche Daten anzugeben, die an Lader und Adapter übergeben werden sollen. Wenn Sie diesen Tag verwenden, müssen Sie ihn auf eine Tabelle mit Schlüssel-Wert-Paaren setzen, die die zusätzlichen Daten enthalten, die an Plugins übergeben werden sollen. Siehe Benutzer-Tags für Details. (V10.0)

Bitte beachten Sie, dass die Tags Transparency, LoadTransparency und LoadAlpha sich gegenseitig ausschließen. Eine Animation kann nicht eine Maske und einen Alphakanal haben!

Siehe LoadAnim für eine Liste der unterstützten Animationsformate.

Eingaben
id
ID des Pinsels, der mit diesem Befehl erstellt wird
frame
das zu ladende Einzelbild (Bereich geht von 1 bis Anzahl Einzelbilder); geben Sie -1 an, wenn Sie das letzte Einzelbild laden möchten
animid
ID der Animation
table
optional: weitere Optionen (siehe oben) (V5.1)
Beispiel
LoadAnimFrame(1, 5, "Animations/HugeAnim.gif")
DisplayBrushFX(1, #CENTER, #CENTER, #CROSSFADE)
Der obige Code lädt das Einzelbild 5 der Animation "Animationen/HugeAnim.gif" als Pinsel 1 und zeigt es mit einem Effekt auf dem Display.

Navigation zeigen