guide:help:dkbuiltin:tgis_controllegendform_vector
Table of Contents
Vector Layer
Documentation | Help File | Layer Properties Control | Vector layer
This is a description of the Layer Properties dialog box layout specific to vector layers. Use it to set colors, sizes, and labels for points, lines, and polygons.
Operations
List of all operation based on items in a left panel.
General
The General node covers general information about the layer.
| Name | Description |
|---|---|
| Ignore shape params | If checked, visual properties embedded into some formats like DXF, DWG, MIF will be ignored, and full visual appearance will be set only by layer properties control. |
| Multipass rendering | By default sections are processed in a last-recently-used order to improve the speed. Therefore the order of sections is irrelevant. Check this option if the order of processing is important (eg. section first specifies road outline, then roads inside for a nice road junction rendering. See also DK11 doc. |
| From Code Page | Program always uses Unicode. However, some layers are not encoded in Unicode. This option provides a possibility to change layer encoding. Some layers (like DXF) will require reopening projects to acknowledge code page change. |
| Other parameters are common and are described here. | |
| Aggregation | |
|---|---|
| Name | Description |
| Method | Method of aggregation that is going to be used for this layer. |
| Radius | Radius within which shapes will be grouped; use similar as Size from Params section. Using Param asText syntax is preferred. |
| Threshhold | Minimum number of shapes to form a group. |
| More in depth guide regarding aggregation is described here. | |
Sections
The Sections node summarizes information about sections visibility (active scale, query-based visibility).
Section
The Section node contains subnodes for specific layer properties.
| Name | Description |
|---|---|
| Render if match… | An SQL like expression to set section activity. More about expression syntax can be found at SQL filter syntax |
| Legend | Section name to be displayed in legend control. |
| Other parameters are common and are described here. | |
Renderer
The Renderer node contains all properties to specify rendering based on the attribute field.
A user can define two zones of rendering. For example to define one zone for altitude below sea levels and the other, using a different set of colors, for altitudes above sea level.
If any zone is defined then colors, line widths, and symbol sizes used to define marker, line, area, label, and chart appearance can be set to use Renderer. Then instead of static assignment a dynamic value form the renderer will be used.
| Renderer | |
|---|---|
| Name | Description |
| Render Expression | Value based on which colors/sizes will be computed. It can be a field name or even basic formula like MEN/POPULATION. Existing fields can be selected from the drop-down list. |
| Round | Rounding for Render formula. = 0 - no rounding, > 0 = digits after decimal point < 0 - digits before decimal point |
| First | |
| Name | Description |
| Number of zones | To enable First rendering zone value must be <> 0. Rendering sizes/values are always smooth, but number of zones defines how many entries in a legend will be created = 0 - disabled > 0 - normal ramp < 0 - logarithmic ramp |
| Minimum value | Minimum value of Render expression to be used as a start value to create a rendering ramp. |
| Maximum value | Maximum value of Render expression to be used as a start value to create a rendering ramp. |
| Start color | Start color to represent the Minimum value. Select color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color or Define color to define own color |
| End color | End color to represent the Maximum value. Select color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color or Define color to define own color |
| Default color | Default color to represent values outside the zone created by the Minimum value and the Maximum value. Select color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color or Define color to define own color |
| Start size | Start size to represent the Minimum value. Select size from the list of predefined sizes. This combo-box also provides access to Use field values to select attribute field and use it as a size or Define custom values to define own size |
| End size | End size to represent the Maximum value. Select marker size from the list of predefined patterns. This combo-box also provides access to Use field values to select attribute field and use it as a symbol size, Define custom values to define own symbol size, or to use size defined by Renderer |
| Default size | Default size to represent values outside the zone created by the Minimum value and the Maximum value. Select marker size from the list of predefined patterns. This combo-box also provides access to Use field values to select attribute field and use it as a symbol size, Define custom values to define own symbol size, or to use size defined by Renderer |
| Second | |
| Name | Description |
| Number of zones | To enable First rendering zone value must be <> 0. Rendering sizes/values are always smooth, but number of zones defines how many entries in a legend will be created = 0 - disabled > 0 - normal ramp < 0 - logarithmic ramp |
| Minimum value | Minimum value of Render expression to be used as a start value to create a rendering ramp. |
| Maximum value | Maximum value of Render expression to be used as a start value to create a rendering ramp. |
| Start color | Start color to represent the Minimum value. Select color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color or Define color to define own color |
| End color | End color to represent the Maximum value. Select color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color or Define color to define own color |
| Default color | Default color to represent values outside the zone created by the Minimum value and the Maximum value. Select color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color or Define color to define own color |
| Start size | Start size to represent the Minimum value. Select size from the list of predefined sizes. This combo-box also provides access to Use field values to select attribute field and use it as a size or Define custom values to define own size |
| End size | End size to represent the Maximum value. Select marker size from the list of predefined patterns. This combo-box also provides access to Use field values to select attribute field and use it as a symbol size, Define custom values to define own symbol size, or to use size defined by Renderer |
| Default size | Default size to represent values outside the zone created by the Minimum value and the Maximum value. Select marker size from the list of predefined patterns. This combo-box also provides access to Use field values to select attribute field and use it as a symbol size, Define custom values to define own symbol size, or to use size defined by Renderer |
Marker
The Marker node contains all properties to specify visual appearance of points.
| Marker | |
|---|---|
| Name | Description |
| Style | Select symbol like a box, a circle, a cross, etc. from the list of predefined symbols. This combo-box also provides access to Select symbol to select a symbol from the file or built-in symbol library. |
| Color | Select color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color, Define color to define own color, or use color defined by Renderer |
| Pattern | Select fill pattern from the list of predefined patterns. This combo-box also provides an option to Select bitmap file to be used as a pattern. |
| Size | Select marker size from the list of predefined sizes. This combo-box also provides access to Use field values to select attribute field and use it as a symbol size, Define custom values to define own symbol size, or to use size defined by Renderer |
| Symbol rotate | Select rotation from the list of predefined angles. This combo-box also provides access to Use field values to select attribute field as an angle, and Define custom values to define own angle. |
| Smart size | This option defines a minimum visible size of a shape to be presented on a map. Elimination o very small shapes can drastically improve rendering speed. Select size for the list of predefined sizes. This combo-box also provides access to Use field values to select the attribute field and use it as a smart size or use Define custom values to define own symbol size. NOTE Point shape has no size so only use of attribute field is meaningful. However, multipoint, if really contains multiple points has a size > 0. |
| Outline | |
| Name | Description |
| Style | Select line style from the list of predefined styles. This combo-box also provides access to Use field values to select style select attribute field as style name. |
| Color | Select color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color, Define color to define own color, or use color defined by Renderer |
| Pattern | Select fill pattern from the list of predefined patterns. This combo-box also provides an option to Select bitmap file to be used as a pattern. |
| Width | Select size from the list of predefined patterns. This combo-box also provides access to Use field values to select attribute field and use it as an outline with, Define custom values to define own outline width or use-value defined by Renderer |
| Others | |
| Name | Description |
| Include in legend | If checked, then the marker icon will be displayed in the legend control. |
Not all properties are active in every situation. For example, an outline cannot be used for built-in symbols, while rotation is available to all symbols except built-in.
Line
The Line node contains all properties to specify visual appearance of lines.
| Line | |
|---|---|
| Name | Description |
| Style | Select line style from the list of predefined styles. This combo-box also provides access to Line Symbol Editor to define line style symbology, Select symbol to select line symbol from the file or built-in symbol library, Use field values to select attribute field as line style name. |
| Color | Select line color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB line color, Define color to define own line color, or use color defined by Renderer. |
| Pattern | Select line pattern (pattern to fill line body) from the list of predefined patterns. This combo-box also provides an option to Select bitmap file to be used as a line pattern. |
| Width | Select line width from the list of predefined widths. This combo-box also provides access to Use field values to select attribute field and use it as a line width, Define custom values to define own line width, or to use value defined by Renderer |
| Symbol gap | Select line symbol gap (distance between the symbol on a line) from the list of predefined gap distances. This combo-box also provides access to Use field values to select an attribute field as a line symbol gap distance. Active only for lines defined with symbols. |
| Symbol rotate | Select a line rotation from the list of predefined angles. This combo-box also provides access to Use field values to select attribute field as a line symbol rotation, and Define custom values to define own line symbol rotation angle. Active only for lines defined with symbols. |
| Smart size | This option defines a minimum visible size of a shape to be presented on a map. Elimination o very small shapes can drastically improve rendering speed. Select size for the list of predefined sizes. This combo-box also provides access to Use field values to select the attribute field and use it as a smart size or use Define custom values to define own symbol size. |
| Outline | |
| Name | Description |
| Style | Select outline style from the list of predefined styles. This combo-box also provides access to Use field values to select style select attribute field as an outline style name. |
| Color | Select outline from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB outline, Define color to define own outline color, or use color defined by Renderer. |
| Pattern | Select fill pattern from the list of predefined patterns. This combo-box also provides an option to select bitmap file to be used as an outline pattern. |
| Width | Select outline width from the list of predefined widths. This combo-box also provides access to Use field values in order to select attribute field and use it as a width, Define custom values to define own outline width, or use value defined by Renderer. |
| Others | |
| Name | Description |
| Include in legend | If checked, then the line icon will be displayed in the legend control. |
Area
The Area node contains all properties to specify polygons' visual appearance.
| Area | |
|---|---|
| Name | Description |
| Style | Select fill symbol like a box, a circle, a cross, etc. from the list of predefined symbols. This combo-box also provides access to Select symbol to select fill symbols form the file or built-in symbol library. |
| Color | Select fill color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB fill color, Define color to define own color, or use fill color defined by Renderer . |
| Pattern | Select fill pattern from the list of predefined patterns. This combo-box also provides an option to Select bitmap file to be used as a are fill pattern. |
| Symbol Size | Select fill symbol size from the list of predefined patterns. This combo-box also provides access to Use field values to select attribute field and use it as a symbol size, Define custom values to define own size, or to use value defined by Renderer. |
| Symbol gap | Select fill symbol gap (distance between symbols) from the list of predefined gap distances. This combo-box also provides access to Define custom values to define own symbol gap distance. |
| Symbol rotate | Select fill symbol rotation from the list of predefined angles. This combo-box also provides access to Use field values to select attribute field as an angle, and Define custom values to define own symbol rotation angle. |
| Smart size | This option defines a minimum visible size of a shape to be presented on a map. Elimination o very small shapes can drastically improve rendering speed. Select size for the list of predefined sizes. This combo-box also provides access to Use field values to select the attribute field and use it as a smart size or use Define custom values to define own symbol size. |
| Outline | |
| Name | Description |
| Style | Select outline style from the list of predefined styles. This combo-box also provides access to Line Symbol Editor to define line style symbology, Select symbol to select outline symbol from the file or built-in symbol library, Use field values to select style select attribute field as outline style name. |
| Color | Select outline color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB outline, Define color to define own outline color, or use color defined by Renderer |
| Pattern | Select outline pattern (pattern to fill line body) from the list of predefined patterns. This combo-box also provides an option to Select bitmap file to be used as an outline pattern. |
| Symbol gap | Select outline symbol gap (distance between symbols on an outline) from the list of predefined gap sizes. This combo-box also provides access to Define custom values to define own outline symbol gap distance. |
| Symbol rotate | Select outline symbol rotation from the list of predefined angles. This combo-box also provides access to Define custom values to define own line symbol rotation angle. |
| Width | Select size from the list of predefined patterns. This combo-box also provides access to Use field values to select attribute field and use it as an outline width, Define custom values to define own outline width or use value defined by Renderer |
| Others | |
| Name | Description |
| Include in legend | If checked, then the area icon will be displayed in the legend control. |
Label
| Value | |
|---|---|
| Name | Description |
| Value | Select the field to use from label form the list of available attribute fields. Labeling allows HTML formatting, using more than one field, etc. For details refer to: Value label formatting. |
| Visible | If unchecked then the label will not be drawn. This is a convenient way to define label appearance but temporarily turns it off. |
| Avoid overlap | If checked then labels will not overlap. |
| Avoid duplicates | If checked then labels with the same content will be drawn only once. |
| Font | |
| Name | Description |
| Name | Select font name form the list of available fonts. |
| Size | Select font size from the list of predefined sizes. This combo-box also provides access to Use field values to select attribute field and use it as a symbol size, Define custom values to define own font size, or to use size defined by Renderer |
| Color | Select font color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color, Define color to define own color, or use color defined by Renderer |
| Bold | If checked then label text will be bold. |
| Underline | If checked then label text will be underline. |
| Italic | If checked then label text will be italic. |
| Strikeout | If checked then label text will be strikeout. |
| Shadow | If checked then label color will be drawn without solid shield, and label color will be used to draw a shadow around label text. To draw labels without shield and visible shadow select same the color for the label color and the font color. |
| Label | |
| Name | Description |
| Color | Select background color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color, Define color to define own color, or use color defined by Renderer |
| Pattern | Select background fill pattern from the list of predefined patterns. This combo-box also provides an option to Select bitmap file to be used as a pattern. |
| Width | Select maximum label width from a list of predefined size. This combo-box also provides access to Define custom values to define own width. |
| Height | Select maximum label height from a list of predefined size. This combo-box also provides access to Define custom values to define own width. |
| Smart size | This option defines a minimum visible size of a shape to be presented on a map. Elimination o very small shapes can drastically improve rendering speed. Select size for the list of predefined sizes. This combo-box also provides access to Use field values to select the attribute field and use it as a smart size or use Define custom values to define own symbol size. |
| Outline | |
| Name | Description |
| Style | Select line style from the list of predefined styles. This combo-box also provides access to Use field values to select style select attribute field as a style name. |
| Color | Select color from a list of predefined colors. This combo-box also provides access to Use field values to select attribute field with ARGB color, Define color to define own color, or use color defined by Renderer |
| Pattern | Select fill pattern from the list of predefined patterns. This combo-box also provides an option to Select bitmap file to be used as a pattern. |
| Width | Select size from the list of predefined patterns. This combo-box also provides access to Use field values to select attribute field and use it as an outline with, Define custom values to define own outline width or use value defined by Renderer |
| Position | |
| Name | Description |
| Alignment | Select label alignment from: - Single line - align label in single line - Left Justify - align label text to left - Center - center label text - Right Justify - align label text to right - Follow - only for lines, label will be placed along the line |
| Flow | If checked then the label will be forced to be visible even if shape centroid is outside the visible extent. |
| Label Rotate | Select label rotation from the list of predefined angles. This combo-box also provides access to Use field values to select attribute field as an angle, and Define custom values to define own angle. |
| Position | Check to define which position relative to label anchor (normally shape centroid) are allowed. Selecting […] provides access to Use field values to select attribute field as a position text value. |
| Others | |
| Include in legend | If checked, then the label icon will be displayed in the legend control. |
Chart
The Chart node contains all properties to define charts.
| Chart | |
|---|---|
| Name | Description |
| Style | Select BAR or PIE chart |
| Minimum value | Used for BAR charts to define bottom value. |
| Maximum value | Used for BAR charts to define top value. |
| Size | Select chart size from the list of predefined patterns. This combo-box also provides access to Define custom values to define own chart size, or to use value defined by Renderer |
| Value | |
| Name | Description |
| Value | Value to be used. Can be just a number, a field name or even basic formula like MEN/POPULATION |
| Legend | Name to be presented in the legend control |
| Color | Clicking on color box brings Define color to define own color |
| Name | Description |
| Include in legend | If checked, then chart icon will be displayed in the legend control. |
3D
The 3d node contains all properties to specify vector layer behavior in 3D.
Treat layer as 2D
Shapes will be drawn flat on a texture that can be then wrapped on the underlying DEM model (if any).
Treat layer as Elevation Model
Shapes represent DEM (for example triangulated network).
| Name | Description |
|---|---|
| Normalized Z | If checked value will be normalized based on current view. This option is useful if values does not represent altitude but some artificial value (eg. statistical values) - values will altered so presentation on 3D will be possible. |
| Scale Z | Scale Z value of a shape vertices by provided percentage. |
| False Z | Fixed value to be added shape vertices Z coordinate. This combo-box also provides access to Use field values to select attribute field with false Z value or Define color to define own. |
Treat layer as 3D objects
Shapes 3D information (ZM) will be used (like building heights, etc.).
| Name | Description |
|---|---|
| Normalized Z | If the checked value will be normalized based on the current view. This option is useful if values do not represent altitude but some artificial value (eg. statistical values) - values will alter so presentation on 3D will be possible. |
| Scale Z | Scale Z value of a shape vertices by provided percentage. |
| False Z | Fixed value to be added shape vertices Z coordinate. This combo-box also provides access to Use field values to select attribute field with false Z value or Define color to define own. |
| Normalized M | If the checked value will be normalized based on the current view. This option is useful if values do not represent altitude but some artificial value (eg. statistical values) - values will alter so presentation on 3D will be possible. |
| Scale M | Scale M value of a shape vertices by provided percentage. |
| False M | Fixed value to be added shape vertices M coordinate. This combo-box also provides access to Use field values to select attribute field with false M value or Define color to define own. |
| Adjust Z | relative to 0 - Z values are absolute relative to DEM - Z value is added to underlying DEM model equal DEM - Z value is substituted with the value form the underlying DEM model |
| Adjust basement | If select lowest then the shape will be set on DEM in the lowest point of DEM covered by shape. This option is useful for imprecise data to guarantee that buildings are not flying over the ground. |
Wizard
The Wizard button brings a simple wizard to create rendering automatically. Please refer to Rendering Wizard.
Units
Units used in some combo-boxes have a special meaning.
Linear units
| Unit | Device independent | Scalable | Description |
|---|---|---|---|
| px | pixel | ||
| dip | ✔ | pixel, equals to pixels size at 96dpi | |
| twips | ✔ | twips, equals to 1/1440 of inch | |
| pt | ✔ | point, equals to 1/72 of inch | |
| mm | ✔ | ✔ | milimeter |
| cm | ✔ | ✔ | centimeter |
| m | ✔ | ✔ | meter |
| km | ✔ | ✔ | kilometer |
| in | ✔ | ✔ | inch |
| yd | ✔ | ✔ | yard (us) |
| mi | ✔ | ✔ | land mile (US) |
| nm | ✔ | ✔ | nautical mile |
Where
- Device independent means that size will maintain independent of a device: a low-res monitor, a 4K monitor or a printer, sizes will always be the same.
- Scalable means that if the scale is 1:1 and for example line with was define as a 1cm then on a monitor or a printer line will be drawn with 1cm width. If the scale is 1:2 then a line will be drawn as 0.5 cm.
Angular units
| Unit | Description |
|---|---|
| deg | degree |
| rad | radian |
2020/03/09 12:53