Annotations & Labels

Text annotations

Add positioned text labels with configurable style and anchoring.

Callout annotations

Text with a leader line and configurable arrowhead — useful for pointing at a specific feature from a label placed nearby.

Point labels

Point geometry can be automatically labeled based on its metadata (code, description, name), following cartographic best practices to avoid label overlap.

Label content

• Default format: {code} {description}
• Supported placeholders: {code}, {description}, {name}
• Empty labels (no content) are automatically hidden

Label placement

• Labels are positioned at the point location, with collision detection to prevent overlaps.
• Priority system: labels on the active layer are placed first.
• After priority sorting, remaining ties are broken top-to-bottom.

Zoom behavior

Labels maintain a constant screen size as you zoom, rather than scaling with world geometry:

• Target screen height: 12.0 px (configurable 8.0–24.0 px).
• World size is clamped between a minimum (default 0.5) and maximum (default 50.0) so labels stop shrinking/growing past those bounds at extreme zoom.

Performance

• Maximum label count (default 1000).
• Only labels within the visible camera bounds are generated (frustum culling).
• A minimum screen-height threshold prevents rendering labels too small to read.

Visibility controls

• Global toggle: Settings ▸ Labels ▸ Enable Point Labels.
• Per-layer toggle: the 🏷 button in the layer panel, next to the lock button. Labels also respect the layer’s own visibility.

Settings reference (Settings ▸ Labels)

Usage

1. Create points with a code and description (e.g. via CSV import or manually).
2. Enable labels: Settings ▸ Labels ▸ Enable Point Labels.
3. Toggle per-layer visibility with the 🏷 button in the layer panel.
4. Customize the label format string, e.g. {code}: {description}.