Label Style Config¶

The LabelStyleConfig file defines named label styles — the appearance, position, and text content of point labels. Styles defined here are referenced by name in the PointStyleConfig via Label, LabelIf, and LabelElse entries.

Unlike the other config files, this file is global — shared across all configurations:

%APPDATA%\SpatialViz\Labels\LabelStyleConfig.txt

File format¶

Each style is a named block:

STYLE_NAME
  HeightMm    = 2.2
  WidthMm     = 0
  OffsetX     = 1.5
  OffsetY     = 0
  RotationDeg = 0
  Just        = ML
  Line        = [H:0.00]

Multiple Line entries produce a multi-line label.

Property	Description
`HeightMm`	Text height in mm on the plotted sheet (auto-scaled to model units)
`WidthMm`	Text box width in mm; `0` = no wrapping
`OffsetX`	Horizontal offset from the point in mm
`OffsetY`	Vertical offset from the point in mm
`RotationDeg`	Label rotation in degrees
`Just`	Justification: `TL` `TC` `TR` `ML` `MC` `MR` `BL` `BC` `BR`
`Line`	One line of label text (repeat for multi-line)

Tokens¶

Use tokens in Line entries to insert point data. Both [TOKEN] and {TOKEN} syntax are accepted.

Token	Value
`[H]` or `[H:0.00]`	Elevation (format string optional)
`[C]`	Survey code
`[P]`	Point number
`[E]`	Easting
`[N]`	Northing
`[A1]`–`[A8]`	Attribute values

The format string after : follows standard .NET numeric format notation (0.00, 0.###, etc.).

Reserved style names¶

Name	Behaviour
`HIDE`	Suppresses the label entirely
`H`	Default elevation label — used as fallback when a named style is not found

Examples (from LabelStyleConfig.txt)¶

Elevation only¶

H
  HeightMm = 2.2
  OffsetX  = 1.5
  Just     = ML
  Line     = [H:0.00]

Benchmark with ID and elevation¶

BM_A1A2+H_RL_(AHD)
  HeightMm = 2.2
  OffsetX  = 1.5
  Just     = ML
  Line     = BM [A1] [A2]
  Line     = RL [H:0.00]
  Line     = (AHD)

Elevation with suffix¶

H_TW
  HeightMm = 2.2
  OffsetX  = 1.5
  Just     = ML
  Line     = [H:0.00]TW

Elevation with attribute appended¶

H{A1}
  HeightMm = 2.2
  OffsetX  = 1.5
  Just     = ML
  Line     = [H:0.00][A1]

Tree label (multi-attribute, offset above point)¶

TREE
  HeightMm = 2.5
  OffsetX  = 1.5
  OffsetY  = 1.5
  Just     = BL
  Line     = [A1]/[A2]/[A3]

This produces a label like 14/0.5/Gum from canopy radius / trunk diameter / species.

Pole label (stacked, offset above symbol)¶

A1_POLE
  HeightMm = 2.5
  OffsetX  = 0
  OffsetY  = 3.0
  Just     = TL
  Line     = [A1]
  Line     = POLE

Hidden label¶

HIDE
  HeightMm = 2.2
  OffsetX  = 0
  OffsetY  = 0
  Just     = ML

HIDE has no Line entries — the label is suppressed.

How styles are referenced¶

In PointStyleConfig, reference a style by name:

TR
  Label    = TREE            # always use TREE style
  LabelIf A4 = Bottom => H  # use H style when A4 = Bottom

POLE
  LabelIf A2 = Mid => A1_POLE
  LabelElse         => HIDE

If a referenced style name does not exist in LabelStyleConfig, R3Survey falls back to the built-in H style (elevation only).