GTViewer Elements
The GTViewer data format contains a variety of element types.
The format also provides two different approaches for defining styles for the element display:
-
Instance Based Symbology – Encodes specific style information on the element itself (color, weight, linestyle, etc.).
-
Style Based Symbology – Uses an element's Filter Id or a Style Id to determine the Style Definition to use when displaying the element. When using Style Based Symbology, all elements with a particular Filter Id (in a given category) or Style Id will have the same style (color, weight, symbol, font, etc.). The Filter Id is also used to control which elements are displayed.
With the GTI GTViewer writer, you will usually choose to either use the Filter Id or the Style Id approach to Style Based Symbology. The Filter Creation Mode parameter determines the method that will be used.
GTViewer Data Element Types
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. |
GTViewer Data Element Properties
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 style definitions are assigned. |
0 to 2499 |
|
Color Id |
gti_colorId |
The color ID of a color in the color table (color.txt) to use for the element. If a Style Definition is used, it will override the element's color id. |
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 is thinner; 15 is thicker. |
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). It must use the GTViewer /t/a/v format. |
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. |
GTViewer Data Element Format Attributes
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 changed 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. |