Labels

wht_type: wht_label

WhiteStar TEXT features contain a single text label. When reading a WhiteStar entity, the reader will create a separate TEXT feature for each label in the entity. Similarly, the writer will create a single entity for each TEXT feature written.

The TEXT feature geometry consists of a single point to specify the location of the text. The following attributes are also present on TEXT features.

Attribute Name

Value

Required/
Optional

wht_label_string

Text of label entity. This is an alphanumeric character string of up to 212 characters.

Default: “”

Optional

wht_label_length

Length of label text, in characters.

Default: length of wht_label_string’s value.

Optional

wht_label_height

Height of the label text. This is an integer, and is interpreted according to the value of wht_label_units.

Range: 0-99999

Default: 10

Optional

wht_label_units

Units by which to interpret the value of wht_label_height. Valid values are “L” for lat/long, “M” for metres, “F” for feet, “R” for relative, or “O” for other projection code.

Default: 10

Optional

wht_label_angle

Angle by which text is rotated about its point. This is measured in degrees counterclockwise.

Range: 0-360

Default: 01G/

Optional

wht_label_orientation

Flag to indicate whether the text is more vertical (value of “V”) or horizontal (value of “Z”). This is always computed at the time of writing.

Computed

wht_label_horijust

Horizontal justification of the string. Valid values are “L” for left-justified, “C” for centre-justified, or “R” for right-justified.

Default: “C”

Optional

wht_label_vertjust

Vertical justification of the string. Valid values are “T” for top-justified, “C” for centre-justified, or “B” for bottom-justified.

Default: “C”

Optional

Note that the attribute wht_label_angle specifies the rotation as a counterclockwise number, contrary to the value which is actually placed in the WhiteStar label record.