Shapes

igds_type: igds_shape

Shape features are used in IGDS to represent closed polygons.

The first coordinate in a shape feature must be equal to the last coordinate. Such features are stored in and read from IGDS files in one of two ways, depending on the number of coordinates in their boundaries:

Number of Coordinates	IGDS Element Type	Description
In V7: Between 3 and 101 In V8: Between 3 and 5000	6	If the coordinates can fit in a single element, then an IGDS type 6 element is used to store the shape.
In V7: Greater than 101 In V8: Greater than 5000	14, 4	If the coordinates cannot fit into a single element, then they are grouped together into a complex shape element (type 14). This consists of a single type 14 element, followed by as many type 4 elements as required to hold all the coordinate data. The type 4 elements have their complex bit turned on. Furthermore, such a complex shape element will be split into multiple complex line string elements if the size of the data exceeds the maximum size that the header can address, which is approximately 65K words.

Number of
Coordinates

IGDS Element
Type

Description

In V7:

Between 3 and 101

In V8:

Between 3 and 5000

If the coordinates can fit in a single element, then an IGDS type 6 element is used to store the shape.

In V7:

Greater than 101

In V8:

Greater than 5000

14, 4

If the coordinates cannot fit into a single element, then they are grouped together into a complex shape element (type 14). This consists of a single type 14 element, followed by as many type 4 elements as required to hold all the coordinate data. The type 4 elements have their complex bit turned on. Furthermore, such a complex shape element will be split into multiple complex line string elements if the size of the data exceeds the maximum size that the header can address, which is approximately 65K words.

Shape elements have the following attributes:

Attribute Name	Notes	Version Info	Contents
igds_fill_color			The color used to fill the shape. This will override any solid fill linkage that may be present on the feature. Range: 0..255 Default: no fill
igds_fill_color.red	Reader only		The fill’s red color intensity, as determined by looking up the fill color index in the color table. Range: 0..255
igds_fill_color.green	Reader only		The fill’s green color intensity, as determined by looking up the fill color index in the color table. Range: 0..255
igds_fill_color.blue	Reader only		The fill’s blue color intensity, as determined by looking up the fill color index in the color table. Range: 0..255
igds_fill_angle1		used in V8 only	The angle of the primary hatch lines in a hatch fill. The angle is measured in degrees counterclockwise up from horizontal. Range: -360.0..360.0 Default: 0
igds_fill_angle2		used in V8 only	The angle of the secondary hatch lines in a hatch fill. The angle is measured in degrees counterclockwise up from horizontal. Range: -360.0..360.0 Default: 0
igds_fill_hole_style_id		used in V8 only	The style id of the holes of a filled area element. Default: 0
igds_fill_island_style_id		used in V8 only	The style id of the island areas of holes of a filled area element. Default: 0
igds_fill_offset_x		used in V8 only	The coordinate offset in the x dimension for the hatch or pattern fill of an area element. Range: Any real number Default: 0
igds_fill_offset_y		used in V8 only	The coordinate offset in the y dimension for the hatch fill of an area element. Range: Any real number Default: 0
igds_fill_offset_z		used in V8 only	The coordinate offset in the z dimension for the hatch or pattern fill of an area element. Range: Any real number Default: 0
igds_fill_pattern_color		used in V8 only	The color used to fill the area element. This corresponds to the color of the hatch or pattern fill linkage. Range: 0..2545
igds_fill_pattern color.red	Reader only	used in V8 only	The pattern_fill’s red color intensity, as determined by looking up the fill color index in the color table. Range: 0..255
igds_fill_pattern color.green	Reader only	used in V8 only	The pattern_fill’s green color intensity, as determined by looking up the fill color index in the color table. Range: 0..255
igds_fill_pattern color.blue	Reader only	used in V8 only	The pattern_fill’s blue color intensity, as determined by looking up the fill color index in the color table. Range: 0..255
igds_fill_pattern_type		used in V8 only	The type of pattern fill for an area element. This indicates the presence of a fill pattern on an area element. Currently only hatch fill is supported. Range: hatch Default: hatch
igds_fill_pixel_size		used in V8 only	The size of pixels for the hatch or pattern fill of an area element. Range: Any real number
igds_fill_rotation		used in V8 only	The rotation angle of the hatch or pattern fill within an area element. The rotation is measured in degrees counterclockwise up from horizontal. Range: -360.0..360.0 Default: 0
igds_fill_scale		used in V8 only	The scale of the hatch fill or pattern fill for an area element. Range: Any positive real number
igds_fill_snappable		used in V8 only	This flag indicates if the hatch or pattern fill for an area element is snappable. Range: yes or no Default: yes
igds_fill_spacing1		used in V8 only	The spacing between the primary hatch lines in a hatch fill. It is necessary for this or igds_fill_spacing2 to exist to define a hatch pattern. Range: Any real number > 0
igds_fill_spacing2		used in V8 only	The spacing between the secondary hatch lines in a hatch fill. It is necessary for this or igds_fill_spacing1 to exist to define a hatch pattern. Range: Any real number > 0
igds_fill_style_id		used in V8 only	The line style id of the hatch fill or pattern fill for an area element. Default: 0
igds_fill_tolerance		used in V8 only	The maximum distance between curved element boundaries and line segments in a hatch fill. Range: Any positive real number
igds_fill_weight		used in V8 only	The line weight of the hatch fill or pattern fill for an area element. Default: 0

Attribute Name

Notes

Version Info

Contents

igds_fill_color

The color used to fill the shape. This will override any solid fill linkage that may be present on the feature.

Range: 0..255

Default: no fill

igds_fill_color.red

Reader only

The fill’s red color intensity, as determined by looking up the fill color index in the color table.

Range: 0..255

igds_fill_color.green

Reader only

The fill’s green color intensity, as determined by looking up the fill color index in the color table.

Range: 0..255

igds_fill_color.blue

Reader only

The fill’s blue color intensity, as determined by looking up the fill color index in the color table.

Range: 0..255

igds_fill_angle1

used in V8 only

The angle of the primary hatch lines in a hatch fill. The angle is measured in degrees counterclockwise up from horizontal.

Range: -360.0..360.0

Default: 0

igds_fill_angle2

used in V8 only

The angle of the secondary hatch lines in a hatch fill. The angle is measured in degrees counterclockwise up from horizontal.

Range: -360.0..360.0

Default: 0

igds_fill_hole_style_id

used in V8 only

The style id of the holes of a filled area element.

Default: 0

igds_fill_island_style_id

used in V8 only

The style id of the island areas of holes of a filled area element.

Default: 0

igds_fill_offset_x

used in V8 only

The coordinate offset in the x dimension for the hatch or pattern fill of an area element.

Range: Any real number

Default: 0

igds_fill_offset_y

used in V8 only

The coordinate offset in the y dimension for the hatch fill of an area element.

Range: Any real number

Default: 0

igds_fill_offset_z

used in V8 only

The coordinate offset in the z dimension for the hatch or pattern fill of an area element.

Range: Any real number

Default: 0

igds_fill_pattern_color

used in V8 only

The color used to fill the area element. This corresponds to the color of the hatch or pattern fill linkage.

Range: 0..2545

igds_fill_pattern color.red

Reader only

used in V8 only

The pattern_fill’s red color intensity, as determined by looking up the fill color index in the color table.

Range: 0..255

igds_fill_pattern color.green

Reader only

used in V8 only

The pattern_fill’s green color intensity, as determined by looking up the fill color index in the color table.

Range: 0..255

igds_fill_pattern color.blue

Reader only

used in V8 only

The pattern_fill’s blue color intensity, as determined by looking up the fill color index in the color table.

Range: 0..255

igds_fill_pattern_type

used in V8 only

The type of pattern fill for an area element. This indicates the presence of a fill pattern on an area element. Currently only hatch fill is supported.

Range: hatch

Default: hatch

igds_fill_pixel_size

used in V8 only

The size of pixels for the hatch or pattern fill of an area element.

Range: Any real number

igds_fill_rotation

used in V8 only

The rotation angle of the hatch or pattern fill within an area element. The rotation is measured in degrees counterclockwise up from horizontal.

Range: -360.0..360.0

Default: 0

igds_fill_scale

used in V8 only

The scale of the hatch fill or pattern fill for an area element.

Range: Any positive real number

igds_fill_snappable

used in V8 only

This flag indicates if the hatch or pattern fill for an area element is snappable.

Range: yes or no

Default: yes

igds_fill_spacing1

used in V8 only

The spacing between the primary hatch lines in a hatch fill. It is necessary for this or igds_fill_spacing2 to exist to define a hatch pattern.

Range: Any real number > 0

igds_fill_spacing2

used in V8 only

The spacing between the secondary hatch lines in a hatch fill. It is necessary for this or igds_fill_spacing1 to exist to define a hatch pattern.

Range: Any real number > 0

igds_fill_style_id

used in V8 only

The line style id of the hatch fill or pattern fill for an area element.

Default: 0

igds_fill_tolerance

used in V8 only

The maximum distance between curved element boundaries and line segments in a hatch fill.

Range: Any positive real number

igds_fill_weight

used in V8 only

The line weight of the hatch fill or pattern fill for an area element.

Default: 0

Tip: Shapes will not be filled in MicroStation unless the "View Attributes: Fill" checkbox is ticked, and a fill color is specified.