Files
prep-step/docs/formato-prt-brep.md
T
davideandClaude Opus 5.5 3396df6be0 Leggi il solido dei .prt ed esportalo in STEP senza Creo
- scripts/psb/brep.py: B-rep esatto da VisibGeom/ActDatums riscritto in
  STEP; coincide faccia per faccia con lo STEP di Creo su due campioni.
- scripts/psb/mesh.py: STEP sfaccettato dalla mesh di SolidPrimdata, per
  i file Wildfire in cui VisibGeom e' cifrata.
- psb.py: tabella dei double corretta (modi a 3/6 byte, prefissi con
  buchi, costanti 04 e 0d, tag ee); tabella dei float a 81 voci, i tag
  ignoti non ricevono piu' un valore inventato; struct dichiarate sotto
  due id.
- tagfit.py, fltfit.py, stepread.py: verifica delle tabelle con vincoli
  geometrici e confronto con lo STEP di Creo.
- docs: nuovo formato-prt-brep.md e lettura-prt-asm.md; correzioni in
  formato-psb.md (3.4) e formato-prt-geometria.md (assi di local_sys =
  colonne); history.md con regressioni e punti aperti.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 09:00:51 +01:00

158 lines
8.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 <file.prt.N> --step out.stp # B-rep esatto
python scripts/psb/brep.py <file.prt.N> --check rif.stp # confronto faccia per faccia con lo STEP di Creo
python scripts/psb/mesh.py <file.prt.N> --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`).