Cells (Shared)

igds_type: igds_shared_cell

Shared cells correspond to IGDS element type 34 and 35. They consist of two parts: the definition (Type 34) and the element (Type 35). The definitions list the component elements of the cells. The elements are made up of an insertion point as well as rotation and scaling parameters. The IGDS reader skips all elements that define the cell and only processes the element features as point features that have only a single coordinate.

If the Expand Named Cells parameter is set to Yes, then the shared cells are expanded into its pieces; otherwise only the cell insertion point is output for each shared cell instance. Expansion of shared cells is supported by both V7 and V8.

The DGNV8 writer can write shared cells, while the IDGS V7 write creates unshared cells from shared cell features.

Shared cell instances have the following attributes:

Attribute Name	Contents
igds_cell_element_class igds_cell_element_style igds_cell_element_color igds_cell_element_weight igds_cell_element_level igds_cell_element_level_name	Stores some standard properties of the first element of a graphic cell, when reading. These are only set if the cell is not set to be expanded into component elements, since equivalent properties can be found as standard properties of each of those elements in that case. Default: No default
igds_cell_insertion_x igds_cell_insertion_y igds_cell_insertion_z	Stores cell insertion point Range: Any real number Default: No default
igds_cell_name	The name of the cell. Corresponds to the name of the cell in a cell library. Range: Character String Default: No default
igds_cell_num_members	Stores a cell’s total number of members. Range: Any real numbers > 0 Default: No default
igds_cell_num_members	Stores a cell’s total number of members. Range: Any real numbers > 0 Default: No default
igds_cell_sequence_number	When reading only with the Expand Named Cells parameter set to Yes, this contains a unique number that can be used to regroup a cell with its component elements.
igds_cell_size	The size in ground units of the maximum span of the cell. If this is specified, the settings for igds_cell_x_scale, igds_cell_y_scale, and igds_cell_z_scale are ignored. If it is not specified, then the scaling factors described above are used. This attribute is not assigned any value by the reader. Range: Any real numbers > 0 Default: No default
igds_cell_size_x	This is the difference of minX and maxX stored in ground units. Note: If igds_cell_size_x and igds_cell_size_y are both specified, then igds_cell_size_x_scale, igds_cell_size_y_scale and igds_cell_size_z_scale values are ignored.
igds_cell_size_y	This is the difference of minY and maxY stored in ground units.
igds_cell_x_scale igds_cell_y_scale igds_cell_z_scale	The scaling factors to apply to the cell. This value may be overridden by the igds_cell_size attribute. Similarly, these factors will not be used to calculate the cell header scale if the igds_cell2DTMat* or igds_cell3DTMat* attributes are present. Range: Any real number > 0 Default: 1
igds_cell2DTMat11 igds_cell2DTMat12 igds_cell2DTMat21 igds_cell2DTMat22	Cell’s 2D matrix containing rotation and scale information. If this is specified, the settings for igds_cell_x_scale, igds_cell_y_scale, and igds_cell_z_scale are ignored for the purpose of setting the cell header scale. Default: No default
igds_cell3DTMat11 igds_cell3DTMat12 igds_cell3DTMat13 igds_cell3DTMat21 igds_cell3DTMat22 igds_cell3DTMat23 igds_cell3DTMat31 igds_cell3DTMat32 igds_cell3DTMat33	Cell’s 3D matrix containing rotation and scale information. If this is specified, the settings for igds_cell_x_scale, igds_cell_y_scale, and igds_cell_z_scale are ignored. Default: No default
igds_rotation	The rotation of the entire cell. The rotation is measured in degrees counterclockwise up from horizontal. Range: -360.0..360.0 Default: 0
igds_sharedcell_description (applicable only to Shared Cells)	The description of the cell. (Supported for version 8 DGN files only.) Range: Character String Default: No default
igds_text_string{#}	When reading only, this contains the text string of the #th text element in the cell. Range: Any string
igds_unnamedcell_num_of_elements	Stores number of elements of an unnamed cell (group) Range: Any real numbers > 0 Default: No default

Attribute Name

Contents

igds_cell_element_class

igds_cell_element_style

igds_cell_element_color

igds_cell_element_weight

igds_cell_element_level

igds_cell_element_level_name

Stores some standard properties of the first element of a graphic cell, when reading.

These are only set if the cell is not set to be expanded into component elements, since equivalent properties can be found as standard properties of each of those elements in that case.

Default: No default

igds_cell_insertion_x

igds_cell_insertion_y

igds_cell_insertion_z

Stores cell insertion point

Range: Any real number

Default: No default

igds_cell_name

The name of the cell. Corresponds to the name of the cell in a cell library.

Range: Character String

Default: No default

igds_cell_num_members

Stores a cell’s total number of members.

Range: Any real numbers > 0

Default: No default

igds_cell_num_members

Stores a cell’s total number of members.

Range: Any real numbers > 0

Default: No default

igds_cell_sequence_number

When reading only with the Expand Named Cells parameter set to Yes, this contains a unique number that can be used to regroup a cell with its component elements.

igds_cell_size

The size in ground units of the maximum span of the cell. If this is specified, the settings for igds_cell_x_scale, igds_cell_y_scale, and igds_cell_z_scale are ignored.

If it is not specified, then the scaling factors described above are used. This attribute is not assigned any value by the reader.

Range: Any real numbers > 0

Default: No default

igds_cell_size_x

This is the difference of minX and maxX stored in ground units.

Note: If igds_cell_size_x and igds_cell_size_y are both specified, then igds_cell_size_x_scale, igds_cell_size_y_scale and igds_cell_size_z_scale values are ignored.

igds_cell_size_y

This is the difference of minY and maxY stored in ground units.

igds_cell_x_scale

igds_cell_y_scale

igds_cell_z_scale

The scaling factors to apply to the cell.

This value may be overridden by the igds_cell_size attribute. Similarly, these factors will not be used to calculate the cell header scale if the igds_cell2DTMat* or igds_cell3DTMat* attributes are present.

Range: Any real number > 0

Default: 1

igds_cell2DTMat11

igds_cell2DTMat12

igds_cell2DTMat21

igds_cell2DTMat22

Cell’s 2D matrix containing rotation and scale information.

If this is specified, the settings for igds_cell_x_scale, igds_cell_y_scale, and igds_cell_z_scale are ignored for the purpose of setting the cell header scale.

Default: No default

igds_cell3DTMat11

igds_cell3DTMat12

igds_cell3DTMat13

igds_cell3DTMat21

igds_cell3DTMat22

igds_cell3DTMat23

igds_cell3DTMat31

igds_cell3DTMat32

igds_cell3DTMat33

Cell’s 3D matrix containing rotation and scale information.

If this is specified, the settings for igds_cell_x_scale, igds_cell_y_scale, and igds_cell_z_scale are ignored.

Default: No default

igds_rotation

The rotation of the entire cell. The rotation is measured in degrees counterclockwise up from horizontal.

Range: -360.0..360.0

Default: 0

igds_sharedcell_description

(applicable only to Shared Cells)

The description of the cell. (Supported for version 8 DGN files only.)

Range: Character String

Default: No default

igds_text_string{#}

When reading only, this contains the text string of the #th text element in the cell.

Range: Any string

igds_unnamedcell_num_of_elements

Stores number of elements of an unnamed cell (group)

Range: Any real numbers > 0

Default: No default