A polygon in which quadrilateral cells are requested, with its spacing, shape and tagging policy. More...
#include <mesh/meshquadregion.h>
Public Attributes | |
| QPolygonF | ring |
| Closed (last == first optional), simple, any orientation. | |
| QVector< QPolygonF > | holes |
| Areas subtracted from ring (QUAD_EVERYWHERE_PLAN_2026-09-07.md §3.1): domain hole rings, and the rings of any explicit region nested inside this one. | |
| bool | isBackground = false |
| True when ring IS a domain outline rather than a ring drawn inside one — the "toggle quads on for the whole model" case. | |
| QuadRegionMode | mode = QuadRegionMode::Auto |
| Requested strategy (default Auto). | |
| bool | requireMapped = false |
| Explicit hard requirement, used by unified planning. | |
| bool | automaticCandidate = false |
| Derived candidate; no outline constraint on fallback. | |
| double | spacing = 0.0 |
| Target quad edge length h; 0 = derive from the size field / max area. | |
| bool | directionalSpacing |
| Explicit Mapped spacing; failure must not fall back to isotropic cells. | |
| double | hAlong = 0.0 |
| Spacing for the side pair most aligned with mappedAlongAngleDeg (directional only). | |
| double | hAcross |
| Positive spacings in mesh CRS units, used only when directionalSpacing. | |
| double | mappedAlongAngleDeg |
| Physical undirected along-axis, degrees from +x CCW; independent of ring start. | |
| double | aspectMax |
| Free: opposite-side mean ratio cap; < 0 inherits global, 0 unbounded, >= 1 explicit. | |
| bool | hasAlignAngle = false |
| Free: constant cross field at alignAngleDeg (from +x, CCW). | |
| double | alignAngleDeg = 0.0 |
| Free: cross-field angle, degrees from +x CCW, meaningful when hasAlignAngle. | |
| QVector< QPointF > | alignGuide |
| Free: optional polyline the field aligns to (streets, channels). | |
| QVector< int > | corners |
| Mapped: 4 ring vertex indices in ring order; empty = auto-pick. | |
| QString | tag |
| MeshTriangle::tag for every cell inside; empty = inherit region marker's. | |
A polygon in which quadrilateral cells are requested, with its spacing, shape and tagging policy.
Plain value type; MeshGenerator::addQuadRegion() copies it. Lengths are in mesh XY (CRS) units.
| double mesh::QuadRegion::alignAngleDeg = 0.0 |
Free: cross-field angle, degrees from +x CCW, meaningful when hasAlignAngle.
Only copied to the native type; MeshKit's generator and planner do not read it.
| QVector<QPointF> mesh::QuadRegion::alignGuide |
Free: optional polyline the field aligns to (streets, channels).
| double mesh::QuadRegion::aspectMax |
Free: opposite-side mean ratio cap; < 0 inherits global, 0 unbounded, >= 1 explicit.
| bool mesh::QuadRegion::automaticCandidate = false |
Derived candidate; no outline constraint on fallback.
| QVector<int> mesh::QuadRegion::corners |
Mapped: 4 ring vertex indices in ring order; empty = auto-pick.
| bool mesh::QuadRegion::directionalSpacing |
Explicit Mapped spacing; failure must not fall back to isotropic cells.
| double mesh::QuadRegion::hAcross |
Positive spacings in mesh CRS units, used only when directionalSpacing.
| double mesh::QuadRegion::hAlong = 0.0 |
Spacing for the side pair most aligned with mappedAlongAngleDeg (directional only).
| bool mesh::QuadRegion::hasAlignAngle = false |
Free: constant cross field at alignAngleDeg (from +x, CCW).
| QVector<QPolygonF> mesh::QuadRegion::holes |
| bool mesh::QuadRegion::isBackground = false |
True when ring IS a domain outline rather than a ring drawn inside one — the "toggle quads on for the whole model" case.
Two consequences: the ring is NOT re-emitted as constraint segments (the domain boundary is already in the PSLG, and duplicating it would double every boundary edge), and the "region lies inside exactly one domain ring" validation is skipped because the region is that ring.
| double mesh::QuadRegion::mappedAlongAngleDeg |
Physical undirected along-axis, degrees from +x CCW; independent of ring start.
| QuadRegionMode mesh::QuadRegion::mode = QuadRegionMode::Auto |
Requested strategy (default Auto).
TrianglesOnly keeps triangles inside the ring; every other value requests mapped quads (see QuadRegionMode).
| bool mesh::QuadRegion::requireMapped = false |
Explicit hard requirement, used by unified planning.
| QPolygonF mesh::QuadRegion::ring |
Closed (last == first optional), simple, any orientation.
| double mesh::QuadRegion::spacing = 0.0 |
Target quad edge length h; 0 = derive from the size field / max area.
| QString mesh::QuadRegion::tag |
MeshTriangle::tag for every cell inside; empty = inherit region marker's.