Fairway distance arcs.

Usage

Add the fairway distance arcs to a graphic.

Include the component in the initial mount call, reconcile it through view.setSmartComponents, or append it with view.addSmartComponent. Types may repeat. Give repeated instances stable id values to style, show, hide, move, reset, or remove one instance independently. The selected Smart Component type, instance ID, render receipt, and protected selection options such as yardages, grid spacing, coverage, measured origin, buffer distance, detail, limits, or targets are sent to the overlay service. Marker-image origins, images, presentation styles, supported labels, and movement remain local.

const view = await caddie.mount(container, graphicRequest, [
  {
    type: "fairway-distance-arcs",
    origin: "green-center",
    yardages: [75, 100, 125, 150],
    fairwayBuffer: { distance: 15, unit: "yards" },
    labels: { primary: "distance", secondary: "elevation-delta" },
    style: {
      strokeStyle: "alternating",
      strokeColor: "#5A7A5C",
      alternateStrokeColor: "#FFFFFF",
      labelPosition: "auto",
      showLegend: true,
    },
  },
  {
    id: "client-plan",
    type: "fairway-distance-arcs",
    origin: "tee",
    stations: [
      { distanceYards: 150, primaryLabel: "8i", secondaryLabel: "Preferred layup" },
    ],
    labels: { primary: "custom", secondary: "custom" },
  },
]);

Defaults

Built-in presentation.

Component options

Configure behavior and presentation.

Behavior

Important implementation details.

• Automatic green-center yardages follow the measured tee-to-green distance; automatic tee yardages use 200, 250, and 300 yards.
• Elevation delta is sampled at each arc's protected centerline crossing and compared with sampled ground elevation at the origin. It does not represent ball flight or adjusted playing distance.
• Distance from tee defaults to direct metric distance from the selected tee to the same protected 50% arc point used by the middle marker. It does not subtract the approach radius from scorecard yardage. The centerline option instead measures accumulated route distance and remains useful for dogleg progress.
• Fairway width is the straight endpoint chord between the two protected fairway-edge intersections. It is measured in metric course space and never follows the longer curved arc path.
• Custom labels never control geometry: distanceYards remains the authoritative radius. This lets a client add clubs, strategy, or personalized guidance without sending course geometry.
• Auto chooses one consistent primary-label side from the image whitespace across all arcs. Secondary labels occupy the opposite side. Collision handling preserves the nearest station and attempts to retain the farthest station.
• When enabled, the legend follows the primary label side, rotates −90° on the left or +90° on the right, and reserves its own edge column so yardage labels do not overlap it.
• Leader endpoints are computed from the current label string, font size, letter spacing, and outline width so dashed lines stop before the characters instead of passing underneath them.
• Changing appearance or visibility is local. Changing origin, from, radii, label sources, or custom station text requests fresh protected placement against the cached artifact.
• The response contains only final arc pixels, clipped endpoints, the centerline crossing pixel, distanceYards, and safe display strings. Fairway polygons, source elevations, tee identities, geographic coordinates, transforms, and the render sidecar remain server-side.