In addition to the generic FME feature attributes that FME Workbench adds to all features (see About Feature Type Attributes), this format also adds format-specific attributes (Format Attributes).
WhiteStar entities define polylines, polygons, and labels (text). Each FME feature can represent an aggregate of polylines, an aggregate of polygons, or a single label. The feature type of a WHITESTAR feature will be one of the values LINE, POLYGON, or TEXT, to specify which type of geometry is being represented.
All WhiteStar features have the following attributes defined:
|
Attribute Name |
Value |
|---|---|
|
wht_type |
Specifies what type of data the feature is representing. Established values are: wht_polyline, wht_polygon, and wht_label. |
|
wht_entity_type |
This attribute holds the string that is placed on the entity header. By default this is POLYLINE or TEXT, but the writer will output this attribute’s value if it is specified. |
|
wht_major_code |
Major attribute code from entity header corresponding to the feature. Range: 0..999 |
|
wht_minor_code |
Minor attribute code from entity header corresponding to the feature. Range: 0..9999 |
When writing WhiteStar data, default values are supplied for wht_major_code and wht_minor_code when needed. The value for wht_major_code defaults to “200” (“manmade”), and wht_minor_code defaults to a value of “0300”, “0100”, or “0200”, depending on the geometry type (point, area, and line, respectively).
In addition to the above, label features have additional attributes. The following sections describe the structure of each type of WhiteStar feature.
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/ |
|---|---|---|
|
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.
Lines
wht_type: wht_polyline
WhiteStar polyline features contain either a single line or an aggregate of lines. When reading a WhiteStar entity, the reader will aggregate all linear elements for a single entity into one LINE feature. Similarly, the writer will put all lines contained in a single LINE feature into one entity in the output WhiteStar file.
The “implied closure” flag of the entity header will always be reflected in the feature type of the feature representing the entity. If the flag is set to “0” in an input WhiteStar file, LINE features will be generated. Conversely, LINE entities are written with the “implied closure” flag in the entity header set to a value of “0”.
Polygons
wht_type: wht_polygon
WhiteStar polygon features contain either a single polygon or an aggregate of polygons. When reading a WhiteStar entity, the reader will aggregate all linear elements for a single entity into one POLYGON feature. Similarly, the writer will put all lines contained in a single POLYGON feature into one entity in the output WhiteStar file.
The “implied closure” flag of the entity header will always be reflected in the feature type of the feature representing the entity. If the flag is set to “1” in an input WhiteStar file, LINE features will be generated. Conversely, POLYGON entities are written with the “implied closure” flag in the entity header set to a value of “1”.