Shot dispersion.

Usage

Add the shot dispersion 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: "shot-dispersion",
    yardage: 260,
    from: "Blue", // Optional tee name or "longitude,latitude"; omit for the authored tee.
    handicap: golfer.handicapIndex, // Optional; defaults to 12 and caps to 1–20.
    movable: true,
    style: { strokeColor: "#FFFFFF", strokeWidth: 3, pointSize: 22, teePointColor: "#07110D", targetPointColor: "#00AEEF", dispersionColor: "#39B54A", dispersionOpacity: 0.4, showLabels: true, labelPosition: "target-top", labelPrecision: "rounded" },
  },
]);

view.setSmartComponentMovable("shot-dispersion", true);
view.resetSmartComponentPosition("shot-dispersion");

Defaults

Built-in presentation.

Component options

Configure behavior and presentation.

Behavior

Important implementation details.

• The target is found with a circle/segment intersection. It does not walk the requested distance around centerline bends.
• If no usable fairway-centerline intersection exists, the target remains at the requested radius on the straight bearing from the selected start toward green center.
• A from value uses the same strict coordinate parsing and tee-name matching as Fairway widths; only final protected endpoint pixels are returned.
• The live yardage pill uses a protected initial pixel/yard calibration and recalculates locally as either point moves; it makes no additional server request.
• The empirical lateral model interpolates handicap-specific sigma-angle and side-dispersion multipliers; its result is applied independently to the left and right sides.
• Tee and target fill colors can be changed independently without moving or rebuilding either endpoint.
• Moving either endpoint updates the 60%-opacity dashed connector immediately and does not rebuild the clean course image.
• The target bar, double-width carry segment, and 25% backward fade recalculate from the live point-to-point distance.
• The visible fade starts at roughly three-quarters of the target width and uses thin white side borders that fade toward the tee.
• The initial two image pixels are retained locally so reset needs no new overlay request.
• caddie100:shotdispersionpositionchange identifies the moved tee or target endpoint and reports its protected original pixel after a drag, keyboard move, or reset.