B1 - Spot Text Display Manager

Script Family

Series B - Drafting Aids

Purpose

Manages the visibility and display styles of COGO Point spot texts using selection, filtering, density evaluation, and action inputs.

When to Use

Use B1 after survey data has been plotted and the drawing needs annotation decluttering, visibility control, or spot text style correction.

Inputs

Selection scope inputs:

  • Initial Selection Area.
  • Selection Scope: selected entities only, invert selection, or process all points.
  • Filter by Feature Type.
  • Filter by Feature Code.
  • Neighbourhood Density Filter: Off, Mild, Moderate, or Aggressive.

Action inputs:

  • Annotation Visibility Option.
  • Annotation Style Option.
  • Suppression Control.
  • Suppression Visibility.

Outputs

  • Updated COGO Point annotation visibility.
  • Updated COGO Point annotation styles.
  • Optional suppression-layer assignment or release.

Workflow Summary

  1. Capture an initial selection set or define an all-points processing mode.
  2. Refine the selection using Feature Type, Feature Code, and optional spatial density filtering.
  3. Apply the selected visibility, style, or suppression action.
  4. Review resulting spot text readability in model space.

None directly.

Reverse-Engineering Notes

When reverse-engineering this Dynamo graph, identify:

  • How COGO Point Mode and Feature Line Mode are detected.
  • How COGO Points at Feature Line vertices are identified.
  • How Feature Type and Feature Code filters are implemented.
  • How the Neighbourhood Density Filter evaluates annotation footprint and spatial clearance.
  • How label styles are mapped to visibility and annotation style options.
  • How suppression layer behaviour is implemented.

Source Basis

  • Primary source: HAPI User Manual.pdf, Section 2.4.1.
  • This note is a manual-facing script overview, not a PythonNet3 implementation specification.

Open Questions

  • Confirm whether B1 now detects Feature Codes from Line Style Name rather than Feature Line Name as described in the Release 1 changelog.
Built with LogoFlowershow