Es ist wichtig, die innerhalb einer Parameterfunktion verwendete Struktur zu verstehen.
Format:
<id> = Parameter(<Name>, <Standardwert>, <Typ>[, <Bedingung1>\]\[, <Bedingung2>\]..);
<Name> | Der in der Bedieneroberfläche angezeigte Name; |
<Standardwert> | Der Standardwert des Parameters.
Sind z. B. innerhalb einer Klammer mehrere Werte durch ein Komma getrennt, sollten darin vorkommende Dezimalwerte grundsätzlich durch einen Punkt getrennt werden. |
<Typ> | Definiert den Parametertyp. Die folgenden Beispielwerte sind möglich:
LINEAR bedeutet, dass der Parameter ein linearer Wert in den ausgewählten linearen Maßeinheiten ist.
ANGULAR bedeutet, dass der Parameter ein Winkelwert in den ausgewählten Winkeleinheiten ist. (aktuell sind nur Gradwerte verfügbar)
TEXT ist eine Textfolge;
FONT ist der Namen einer Schriftart;
COLOR ist ein RGB-Farbwert;
MATERIAL ist ein Materialname;
CHECKBOX ist ein logischer Wert, entweder ON (AN) oder OFF (AUS) |
<Bedingung> | Bedingungen sind optional. Sie definieren mögliche Einschränkungen, die auf Parameter einwirken. Einschränkungen können in willkürlicher Reihenfolge aufgeführt werden und können folgende Form haben:
Set(<Wert>,...) - eine Liste von erlaubten Parameterwerten
Interval(<Minimalwert>, <Maximalwert>) - stellt Minimal- und Maximalwerte für den Parameter ein;
LessThan(<Wert>) - gibt an, dass der Parameter kleiner als der angegebene Wert sein sollte
LessOrEqual(<Wert>) - gibt an, dass der Parameter nicht größer als der angegebene Wert sein sollte
GreaterThan(<Wert>) - gibt an, dass der Parameter größer als der angegebene Wert sein sollte
GreaterOrEqual(<Wert>) - gibt an, dass der Parameter nicht kleiner als der angegebene Wert sein sollte
Set(FolderList) - ein bestimmter Einstellungsoperator, der in Erscheinung tritt, wenn eine Liste von erlaubten Werten durch den Operator FolderList definiert wird.
Einschränkungen sollten einander nicht widersprechen. Beispielsweise können Sie GreaterThan(5) und LessThan(2) nicht miteinander kombinieren.
Wenn Sie Parametereinschränkungen angeben, ist es nicht erlaubt, Bezeichner oder Ausdrücke zu verwenden, die direkt oder indirekt von anderen Parametern abhängen, wie z. B. Argumente der obengenannten Funktionen. Nur Konstanten oder Konstantenausdrücke dürfen verwendet werden, wie zum Beispiel: LessOrEqual(PI/2). |
Beispiel für eine Parameterbeschreibung:
Alpha = Parameter("Drehwinkel", 45, ANGULAR, Interval(-90, 90)); // Hier wird ein Parameter erstellt, der einen Drehwinkel definiert. Der Name ist 'Drehwinkel', der Standardwert ist 45, der Werttyp ist Winkel und das Intervall liegt zwischen '-90' und '90'.