This commit is contained in:
2026-09-09 18:06:21 +08:00
parent 161af68fe3
commit 45b9f9ed5d
79 changed files with 1167 additions and 1532 deletions
@@ -89,19 +89,17 @@
<p>The STL file editor points a geometry at an <code>.stl</code> file rather than describing a shape: the model
holds a file reference, and the editor is a picker over it plus a read-only summary of what was
loaded. On the web the file lives on the <strong>server</strong>, not on the machine running the browser, and
loaded. The file lives on the <strong>server</strong>, not on the machine running the browser, and
that difference shapes everything else on the page.</p>
<h2 id="layout">Layout</h2>
<ol>
<li><strong>File reference</strong> — a read-only field showing the path currently referenced, with an empty-state
hint when there is none.</li>
<li><strong>The picker</strong> — on the web a <strong>Select</strong> dropdown whose menu holds <em>Browse…</em>, <em>Browse Resource…</em>
and, only while a path is set, <em>Clear</em>. Either Browse entry opens the in-app File Explorer dialog
filtered to <code>.stl</code>. In the desktop client this is a <strong>Browse</strong> button opening the operating
system's file dialog, beside a <strong>Reload</strong> button and a status line; the web has no Reload.</li>
<li><strong>STL info</strong> — behind an info icon on the web, opening a dialog; a collapsed <em>Information</em>
expander in the desktop client. Both show the triangle count and the bounding box as read-only
vector rows, and the web dialog states an empty case when nothing is loaded.</li>
<li><strong>The picker</strong> — a <strong>Select</strong> dropdown whose menu holds <em>Browse…</em>, <em>Browse Resource…</em> and, only
while a path is set, <em>Clear</em>. Either Browse entry opens the in-app File Explorer dialog filtered
to <code>.stl</code>. There is no reload action.</li>
<li><strong>STL info</strong> — behind an info icon, opening a dialog that shows the triangle count and the
bounding box as read-only vector rows, and states an empty case when nothing is loaded.</li>
</ol>
<h2 id="behavior">Behavior</h2>
<ul>
@@ -115,8 +113,8 @@ re-homed path, not the one that was chosen.</li>
walking the triangles rather than kept resident. Only Min and Max come back from the server;
Dimension and Center are derived in the browser from them.</li>
<li><strong>The picker previews.</strong> Double-clicking an <code>.stl</code> row in the File Explorer dialog swaps its slave
panel to a 3D preview of that file before the pick is confirmed — a capability the desktop file
dialog has no equivalent of. The dialog opens with that panel hidden, which is why the double-click
panel to a 3D preview of that file before the pick is confirmed. The dialog opens with that panel
hidden, which is why the double-click
is the gesture that reaches a preview there; a single click does so only once the toolbar's pencil
has revealed the panel. The preview belongs to the File Explorer rather than to this editor — see
<a class="xref" href="../util/stl-preview-pane.html">STL Preview Pane</a>.</li>