SaveAnim(id, file$[, format, table])
id
angegebene Animation in
der durch file$
angegebenen Datei im durch format
angegebenen
Animationsformat. Dies kann entweder eine der folgenden Konstanten
oder ein von einem Plugin bereitgestelltes Animationsformat sein:
#ANMFMT_GIF:
Colors
und Dither
(siehe
unten) verwenden, um die Anzahl der Paletteneinträge festzulegen,
die der Animation zugewiesen werden sollen und ob Dithering
angewendet werden soll oder nicht. Wenn #ANMFMT_GIF
mit einer
Palettenanimation verwendet wird, wird keine Quantisierung durchgeführt.
#ANMFMT_GIF
unterstützt auch Palettenanimation mit einem transparenten
Stift. #ANMFMT_GIF
ist das von SaveAnim()
verwendete Standardformat.
#ANMFMT_MJPEG:
Quality
(siehe unten)
festlegen können, um die zu verwendende Komprimierungsstufe
zu wählen.
#ANMFMT_IFF:
Colors
und Dither
(siehe
unten) verwenden, um die Anzahl der Paletteneinträge festzulegen,
die der Animation zugewiesen werden sollen und ob Dithering
angewendet werden soll oder nicht. Wenn #ANMFMT_IFF
mit einer
Palettenanimation verwendet wird, wird keine Quantisierung durchgeführt.
#ANMFMT_IFF
unterstützt auch Palettenanimation mit einem transparenten
Stift. (V9.0)
Mit dem optionalen Argument table
können Sie weiterer Parameter
festlegen:
Dither:
Dither
auf True
, um Dithering zu ermöglichen. Dieser
Tag wird nur verarbeitet, wenn das Zielformat palettenbasiert
ist und die Quelldaten RGB sind. GIF- und IFF-Animationen verwenden
immer eine Farbpalette. Der Standardwert ist False
, was kein
Dithering bedeutet.
Depth:
Colors:
Depth
. Anstelle einer Bittiefe
können Sie hier angeben, wie viele Farben die Animation verwenden
soll. Auch dies wird nur berücksichtigt, wenn das Format palettenbasiert
ist und die Quelldaten im RGB-Format vorliegen. Gültige Werte
liegen zwischen 1 und 256. Die Voreinstellung ist 256.
Optimize:
True
.
Quality:
FPS:
FPS
können Sie diese Anzahl an Bildern
festlegen. Dies wird nur für Videodateiformate berücksichtigt.
Voreingestellt sind 25 Bildern pro Sekunde.
FillColor:
#NOCOLOR
,
was bedeutet, dass transparente Pixel so belassen werden, wie
sie sind. (V9.0)
Adapter:
UserTags:
Hier ist eine Tabelle, die einen Überblick zeigt, welche Tabellenelemente mit den verschiedenen Animationsformate verwendet werden können:
SaveAnim()
kann sowohl mit diskbasierten Animationen oder vollständig
im internen Speicher gepufferten Animationen verwendet werden.
Wenn Sie eine Animation aus mehreren Einzelbilder (z.B. eine Reihe von Pinseln) speichern möchten, können Sie dies mit BeginAnimStream(), WriteAnimFrame() und FinishAnimStream() erledigen.
#ANMFMT_GIF
)SaveAnim(1, "my_anim.gif", #ANMFMT_GIF, {Colors = 64, Dither = True})Der obige Code speichert Anim 1 als "my_anim.gif" in 64 Farben mit aktiviertem Dithering ab.