Bezeichnung
BrushToRGBArray -- wandelt den Pinsel in ein Pixelarray um (V5.0)
Übersicht
table = BrushToRGBArray(id[, invalpha])
Beschreibung
Dieser Befehl kopiert alle Pixel aus dem angegebenen Pinsel in eine Tabelle und gibt Ihnen diese in table zurück. Die Tabelle kann als Matrix mit einer Anzahl von Zeilen angesehen werden, die der Höhe des Pinsels entspricht, wobei jede Zeile eine Anzahl von Elementen enthält, die der Breite des Pinsels entspricht. Die Reihenfolge der Pixeldaten in dieser Tabelle ist wie folgt: Zeile für Zeile von oben nach unten, d.h. die Tabelle beginnt mit der ersten Pixelzeile. Die einzelnen Pixel werden als ARGB-Werte gespeichert.

Beachten Sie, dass die Zeilen nicht als Untertabellen gespeichert werden. Die von BrushToRGBArray() zurückgegebene Tabelle ist eindimensional und enthält genau height * width-Elemente, die nacheinander, Zeile für Zeile gespeichert werden.

Das optionale Argument invalpha kann verwendet werden, damit BrushToRGBArray() alle Alphakanalwerte invertiert. Dies bedeutet, dass ein Wert von 0 hundertprozentig sichtbar und ein Wert von 255 völlig unsichtbar ist. Normalerweise ist es genau umgekehrt. Aus historischen Gründen verwendet die Darstellungsbibliothek von Hollywood invertierte Alphawerte und aus diesem Grund wird dies auch von BrushToRGBArray() unterstützt, obwohl es nicht der Standard ist.

Bitte beachten Sie, dass die Tabelle, die Sie von diesem Befehl erhalten, in der Regel viel Speicher in Anspruch nimmt. Daher sollten Sie diese Tabelle auf Nil setzen, sobald Sie sie nicht mehr benötigen. Andernfalls werden Sie riesige Mengen an Speicher verschwenden und es könnte sogar passieren, dass Ihrem Skript kein Speicher mehr zur Verfügung steht.

Um ein Pixelarray zurück zu einem Pinsel zu konvertieren, können Sie den Befehl RGBArrayToBrush() verwenden.

Beachten Sie, dass es für Palettenpinsel auch den Befehl BrushToPenArray() gibt, die die Stiftwerte des Pinsels anstelle der RGB-Farben zurückgibt. Siehe BrushToPenArray für Details.

Siehe auch PenArrayToBrush() und RGBArrayToBrush().

Eingaben
id
Identifikator des Pinsels
invalpha
optional: auf True gesetzt, werden Alphawerte invertiert (Standard ist False)
Rückgabewerte
table
eine Tabelle, die alle Pixel vom Pinsel enthält; vergessen Sie nicht, diese Tabelle auf Nil zu setzen, wenn Sie sie nicht mehr benötigen!

Navigation zeigen