Definitionsbereichseigenschaften abrufen

Status: nicht realisiert; zur Realisierung in einer späteren Version vorgesehen

Dieses Fib-Element dient dazu, die Parameter der Definitionsbereiche abzurufen.

Syntax: $Obj = domainProperty( Variable , Type[.Element]*, Mode, Obj_1 )$

Syntax: $Obj = dp( Variable , Type[.Element]*, Mode, Obj_1 )$

Beschreibung des Elemente:

• $Variable$: Dies ist die Variable, welche das Definitionsbereichselement definiert. Kann kein Eigenschaftswert für die Variable ermittelt werden, wird die Variable mit $0$ belegt.
• $Type$: Dies ist der Typ des Definitionsbereichs, dessen Werte ermittelt werden sollen. Mögliche Typen sind in Tabelle 5 auf Seite aufgeführt.
• $Element$: Wenn es sich beim Definitionsbereich um einen Definitionsbereich für Vektoren handelt, muss mit $Element$ die Nummer des Vektorelements angegeben werden, für welche ein Eigenschaftswert zurückgegeben werden soll. Es können auch mehrere $Element$ Angaben aufeinander folgen, wenn mehrere Definitionsbereichsvektoren verschachtelt sind. Da die $Variable$ nur mit Skalaren belegt werden kann, kann auch kein Vektor mit dem Definitionsbereichselement ermittelt werden, sondern es muss immer ein Vektorelement ausgewählt werden. Die Zählung der Vektorelemente eines Vektors beginnt bei $1$.
• $Mode$: Dieses Element gibt an, welcher Eigenschaftswert des Definitionsbereichs ausgewählt werden soll. Mögliche Werte sind in Tabelle 4 aufgeführt.
• $Obj_1$: Dies ist das Unterobjekt in dem die $Variable$ definiert ist und welches für die Variablenbelegung des Definitionsbereichselement ausgewertet wird.

Um den richtigen Definitionsbereich zu finden werden zuerst die Definitionsbereiche des nächst höheren root-Elements durchsucht, dann seine Definitionsbereiche für Werte. Wenn auch darin kein entsprechender Definitionsbereich gefunden wurde, wird das nächst höheret (zum ersten root-Element) root-Element durchsucht und so weiter.

Table: Mögliche abrufbare Eigenschaften eines Definitionsbereichs

Name	Wert	Beschreibung
null	0	Zurückgegeben wird der Nullwert des Definitionsbereichs.
min	1	Zurückgegeben wird das Minimum des Definitionsbereichs.
max	2	Zurückgegeben wird das Maximum des Definitionsbereichs.
size	3	Zurückgegeben wird die Größe (also $Maximum-Minimum$) des Definitionsbereichs.
scaling	4	Zurückgegeben wird der Skalierungsfaktor des Definitionsbereichs. Bei Definitionsbereichen die nicht skaliert werden, wird $1$ zurückgegeben.
Unskalierte Werte
(Bei Definitionsbereichen, die nicht skaliert werden, entsprechen diese
den skalierten Werten [z. B. ist dann die Rückgabe für "unscaled min"
gleich der von "min"])
unscaled null	10	Zurückgegeben wird der unskalierte Nullwert des Definitionsbereichs.
unscaled min	11	Zurückgegeben wird das unskalierte Minimum des Definitionsbereichs.
unscaled max	12	Zurückgegeben wird das unskalierte Maximum des Definitionsbereichs.
unscaled size	13	Zurückgegeben wird die unskalierte Größe (also $(unskaliertes\ Maximum)-(unskaliertes\ Minimum)$) des Definitionsbereichs.

Anmerkungen: Mit dieses Element können Eigenschaften der Umgebung erfragt werden. Dies kann beispielsweise nützlich sein, wenn ein Multimediaobjekt im Nachhinein über die Angabe der Dimensionsdefinitionsbereiche skaliert werden soll. Die dargestellten Objekte können dann automatisch über die Erfragung der Eigenschaften des Dimensionsdefinitionsbereiche in Größe und Position angepasst werden.

Beispiele:

• $dp( x , dim.1, min, Obj_1 )$: Die Variable $x$ wird mit dem minimalen Wert des Definitionsbereichs für die erste Dimension belegt.
• $dp( x , property( colorRGB).2, max, Obj_1 )$: Die Variable $x$ wird mit dem maximalen Wert des Definitionsbereichs für Grün (zweites Vektorelement) von RGB-Farben belegt.
• $dp( x , property( colorGrayscale).1, size, Obj_1 )$: Die Variable $x$ wird mit der Größe des Definitionsbereich für SW-Farben belegt. Hier muss die $1$ für das erste Vektorelement mit angegeben werden, da der Definitionsbereichs für SW-Farben ein Vektor ist, auch wenn er nur ein Element enthält.
• $dp( x , matrix.3.2, null, Obj_1 )$: Die Variable $x$ wird mit dem Nullwert des zweiten Unterdefinitionsbereichs des dritten Unterdefinitionsbereichs des Matrixdefinitionsbereichs belegt.