23#ifndef OPENSWMMVIS_MESH_MESHQUADREGION_H
24#define OPENSWMMVIS_MESH_MESHQUADREGION_H
178bool pointInRing(
const QPolygonF &ring,
const QPointF &p);
193bool pointInRegion(
const QPolygonF &ring,
const QVector<QPolygonF> &holes,
const QPointF &p);
231 const QVector<QPolygonF> &holes);
277 double cornerTolDeg = 25.0,
double rectilinearTolDeg = 2.0);
298QPolygonF
resampleRing(
const QPolygonF &ring,
double h,
double keepTurnDeg = 0.0);
Quadrilateral quality metrics (workplans/QUAD_MESHING_REDESIGN_PLAN_2026-09-06.md §5).
The Qt-facing MeshKit API (meshkit::core_qt, meshkit::model_qt, meshkit::io_qt): mesh value types and...
QuadRegionMode
Requested (or classified) cell strategy of a QuadRegion.
Definition meshquadregion.h:45
@ Auto
classifyQuadRegion() decides: Mapped → Submapped → Free.
Definition meshquadregion.h:46
@ Mapped
Four logical sides (polylines) → transfinite quads.
Definition meshquadregion.h:47
@ Submapped
Exactly rectilinear ring. A classification only: MeshGenerator meshes it like Mapped.
Definition meshquadregion.h:49
@ Free
Quad-dominant (cross-field lattice) candidate.
Definition meshquadregion.h:52
@ TrianglesOnly
Region ring is still a constraint loop, interior stays triangles.
Definition meshquadregion.h:53
bool ringIsSimple(const QPolygonF &ring)
Reject proper nonadjacent edge crossings using plain double orientation signs.
Definition meshquadregion.cpp:11
double ringSignedArea(const QPolygonF &ring)
Compute oriented shoelace area after translating corners to the first vertex.
Definition meshquadregion.cpp:8
QuadRegionMode classifyQuadRegion(const QPolygonF &ring, QVector< int > *corners, double cornerTolDeg=25.0, double rectilinearTolDeg=2.0)
Heuristically classify normalized ring turns as Mapped, Submapped or Free.
Definition meshquadregion.cpp:14
QPolygonF resampleRing(const QPolygonF &ring, double h, double keepTurnDeg=0.0)
Normalize a ring and insert equal-part subdivisions along all implicit closing edges.
Definition meshquadregion.cpp:15
double ringTurnDeg(const QPolygonF &ring, int i)
Compute a signed exterior turn at one ring corner using adjacent edge cross/dot products.
Definition meshquadregion.cpp:16
bool pointInRegion(const QPolygonF &ring, const QVector< QPolygonF > &holes, const QPointF &p)
Combine outer-ring parity with exclusion by every supplied hole-ring parity.
Definition meshquadregion.cpp:10
bool polylineIntersectsRect(const QVector< QPointF > &path, const QRectF &rect)
Test whether any consecutive path segment meets a normalized closed rectangle.
Definition meshquadregion.cpp:7
QuadQualityBounds quadRegionQualityBounds(const QuadRegion ®ion, QuadQualityBounds global)
Copy global quality bounds and apply an explicitly nonnegative region aspect override.
Definition meshquadregion.h:115
QString validateQuadRegion(const QuadRegion &r, const QVector< QPolygonF > &domains, const QVector< QPolygonF > &holes)
Check region authoring policy, normalized ring and sampled domain/hole containment.
Definition meshquadregion.cpp:12
QPolygonF normalizeRingCCW(const QPolygonF &ring)
Copy a ring while dropping scale-fuzzy consecutive/closing duplicates and reversing negative area.
Definition meshquadregion.cpp:6
QString validateQuadRegionsDisjoint(const QVector< QuadRegion > ®ions)
Check explicit region pairs for proper crossings or strictly interior sampled vertices.
Definition meshquadregion.cpp:13
bool pointInRing(const QPolygonF &ring, const QPointF &p)
Test a point using a strict horizontal-ray odd-even crossing rule.
Definition meshquadregion.cpp:9
Acceptance bounds shared by pairing, cleanup, smoothing and the legacy tri-pair merge.
Definition meshquadquality.h:37
double maxAspect
longest / shortest side (opposite-side means). <= 0 = unbounded.
Definition meshquadquality.h:43
A polygon in which quadrilateral cells are requested, with its spacing, shape and tagging policy.
Definition meshquadregion.h:61
bool automaticCandidate
Derived candidate; no outline constraint on fallback.
Definition meshquadregion.h:79
QPolygonF ring
Closed (last == first optional), simple, any orientation.
Definition meshquadregion.h:62
double mappedAlongAngleDeg
Physical undirected along-axis, degrees from +x CCW; independent of ring start.
Definition meshquadregion.h:88
QVector< int > corners
Mapped: 4 ring vertex indices in ring order; empty = auto-pick.
Definition meshquadregion.h:98
QString tag
MeshTriangle::tag for every cell inside; empty = inherit region marker's.
Definition meshquadregion.h:99
double aspectMax
Free: opposite-side mean ratio cap; < 0 inherits global, 0 unbounded, >= 1 explicit.
Definition meshquadregion.h:90
double hAlong
Spacing for the side pair most aligned with mappedAlongAngleDeg (directional only).
Definition meshquadregion.h:85
bool directionalSpacing
Explicit Mapped spacing; failure must not fall back to isotropic cells.
Definition meshquadregion.h:81
QVector< QPointF > alignGuide
Free: optional polyline the field aligns to (streets, channels).
Definition meshquadregion.h:97
double alignAngleDeg
Free: cross-field angle, degrees from +x CCW, meaningful when hasAlignAngle.
Definition meshquadregion.h:95
bool hasAlignAngle
Free: constant cross field at alignAngleDeg (from +x, CCW).
Definition meshquadregion.h:92
QVector< QPolygonF > holes
Areas subtracted from ring (QUAD_EVERYWHERE_PLAN_2026-09-07.md §3.1): domain hole rings,...
Definition meshquadregion.h:67
double hAcross
Positive spacings in mesh CRS units, used only when directionalSpacing.
Definition meshquadregion.h:86
QuadRegionMode mode
Requested strategy (default Auto).
Definition meshquadregion.h:77
bool isBackground
True when ring IS a domain outline rather than a ring drawn inside one — the "toggle quads on for the...
Definition meshquadregion.h:74
double spacing
Target quad edge length h; 0 = derive from the size field / max area.
Definition meshquadregion.h:80
bool requireMapped
Explicit hard requirement, used by unified planning.
Definition meshquadregion.h:78