# Il solido di un `.prt`: B-rep, mesh ed esportazione STEP senza Creo Come si ricava la **forma** di una parte dal file, e come la si scrive in STEP per vederla. È reverse engineering (script Python in `scripts/psb/`, non fa parte dell'app), ma a differenza degli altri doc di formato qui **quasi tutto è provato contro Creo**: tre coppie `.prt` + `.stp` esportato da Creo dallo stesso modello hanno fatto da oracolo. Il formato delle sezioni è in [`formato-psb.md`](formato-psb.md); stato del lavoro e punti aperti in [`history.md`](history.md). ## 1. Due strade, secondo chi ha salvato il file | | File salvato da Creo (generazione ≥ 1632) | File salvato da Wildfire (1322-1430) | |---|---|---| | `VisibGeom` (B-rep esatto) | tipo `9`, leggibile | tipo `b`/`11`, **cifrata** | | `SolidPrimdata` (mesh di visualizzazione) | di solito **senza mesh** | mesh presente, solo compressa | | Strada | `brep.py`: STEP con superfici vere | `mesh.py`: STEP **sfaccettato** (triangoli piani) | | Risultato | identico allo STEP di Creo | stessa forma entro la sfaccettatura (volume 0,05-0,2%) | Le due strade sono complementari: dove manca una c'è l'altra. La generazione è il secondo numero dopo `PART` nella prima riga del file. ```powershell python scripts/psb/brep.py --step out.stp # B-rep esatto python scripts/psb/brep.py --check rif.stp # confronto faccia per faccia con lo STEP di Creo python scripts/psb/mesh.py --step out.stp # STEP sfaccettato dalla mesh ``` ## 2. Il B-rep: `VisibGeom` Radice `Sld_VisGeom` → `active_geom`, con tre array: `srf_array` (superfici), `crv_array` (spigoli), `qlt_array` (quilt). ### 2.1 Superfici | Campo | Significato | Prova | |---|---|---| | `geom_id` | id della superficie | | | `geom_type` | 34 piano, 36 cilindro, 37 cono, 38 toro, 40 superficie spline, 44 `tab_cyl` | tipo uguale allo STEP su 246 facce | | `feat_id` | feature che l'ha generata | | | `orient` | `1`: il verso della faccia è la normale naturale (∂u × ∂v); `-1`: opposto. È il `same_sense` dello STEP | 246 facce su 246 | | `envlp` | inviluppo `[[u_min, v_min], [u_max, v_max]]` in coordinate parametriche | | | `srf_prim_ptr(...)` | la primitiva: `local_sys` più i suoi parametri | sotto | | `frst_cntr_ptr`, `next_cntr_ptr` | lista concatenata dei contorni | 281 contorni = 281 loop dello STEP | | `topol_ref_data.list_type` | 98 = faccia del solido, 57 = faccia di una quilt (`list_id` = id della quilt) | gusci chiusi/aperti uguali allo STEP | Le superfici senza contorno (`frst_cntr_ptr` nullo, `boundary_type` 6) non fanno parte del solido e si scartano. **Non tutte le superfici stanno in `VisibGeom`.** Quelle a cui è agganciato un asse di riferimento stanno in `ActDatums`, stesso formato, stessa catena `next_geom_ptr`. Sintomo: spigoli che citano un `geom_id` inesistente e due contorni in meno rispetto allo STEP. ### 2.2 `local_sys`: gli assi sono le colonne `local_sys` è 4×3: tre righe di una matrice `R` e l'origine `o`, con ```text mondo = o + R · locale ``` Gli assi locali sono quindi le **colonne** di `R`, non le righe. Leggerle per righe funziona solo sulle matrici simmetriche (l'identità) e sbaglia tutte le altre: era l'errore di `formato-prt-geometria.md` §6.1, e spiega l'"asse incerto" di Foro 3 lì descritto. Parametrizzazioni (`ex`, `ey`, `ez` = colonne di `R`): | Tipo | Punto a `(u, v)` | Parametri | |---|---|---| | piano | `o + u·ex + v·ey` | | | cilindro | `o + r·(cos u·ex + sin u·ey) + v·ez` | `radius` | | cono | `o + v·tan(α)·(cos u·ex + sin u·ey) + v·ez` (vertice in `o`) | `half_angle`, può essere **negativo** | | toro | `o + (R + r·cos v)·(cos u·ex + sin u·ey) + r·sin v·ez` | `radius1` = R, `radius2` = r | | spline | pezza di Hermite bicubica: `i_points`, `end_u_tangts`, `end_v_tangts`, `end_uv_deriv`; l'angolo `(a, b)` sta all'indice `2a + b` | solo una maglia (`u_params` = `v_params` = `[0, 1]`) | Prova: il vincolo di §2.4 su 4472 spigoli di 22 file; il toro è provato solo così (nessuno STEP di riferimento con un toro). ### 2.3 Spigoli e contorni Uno spigolo (`crv_array`) **non ha una curva 3D**. Ha i campioni della curva nelle coordinate parametriche delle due superfici che separa: | Campo | Significato | |---|---| | `crv_hdr_geom_ptr[0]`, `[1]` | le due superfici (lato 0 e lato 1); `0` = nessuna, bordo libero di una quilt | | `crv_pnt_arr` | campioni `[u0, v0, u1, v1]`: lo stesso punto sulle due superfici | | `crv_pnt_dir[k]` | `1` se il contorno della superficie `k` percorre i campioni in avanti, `-1` all'indietro | | `next_crv_hdr_ptr[k]` | lo spigolo successivo nel contorno della superficie `k` | Un contorno si percorre partendo da `frst_cntr_crv_hdr_ptr` e seguendo `next_crv_hdr_ptr` del lato che guarda la superficie, fino a tornare al primo. `trv = 1` è un contorno esterno, `trv = -1` un foro. Una superficie Creo può avere **più contorni esterni** (regioni staccate dello stesso piano): lo STEP di Creo ne fa una faccia per ciascuno, e un foro va al contorno esterno il cui inviluppo UV lo contiene. La curva 3D si ricostruisce: i campioni si interpolano in UV sulla superficie curva (lì cerchi e generatrici sono rette), poi la polilinea si riconosce come retta, cerchio o altro. Su 357 spigoli il tipo coincide sempre con quello scelto da Creo. Limite: fra due superfici curve qualsiasi l'interpolazione fra i campioni è un'approssimazione, e nello STEP quelle curve sono polilinee. ### 2.4 Il vincolo che regge tutto Lo stesso campione, calcolato sulle due superfici dello spigolo, deve dare lo stesso punto. Non richiede né Creo né uno STEP, e sbaglia in modo vistoso (millimetri) appena un numero è decodificato male. È il controllo di regressione di questa parte (`brep.py` lo stampa sempre) ed è ciò che ha corretto la tabella dei `double` (`tagfit.py`, [`formato-psb.md`](formato-psb.md) §3.4). Sugli spigoli analitici lo scarto è 1e-13 mm; sulle intersezioni non analitiche arriva a qualche millesimo, che è la precisione con cui Creo le salva. ## 3. La mesh: `SolidPrimdata` Sezione compressa (`unz.py`), mai cifrata. Radice `pgl_primdata_group_table` → `pgl_primdata_groups_arr`: un gruppo per livello di dettaglio (`lod_value`; si usa quello con più triangoli). Dentro, primitive di due famiglie: - **filo**: `prim_arc` (`center_d`, `radius_d`, angoli, `plane_orientation`), `prim_multiline` e `prim_multipoly` (`pts`); - **facce**: `prim_tristripsetwithatt`, circa una per faccia del modello. `mv_p_NxNyNzxyz` è una lista di vertici da 6 `float` (normale, poi punto); `p_accum_set_size` dà la fine cumulata di ogni striscia di triangoli. Il verso dei triangoli lo decide la normale del vertice. Sul campione con STEP: 1518 vertici tutti sulle superfici dello STEP, normali unitarie, mesh chiusa. La mesh dipende dalla tabella dei `float` ([`formato-psb.md`](formato-psb.md) §3.4), nota per 81 tag su 144: `mesh.py` **si ferma** se la mesh usa un tag ignoto, non inventa il valore. ## 4. Prove | Campione | Strada | Esito | |---|---|---| | `9245000212.prt.6` (Creo) | B-rep | 176 facce su 176 uguali allo STEP di Creo (contorni, tipo, verso, raggi, gusci 173 + 3); curve 582 rette, 270 cerchi, 162 spline tutte dello stesso tipo; volume 479071,6 contro 479069,2 | | `9284212392.prt.14` (Creo) | B-rep | 70 facce su 70; 10 quilt da 2 facce come Creo; volume uguale a 9 cifre (259458,935) | | `9284212178.prt.2` (Wildfire) | mesh | 1116 triangoli, solido chiuso; volume 136320,9 contro 136251,1 (0,05%) | | `raw/` (76 `.prt`, senza STEP) | B-rep | 26 solidi validi in OpenCascade; in 20 il volume torna con quello di `BasicText` entro 3e-4 | "Valido" e i volumi sono calcolati con OpenCascade (`cadquery-ocp`) sugli STEP prodotti, quindi con un kernel indipendente. I campioni con STEP non sono nel repo. ## 5. Cosa non regge ancora - **Sei parti di `raw/`** (cuscinetti, viti, pezzi con tori) danno un solido valido ma un volume diverso dall'1 al 9% da quello scritto nel `.prt`; `cusci_dgbb7` dà volume **negativo**. Non è deciso se sia un errore di orientamento o un volume non aggiornato nel file: serve una coppia con STEP di un pezzo tornito con raccordi. - **`tab_cyl`** (tipo 44, estrusione di una spline) e spline a più maglie: non gestite. - **Foro senza contorno esterno** (`9251200244.prt.16`): la regola dell'inviluppo non basta. - **Cifratura** dei file Wildfire: entropia 7,995 bit/byte, chiave diversa per sezione e per file (48 campioni con lo stesso testo in chiaro iniziale, nessuna relazione con lunghezza o checksum dell'indice). Non riprovare con XOR o chiavi derivate dall'indice. Rimedi: la mesh, oppure riaprire e risalvare il file in Creo. - **STEP sfaccettato**: un cilindro resta fatto di triangoli. Ricostruire piani, cilindri e coni dalla mesh è possibile (gli insiemi di strisce corrispondono quasi alle facce: 38 contro 46 sul campione) ma sarebbe una stima, non una lettura. - **Tabella dei `float`**: 63 tag ancora ignoti. Ogni coppia `.prt` Wildfire + `.stp` risolve quelli che usa (`fltfit.py`).