mirror of
https://github.com/OrcaSlicer/OrcaSlicer.git
synced 2026-09-26 10:21:00 +00:00
Tommaso BianchiandClaude Opus 5
555af98474
The connector work has lived outside the code since 2026-08-05, in a workspace repo with no
remote. It is the basis of a decision that now shapes the Design tab, so it belongs here.
docs/design/mate-connectors/
DESIGN_MATE_CONNECTORS.md seven CAD systems surveyed; the frame-pair model this kernel
already matches; sections 8b/8c on the glyph, and section 9's
four open decisions (D1-D4) still awaiting Tommaso.
bear.step the male, Onshape 2026-08-05T08:27Z, md5 faf228326ee3f971
BearConnector_Female*.step/.stl, BearConnector_Cutter.step
built by make_female.py FROM the real male B-rep rather than
re-modelled, so the pocket is complementary by construction
including every deliberate asymmetry. Fit measured at exactly
0.2000 mm, zero interference, mated hosts proven coplanar.
BEAR_CONNECTOR_REVIEW.md the symmetry-group result: identity 81/81 edges, mirror-x 0/81,
mirror-y 0/81, rot180Z 0/81, rot90Z 0/81, diagonal 0/81 at
0.1 mm. Trivial group, so every PARTIAL view fixes orientation.
extract_outline.py, simplify_study.py, relief_sheet.py, handedness.py, make_female.py,
trim_female.py, fit_check.py, verify_trimmed.py, coplanar_test.py + their sheets
THE DECISION THIS SUPPORTS (snaporca-x0kd): the mate connector is drawn as a simplified BEAR
FACE by default, with the standard disc + roll quadrant + Z arrow kept behind a preference.
Face orientation is hardwired perception -- a toddler reads a face's roll and verse with no
instruction -- and no abstract glyph earns that. Measured against the alternative: the disc's
gold quadrant+tick falls 89 -> 66 -> 37 -> 20 -> 3 -> 0 lit pixels as the camera drops from
47 deg to edge-on, and is a shapeless blob by 16 deg.
WHAT THE SIMPLIFICATION STUDY SETTLED (snaporca-wi3z), all measured off the real B-rep:
The eyes are load-bearing. Same outline and muzzle with the eyes removed stops reading as
a face at every size. Whatever else goes, they stay.
45 -> 22 outline vertices with no loss of read at 22 / 32 / 48 px; the muzzle reduces to
one filled triangle. Three marks plus a cheek dot.
Drawn FLAT the face fails exactly where the disc fails: in the connector's plane everything
foreshortens by sin(elevation). Rendered as its real relief instead, lit pixels at 32 px go
164 -> 210 at 16 deg and 69 -> 120 at 6 deg, and the snout ridge stands proud as a profile
rather than smearing. The glyph must be a shaded relief, not an outline.
Handedness already reads without any added mark -- 32 to 35 % of lit pixels differ from the
mirror, and re-registering by best whole-pixel translation returns offset (0,0), so it is
real shape asymmetry. But it reads only BY COMPARISON. A dot on one cheek makes it local:
34.5 / 37.0 / 36.4 %, and unlike uneven eyes (42 %) it does not read as a defect.
Tommaso's calls: it stays a bear, and handedness must read.
The scripts were repointed at the co-located male and extract_outline.py re-run from here to
prove it -- same 45 outline points, same three inner wires, same 3829.5 mm2 back plate.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
300 lines
14 KiB
HTML
300 lines
14 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<title>Mate connector glyph — polarity and verse</title>
|
|
<style>
|
|
:root {
|
|
--ground: #eceef1;
|
|
--panel: #f8f9fb;
|
|
--panel-edge: #d3d8df;
|
|
--ink: #171a1f;
|
|
--ink-soft: #5a626e;
|
|
--ink-faint: #8b93a0;
|
|
--viewport: #9aa0a8; /* the grey a CAD viewport actually is */
|
|
--viewport-2: #7f858d;
|
|
--axis-z: #2f6fed;
|
|
--axis-x: #d94a3d;
|
|
--axis-y: #3aa757;
|
|
--quadrant: #e8a317;
|
|
--anchor: #6b7280;
|
|
--driven: #2f6fed;
|
|
--warn: #c2410c;
|
|
}
|
|
@media (prefers-color-scheme: dark) {
|
|
:root {
|
|
--ground: #14171c;
|
|
--panel: #1b1f26;
|
|
--panel-edge: #2b313a;
|
|
--ink: #e8eaee;
|
|
--ink-soft: #a6aeba;
|
|
--ink-faint: #6e7784;
|
|
--viewport: #4a5058;
|
|
--viewport-2: #3a3f46;
|
|
--axis-z: #6ea2ff;
|
|
--axis-x: #ff7a6d;
|
|
--axis-y: #5fd07f;
|
|
--quadrant: #ffc247;
|
|
--anchor: #9aa3b0;
|
|
--driven: #6ea2ff;
|
|
--warn: #fb923c;
|
|
}
|
|
}
|
|
:root[data-theme="dark"] {
|
|
--ground:#14171c; --panel:#1b1f26; --panel-edge:#2b313a; --ink:#e8eaee;
|
|
--ink-soft:#a6aeba; --ink-faint:#6e7784; --viewport:#4a5058; --viewport-2:#3a3f46;
|
|
--axis-z:#6ea2ff; --axis-x:#ff7a6d; --axis-y:#5fd07f; --quadrant:#ffc247;
|
|
--anchor:#9aa3b0; --driven:#6ea2ff; --warn:#fb923c;
|
|
}
|
|
:root[data-theme="light"] {
|
|
--ground:#eceef1; --panel:#f8f9fb; --panel-edge:#d3d8df; --ink:#171a1f;
|
|
--ink-soft:#5a626e; --ink-faint:#8b93a0; --viewport:#9aa0a8; --viewport-2:#7f858d;
|
|
--axis-z:#2f6fed; --axis-x:#d94a3d; --axis-y:#3aa757; --quadrant:#e8a317;
|
|
--anchor:#6b7280; --driven:#2f6fed; --warn:#c2410c;
|
|
}
|
|
|
|
* { box-sizing: border-box; }
|
|
body {
|
|
margin: 0; padding: 40px 24px 72px;
|
|
background: var(--ground); color: var(--ink);
|
|
font: 15px/1.6 ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
|
|
}
|
|
.wrap { max-width: 1000px; margin: 0 auto; display: flex; flex-direction: column; gap: 28px; }
|
|
header { display: flex; flex-direction: column; gap: 6px; }
|
|
h1 { font-size: 26px; line-height: 1.25; margin: 0; letter-spacing: -0.01em; text-wrap: balance; }
|
|
.sub { color: var(--ink-soft); max-width: 62ch; margin: 0; }
|
|
.eyebrow {
|
|
font-size: 11px; letter-spacing: 0.12em; text-transform: uppercase;
|
|
color: var(--ink-faint); font-weight: 600;
|
|
}
|
|
h2 {
|
|
font-size: 13px; letter-spacing: 0.1em; text-transform: uppercase;
|
|
color: var(--ink-faint); margin: 16px 0 0; font-weight: 600;
|
|
}
|
|
.row { display: flex; flex-wrap: wrap; gap: 16px; }
|
|
.card {
|
|
background: var(--panel); border: 1px solid var(--panel-edge);
|
|
border-radius: 10px; padding: 18px; flex: 1 1 220px; min-width: 220px;
|
|
display: flex; flex-direction: column; gap: 10px;
|
|
}
|
|
.card.wide { flex: 1 1 100%; }
|
|
.stage { display: flex; align-items: center; justify-content: center; padding: 4px 0; }
|
|
.name { font-weight: 650; font-size: 15px; }
|
|
.note { color: var(--ink-soft); font-size: 13.5px; margin: 0; }
|
|
.k { color: var(--ink); font-weight: 600; }
|
|
table { border-collapse: collapse; width: 100%; font-size: 14px; }
|
|
th, td { text-align: left; padding: 8px 10px; border-bottom: 1px solid var(--panel-edge); vertical-align: top; }
|
|
th { color: var(--ink-faint); font-weight: 600; font-size: 12px; letter-spacing: 0.06em; text-transform: uppercase; }
|
|
code { font: 13px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace; color: var(--ink-soft); }
|
|
.legend { display: flex; flex-wrap: wrap; gap: 14px; font-size: 13px; color: var(--ink-soft); }
|
|
.swatch { display: inline-flex; align-items: center; gap: 7px; }
|
|
.dot { width: 11px; height: 11px; border-radius: 50%; display: inline-block; }
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div class="wrap">
|
|
|
|
<header>
|
|
<div class="eyebrow">SnapOrca Design · assembly</div>
|
|
<h1>Mate connector glyph — polarity and verse</h1>
|
|
<p class="sub">
|
|
Onshape's core (disc + roll quadrant + Z arrow) is adopted unchanged because it is proven and
|
|
aligned. The addition is <span class="k">polarity</span> — which connector is anchored and
|
|
which one travels — which no surveyed CAD system encodes in its glyph.
|
|
</p>
|
|
</header>
|
|
|
|
<h2>The three jobs of the glyph</h2>
|
|
<div class="row">
|
|
<div class="card">
|
|
<div class="stage">
|
|
<svg width="150" height="130" viewBox="-75 -95 150 130" aria-label="Disc with origin dot">
|
|
<ellipse cx="0" cy="0" rx="42" ry="17" fill="none" stroke="var(--ink-soft)" stroke-width="2.5"/>
|
|
<circle cx="0" cy="0" r="3.6" fill="var(--ink)"/>
|
|
</svg>
|
|
</div>
|
|
<div class="name">Disc — the XY plane</div>
|
|
<p class="note">Says “I am a frame, and this is the plane I sit in.” The dot is the exact origin.</p>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<div class="stage">
|
|
<svg width="150" height="130" viewBox="-75 -95 150 130" aria-label="Disc with one quadrant filled">
|
|
<path d="M0,0 L42,0 A42,17 0 0 1 0,17 Z" fill="var(--quadrant)" opacity="0.9"/>
|
|
<ellipse cx="0" cy="0" rx="42" ry="17" fill="none" stroke="var(--ink-soft)" stroke-width="2.5"/>
|
|
<circle cx="0" cy="0" r="3.6" fill="var(--ink)"/>
|
|
</svg>
|
|
</div>
|
|
<div class="name">Quadrant — the roll</div>
|
|
<p class="note">
|
|
The filled sector is the +X/+Y quadrant. It steps 90° with the reorient control, so the
|
|
clocking that Fastened and Slider lock is <em>visible</em> before you commit.
|
|
</p>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<div class="stage">
|
|
<svg width="150" height="130" viewBox="-75 -95 150 130" aria-label="Z arrow drawn only upward">
|
|
<path d="M0,0 L42,0 A42,17 0 0 1 0,17 Z" fill="var(--quadrant)" opacity="0.9"/>
|
|
<ellipse cx="0" cy="0" rx="42" ry="17" fill="none" stroke="var(--ink-soft)" stroke-width="2.5"/>
|
|
<line x1="0" y1="0" x2="0" y2="-58" stroke="var(--axis-z)" stroke-width="3.5" stroke-linecap="round"/>
|
|
<polygon points="0,-80 -9.5,-56 9.5,-56" fill="var(--axis-z)"/>
|
|
<circle cx="0" cy="0" r="3.6" fill="var(--ink)"/>
|
|
</svg>
|
|
</div>
|
|
<div class="name">Arrow — the verse</div>
|
|
<p class="note">
|
|
Drawn on <span class="k">+Z only</span>. Nothing below the disc. A double-headed axis is what
|
|
makes people ask which way it points; a one-sided arrow cannot be misread.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
|
|
<h2>Polarity — the part nobody else draws</h2>
|
|
<div class="row">
|
|
<div class="card">
|
|
<div class="stage">
|
|
<svg width="170" height="150" viewBox="-85 -105 170 150" aria-label="Fixed connector, open collar">
|
|
<path d="M0,0 L42,0 A42,17 0 0 1 0,17 Z" fill="var(--quadrant)" opacity="0.55"/>
|
|
<ellipse cx="0" cy="0" rx="42" ry="17" fill="none" stroke="var(--anchor)" stroke-width="2.5"/>
|
|
<line x1="0" y1="0" x2="0" y2="-56" stroke="var(--anchor)" stroke-width="3" stroke-linecap="round"/>
|
|
<polygon points="0,-80 -9.5,-56 9.5,-56" fill="none" stroke="var(--anchor)" stroke-width="3" stroke-linejoin="round"/>
|
|
<ellipse cx="0" cy="-56" rx="9.5" ry="3.6" fill="none" stroke="var(--anchor)" stroke-width="2.2"/>
|
|
<circle cx="0" cy="0" r="3.6" fill="var(--anchor)"/>
|
|
</svg>
|
|
</div>
|
|
<div class="name">Fixed — the socket</div>
|
|
<p class="note">
|
|
Hollow head, muted colour. This body <span class="k">does not move</span>. It receives.
|
|
</p>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<div class="stage">
|
|
<svg width="170" height="150" viewBox="-85 -105 170 150" aria-label="Driven connector, solid cone">
|
|
<path d="M0,0 L42,0 A42,17 0 0 1 0,17 Z" fill="var(--quadrant)" opacity="0.95"/>
|
|
<ellipse cx="0" cy="0" rx="42" ry="17" fill="none" stroke="var(--driven)" stroke-width="2.5"/>
|
|
<line x1="0" y1="0" x2="0" y2="-58" stroke="var(--driven)" stroke-width="3.5" stroke-linecap="round"/>
|
|
<polygon points="0,-80 -9.5,-56 9.5,-56" fill="var(--driven)"/>
|
|
<circle cx="0" cy="0" r="3.6" fill="var(--driven)"/>
|
|
</svg>
|
|
</div>
|
|
<div class="name">Driven — the plug</div>
|
|
<p class="note">
|
|
Solid head, active colour. This body <span class="k">is the one that jumps</span>. It inserts.
|
|
</p>
|
|
</div>
|
|
|
|
<div class="card">
|
|
<div class="stage">
|
|
<svg width="170" height="150" viewBox="-85 -105 170 150" aria-label="Degenerate roll, hatched quadrant">
|
|
<defs>
|
|
<pattern id="hatch" width="6" height="6" patternUnits="userSpaceOnUse" patternTransform="rotate(45)">
|
|
<line x1="0" y1="0" x2="0" y2="6" stroke="var(--warn)" stroke-width="2"/>
|
|
</pattern>
|
|
</defs>
|
|
<path d="M0,0 L42,0 A42,17 0 0 1 0,17 Z" fill="url(#hatch)" opacity="0.85"/>
|
|
<ellipse cx="0" cy="0" rx="42" ry="17" fill="none" stroke="var(--warn)" stroke-width="2.5" stroke-dasharray="5 4"/>
|
|
<line x1="0" y1="0" x2="0" y2="-58" stroke="var(--axis-z)" stroke-width="3.5" stroke-linecap="round"/>
|
|
<polygon points="0,-80 -9.5,-56 9.5,-56" fill="var(--axis-z)"/>
|
|
<circle cx="0" cy="0" r="3.6" fill="var(--ink)"/>
|
|
</svg>
|
|
</div>
|
|
<div class="name">Roll undefined</div>
|
|
<p class="note">
|
|
Hatched quadrant, dashed disc: a circular face or a seam gave no usable direction. Says
|
|
“pick a direction” without a dialog.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
|
|
<h2>The pair reads as a magnet</h2>
|
|
<div class="card wide">
|
|
<div class="stage">
|
|
<svg width="620" height="230" viewBox="-310 -120 620 230" aria-label="Two connectors facing each other on two plates">
|
|
<!-- lower plate (fixed) -->
|
|
<path d="M-260,52 L-60,10 L60,44 L-140,86 Z" fill="var(--viewport)" stroke="var(--viewport-2)" stroke-width="1.5"/>
|
|
<!-- upper plate (driven) -->
|
|
<path d="M-60,-96 L140,-138 L260,-104 L60,-62 Z" fill="var(--viewport)" stroke="var(--viewport-2)" stroke-width="1.5" opacity="0.55"/>
|
|
|
|
<!-- dashed field line between origins -->
|
|
<line x1="-100" y1="48" x2="100" y2="-79" stroke="var(--ink-faint)" stroke-width="2" stroke-dasharray="7 6"/>
|
|
|
|
<!-- FIXED connector, pointing up (+Z out of the lower plate) -->
|
|
<g transform="translate(-100,48)">
|
|
<path d="M0,0 L38,0 A38,15 0 0 1 0,15 Z" fill="var(--quadrant)" opacity="0.5"/>
|
|
<ellipse cx="0" cy="0" rx="38" ry="15" fill="none" stroke="var(--anchor)" stroke-width="2.4"/>
|
|
<line x1="0" y1="0" x2="0" y2="-48" stroke="var(--anchor)" stroke-width="3" stroke-linecap="round"/>
|
|
<polygon points="0,-70 -9,-48 9,-48" fill="none" stroke="var(--anchor)" stroke-width="3" stroke-linejoin="round"/>
|
|
<ellipse cx="0" cy="-48" rx="9" ry="3.4" fill="none" stroke="var(--anchor)" stroke-width="2"/>
|
|
<circle cx="0" cy="0" r="3.4" fill="var(--anchor)"/>
|
|
</g>
|
|
|
|
<!-- DRIVEN connector, pointing down (+Z out of the upper plate's underside) -->
|
|
<g transform="translate(100,-79) rotate(180)">
|
|
<path d="M0,0 L38,0 A38,15 0 0 1 0,15 Z" fill="var(--quadrant)" opacity="0.9"/>
|
|
<ellipse cx="0" cy="0" rx="38" ry="15" fill="none" stroke="var(--driven)" stroke-width="2.4"/>
|
|
<line x1="0" y1="0" x2="0" y2="-50" stroke="var(--driven)" stroke-width="3.4" stroke-linecap="round"/>
|
|
<polygon points="0,-70 -9,-48 9,-48" fill="var(--driven)"/>
|
|
<circle cx="0" cy="0" r="3.4" fill="var(--driven)"/>
|
|
</g>
|
|
|
|
<text x="-100" y="102" text-anchor="middle" font-size="13" fill="var(--ink-soft)">fixed · receives</text>
|
|
<text x="100" y="-100" text-anchor="middle" font-size="13" fill="var(--ink-soft)">driven · inserts</text>
|
|
</svg>
|
|
</div>
|
|
<p class="note">
|
|
Two arrows nose to nose. Because a magnet's north seeks a south, <span class="k">“facing” is the
|
|
self-evident default</span> — which settles open decision D1 on visual grounds instead of a
|
|
convention nobody can look up. Nothing has to be remembered: the picture is the rule.
|
|
The dashed line is what makes the two glyphs read as one object.
|
|
</p>
|
|
</div>
|
|
|
|
<h2>States</h2>
|
|
<div class="card wide">
|
|
<table>
|
|
<thead>
|
|
<tr><th>State</th><th>Drawing</th><th>Why</th></tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><span class="k">Candidate</span> (hover)</td>
|
|
<td>small dot only</td>
|
|
<td>Onshape draws plain white dots at every corner and midpoint. Dots propose; the full glyph commits.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="k">Picked</span></td>
|
|
<td>disc + quadrant + cone</td>
|
|
<td>The committed frame, with roll and verse both readable.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><span class="k">Roll undefined</span></td>
|
|
<td>hatched quadrant, dashed disc</td>
|
|
<td>Turns requirement R8 from a message nobody reads into a mark you cannot miss.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<h2>Constraints on the drawing</h2>
|
|
<div class="card wide">
|
|
<p class="note">
|
|
<span class="k">Do not make it a fourth RGB triad.</span> The bed-centre world triad
|
|
(<code>DesignCanvas.cpp:65</code>) and the move gizmo are already three coloured arrows. The disc
|
|
and the quadrant are what tell a connector apart from those — keep the arms short, and consider
|
|
drawing only Z on the committed glyph, with X and Y implied by the quadrant.
|
|
</p>
|
|
<div class="legend">
|
|
<span class="swatch"><i class="dot" style="background:var(--quadrant)"></i> roll quadrant</span>
|
|
<span class="swatch"><i class="dot" style="background:var(--axis-z)"></i> Z / driven</span>
|
|
<span class="swatch"><i class="dot" style="background:var(--anchor)"></i> fixed</span>
|
|
<span class="swatch"><i class="dot" style="background:var(--warn)"></i> roll undefined</span>
|
|
</div>
|
|
</div>
|
|
|
|
</div>
|
|
</body>
|
|
</html>
|