Bezeichnung
SetDepth -- stellt die Farbtiefe der Palette ein (V9.0)
Übersicht
SetDepth(depth[, t])
Beschreibung
Dieser Befehl setzt die Farbtiefe der aktuell aktiven Palette auf die in depth angegebene Farbtiefe. Die Farbtiefe in depth muss eine Bit-Tiefe zwischen 1 (= 2 Farben) und 8 (= 256 Farben) haben. Siehe Übersicht Paletten für Details. Beachten Sie, dass wenn die angegebene Farbtiefe geringer ist als die der an die Palette angehängten Pixeldaten, die Pixeldaten neu zugeordnet werden, um der neuen Farbtiefe zu entsprechen.

Standardmäßig ist die Palette des aktuellen Displays die aktive Palette, aber natürlich nur, wenn das aktuelle Display ein Palettenmodus-Display ist. Siehe Palettenmodus-Displays für Details. Eine Palette kann mit dem Befehl SelectPalette() zur aktiven Palette gemacht werden.

Alternativ kann die angegebene Farbtiefe auch auf ein anderes Palettenobjekt gesetzt werden. Dazu müssen Sie das optionale Tabellenargument an SetDepth() übergeben und die Tags Type und ID angeben. Siehe weiter unten für ein Beispiel.

Die folgenden Tags werden durch das optionale Tabellenargument t unterstützt:

Type:
Setzen Sie dies auf den Typ des Objekts, dessen Farbtiefe Sie einstellen möchten. Dies kann einer der folgenden Objekttypen sein:

 
#ANIM
#BGPIC
#BRUSH
#DISPLAY
#LAYER
#PALETTE
#SPRITE

Beachten Sie, dass Sie bei Verwendung der Typen #ANIM oder #SPRITE auch den Tag Frame (siehe unten) setzen müssen, um das Einzelbild anzugeben, dessen Pixeldaten verwendet werden sollen. Wenn Sie #LAYER verwenden und die angegebene Ebene eine Animationsebene ist, müssen Sie auch den Tag Frame setzen.

Type ist standardmäßig der Typ der aktuell aktiven Palette, die mit dem Befehl SelectPalette() gewählt wurde. Siehe SelectPalette für Details.

ID:
Setzen Sie diesen Tag auf den Identifikator des Objekts, dessen Farbtiefe Sie einstellen möchten. Die Standardeinstellung ist die ID der aktuell aktiven Palette, die mit SelectPalette() ausgewählt wurde. Siehe SelectPalette für Details.

Frame:
Wenn der Typ eine Animation, ein Sprite oder eine Animationsebene ist, müssen Sie diesen Tag setzen, um das Einzelbild anzugeben, dessen Farbttiefe eingestellt werden soll. Die Einzelbilder werden von 1 an gezählt. Bei Animationen und Sprites ist der Standardwert 1, bei Animationsebenen das aktuelle Einzelbild.

Remap:
Wenn dieser Tag auf False gesetzt ist, werden Stifte außerhalb des Bereichs nicht den vorhandenen Stiften neu zugeordnet, sondern einfach auf den im Tag ClipPen (siehe unten) angegebenen Stift gesetzt, d.h. es findet keine Neuzuordnung statt. Beachten Sie, dass Remap nur beim Reduzieren von Farben wirksam ist. Wenn die neue Farbtiefe mehr Stifte hat als die alte, hat Remap keine Auswirkung. (V10.0)

ClipPen:
Dies wird nur verwendet, wenn der Tag Remap auf False gesetzt ist (siehe oben). In diesem Fall werden Stifte außerhalb des Bereichs nicht den vorhandenen Stiften neu zugeordnet, sondern einfach auf den im Tag ClipPen angegebenen Stift gesetzt, d.h. es findet keine Neuzuordnung statt. Beachten Sie, dass ClipPen nur beim Reduzieren von Farben wirksam ist. Wenn die neue Farbtiefe mehr Stifte hat als die alte, führt ClipPen nichts aus. (V10.0)

Eingaben
depth
gewünschte neue Farbtiefe der Palette (im Bereich von 1 bis 8)
t
optional: Tabelle mit weiteren Optionen (siehe oben)
Beispiel
SetDepth(4, {Type = #BRUSH, ID = 2})
Der obige Code setzt die Farbtiefe der Palette von Pinsel 2 auf 4 (= 16 Farben).

Navigation zeigen