Bezeichnung
PathToBrush -- wandelt Pfad(e) in Vektorpinsel um (V7.0)
Übersicht
[id] = PathToBrush(id, table)
Beschreibung
Dieser Befehl kann verwendet werden, um einen oder mehrere Pfade in einen Vektorpinsel umzuwandeln. PathToBrush() wird einen neuen Pinsel mit dem in id angegebenen Identifikator erstellen oder wenn Sie statt dessen in id Nil übergeben, wählt PathToBrush() automatisch einen freien Identifikator für den neuen Pinsel und gibt ihn zurück.

Das Umwandeln von Pfaden in Vektorpinseln hat den Vorteil, dass Sie den einzelnen Pfaden, die in einem einzigen Vektorpinsel kombiniert werden, verschiedene Farben zuordnen können, so dass Sie einfach mehrfarbige Pfade innerhalb eines einzigen Pinselobjekts verwalten können. Darüber hinaus können die in dem Vektorpinsel kombinierten Pfade auch unterschiedliche Zeichnungsstile verwenden.

Sie müssen eine Tabelle im Argument table übergeben, welches eine Anzahl von Untertabellen enthält. In dieser sind Informationen über die einzelnen Pfade angegeben, die in den Vektorpinsel eingebettet werden sollen. Die Pfade werden in genau der gleichen Reihenfolge in den Vektorpinsel gezeichnet, wie sie in dieser Tabelle erscheinen.

Beachten Sie, dass jeder Pfad, der in den Vektorpinsel eingebettet werden soll, zuerst normalisiert wird. So werden standardmäßig alle Pfade in der oberen linken Ecke des Vektorpinsels gezeichnet. Sie können dieses Verhalten ändern, indem Sie die Argumente X und Y in den einzelnen Untertabellen für jeden Pfad angeben, der dem Vektorpinsel hinzugefügt werden soll (siehe unten).

Folgende Untertabellenfelder können angegeben werden:

ID:
Dies muss auf den Identifikator des Pfadobjekts gesetzt werden, das in den zu erstellenden Vektorpinsel eingebettet werden soll. Dies muss immer angegeben werden. Beachten Sie, dass PathToBrush() eine Kopie dieses Pfades erstellt, so dass nachfolgende Änderungen des Pfades den neuen Vektorpinsel in keiner Weise beeinflussen werden. Sie können diesen Pfad auch aus dem Speicher löschen, nachdem Sie ihn dem Vektorpinsel hinzugefügt haben.

X:
Die X-Position, wo dieser Pfad in den Vektorpinsel gezeichnet werden soll. Diese Position muss relativ zur linken Ecke des Vektorpinsels sein. Beachten Sie, dass PathToBrush() intern den Pfad normalisiert, bevor er ihn dem Vektorpinsel hinzufügt, so dass Sie dieses Feld normalerweise verwenden müssen, um den Pfad korrekt innerhalb des Vektorpinsels zu positionieren. Voreinstellung auf 0.

Y:
Die X-Position, wo dieser Pfad in den Vektorpinsel gezeichnet werden soll. Diese Position muss relativ zur linken Ecke des Vektorpinsels sein. Beachten Sie, dass PathToBrush() intern den Pfad normalisiert, bevor er ihn dem Vektorpinsel hinzufügt, so dass Sie dieses Feld normalerweise verwenden müssen, um den Pfad korrekt innerhalb des Vektorpinsels zu positionieren. Voreinstellung auf 0.

Color:
Der Pfad wird in dieser ARGB-Farbe gezeichnet. Diese Farbe kann auch eine Transparenzeinstellung enthalten. Voreingestellt ist #BLACK.

Beachten Sie, dass die Form- und Füllstile, die von den einzelnen Pfaden verwendet werden sollen, diejenigen sind, die zum Zeitpunkt der Erstellung des Pfades mit StartPath() aktiv waren. Dies unterscheidet sich von der Art und Weise, wie Form- und Füllstile beim Zeichnen von Pfaden mit DrawPath() arbeiten. DrawPath() verwendet die Form- und Füllstile, die aktiv sind, wenn DrawPath() aufgerufen wird. PathToBrush() wird die Form- und Füllstile benutzen, die aktiv waren, wenn StartPath() auf den einzelnen Pfaden aufgerufen wurde. Dies ermöglicht Ihnen, verschiedene Form- und Füllstile für die einzelnen Pfade zu verwenden, die in den Vektorpinsel eingebettet werden.

Eingaben
id
Identifikator für den neuen Pinsel oder Nil für die automatische ID-Zuweisung
table
Tabelle, die Pfade enthält, um sie in den Vektorpinsel einzubinden (siehe oben)
Rückgabewerte
id
optional: Identifikator des neuen Pinsels; wird nur zurückgegeben, wenn Nil als ID übergeben wurde (siehe oben)
Beispiel
PathToBrush(1, {{ID=1, Color=#RED}, {ID=2, Color=#BLUE, X=100}})
Dieser Code bettet die Pfade 1 und 2 innerhalb in einen neuen Vektorpinsel, der die ID 1 verwendet. Der Pfad 1 wird in Rot und der Pfad 2 wird blau gezeichnet. Zusätzlich wird der Pfad 2 an der X-Position 100 gezeichnet, während der Pfad 1 bei 0.0 gezeichnet wird.

Navigation zeigen