Text Nodes

igds_type: igds_text_node

Text nodes correspond to IGDS element type 7.

Text node features are point features, and only have a single coordinate. Usually, text nodes are used to group together lines of text into a single complex element. However, such text groups are handled by the igds_multi_text type and not by this type, which is used only for text nodes with no attached text.

Tip  Free-standing text nodes are often used as point features in IGDS files, with the text node number holding a key to related attribution.

Text node elements have the following attributes.

Attribute Name

Description

igds_font

The IGDS font number for the text node. For free standing text nodes, this value is relatively meaningless. Values from 0..511 are RSC fonts, while values from 512..1023 are SHX font, and values above 1023 are True Type fonts.

Range: 0

Default: 25

igds_justification

The justification code for the text node.

Range: 0..14

0 is Left/Top 8 is Center/Bottom

1 is Left/Center 9 is Right Margin/Top

2 is Left/Bottom 10 is Right Margin/Center

3 is Left Margin/Top 11 is Right Margin/Bottom

4 is Left Margin/Center 12 is Right/Top

5 is Left Margin/Bottom 13 is Right/Center

6 is Center/Top 14 is Right/Bottom

7 is Center/Center

Default: 5

igds_line_spacing

The line spacing between lines of text associated with the text node. It is measured in ground units.

Range: Any real number > 0

Default: 0

igds_max_string_length

The maximum length of the strings associated with the text node.

Range: integer >= 0

Default: 255

igds_max_used_string_
length

The actual length of the strings associated with the text node.

(Not included in Version 8 DGN files.)

Range: integer >= 0

Default: 0

igds_node_number

The node number assigned to the text node.

Range: 0..65535

Default: 0

igds_number_of_strings

The number of text elements associated with the text node. If the number is greater than 0, then the text node is returned as an igds_multi_text.

This is only used by the IGDS reader.

Range: integer >= 0

Default: Not applicable.

igds_rotation

The rotation of the text node. The rotation is measured in degrees counterclockwise up from horizontal. For free standing text nodes, this value is relatively meaningless.

Range: -360.0..360.0

Default: 0

igds_text_size

The text size of the text in the node. This is stored as the text height in the element. The text size is measured in ground units.

Range: Any real number > 0

Default: 20

igds_text_width_
multiplier

The text width of the text in the node. The text width is measured in ground units. If this is not supplied, then igds_text_size is used.

Range: Any real number > 0

Default: Value of igds_text_size

Tip  When a text node feature is reprojected, its rotation and text size are also automatically adjusted to be correct in the new coordinate system.