Loading...
Searching...
No Matches
mesh::QuadRegion Struct Reference

A polygon in which quadrilateral cells are requested, with its spacing, shape and tagging policy. More...

#include <mesh/meshquadregion.h>

Collaboration diagram for mesh::QuadRegion:

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.
 

Detailed Description

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.

Member Data Documentation

◆ alignAngleDeg

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.

◆ alignGuide

QVector<QPointF> mesh::QuadRegion::alignGuide

Free: optional polyline the field aligns to (streets, channels).

◆ aspectMax

double mesh::QuadRegion::aspectMax
Initial value:
=
-1.0

Free: opposite-side mean ratio cap; < 0 inherits global, 0 unbounded, >= 1 explicit.

◆ automaticCandidate

bool mesh::QuadRegion::automaticCandidate = false

Derived candidate; no outline constraint on fallback.

◆ corners

QVector<int> mesh::QuadRegion::corners

Mapped: 4 ring vertex indices in ring order; empty = auto-pick.

◆ directionalSpacing

bool mesh::QuadRegion::directionalSpacing
Initial value:
=
false

Explicit Mapped spacing; failure must not fall back to isotropic cells.

◆ hAcross

double mesh::QuadRegion::hAcross
Initial value:
=
0.0

Positive spacings in mesh CRS units, used only when directionalSpacing.

◆ hAlong

double mesh::QuadRegion::hAlong = 0.0

Spacing for the side pair most aligned with mappedAlongAngleDeg (directional only).

◆ hasAlignAngle

bool mesh::QuadRegion::hasAlignAngle = false

Free: constant cross field at alignAngleDeg (from +x, CCW).

◆ holes

QVector<QPolygonF> mesh::QuadRegion::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.

No cell is generated inside a hole and the lattice keeps its boundary clearance from every hole ring, exactly as it does from ring.

◆ isBackground

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.

◆ mappedAlongAngleDeg

double mesh::QuadRegion::mappedAlongAngleDeg
Initial value:
=
0.0

Physical undirected along-axis, degrees from +x CCW; independent of ring start.

◆ mode

QuadRegionMode mesh::QuadRegion::mode = QuadRegionMode::Auto

Requested strategy (default Auto).

TrianglesOnly keeps triangles inside the ring; every other value requests mapped quads (see QuadRegionMode).

◆ requireMapped

bool mesh::QuadRegion::requireMapped = false

Explicit hard requirement, used by unified planning.

◆ ring

QPolygonF mesh::QuadRegion::ring

Closed (last == first optional), simple, any orientation.

◆ spacing

double mesh::QuadRegion::spacing = 0.0

Target quad edge length h; 0 = derive from the size field / max area.

◆ tag

QString mesh::QuadRegion::tag

MeshTriangle::tag for every cell inside; empty = inherit region marker's.


The documentation for this struct was generated from the following file: