GTViewer Elements

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_
spacing

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.