Bezeichnung
WritePen -- schreibt den Stift in das Palettenobjekt (V9.0)
Übersicht
WritePen(x, y, pen[, t])
Beschreibung
Dieser Befehl schreibt den durch pen angegebenen Stift an die durch x und y angegebene Position im aktuell aktiven Palettenobjekt. Standardmäßig ist das aktuelle Display das aktive Palettenobjekt, aber natürlich nur, wenn das aktuelle Display ein Palettenmodus-Display ist. Siehe Palettenmodus-Displays für Details. Sie können das aktive Palettenobjekt mit dem Befehl SelectPalette() festlegen.

Alternativ können Sie auch WritePen() verwenden, um einen Stift in ein anderes Palettenobjekt zu schreiben. Dazu müssen Sie das optionale Tabellenargument t an WritePen() übergeben und die Tags Type und ID angeben. Siehe 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, in dessen Pixeldaten Sie schreiben 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 des aktuell aktiven Palettenobjekts, welches mit SelectPalette() eingestellt wurde. Siehe SelectPalette für Details.

ID:
Setzen Sie diesen Tag auf den Identifikator des Objekts, dessen Pixeldaten verwendet werden sollen. Die Standardeinstellung ist die ID des aktuell aktiven Palettenobjekts, welches mit SelectPalette() festgelegt 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 Pixeldaten verwendet werden sollen. Einzelbilder werden von 1 an gezählt. Bei Verwendung mit Animationen und Sprites wird standardmäßig 1 und bei Verwendung mit Animationsebenen des aktuellen Einzelbildes verwendet.

Eingaben
x
x-Position zum Schreiben
y
y-Position zum Schreiben
pen
der Stift zum Schreiben
t
optional: Tabelle mit weiteren Optionen (siehe oben)
Beispiel
WritePen(0, 0, 10, {Type = #BRUSH, ID = 2})
Der Code zeichnet ein Pixel, welches Stift 10 verwendet, in Pinsel 2 in der oberen linken Ecke.
Navigation zeigen