Bezeichnung
GetFreePen -- gibt unbenutzten Stift zurück (V10.0)
Übersicht
pen = GetFreePen([t])
Beschreibung
Dieser Befehl versucht, einen nicht verwendeten Stift im aktuell aktiven Palettenbild zu finden und gibt ihn zurück. Wenn alle Stifte verwendet werden, wird -1 zurückgegeben. Standardmäßig durchsucht dieser Befehl die Palettenpixeldaten des aktuellen Displays, sodass er nur funktioniert, wenn es sich bei dem aktuellen Display um ein Display im Palettenmodus handelt. Siehe Palettenmodus-Displays für Details. Wenn Sie nicht möchten, dass GetFreePen() das aktuelle Display verwendet, können Sie das aktive Palettenbild mit dem Befehl SelectPalette() auswählen. Beachten Sie jedoch, dass Sie ein Palettenobjekt auswählen müssen, an dem Pixeldaten zugeordnet sind, z.B. einen Palettenpinsel oder ein Paletten-BGPic. Die bloße Auswahl eines Palettenobjekts funktioniert nicht, da freie Stifte natürlich nur ermittelt werden können, wenn Pixeldaten vorhanden sind.

Sie können auch das optionale Tabellenargument t verwenden, um das Quellpalettenobjekt anzugeben. Das Tabellenargument unterstützt genau dieselben Argumente wie das optionale Tabellenargument von GetPen(). Siehe GetPen für Details.

Eingaben
t
optional: Tabelle zur Angabe weiterer Optionen (siehe oben)
Rückgabewerte
pen
Index der unbenutzten Stifte oder -1, wenn alle Stifte benutzt werden

Navigation zeigen