The GTViewer format contains a variety of element types. The GTViewer format is designed to provide elements with different coordinate precisions to better utilize resources on platforms that are limited. While the format does support 16, 32, and 64 bit elements, only the 32 bit elements along with two 64 bit elements (arcs and ellipses) are supported by the Reader and Writer modules.
The GTViewer format also provides two different approaches for defining styles for the element display: Instance Based and Filter Based. Instance Based Symbology encodes specific style information on the element itself (color, weight, linestyle, etc.). Filter Based Symbology uses the Filter Id on the element to determine which Dynamic Style Rule to use when displaying the element. When using Filter Based Symbology, all elements with a particular Filter Id (in a given category) will have the same style (color, weight, symbol, font, etc.). The Filter Id is also used to determine which elements are displayed.
The following table lists all of the GTViewer Data Element types and type names used by the Reader and Writer modules:
|
gti_TypeID |
gti_type |
Description |
|---|---|---|
|
3 |
gti_group |
Aggregate, Composite Line, Composite Shape, Composite Shape with Holes. |
|
6 |
gti_data |
Data only element, no geometry. |
|
100 |
gti_point32 |
Single point element. |
|
101 |
gti_line32 |
Line consisting of 2 points. |
|
102 |
gti_lineString32 |
Line consisting of 2 or more points. |
|
103 |
gti_shape32 |
Closed Shape consisting of 3 or more points. |
|
104 |
gti_arc32 |
Elliptical Arc defined by a primary axis, secondary axis, start angle, sweep angle, and rotation. |
|
105 |
gti_circle32 |
Circle defined by an origin and radius. |
|
106 |
gti_ellipse32 |
Ellipse defined by a primary axis, secondary axis, and rotation. |
|
107 |
gti_text32 |
Text defined by string, origin, size, rotation, and justification. |
|
109 |
gti_symbol32 |
Oriented Point. |
|
110 |
gti_3pointArc32 |
Circular Arc defined by an origin, start point and end point. |
|
112 |
gti_dimension32 |
Two point line containing a dimension label. |
|
114 |
gti_shapeWithHoles32 |
Closed shape with one or more holes. |
|
204 |
gti_arc64 |
High precision elliptical Arc defined by a primary axis, secondary axis, start angle, sweep angle, and rotation. |
|
206 |
git_ellipse64 |
High precision ellipse defined by a primary axis, secondary axis and rotation. |
The following table describes all of the properties common to all GTViewer elements and are used by both the Reader and Writer modules:
|
Property |
FME Property Name |
Description |
Value Range |
|---|---|---|---|
|
Element Type Id |
gti_typeId |
Identifies the Type of Element |
3 – group 6 – data only 100 – point 32 101 – line 32 102 – line string 32 103 – shape 32 104 – arc 32 105 – circle 32 106 – ellipse 32 107 – text 32 109 – symbol 32 110 – 3 point arc 112 – dimension/leader line 114 – shape with holes 204 – arc 64 206 – ellipse 64 |
|
Filter Id |
gti_filterId |
Identifies the Filter Class an element belongs to. Filter Classes are used to determine which elements are displayed and how dynamic style rules are assigned. |
0 to 2499 |
|
Color Id |
gti_colorId |
The color ID of a color in the color table to use for the element. |
0 to 255 |
|
Linestyle Style Id |
gti_styleId |
The ID of a standard linestyle pattern to use for the element. |
0 to 7 |
|
Weight |
gti_weight |
The weight of the element |
0 to 15 |
|
Fill Flag |
gti_fill |
Determines if fillable elements (shape, ellipse, circle, composite shape, shape with holes) are filled or hollow. |
0 or 1 |
|
Extended Style |
gti_extendedStyle |
Defines an extended style for linear element, text, and group elements. Linear elements use the extended style ID as a user-defined linestyle ID. Text uses it as an extended text style (underline, strikethrough, box, rounded box). Group elements use it to identify the sub-elements as an aggregate, composite line, shape, or shape with holes. |
Linear Elements: UDLS id: 0 to 999
Text Elements: 0 – Regular Text 1 – Circle Box 2 – Square Box 3 – Underline 4 – Strikethrough
Group Elements: 0 – aggregate 1 – composite line 2 – composite shape 3 – composite shape with holes |
|
Embedded Data Type |
gti_embeddedDataType |
Embedded Data Type |
Value can be 1 (tabular data). Other embedded data types may be supported in the future. |
|
Embedded Data |
gti_embeddedData |
Embedded Tabular data (attribute/value pairs). |
String value of any size. |
|
Linkage |
gti_key1 gti_key2 |
A one or two key linkage used to associate a graphic element with a tabular record. The keys are unsigned 32 bit integer values. |
0 to max unsigned 32 bit integer. |
| Style Definition Id | gti_style_def_id | This attribute can be used to read or set the Style Definition Id. If the styleNameMap_byCat or styleNameMap_global Filter Creation modes are used, you should not set the gti_style_def_id since it will be set automatically. |
0 to max unsigned 32 bit integer. 0 means it is not used. |
The following format attributes can be used with specific elements:
|
Property |
FME Property Name |
Description |
Value Range |
|---|---|---|---|
|
gti_shape32, gti_ellipse32, gti_circle32, gti_shapeWithHoles32 |
gti_fill |
Determines if a shape, circle, or ellipse is to be filled or left empty. |
0 – not filled, 1 – filled |
|
gti_arc32, gti_arc64, gti_ellipse32, gti_ellipse64 |
gti_primary_axis |
The Primary Axis size for an arc or ellipse element. |
Unsigned long integer. |
|
gti_arc32, gti_arc64, gti_ellipse32, gti_ellipse64 |
gti_secondary_axis |
The Primary Axis size for an arc or ellipse element. |
Unsigned long integer. |
|
gti_arc32, gti_arc64 |
gti_start_angle |
The start angle for an arc. |
Angle in degrees. |
|
gti_arc32, gti_arc64 |
gti_sweep_angle |
The sweep angle for an arc. |
Angle in degrees. |
|
gti_arc32, gti_arc64, gti_ellipse32, gti_ellipse64, gti_text32 |
gti_rotation |
The rotation angle for various elements. |
Angle in degrees. |
|
gti_text32 |
gti_text_string |
The text string |
String value. |
|
gti_text32 |
gti_text_heightMult |
The text height multiplier. |
Unsigned Long. |
|
gti_text32 |
gti_text_font |
The ID of the font to use for the text element. |
0 to 255. |
|
gti_text32 |
gti_text_justification |
The text justification value to use with the text element. |
0 – default (bottom/left) 100 – bottom/left 101 – center/left 102 – top/left 103 – bottom/center 104 – center/center 105 – top/center 106 – bottom/right 107 – center/right 108 – top/right |
|
gti_text32 |
gti_text_multiline_dir |
For text with multiple lines, the direction of the lines can be change from top to bottom to bottom to top. The default is top to bottom. |
-1 – bottom to top 1 – top to bottom |
|
gti_text32 |
gti_text_multiline_ |
The spacing of the lines default to 1.4 times the individual line height. This factor can be changed with this attribute. |
Floating point value. |
|
gti_shapeWithHoles32 |
gti_fill_colorId |
The color ID of the shape’s fill. If not defined, this color will be the element color. |
0 to 255. |