Point Label Rules

The PointLabelRules file controls the descriptive text labels placed on survey strings — the annotation that identifies what each string represents (e.g. CONCRETE DRIVEWAY, TIMBER FENCE, SMH). This is separate from the elevation or code labels controlled by PointStyleConfig and LabelStyleConfig.

The file is located at: %APPDATA%\SpatialViz\PointLabelRules\<ConfigName>_PointLabelRules.json

It is a JSON file and is per-configuration.

Structure

{
  "ConfigName": "R3Survey2025",
  "TextCase": "Upper",
  "Rules": [
    {
      "Code": "CODENAME",
      "Match": {},
      "Layer": "LAYER-LABELS",
      "Text": ["Label line 1", "Label line 2"],
      "TextShort": ["Short label"],
      "Children": []
    }
  ]
}

Top-level fields

Field	Description
ConfigName	Must match the configuration name
TextCase	"Upper" (all caps), "Lower", or "None" (as written)
Rules	Array of label rules, one per survey code

Rule fields

Field	Description
Code	Survey code this rule applies to
Match	Attribute conditions that must be true (empty {} = always match)
Layer	CAD layer for the label entity
Text	Array of label lines (long form)
TextShort	Array of label lines (short form — used where space is limited)
Children	Array of override rules evaluated after the base rule

Tokens

Use {TOKEN} placeholders in Text and TextShort values:

Token	Value
{A1}–{A8}	Attribute values
{H} or {H:0.00}	Elevation

How rules are resolved

1. Find the base rule matching the survey code.
2. Walk the Children array — the first child whose Match conditions are all satisfied is applied.
3. If a matching child is found, its Layer, Text, and TextShort override the base rule's values (any field not present in the child is inherited from the base).
4. Children can themselves have children — resolution continues depth-first until no further match is found.
5. Token placeholders are then expanded.
6. TextCase is applied last.

Examples (from R3Survey2025 configuration)

Simple code label

{
  "Code": "MH",
  "Match": {},
  "Layer": "SEWER-TEXT",
  "Text": ["SMH"],
  "Children": []
}

All MH points get the label SMH on the SEWER-TEXT layer.

Label driven by attribute

{
  "Code": "DY",
  "Match": {},
  "Layer": "HARDSTAND-TEXT",
  "Text": ["{A2} DRIVEWAY"],
  "TextShort": ["{A2} D'WAY"],
  "Children": []
}

A DY point with A2 = Concrete produces the label CONCRETE DRIVEWAY (after TextCase = Upper is applied).

Conditional label via children

{
  "Code": "KERB",
  "Match": {},
  "Layer": "RD-KB-LABELS",
  "Text": ["{A5} KERB"],
  "Children": [
    { "Match": { "A4": "Vehicle Xing" }, "Text": ["VEHICLE XING"] },
    { "Match": { "A2": "Pram Xing" }, "Text": ["KERB RAMP"], "TextShort": ["RAMP"] }
  ]
}

• If A4 = Vehicle Xing → label is VEHICLE XING
• If A2 = Pram Xing → label is KERB RAMP (or RAMP in short form)
• Otherwise → label is {A5} KERB (e.g. CONCRETE KERB)

Conditional layer change via children

{
  "Code": "BLD",
  "Match": {},
  "Layer": "BUILDINGS-LABELS",
  "Text": ["{A6} {A2}"],
  "Children": [
    { "Match": { "A5": "Lower Ground" }, "Layer": "BUILDINGS_LG-LABELS" },
    { "Match": { "A5": "Ground", "A2": "House" }, "Layer": "BUILDINGS_G-LABELS", "Text": ["{A6} RESIDENCE"] },
    { "Match": { "A5": "Ground" }, "Layer": "BUILDINGS_G-LABELS" },
    { "Match": { "A5": "L1" }, "Layer": "BUILDINGS_L1-LABELS" }
  ]
}

The text is inherited from the base rule; only the layer changes per floor level. The Ground/House child also overrides the text to {A6} RESIDENCE.

Multi-line label

{
  "Code": "BANK",
  "Match": {},
  "Layer": "TOPOGRAPHY-TEXT",
  "Children": [
    { "Match": { "A2": "Bottom" }, "Text": ["BOT", "OF", "BANK"] },
    { "Match": { "A2": "Top" }, "Text": ["TOP", "OF", "BANK"] }
  ]
}

Each element of the Text array is a separate line. The base rule has no Text (no label for unrecognised A2 values).

Pipe label with diameter and material

{
  "Code": "PI",
  "Match": {},
  "Layer": "DRAINAGE_LABELS",
  "Text": ["{A3}%%c PIPE"],
  "Children": [
    { "Match": { "A4": "PVC" }, "Text": ["{A3}%%c PVC PIPE"] },
    { "Match": { "A4": "Concrete" }, "Text": ["{A3}%%c RCP"] }
  ]
}

%%c is the AutoCAD diameter symbol (Ø). A PI point with A3 = 375 and A4 = Concrete produces 375Ø RCP.

Notes

• Matching is case-insensitive
• A code with no matching rule produces no string label
• If TextShort is absent, the long Text is used in all contexts
• Match: {} (empty) always matches — used as the base rule fallback