Table 6.57—DRM_Colour_Index_Control_Link

Property

Description

Superclass

·         <DRM Control Link>

Class

·         <DRM Colour Index Control Link>

Subclass

·         none

Definition

The specialized <DRM Control Link> used to provide the connection between an ordered aggregation of <DRM Expression>s and the target fields of a <DRM Colour Index>.

The color_index field is 1-based index into the ordered aggregation of <DRM Expression>s, and is used to select the specific <DRM Expression>s that defines <DRM Colour Index>’s index field.

The intensity_level_index field is a 1-based index into the ordered aggregation of <DRM Expression>s, and is used to select the specific <DRM Expression>s that defines <DRM Colour Index>’s intensity_level field.

Example(s)

·         Consider a <DRM Geometry Model> within a <DRM Model> representing a tree, where the geometry consists of a single <DRM Polygon> defined with <DRM Stamp Behaviour>.

Colour Index Control Link, Example 1

The <DRM Polygon>'s appearance is determined by a <DRM Colour Index> and an <DRM Image Mapping Function>. However, for every <DRM Geometry Model Instance> of this tree, the data provider wants to be able to vary the intensity_level of the <DRM Colour Index>, so that its contribution to the overall color of the tree changes from instance to instance. Consequently, the <DRM Colour Index> has a <DRM Colour Index Control Link>, which specifies a <DRM Variable> that controls the intensity_level of the <DRM Colour Index>, so that each <DRM Geometry Model Instance> can supply its own <DRM Literal> to determine the percent contribution of the <DRM Colour Index> to the appearance of the <DRM Polygon>.

Inherited field elements

field_name

range

Field_Data_Type

description1

 

String

Field elements

field_name

range

Field_Data_Type

colour_index2

 

Integer_Unsigned

intensity_level_index3

 

Integer_Unsigned

Associated to (one-way) (inherited)

·         none

Associated to (one-way)

·         none

Associated by (one-way) (inherited)

·         none

Associated by (one-way)

·         none

Associated with (two-way) (inherited)

·         none

Associated with (two-way)

·         none

Composed of (two-way) (inherited)

·         one or more {ordered} <DRM Expression>s

Composed of (two-way)

·         none

Composed of (two-way metadata) (inherited)

·         none

Composed of (two-way metadata)

·         none

Component of (two-way) (inherited)

·         none

Component of (two-way)

·         one or more <DRM Colour Index>s

Constraints

·         none

Notes

1 A text description for what the <DRM Control Link> is.

2 Index of the expression defining the <DRM Colour Index>’s index field. Zero means that the <DRM Colour Index>’s index field is not controlled.

3 Index of the expression defining the <DRM Colour Index>’s intensity level field. Zero means that the <DRM Colour Index>’s intensity level field is not controlled.

Class diagram

<DRM Colour Index Control Link>