Bezeichnung
PALETTE -- definiert eine Palette für die spätere Verwendung (V9.0)
Übersicht
@PALETTE id[, filename$][, table]
Beschreibung
Mit dieser Präprozessor-Anweisung kann eine Palette für die spätere Verwendung definiert werden. Die Palette kann entweder aus einer Datei geladen werden, es kann sich um eine der vordefinierten Paletten Hollywoods handeln oder Sie können Ihre eigene Palette definieren, indem Sie eine Reihe von Farben angeben.

Wenn Sie das Argument filename$ übergeben, wird die Palette aus dieser Datei geladen. Die in filename$ angegebene Datei kann entweder im von Deluxe Paint festgelegten IFF ILBM-Palettenformat vorliegen, oder alternativ kann filename$ auch eine normale Bilddatei sein, die eine Palette enthält. In diesem Fall extrahiert @PALETTE einfach die Palette aus der Bilddatei. Beachten Sie jedoch, dass Hollywood die gesamte Bilddatei mit Ihrem Applet oder Ihrem Programm verknüpft, wenn Sie eine vollständige Bilddatei an @PALETTE übergeben und Ihr Skript in ein Applet oder ein Programm kompilieren, wodurch sich die Größe der Ausgabedatei erhöht. Daher wird empfohlen, nur Palettendateien im IFF-ILBM-Format mit @PALETTE zu verwenden, da diese sehr klein sind, da sie keine Bilddaten enthalten.

Wenn Sie das Argument filename$ nicht übergeben, müssen Sie im optionalen Tabellenargument entweder den Tag Type oder Colors setzen, um die Palette zu definieren (siehe unten). Folgende Tags können Sie mit dem optionalen Tabellenargument verwenden:

Type:
Setzen Sie diesen Tag, wenn Sie eine der vordefinierten Paletten von Hollywood verwenden möchten. In diesem Fall müssen Sie Type auf den Identifikator der gewünschten eingebauten Palette setzen. Siehe SetStandardPalette für eine Liste der integrierten Paletten. Wenn Sie diesen Tag setzen, dürfen Sie filename$ oder Colors nicht übergeben.

Colors:
Mit diesem Tag kann eine benutzerdefinierte Palette definiert werden. Wenn Sie Colors festlegen, dürfen Sie filename$ oder Type nicht übergeben. Um eine benutzerdefinierte Palette zu definieren, setzen Sie Colors auf eine Tabelle mit den gewünschten Farben für die Palette. Die Palettenfarbtiefe wird automatisch aus der Anzahl der Farben in der Tabelle berechnet. Alternativ können Sie auch den Tag Depth setzen, um die Palettenfarbtiefe zu definieren (siehe unten).

Depth:
Die gewünschte Farbtiefe für die Palette. Diese muss zwischen 1 (= 2 Farben) und 8 (= 256 Farben) liegen. Voreingestellt ist 8. Dies muss nur angegeben werden, wenn auch der Tag Colors gesetzt wird. Wenn Depth mehr Farben angibt, als Sie in der Tabelle im Tag Colors übergeben haben, werden die verbleibenden Farben auf Schwarz initialisiert.

TransparentPen:
Mit diesem Tag kann der Stift angegeben werden, der in der Palette transparent sein soll. Der Standardwert ist #NOPEN, was bedeutet, dass kein Stift transparent gemacht wird. Dies darf nur verwendet werden, wenn auch der Tag Type oder Colors übergeben wird.

Link:
Setzen Sie diesen Tag auf False, wenn Sie filename$ beim Kompilieren Ihres Skripts nicht mit Ihrem Programm/Applet verknüpft haben möchten. Dieser Tag ist standardmäßig auf True gesetzt. Dies bedeutet, dass die Palette mit Ihrem Programm/Applet verknüpft wird, wenn sich Hollywood im Kompilierungsmodus befindet. Wenn Sie diesen Tag verwenden, müssen Sie auch filename$ übergeben.

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. Wenn Sie diesen Tag verwenden, müssen Sie auch filename$ übergeben.

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. Wenn Sie diesen Tag verwenden, müssen Sie auch filename$ übergeben.

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)

Um Paletten zur Laufzeit zu laden oder zu erstellen, sehen Sie sich die Befehle LoadPalette() und CreatePalette() an.

Eingaben
id
ein Wert, der zur Identifizierung dieser Palette später im Code verwendet wird
filename$
die Palettendatei, die Sie laden möchten
table
optional: Tabelle mit weiteren Optionen (siehe oben)
Beispiel
@PALETTE 1, "DPaint32.pal"
Lädt "DPaint32.pal" als Palette 1 vor.


@PALETTE 1, {Colors = {#WHITE, #BLACK, $7777CC, $BBBBBB}}
Definiert eine benutzerdefinierte Palette als Palette 1.


@PALETTE 1, {Type = #PALETTE_CGA}
Definiert die Standard-CGA-Palette als Palette 1.

Navigation zeigen