Retrieve domain properties

Status: not implemented, planned for implementation

This Fib element is used to retrieve parameters of the domains.

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

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

Description of the elements:

• $Variable$: The variable, which the domain property element defines. If no domain parameter for the variable can be determined, the variable will be set to $0$ .
• $Type$: The type of the domain whose parameter should be determined. Possible types are listed in table 5 on page .
• $Element$: If the domain is a vector domain (a domain for vectors), the number of the vector element, for which a property value should be returned, must be specified with $Element$. Ther can be more than one $Element$ parameters following each other, if some (more than one) vector domains are nested. Since the $Variable$ can only be assigned to scalars, no vector can be determined with the domain property element, but there have to always be a vector element selected. The counting of the vector elements of a vector starts at $1$.
• $Mode$: Which property value of the domain is to be selected. Possible values are listed in table 4 .
• $Obj_1$: The subobject, for which the $Variable$ is defined and which will be evalued for the retrieved variable assignment of the domain property element.

For finding the correct domain first the domains of the next (higher) root-element are searched, than its value domains. If no appropriate domain is found in the first root-element the next (higher) (to the first root-element) root-element is searched and so on.

Table 4: Possible retrievable properties of a domain

Name	Value	Description
null	0	The zero value of the domain will be returned.
min	1	The minimum value of the domain will be returned.
max	2	The maximum value of the domain will be returned.
size	3	The size ( $Maximum-Minimum$) of the domain will be returned.
scaling	4	The scaling factor of the domain will be returned. If the domain isn't scaled, $1$ will be returned.
Unscaled(not scaled) values
(In domains that are not scaled, these correspond to the scaled
values (for example, then the return value of "unscaled min"
is equal to that of "min")
unscaled null	10	The unscaled zero value of the domain will be returned.
unscaled min	11	The unscaled minimum value of the domain will be returned.
unscaled max	12	The unscaled maximum value of the domain will be returned.
unscaled size	13	The unscaled size ( $unscaled\ maximum - unscaled\ minimum$) of the domain will be returned.

Notes: With this element properties of the environment can be obtained. This can be useful, if a multimedia object is to be scaled afterwards with a given dimension domain. The displayed objects can be automatically adjusted via the retrieval of the dimension domain properties in size and position.

Examples:

• $dp( x , dim.1, min, Obj_1 )$: The variable $x$ is set to the minimum value of the domain for the first dimension.
• $dp( x , property( colorRGB).2, max, Obj_1 )$: The variable $x$ is set to the maximum value of the domain for the color green (second vector element) of the RGB colors.
• $dp( x , property( colorGrayscale ).1, size, Obj_1 )$: The variable $x$ is set to the size of the domain for SW colors. The $1$ for the first vector element must be specified, because the domain for SW color is a vector, even if it contains only one element.
• $dp( x , matrix.3.2, null, Obj_1 )$: The variable $x$ is set to the zero value of the second subdomain of the third subdomain of the matrix domain.