Vista 3D del modello in una pagina HTML autonoma

Aggiunge --3d: genera un file HTML che si apre con un doppio clic e
permette di ruotare il pezzo col mouse, ingrandire con la rotella e
spostare col tasto destro. Mesh, stile e codice sono dentro la pagina:
nessuna libreria esterna e nessuna connessione, cosi' funziona anche da
una cartella di rete. Il disegno usa una canvas 2D con ordinamento per
profondita' invece di WebGL, che su alcune postazioni e' disattivato.

La forma non viene dal .prt ma da una mesh STL esportata da Creo, cercata
accanto al modello per nome (9258400207.prt.11 -> 9258400207.stl). Se
manca, il comando lo dice invece di fallire.

Perche' serve la mesh: la geometria nel .prt e' scritta nel formato del
kernel Granite di PTC ed e' compressa. Verificato con un attacco a testo
noto, presi da un export STEP i 22 valori esatti del modello (raggi 1,6 /
2,1 / 2,5 / 2,75 / 5,25 e coordinate fino a 75,0) e cercati nel file in
cinque codifiche su tutti i blocchi: nessun riscontro. La via ufficiale
per leggere i .prt nativi senza Creo e' il Granite Interoperability
Kernel di PTC, che si innesterebbe al posto di mesh.py senza toccare il
resto.

Quando la mesh c'e', il record guadagna un blocco "geometry" con
ingombro, volume e area. Il peso NON viene calcolato: servirebbe la
densita', che dipende dal materiale, e il materiale e' testo libero.
Sul 9258400207 il parametro dice "Anticordal 100", che e' alluminio:
applicare la densita' dell'acciaio darebbe 0,686 kg invece di 0,237.

Gli export (stl, dxf, dwg, iges, pdf) sono esclusi dal repository come i
modelli: sono geometria e tavole complete dei pezzi.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

creoparams/extract.py

@@ -93,7 +93,7 @@ def _aggregate(occurrences: list) -> dict:
     return dict(sorted(result.items()))
 
 
-def extract(path: str, expected: "list[str] | None" = None) -> dict:
+def extract(path: str, expected: "list[str] | None" = None) -> dict:  # noqa: C901
     """Estrae i metadati da un singolo file. Solleva ugc.NotACreoFile se il
     file non e' un nativo Creo riconoscibile."""
     with open(path, "rb") as handle:
@@ -156,9 +156,48 @@ def extract(path: str, expected: "list[str] | None" = None) -> dict:
     if container.base_kind == "DRAWING":
         record["drawing"] = drawing.read(data)
 
+    # Se accanto al modello c'e' una mesh esportata, ne ricaviamo ingombro e
+    # volume: sono le uniche grandezze geometriche ottenibili senza Creo.
+    if holds_parameters:
+        try:
+            geometry = read_mesh(path)
+        except (OSError, ValueError):
+            geometry = None
+        if geometry is not None:
+            record["geometry"] = geometry.to_dict()
+            record["geometry"]["source_kind"] = "mesh esportata"
+
     return record
 
 
+#: Estensioni di mesh cercate accanto al modello, in ordine di preferenza.
+MESH_EXTENSIONS = (".stl", ".STL")
+
+
+def find_mesh(path: str) -> "str | None":
+    """Cerca una mesh esportata accanto al modello.
+
+    La geometria dei .prt non e' leggibile senza la libreria di PTC, quindi
+    la forma arriva da un file esportato con lo stesso nome: 9258400207.prt.11
+    -> 9258400207.stl.
+    """
+    directory = os.path.dirname(os.path.abspath(path))
+    stem, _, _ = split_filename(os.path.basename(path))
+    for extension in MESH_EXTENSIONS:
+        candidate = os.path.join(directory, stem + extension)
+        if os.path.isfile(candidate):
+            return candidate
+    return None
+
+
+def read_mesh(path: str):
+    """La mesh associata al modello, o None se non e' stata esportata."""
+    from . import mesh as mesh_module
+
+    found = find_mesh(path)
+    return mesh_module.read_stl(found) if found else None
+
+
 def read_preview(path: str):
     """L'anteprima incorporata nel file, o None se assente.