discontinuedPackage jet_cad_floor_plan has been discontinued and replaced by jet_cad_2d_plan.

edgeSnap function

double? edgeSnap(List<(double, double)> stretches, List<(double, double)> otherCuts, double u, double w, double aperture,)

Spec 08 D15's edge snap: the centre that puts one edge of an opening centred at u, w wide, on a candidate, or null.

• The candidates are every stretch's ends (stretches, as stretchesOf gives them: the straight span's ends and the obstacles' edges inside it) and every edge of otherCuts (the host's other openings' drawn cuts, D8).
• An edge u − w/2 or u + w/2 within aperture of a candidate (the distance at most aperture) snaps: the centre becomes the one that puts that edge on it.
• The nearest (edge, candidate) pair wins; ties go to the lower centre.

Everything is along the host's centreline, in its local units: the caller gives aperture in them.

Implementation

double? edgeSnap(List<(double, double)> stretches,
    List<(double, double)> otherCuts, double u, double w, double aperture) {
  final lo = u - w / 2, hi = u + w / 2;
  double? best;
  var bestDistance = double.infinity;
  void offer(double centre, double distance) {
    if (distance > aperture) return;
    if (distance < bestDistance ||
        (distance == bestDistance && centre < best!)) {
      best = centre;
      bestDistance = distance;
    }
  }

  void candidate(double q) {
    offer(q + w / 2, (lo - q).abs());
    offer(q - w / 2, (hi - q).abs());
  }

  for (final (a, b) in stretches) {
    candidate(a);
    candidate(b);
  }
  for (final (a, b) in otherCuts) {
    candidate(a);
    candidate(b);
  }
  return best;
}