Bezeichnung
ReadPen -- liest einen Stift aus dem Palettenobjekt (V9.0)
Übersicht
pen = ReadPen(x, y[, t])
Beschreibung
Dieser Befehl liest den Stift an der durch x und y angegebenen Position aus dem 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 ReadPen() verwenden, um einen Stift aus einem anderen Palettenobjekt zu lesen. Dazu müssen Sie das optionale Tabellenargument t an ReadPen() übergeben und die Tags Type und ID angeben. Siehe unten für ein Beispiel.

Die folgenden Tags werden vom optionalen Tabellenargument t unterstützt:

Type:
Setzen Sie dies auf den Typ des Objekts, dessen Palette Sie abfragen 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 Pixeldaten verwendet werden sollen. Die Standardeinstellung ist die ID des aktuell aktiven Palettenobjekts, der 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. Die Einzelbilder werden von 1 an gezählt. Bei Verwendung mit Animationen und Sprites wird standardmäßig 1 und mit Animationsebenen das aktuelle Einzelbild verwendet.

Eingaben
x
Position x, von der gelesen wird
y
Position y, von der gelesen wird
t
optional: Tabelle mit weiteren Optionen (siehe oben)
Rückgabewerte
pen
Stift an der angegebenen Position
Beispiel
@DISPLAY {Palette = #PALETTE_MONOCHROME}
pen = ReadPen(0, 0)
Der obige Code liest den Stift in der oberen linken Ecke des Displays. Dies ist 0, da der Display-Hintergrund standardmäßig mit Stift 0 gefüllt wird.


pen = ReadPen(0, 0, {Type = #BRUSH, ID = 2})
Der Code liest den Stift in der oberen linken Ecke vom Pinsel 2.

Navigation zeigen