Table 6.173—DRM_LSR_Location_3D_Control_Link

Property

Description

Superclass

·         <DRM Control Link>

Class

·         <DRM LSR Location 3D Control Link>

Subclass

·         none

Definition

This DRM class defines 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 LSR Location 3D>.

The x_expression_index field is a 1-based index into the ordered aggregation of <DRM Expression>s, and is used to select the specific <DRM Expression> that controls the value of the x field of the <DRM LSR Location 3D>.

The y_expression_index field is 1-based index into the ordered aggregation of <DRM Expression>s, and is used to select the specific <DRM Expression> that controls the value of the y field of the <DRM LSR Location 3D>.

The z_expression_index field is 1-based index into the ordered aggregation of <DRM Expression>s, and is used to select the specific <DRM Expression> that controls the value of the z field of the <DRM LSR Location 3D>.

Example(s)

·         Consider a building <DRM Model> that may be instanced on terrain polygons that are at various different orientations. Each building wall meets the terrain, leaving no gaps. This means that the lengths of the building's walls are required to be adjusted by different amounts in each instance to match the slope of the ground.

The location of each <DRM Vertex> at the base of a wall <DRM Polygon> can be adjusted by using an <DRM LSR Location 3D Control Link> aggregated by the <DRM LSR Location 3D> that specifies the location of the <DRM Vertex>. Each <DRM LSR Location 3D Control Link> will itself aggregate a <DRM Variable>, which will specify the new location value. These <DRM Variable>s are set separately for each instance to match the terrain upon which the instance is positioned. This calls for the <DRM Variable>s to be set from outside the building <DRM Model>, so all of these <DRM Variable>s in the building <DRM Model> are associated with the <DRM Interface Template> of the <DRM Model> .

·         See also <DRM Interface Template>, <DRM Model Instance Template Index>.

Inherited field elements

field_name

range

Field_Data_Type

description1

 

String

Field elements

field_name

range

Field_Data_Type

x_expression_index2

 

Integer_Unsigned

y_expression_index3

 

Integer_Unsigned

z_expression_index4

 

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_Expressions

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 LSR Location 3D>s

Constraints

·         none

Notes

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

2 Index of the expression whose value controls the x field of the affected <DRM LSR Location 3D>. If zero, this field is not controlled.

3 Index of the expression whose value controls the y field of the affected <DRM LSR Location 3D>. If zero, this field is not controlled.

4 Index of the expression whose value controls the z field of the affected <DRM LSR Location 3D>. If zero, this field is not controlled.

Class diagram

<DRM LSR Location 3D Control Link>