table = BrushToRGBArray(id[, invalpha])
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().
True
gesetzt, werden Alphawerte
invertiert (Standard ist False
)