fix(task-4): the end-view occlusion rule, the double-drawn groove, the left view
Three defects in the orthographic view engine, all one missing idea: the engine
had no visibility rule and no single owner for the silhouette.
1. `_end_circles` inverted the hidden-line rule. Walking the bands from the
viewing end it drew a circle only when its radius EXCEEDED everything nearer,
and roled every such circle `hidden` unless it was the first band - so the one
edge that CANNOT be occluded (a step face larger than the material in front of
it) shipped dashed on HIDDEN, and the circle that really is covered was not
drawn at all. `_front_max` is now the rule: an edge of radius r at station x is
continuous when r is larger than every outer radius between x and the observer,
dashed when it is not, and it is always drawn. Bores follow the mirror image -
you see down a bore only while it stays at least as wide. Each distinct radius
is emitted once, because two coincident circles are a duplicate entity.
The same rule now roles a feature's axis-centred end-view circle, whose axial
station comes from `removal_box`; a feature that reports none keeps its own
verdict rather than having one guessed.
Ground truth by ray cast along the axis of the same solid of revolution
(segments 20x25, 40x30, 15x20; observer at +X, probe just inside each edge):
r=10 at x=75 -> first surface x=75 -> VISIBLE (was visible, kept)
r=15 at x=60 -> first surface x=60 -> VISIBLE (was HIDDEN, fixed)
r=12.5 at x=20 -> first surface x=60 -> HIDDEN (was not drawn, fixed)
2. Every axisymmetric groove was drawn twice - once as the notch
`radial_profile` cuts into the silhouette, once by the feature's own
`prims()`, which `_feature_layer` appended unconditionally. Six exactly
coincident LINEs per grooved shaft, which is precisely what
`critique.py::_check_duplicate_entities` matches, so premium rule 7 could
never be met on a part carrying a retaining or O-ring groove. `_profile_owned`
now drops a feature primitive that the body already emitted, and drops a
revolved front view's `visible` silhouette line from any feature that edits
the radial profile: the spec's rule is that grooves cut a notch in the
silhouette, and the notch belongs to the one calculation. Suppression is
"the profile already drew this", not "this feature edits the profile", so a
blind bore keeps the bottom line the profile cannot express, and an internal
thread keeps its ISO 6410 limit line.
A groove straddling a step was worse than duplicated: the feature reads one
surface radius for a span that has two, so it drew a groove floor through
solid material and left the +Y path with four odd-degree nodes. It now has
two - its two ends on the axis.
3. `build_view` validated `side` and put it in ctx, but the prismatic branch
ignored it: `side="left"` returned the right-hand view, with every feature on
the wrong side of the sheet and a symmetric outline rectangle to hide it. An
observer at -X sees screen-right = -Y, so the feature layer is now mirrored
about the outline's mid-Y. The top view is always seen from above and does
not move with `side`; that is now said in the docstring and pinned by a test.
Tests: the two that pinned the inverted rule are rewritten around the ray cast,
and one of them contradicted its own name. Seven tests added, and the prismatic
side-view test's hole moved off the y=25 mirror axis, where it could not tell a
left view from a right one. Nine of them fail against the previous `views.py`
and pass against this one.
Live AutoCAD was unavailable for a SOLPROF cross-check: the running AutoCAD 2026
(pid 40068) reports Responding=False and `GetActiveObject("AutoCAD.Application")`
never returned inside 100 s, so no scratch document was created and none is left
open. No new ActiveX member is called by this change - views.py is pure.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FKFStjEFzpGyLq5bMpWxTd
This commit is contained in:
co-authored by
Claude Opus 5
parent
48eb057273
commit
b2f858212f
+220
-18
@@ -33,10 +33,24 @@ from engineering.mech.part import (
|
||||
part_max_diameter,
|
||||
segment_bounds,
|
||||
)
|
||||
from engineering.mech.primitives import Circle, DimIntent, Line, Prim, Pt, bbox
|
||||
from engineering.mech.primitives import (
|
||||
Arc,
|
||||
Circle,
|
||||
DimIntent,
|
||||
HatchArea,
|
||||
Line,
|
||||
Poly,
|
||||
Prim,
|
||||
Pt,
|
||||
Text,
|
||||
bbox,
|
||||
)
|
||||
|
||||
_EPS = 1e-9
|
||||
_SNAP = 6 # decimals used to match a corner vertex to a corner edit
|
||||
#: Radii closer together than this are the same circle, in millimetres. Looser
|
||||
#: than ``_EPS`` on purpose: it compares *measured* radii, not exact vertices.
|
||||
_TOL = 1e-6
|
||||
|
||||
VIEW_KINDS: tuple[str, ...] = ("front", "side", "top")
|
||||
PROJECTIONS: tuple[str, ...] = ("first", "third")
|
||||
@@ -279,24 +293,81 @@ def _axis_prims(part: RevolvedPart) -> tuple[Prim, ...]:
|
||||
return (Line((-over, 0.0), (length + over, 0.0), "center"),)
|
||||
|
||||
|
||||
def _band_order(bands: tuple[Band, ...], side: str) -> list[Band]:
|
||||
"""The bands from the end the observer stands at, nearest first."""
|
||||
return list(reversed(bands)) if side == "right" else list(bands)
|
||||
|
||||
|
||||
def _band_radii_near_first(band: Band, side: str) -> tuple[float, float]:
|
||||
"""A band's two outer radii, the one nearer the observer first.
|
||||
|
||||
They differ only on a taper: ``r_out0`` sits at ``x0`` and ``r_out1`` at
|
||||
``x1``, so which of them faces the observer depends on the end they are
|
||||
looking from.
|
||||
"""
|
||||
return (band.r_out1, band.r_out0) if side == "right" else (band.r_out0, band.r_out1)
|
||||
|
||||
|
||||
def _front_max(bands: tuple[Band, ...], side: str, x: float) -> float:
|
||||
"""The largest outer radius of the material lying **between** ``x`` and the observer.
|
||||
|
||||
This is the whole hidden-line rule for a view along the axis of a solid of
|
||||
revolution: a circular edge of radius ``r`` at station ``x`` is drawn
|
||||
continuous when ``r`` is larger than everything in front of it, because then
|
||||
nothing can cover it, and dashed when it is not, because the material in
|
||||
front does cover it. A step face whose circle is *larger* than the material
|
||||
ahead of it is the one edge that cannot be occluded.
|
||||
"""
|
||||
best = 0.0
|
||||
for band in bands:
|
||||
nearer = band.x0 >= x - _TOL if side == "right" else band.x1 <= x + _TOL
|
||||
if nearer:
|
||||
best = max(best, band.r_out0, band.r_out1)
|
||||
return best
|
||||
|
||||
|
||||
def _end_circles(part: RevolvedPart, side: str) -> tuple[Prim, ...]:
|
||||
"""The concentric circles the profile crosses at one end, roled by occlusion.
|
||||
|
||||
Outer edges: walking from the observer, a radius larger than everything
|
||||
already passed is ``visible``; a smaller one is behind that material and is
|
||||
``hidden`` - it is still drawn, dashed, because it is a real edge of the
|
||||
part. Bore edges follow the mirror-image rule: you can see down a bore only
|
||||
while it stays at least as wide, so a bore radius no larger than the
|
||||
narrowest bore in front of it is ``visible`` and anything wider (or anything
|
||||
behind solid material) is ``hidden``.
|
||||
|
||||
Each distinct radius is emitted once: two coincident circles would be a
|
||||
duplicate entity, which is what ``drawing_critique`` reports.
|
||||
"""
|
||||
bands = radial_profile(part)
|
||||
order = list(reversed(bands)) if side == "right" else list(bands)
|
||||
order = _band_order(bands, side)
|
||||
|
||||
prims: list[Prim] = []
|
||||
seen_out = 0.0
|
||||
for index, band in enumerate(order):
|
||||
radius = max(band.r_out0, band.r_out1)
|
||||
if radius > seen_out + 1e-6:
|
||||
prims.append(Circle((0.0, 0.0), radius, "visible" if index == 0 else "hidden"))
|
||||
seen_out = radius
|
||||
seen_in = 0.0
|
||||
for index, band in enumerate(order):
|
||||
if band.r_in > seen_in + 1e-6:
|
||||
prims.append(Circle((0.0, 0.0), band.r_in, "visible" if index == 0 else "hidden"))
|
||||
seen_in = band.r_in
|
||||
emitted: set[float] = set()
|
||||
|
||||
over = seen_out * (1.0 + AXIS_OVERRUN)
|
||||
def emit(radius: float, role: str) -> None:
|
||||
key = round(float(radius), _SNAP)
|
||||
if key <= _TOL or key in emitted:
|
||||
return
|
||||
emitted.add(key)
|
||||
prims.append(Circle((0.0, 0.0), float(radius), role))
|
||||
|
||||
front_max = 0.0
|
||||
for band in order:
|
||||
for radius in _band_radii_near_first(band, side):
|
||||
emit(radius, "visible" if radius > front_max + _TOL else "hidden")
|
||||
front_max = max(front_max, radius)
|
||||
|
||||
open_r = math.inf
|
||||
for band in order:
|
||||
if band.r_in <= _TOL:
|
||||
open_r = 0.0 # solid across the whole section: nothing behind is seen
|
||||
continue
|
||||
emit(band.r_in, "visible" if band.r_in <= open_r + _TOL else "hidden")
|
||||
open_r = min(open_r, band.r_in)
|
||||
|
||||
over = front_max * (1.0 + AXIS_OVERRUN)
|
||||
prims.append(Line((-over, 0.0), (over, 0.0), "center"))
|
||||
prims.append(Line((0.0, -over), (0.0, over), "center"))
|
||||
return tuple(prims)
|
||||
@@ -313,15 +384,131 @@ def _rectangle(
|
||||
)
|
||||
|
||||
|
||||
def _feature_layer(part, kind: str, ctx: dict) -> tuple[list[Prim], list[DimIntent], list[dict]]:
|
||||
def _mirror_u(prims, axis: float) -> tuple[Prim, ...]:
|
||||
"""Reflect primitives about the vertical line ``u = axis`` (screen left <-> right).
|
||||
|
||||
``Text`` moves with the drawing but keeps its rotation: a mirrored label
|
||||
would read backwards, and no drawing has ever wanted that.
|
||||
"""
|
||||
|
||||
def flip(point: Pt) -> Pt:
|
||||
return (2.0 * axis - float(point[0]), float(point[1]))
|
||||
|
||||
out: list[Prim] = []
|
||||
for prim in prims:
|
||||
if isinstance(prim, Line):
|
||||
out.append(Line(flip(prim.p1), flip(prim.p2), prim.role))
|
||||
elif isinstance(prim, Arc):
|
||||
# reflection reverses the sweep, so the CCW arc runs from the
|
||||
# reflected end angle to the reflected start angle
|
||||
out.append(
|
||||
Arc(
|
||||
flip(prim.center),
|
||||
prim.radius,
|
||||
(180.0 - prim.end_deg) % 360.0,
|
||||
(180.0 - prim.start_deg) % 360.0,
|
||||
prim.role,
|
||||
)
|
||||
)
|
||||
elif isinstance(prim, Circle):
|
||||
out.append(Circle(flip(prim.center), prim.radius, prim.role))
|
||||
elif isinstance(prim, Poly):
|
||||
out.append(Poly(tuple(flip(pt) for pt in prim.points), prim.closed, prim.role))
|
||||
elif isinstance(prim, HatchArea):
|
||||
out.append(
|
||||
HatchArea(
|
||||
tuple(tuple(flip(pt) for pt in loop) for loop in prim.loops), prim.material
|
||||
)
|
||||
)
|
||||
elif isinstance(prim, Text):
|
||||
out.append(prim._replace(at=flip(prim.at)))
|
||||
else: # pragma: no cover - Prim is a closed union
|
||||
raise TypeError(f"_mirror_u: not a primitive: {prim!r}")
|
||||
return tuple(out)
|
||||
|
||||
|
||||
def _same_geometry(a: Prim, b: Prim) -> bool:
|
||||
"""True when two primitives would be drawn on top of each other, role aside.
|
||||
|
||||
Exactly what ``engineering/critique.py::_check_duplicate_entities`` matches,
|
||||
so anything this returns True for is a warning on the finished drawing.
|
||||
"""
|
||||
if isinstance(a, Line) and isinstance(b, Line):
|
||||
forward = math.dist(a.p1, b.p1) <= _TOL and math.dist(a.p2, b.p2) <= _TOL
|
||||
reverse = math.dist(a.p1, b.p2) <= _TOL and math.dist(a.p2, b.p1) <= _TOL
|
||||
return forward or reverse
|
||||
if isinstance(a, Circle) and isinstance(b, Circle):
|
||||
return math.dist(a.center, b.center) <= _TOL and abs(a.radius - b.radius) <= _TOL
|
||||
if isinstance(a, Arc) and isinstance(b, Arc):
|
||||
return (
|
||||
math.dist(a.center, b.center) <= _TOL
|
||||
and abs(a.radius - b.radius) <= _TOL
|
||||
and abs((a.start_deg - b.start_deg) % 360.0) <= _TOL
|
||||
and abs((a.end_deg - b.end_deg) % 360.0) <= _TOL
|
||||
)
|
||||
return False
|
||||
|
||||
|
||||
def _profile_owned(feature, part, prim: Prim, kind: str, body: list[Prim]) -> bool:
|
||||
"""True when the radial profile has already drawn this primitive.
|
||||
|
||||
Two separate reasons, and both are the same principle - the profile is the
|
||||
one calculation the silhouette comes out of, so a feature never draws it a
|
||||
second time:
|
||||
|
||||
* the primitive is coincident with something the body already emitted; or
|
||||
* the feature edits the radial profile and this is a **silhouette** line of
|
||||
a revolved front view. ``radial_profile`` already cut the notch, and the
|
||||
feature's own idea of where the surface is can even contradict it - a
|
||||
groove straddling a step reads one surface radius for a span that has two.
|
||||
"""
|
||||
if any(_same_geometry(prim, other) for other in body):
|
||||
return True
|
||||
if kind == "front" and getattr(prim, "role", None) == "visible":
|
||||
return bool(feature.radial_edit(part))
|
||||
return False
|
||||
|
||||
|
||||
def _end_view_role(feature, part, prim: Prim, bands: tuple[Band, ...], side: str) -> Prim:
|
||||
"""Re-role a feature's axis-centred end-view circle by the same occlusion rule.
|
||||
|
||||
The feature knows its diameter, not what is standing in front of it. Its
|
||||
axial station comes from ``removal_box``; a feature that does not report one
|
||||
keeps its own verdict rather than having one guessed for it.
|
||||
"""
|
||||
if not isinstance(prim, Circle) or math.dist(prim.center, (0.0, 0.0)) > _TOL:
|
||||
return prim
|
||||
box = feature.removal_box(part)
|
||||
if box is None:
|
||||
return prim
|
||||
x_near = float(box[2]) if side == "right" else float(box[0])
|
||||
covered = _front_max(bands, side, x_near)
|
||||
return prim._replace(role="visible" if prim.radius > covered + _TOL else "hidden")
|
||||
|
||||
|
||||
def _feature_layer(
|
||||
part,
|
||||
kind: str,
|
||||
ctx: dict,
|
||||
*,
|
||||
body: list[Prim] | None = None,
|
||||
bands: tuple[Band, ...] | None = None,
|
||||
) -> tuple[list[Prim], list[DimIntent], list[dict]]:
|
||||
drawn: list[Prim] = list(body or ())
|
||||
prims: list[Prim] = []
|
||||
dims: list[DimIntent] = []
|
||||
omitted: list[dict] = []
|
||||
end_view = bands is not None and kind == "side"
|
||||
side = str(ctx.get("side", "right")).strip().lower()
|
||||
for feature in part.features:
|
||||
own = feature.prims(part, kind, ctx)
|
||||
own = tuple(feature.prims(part, kind, ctx))
|
||||
if end_view:
|
||||
own = tuple(_end_view_role(feature, part, prim, bands, side) for prim in own)
|
||||
own = tuple(prim for prim in own if not _profile_owned(feature, part, prim, kind, drawn))
|
||||
if own and kind == "front" and getattr(feature, "axisymmetric", False):
|
||||
own = tuple(own) + mirror_about_x(own)
|
||||
prims.extend(own)
|
||||
drawn.extend(own)
|
||||
dims.extend(feature.dims(part, kind, ctx))
|
||||
if own:
|
||||
continue
|
||||
@@ -344,7 +531,12 @@ def build_view(
|
||||
projection: str = "first",
|
||||
detail: dict | None = None,
|
||||
) -> View:
|
||||
"""Project a part onto one view plane and return its primitive description."""
|
||||
"""Project a part onto one view plane and return its primitive description.
|
||||
|
||||
``side`` is the end the observer stands at for an end view, and it decides
|
||||
both what is in front of what and which way round the view reads. The
|
||||
``top`` view is always seen from above, so ``side`` does not apply to it.
|
||||
"""
|
||||
name = str(kind or "").strip().lower()
|
||||
if name not in VIEW_KINDS:
|
||||
raise ValueError(f"build_view: kind {kind!r} is not one of {VIEW_KINDS}.")
|
||||
@@ -356,6 +548,8 @@ def build_view(
|
||||
ctx = {"side": where, "scale": float(scale), "projection": str(projection)}
|
||||
prims: list[Prim] = []
|
||||
omitted: list[dict] = []
|
||||
bands: tuple[Band, ...] | None = None
|
||||
mirror_u: float | None = None
|
||||
|
||||
if isinstance(part, RevolvedPart):
|
||||
if name == "top":
|
||||
@@ -369,6 +563,7 @@ def build_view(
|
||||
prims.extend(_axis_prims(part))
|
||||
omitted.extend(unplaced)
|
||||
else:
|
||||
bands = radial_profile(part)
|
||||
prims.extend(_end_circles(part, where))
|
||||
elif isinstance(part, PrismaticPart):
|
||||
x0, y0, x1, y1 = outline_bbox(part)
|
||||
@@ -378,12 +573,19 @@ def build_view(
|
||||
omitted.extend(unplaced)
|
||||
elif name == "side":
|
||||
prims.extend(_rectangle(y0, y1, 0.0, part.thickness))
|
||||
# An observer standing at -X sees screen-right = -Y, so the left
|
||||
# view is the right view mirrored. The thickness rectangle spans
|
||||
# y0..y1 either way and is its own mirror; the features are not.
|
||||
if where == "left":
|
||||
mirror_u = (y0 + y1) / 2.0
|
||||
else:
|
||||
prims.extend(_rectangle(x0, x1, 0.0, part.thickness))
|
||||
else: # pragma: no cover - build_part only makes these two
|
||||
raise ValueError(f"build_view: {type(part).__name__} is not a part model.")
|
||||
|
||||
feature_prims, dims, feature_omitted = _feature_layer(part, name, ctx)
|
||||
feature_prims, dims, feature_omitted = _feature_layer(part, name, ctx, body=prims, bands=bands)
|
||||
if mirror_u is not None:
|
||||
feature_prims = list(_mirror_u(feature_prims, mirror_u))
|
||||
prims.extend(feature_prims)
|
||||
omitted.extend(feature_omitted)
|
||||
|
||||
|
||||
+170
-8
@@ -7,6 +7,8 @@ to 1e-9. The radial profile is the single calculation both the silhouette and
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from collections import Counter
|
||||
|
||||
import pytest
|
||||
|
||||
from engineering.mech.features import (
|
||||
@@ -17,6 +19,7 @@ from engineering.mech.features import (
|
||||
Fillet,
|
||||
Hole,
|
||||
Keyway,
|
||||
ORingGroove,
|
||||
RetainingGroove,
|
||||
)
|
||||
from engineering.mech.part import PrismaticPart, RevolvedPart, Segment
|
||||
@@ -55,6 +58,17 @@ def roles(view: View, role: str):
|
||||
return [p for p in view.prims if getattr(p, "role", None) == role]
|
||||
|
||||
|
||||
def coincident(view: View) -> dict:
|
||||
"""Geometries drawn more than once - exactly what ``_check_duplicate_entities`` flags."""
|
||||
counts: Counter = Counter()
|
||||
for prim in view.prims:
|
||||
if isinstance(prim, Line):
|
||||
counts[tuple(sorted((prim.p1, prim.p2)))] += 1
|
||||
elif isinstance(prim, Circle):
|
||||
counts[(prim.center, round(prim.radius, 9))] += 1
|
||||
return {key: n for key, n in counts.items() if n > 1}
|
||||
|
||||
|
||||
def test_the_engine_declares_three_orthographic_kinds_and_two_projections():
|
||||
assert VIEW_KINDS == ("front", "side", "top")
|
||||
assert PROJECTIONS == ("first", "third")
|
||||
@@ -162,25 +176,141 @@ def test_an_axisymmetric_feature_is_mirrored_and_a_keyway_is_not():
|
||||
assert keyway_lines and all(line.p1[1] > 0 for line in keyway_lines)
|
||||
|
||||
|
||||
@pytest.mark.parametrize(
|
||||
"groove",
|
||||
[
|
||||
RetainingGroove(id="rg", x=30.0, d=30.0, m=1.6, d2=28.6),
|
||||
ORingGroove(id="or", x=40.0, cord=3.0, b=4.1, h=2.3),
|
||||
],
|
||||
ids=["retaining", "oring"],
|
||||
)
|
||||
def test_a_groove_is_the_notch_in_the_silhouette_and_is_not_drawn_a_second_time(groove):
|
||||
"""The spec's rule is `grooves cut a notch in the silhouette`. The notch is
|
||||
the radial profile's; the feature does not redraw it. Two coincident LINEs
|
||||
are what ``drawing_critique(focus=None)`` reports as a duplicate, and
|
||||
premium rule 7 needs that report empty before ``drawing_finalize``."""
|
||||
view = build_view(shaft(groove), "front")
|
||||
assert coincident(view) == {}
|
||||
# the notch is still there, mirrored, once per side
|
||||
floor = {round(abs(line.p1[1]), 6) for line in view.prims if isinstance(line, Line)}
|
||||
assert (14.3 in floor) or (12.7 in floor)
|
||||
assert view.omitted == ()
|
||||
|
||||
|
||||
def test_an_axial_bore_end_circle_is_drawn_once():
|
||||
"""``_end_circles`` reads the bore off the same radial profile the feature
|
||||
edited, so the feature's own circle would be the second copy of it."""
|
||||
view = build_view(shaft(AxialBore(id="ab", at="start", diameter=8.0, depth=30.0)), "side")
|
||||
assert coincident(view) == {}
|
||||
assert len([c for c in view.prims if isinstance(c, Circle) and abs(c.radius - 4.0) < EPS]) == 1
|
||||
|
||||
|
||||
def test_a_blind_bore_keeps_the_bottom_line_the_profile_cannot_draw():
|
||||
"""Suppression is `the profile already drew this`, not `this feature edits
|
||||
the profile` - the blind bottom is not on the radial profile at all."""
|
||||
view = build_view(shaft(AxialBore(id="ab", at="start", diameter=8.0, depth=30.0)), "front")
|
||||
bottoms = [
|
||||
line
|
||||
for line in roles(view, "hidden")
|
||||
if isinstance(line, Line) and abs(line.p1[0] - 30.0) < EPS and abs(line.p2[0] - 30.0) < EPS
|
||||
]
|
||||
assert len(bottoms) == 1
|
||||
assert {round(bottoms[0].p1[1], 6), round(bottoms[0].p2[1], 6)} == {-4.0, 4.0}
|
||||
|
||||
|
||||
def test_a_groove_straddling_a_step_leaves_one_closed_silhouette():
|
||||
"""The feature's own prims read a single surface radius for a span that has
|
||||
two, so drawing them as well as the profile's notch put a groove floor
|
||||
through solid material and left the +Y path with four odd-degree nodes.
|
||||
An open path has exactly two: its two ends on the axis."""
|
||||
part = shaft(RetainingGroove(id="rg", x=20.0, d=30.0, m=1.6, d2=28.6))
|
||||
upper = [
|
||||
line
|
||||
for line in roles(build_view(part, "front"), "visible")
|
||||
if isinstance(line, Line) and line.p1[1] >= 0.0 and line.p2[1] >= 0.0
|
||||
]
|
||||
degree: Counter = Counter()
|
||||
for line in upper:
|
||||
degree[(round(line.p1[0], 6), round(line.p1[1], 6))] += 1
|
||||
degree[(round(line.p2[0], 6), round(line.p2[1], 6))] += 1
|
||||
assert sorted(node for node, n in degree.items() if n % 2) == [(0.0, 0.0), (75.0, 0.0)]
|
||||
# nothing is drawn at the groove floor radius outside the band the profile cut
|
||||
assert not [
|
||||
line
|
||||
for line in upper
|
||||
if abs(line.p1[1] - 14.3) < EPS and abs(line.p2[1] - 14.3) < EPS and line.p1[0] < 20.0
|
||||
]
|
||||
|
||||
|
||||
# -- the revolved end view ---------------------------------------------------
|
||||
|
||||
|
||||
def test_the_end_view_marks_a_diameter_behind_a_larger_one_as_hidden():
|
||||
def test_the_end_view_hides_the_smaller_diameter_and_draws_the_step_face_continuous():
|
||||
"""Ground truth by ray cast along the axis of the same solid of revolution
|
||||
(viewer at +X, probe just inside each edge):
|
||||
|
||||
edge r=10 at x=75 -> first surface at x=75 -> VISIBLE
|
||||
edge r=15 at x=60 -> first surface at x=60 -> VISIBLE
|
||||
edge r=12.5 at x=20 -> first surface at x=60 -> HIDDEN
|
||||
|
||||
The annular step face at x=60 faces the observer and nothing at projected
|
||||
radius 15-eps stands in front of it, so the 30 mm circle is continuous. The
|
||||
25 mm circle is the one that is genuinely covered, and it is still *drawn* -
|
||||
dashed, not dropped.
|
||||
"""
|
||||
view = build_view(shaft(), "side", side="right")
|
||||
circles = [p for p in view.prims if isinstance(p, Circle)]
|
||||
radii = {(round(c.radius, 6), c.role) for c in circles}
|
||||
assert (10.0, "visible") in radii # the near end
|
||||
assert (15.0, "hidden") in radii # the middle step, behind it
|
||||
assert (12.5, "hidden") not in radii # smaller than 15, never seen
|
||||
assert radii == {(10.0, "visible"), (15.0, "visible"), (12.5, "hidden")}
|
||||
assert len([p for p in view.prims if getattr(p, "role", None) == "center"]) == 2
|
||||
|
||||
|
||||
def test_looking_from_the_left_reverses_which_circle_is_visible():
|
||||
"""From -X the near end is the 25 mm face; the 20 mm end is behind the 30 mm body."""
|
||||
view = build_view(shaft(), "side", side="left")
|
||||
circles = [p for p in view.prims if isinstance(p, Circle)]
|
||||
radii = {(round(c.radius, 6), c.role) for c in circles}
|
||||
assert (12.5, "visible") in radii
|
||||
assert (15.0, "hidden") in radii
|
||||
assert radii == {(12.5, "visible"), (15.0, "visible"), (10.0, "hidden")}
|
||||
|
||||
|
||||
def test_a_feature_circle_at_the_far_end_is_hidden_behind_the_larger_body():
|
||||
"""A chamfer at x=0 seen from +X sits behind the 30 mm band, so its circle
|
||||
is dashed; seen from -X nothing is in front of it and it is continuous."""
|
||||
part = shaft(Chamfer(id="c1", at="start", size=2.0))
|
||||
right = {
|
||||
(round(c.radius, 6), c.role)
|
||||
for c in build_view(part, "side", side="right").prims
|
||||
if isinstance(c, Circle)
|
||||
}
|
||||
left = {
|
||||
(round(c.radius, 6), c.role)
|
||||
for c in build_view(part, "side", side="left").prims
|
||||
if isinstance(c, Circle)
|
||||
}
|
||||
assert (10.5, "hidden") in right
|
||||
assert (10.5, "visible") in left
|
||||
|
||||
|
||||
def test_a_bore_that_widens_behind_a_narrower_one_is_hidden():
|
||||
"""Looking into the narrow end you see the small bore; the wider bore behind
|
||||
it is covered by the wall of the narrow one. From the other end, both are
|
||||
seen down the widening hole."""
|
||||
part = RevolvedPart(
|
||||
name="stepped-bore",
|
||||
segments=(Segment(20.0, 40.0, 10.0), Segment(20.0, 40.0, 20.0)),
|
||||
)
|
||||
right = {
|
||||
(round(c.radius, 6), c.role)
|
||||
for c in build_view(part, "side", side="right").prims
|
||||
if isinstance(c, Circle)
|
||||
}
|
||||
left = {
|
||||
(round(c.radius, 6), c.role)
|
||||
for c in build_view(part, "side", side="left").prims
|
||||
if isinstance(c, Circle)
|
||||
}
|
||||
assert (10.0, "visible") in right and (5.0, "visible") in right
|
||||
assert (5.0, "visible") in left and (10.0, "hidden") in left
|
||||
|
||||
|
||||
def test_a_revolved_top_view_is_refused_because_it_repeats_the_front():
|
||||
@@ -211,14 +341,46 @@ def test_a_corner_fillet_replaces_an_outline_vertex_with_an_arc():
|
||||
|
||||
|
||||
def test_a_prismatic_side_view_is_the_thickness_rectangle_with_a_hidden_line_per_hole():
|
||||
hole = Hole(id="h1", x=20.0, y=25.0, diameter=10.0)
|
||||
# y=10, deliberately OFF the y=25 mirror axis of the 0..50 plate: a hole on
|
||||
# the axis cannot tell a right-hand view from a left-hand one.
|
||||
hole = Hole(id="h1", x=20.0, y=10.0, diameter=10.0)
|
||||
view = build_view(plate(hole), "side")
|
||||
visible = roles(view, "visible")
|
||||
hidden = roles(view, "hidden")
|
||||
assert len(visible) == 4
|
||||
assert view.bbox == (0.0, 0.0, 50.0, 8.0)
|
||||
assert len(hidden) == 2
|
||||
assert {round(line.p1[0], 6) for line in hidden} == {20.0, 30.0}
|
||||
assert {round(line.p1[0], 6) for line in hidden} == {5.0, 15.0}
|
||||
|
||||
|
||||
def test_a_prismatic_left_side_view_is_the_right_view_mirrored():
|
||||
"""An observer at -X sees screen-right = -Y, so the hole at y=10 in a plate
|
||||
spanning y 0..50 lands at u = 50-15 .. 50-5. Accepting ``side='left'`` and
|
||||
returning the right-hand view puts every feature on the wrong side of the
|
||||
sheet with nothing in the drawing to reveal it."""
|
||||
hole = Hole(id="h1", x=20.0, y=10.0, diameter=10.0)
|
||||
part = plate(hole)
|
||||
right = {
|
||||
round(line.p1[0], 6) for line in roles(build_view(part, "side", side="right"), "hidden")
|
||||
}
|
||||
left = {round(line.p1[0], 6) for line in roles(build_view(part, "side", side="left"), "hidden")}
|
||||
assert right == {5.0, 15.0}
|
||||
assert left == {35.0, 45.0}
|
||||
# the thickness rectangle is its own mirror, so only the features move
|
||||
assert build_view(part, "side", side="left").bbox == (0.0, 0.0, 50.0, 8.0)
|
||||
|
||||
|
||||
def test_a_prismatic_top_view_is_always_seen_from_above():
|
||||
"""``side`` names the end an *end* view is taken from; the top view is not
|
||||
one, so it must not move with it."""
|
||||
part = plate(Hole(id="h1", x=20.0, y=10.0, diameter=10.0))
|
||||
from_right = {
|
||||
round(line.p1[0], 6) for line in roles(build_view(part, "top", side="right"), "hidden")
|
||||
}
|
||||
from_left = {
|
||||
round(line.p1[0], 6) for line in roles(build_view(part, "top", side="left"), "hidden")
|
||||
}
|
||||
assert from_right == from_left == {15.0, 25.0}
|
||||
|
||||
|
||||
def test_a_prismatic_top_view_projects_the_other_axis():
|
||||
|
||||
Reference in New Issue
Block a user