[id] = LoadPalette(id, filename$[, table])

Die in filename$ angegebene Palette kann entweder im IFF-ILBM-Palettenformat vorliegen, wie es von Deluxe Paint festgelegt wurde, oder filename$ kann alternativ auch eine normale Bilddatei sein, die eine Palette enthält. In diesem Fall extrahiert LoadPalette() einfach die Palette aus der Bilddatei.

Das dritte Argument ist optional. In dieser Tabelle können weitere Optionen für den Ladevorgang festgelegt werden. Die folgenden Felder der Tabelle können verwendet werden:

Loader:

Mit diesem Tag können Sie ein oder mehrere Formatlademodule angeben, die diese Palette laden sollen. Dies muss als eine Zeichenkette 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.

Adapter:

Mit diesem Tag können Sie einen oder mehrere Dateiadapter angeben, die die angegebene Datei öffnen sollen. Dies muss als eine Zeichenkette 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.

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)

Dieser Befehl gibt es auch als Präprozessor: Verwenden Sie @PALETTE, um Paletten vorzuladen.

id

ID für die Palette oder Nil für die automatische ID-Zuweisung

filename$

Datei, welche geladen wird

table

optional: weitere Optionen (siehe oben)

id

optional: Identifikator der Palette; wird nur zurückgegeben, wenn Sie beim Argument id Nil angegeben haben.

LoadPalette(1, "DPaint32.pal")