Class Name: LSR Location 3D Control Link

Superclass - Control Link

Definition

The specialized Control Link used to provide the connection between an ordered aggregation of Expressions and the target fields of a LSR Location 3D.

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

The y_expr_index field is a 1-based index into the ordered aggregation of Expressions, and is used to select the specific Expression that controls the value of LSR Location 3D's y field.

The z_expr_index field is a 1-based index into the ordered aggregation of Expressions, and is used to select the specific Expression that controls the value of LSR Location 3D's z field.

Primary Page in DRM Diagram:

Secondary Pages in DRM Diagram:

Example

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

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

  2. See also Interface Template, Geometry Instance Template Index.

FAQs

--FAQs needed here --

Constraints

None.

Composed of (two-way)(inherited)

Component of (two-way)

Inherited Field Elements

SE_STRING description; (notes)

Field Elements

SE_UINT32 x_expr_index; (notes)
SE_UINT32 y_expr_index; (notes)
SE_UINT32 z_expr_index; (notes)

Notes

Fields Notes

description

 A text description of what the Control_Link is for

x_expr_index

 index of the expression whose value controls the x field of the affected
 <LSR Location 3D>. If 0, this field is not controlled.

y_expr_index

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

z_expr_index

 index of the expression whose value controls the z field of the affected
 <LSR Location 3D>. If 0, this field is not controlled.

Prev: LSR Location 3D. Next: LSR Transformation. Up:Index.