Files
prep-step/docs/lettura-prt-asm.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

241 lines
15 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.
# Leggere un `.prt` e un `.asm`: sintesi e dati estraibili
Riassunto in un posto solo di **come si legge un file Creo senza aprire Creo** e di **cosa se ne
ricava**. Non sostituisce i doc di formato: è la mappa che dice quale aprire per ogni domanda.
I dettagli (byte, tabelle, casi limite) stanno in [`formato-psb.md`](formato-psb.md),
[`formato-asm-record.md`](formato-asm-record.md), [`formato-prt-feature.md`](formato-prt-feature.md)
e [`formato-prt-geometria.md`](formato-prt-geometria.md); qui solo il quadro e i rimandi.
## 1. Cosa è in produzione e cosa è solo studio
| Cosa | Stato | Dove |
|---|---|---|
| Elenco dei componenti di un `.asm` (`members`), istanze di family table, nome proprio | **nel codice**, validato contro BOM Creo | `AsmRecordReader`, `scripts/CreoBom.cs` |
| Componenti soppressi e riferimenti esterni di un `.asm` | **nel codice** | `EstraiCodiciSoppressi`, `EstraiCodiciRiferimentiEsterni` |
| Euristica testuale (codici citati almeno due volte) | **nel codice**, solo fallback | `AssemblyComponentScanner` |
| Qualsiasi altra sezione di un `.prt`/`.asm` (feature, quote, geometria, massa, parametri...) | **solo reverse engineering**, parser di riferimento in Python | `scripts/psb/` |
Nessun valore decodificato dal parser PSB è stato ancora confrontato con Creo, salvo i casi
citati nei doc di formato: il *significato* dei campi è dedotto dal nome (livelli di prova in
[`history.md`](history.md)). Per la distinta base vale invece il livello forte: confronto riga per
riga con BOM esportate da Creo.
## 2. Il contenitore, uguale per `.prt` e `.asm`
Un file Creo è un contenitore "UGC": un'intestazione ASCII, un indice, poi le sezioni una dopo
l'altra. `.prt` e `.asm` differiscono solo per il tipo (`PART`/`ASSEMBLY`) nella prima riga e per le
sezioni presenti.
```text
#UGC:2 PART 1632 ... 000002cc \ tipo, generazione del formato, lunghezza dell'intestazione
#- VERS / HOST / UOBJ_ID / CMNM campi a righe fisse
#-END_OF_UGC_HEADER
#Creo TM 2.0 ... M200 versione di Creo che ha salvato
#UGC_TOC ... indice: nome offset lunghezza dimensione generazione tipo ...
```
Per trovare una sezione:
1. L'ultimo campo della prima riga (`000002cc`) è la costante da sommare agli offset dell'indice.
2. Ogni sezione comincia con una riga `#<Nome>`, compresa nell'offset e nella lunghezza.
3. L'indice è **a catena**: `NEXT_TOC_ENTRY` punta a un secondo indice in fondo al file.
Il campo `tipo` dell'indice dice come è conservato il corpo:
| Tipo | Contenuto | Si legge? |
|---|---|---|
| `9` | PSB in chiaro | sì |
| `a` | PSB compresso Unix `compress` (LZW) | sì, dopo la decompressione |
| `11` (JPEG) | miniatura del modello (`THMB_IMG_MAIN`) | è un'immagine |
| `b`, `11` dei file Wildfire | non decodificato | **no** |
| `c` | `DispDataTable` | no |
La **generazione** (secondo numero dopo `PART`/`ASSEMBLY`: `1322`...`2063`) conta: i file salvati
da Wildfire (`1322`, `1375`, `1376`) hanno quasi tutte le sezioni illeggibili. Il rimedio pratico è
riaprirli in Creo e risalvarli (diventano tipo `9`). Fa eccezione `members` dei `.asm`, che è
sempre in chiaro: per questo `AsmRecordReader` funziona anche sui file vecchi.
## 3. Il formato delle sezioni: PSB
Il corpo è una serializzazione a marcatori di strutture C. Regole minime per leggerlo:
- I byte `e0`-`ff` sono **marcatori**, gli altri sono dati. `e0 <tipo> <nome>\0` dichiara un campo
e ne dà il valore; gli elementi successivi di un array sono **posizionali**, senza nomi.
- Un campo è scritto col nome **una sola volta**: dopo, i valori arrivano nudi e chi legge
deve sapere "dopo il campo X viene il campo Y" (tabella `next[id]`).
- **Interi**: 1 byte (`00`-`7f`), 2 byte (`80`-`bf`, 14 bit), 3 byte (`c0`-`df`, 21 bit), più
forme grezze `e8`-`eb` e `f5`/`f6`.
- **`double`**: il primo byte è un tag che codifica il byte alto e quanti byte seguono (`2f 59 00`
= 100; `18` = 0; `0f` = 1). Tabella completa in `formato-psb.md` §3.2.
- **`float` a 32 bit** (tipo `06`, usato nella mesh di visualizzazione): la tabella dei prefissi
`50`-`df` **non è completa**, quindi la mesh non è esportabile.
- **Stringhe**: Latin1 terminate da `\0`. Il file si legge come testo Latin1 (1 byte = 1 carattere).
Grammatica completa e algoritmo di lettura: [`formato-psb.md`](formato-psb.md) §2-§4.
## 4. Leggere un `.asm`
### 4.1 La distinta: sezione `members`
È l'unico caso già in produzione. `members` è l'elenco dei componenti diretti (livello 1), un
record per **occorrenza**:
| Campo | Significato |
|---|---|
| `id` | id del componente dentro questo assieme (il "Componente ID N" di Creo) |
| `type` | `1` = sottoassieme (`.asm`), `2` = parte (`.prt`) |
| `name` | il file su disco, senza estensione (per le family table è il **generico**) |
| `e1`, `e2`, `e3`, `origin` | matrice di posizionamento: presente nel file, **non letta** dal codice |
Il conteggio dichiarato `N` fa da controllo: se i record trovati non sono `N`, `LeggiMembri` lancia
`InvalidDataException` e la fase 4 ripiega sull'euristica testuale.
### 4.2 Cosa si ricava, e dove sta
| Dato | Dove nel `.asm` | Note |
|---|---|---|
| Componenti diretti, tipo, quantità | `members` | un record per occorrenza: la quantità si ottiene contando |
| Nome istanza di una family table di parte | record parametro `ConfigName` (`<istanza>`, id del membro) | la BOM stampa l'istanza, il disco contiene il generico |
| Istanza da pattern/array feature | `ConfigName` con suffisso `#AF<n>` | il suffisso va tolto: non è una family table |
| Istanza scritta dentro `name` | `<istanza><generico>` nel record `members` | il generico è il file da cercare nell'indice |
| Nome proprio del modello | primo record `objname` | la BOM intesta i blocchi con questo, non col nome del file |
| Componenti **soppressi** | stringa `Componente ID <n> (<codice>.PRT)` fuori da `members` | fuori dalla BOM, ma **il file serve** per aprire l'assieme |
| **Riferimenti esterni** (assembly feature, datum copiati) | tabella a parte, array `f2 f7 05 ... f3` | fuori dalla BOM, il file serve e si ricorre dentro |
| Family table di assiemi (sorelle) | `model_name` + `stamp` (solo i nomi) | confermata dal nome proprio; il contenuto delle istanze non è decodificato |
| BOM ricorsiva con quantità moltiplicate | `scripts/CreoBom.cs` | visita depth-first, un blocco per modello |
| Parametri, massa, unità, layer, viste, nomi | sezioni PSB come in un `.prt` (§5) | solo reverse engineering |
Due liste da non confondere ([`formato-asm-record.md`](formato-asm-record.md) §7.3): i componenti
della **distinta** sono i `members`; i file **necessari per aprire** l'assieme sono i `members` più
i soppressi più i riferimenti esterni. Chi popola `raw/` usa l'unione; chi verifica la completezza
usa solo i `members`.
### 4.3 Cosa il `.asm` non dice
- **Il percorso** dei figli: registra il nome del modello, non la cartella né la revisione attesa.
Creo apre la revisione più alta; se lo stesso codice esiste in più cartelle, vince la copia
accanto all'assieme (`ScegliPerCartella`, §7.4 del doc dei record).
- La matrice di posizionamento e i campi numerici dell'header dopo `ASSEMBLY`: non decodificati.
## 5. Leggere un `.prt`
Un `.prt` ha le stesse sezioni PSB di un assieme, più quelle geometriche. Catalogo dei dati
(nomi di sezione e radice come nel file; dettaglio in `formato-psb.md` §5):
| Dato | Sezione | Cosa contiene |
|---|---|---|
| Massa e unità | `BasicText` | `density`, `volume`, `cg`, `inertia`, `surfarea`, `unit_arr` (`MM`, `KILOGRAM`, `SECS`) |
| Tolleranze di default | `BasicData` | tabelle ISO 2768, tabelle dei fori |
| **Quote** | `FullMData` | `dim_array`: `dim_type`, `feat_id`, `value`, `tol_ptr.value` |
| Modelli referenziati | `FullMData` | `ref_part_table` |
| **Elenco e ordine delle feature** | `AllFeatur` | lista concatenata: `id`, `feat_type_ptr.type`, `sect_name` |
| Definizione di ogni feature | `FeatDefs`, `FeatDefsDtm` | schizzi, istruzioni di posizionamento, parametri del foro |
| Tipi di feature presenti | `FeatDefsIndex` | `feat_defs_index` |
| Storico di modellazione | `MdlStatus` | un record per azione, con utente, data, nome e icona |
| **B-rep** | `VisibGeom`, `NovisGeom` | superfici (`srf_array`: piano, cilindro, cono...), contorni, spigoli (`crv_array`) |
| Piani, assi, punti, sistemi di coordinate | `ActEntity`, `ActDatums`, `MdlRefInfo` | entità di riferimento con `local_sys` 4×3 |
| **Nomi, parametri, relazioni** | `LargeText` | `names_table`, `symtbl` (`DENOMINAZIONE`, `PRO_MP_*`...), `relset_code_tree` |
| Layer | `DispCntrl` | layer con gli id contenuti |
| Family table | `FamilyInf` | `gen_name`, `info_items` |
| Sezioni trasversali | `Xsections` | nomi e geometria |
| Viste salvate | `ModelView#n` | matrici 4×4 di orientamento |
| Ingombro | `SolidPersistTable` (compressa) | `xyz_min_max`, `bounding_radius` |
| Geometria di visualizzazione | `SolidPrimdata` (compressa) | archi, linee, mesh di normali e vertici |
| Miniatura | `THMB_IMG_MAIN` | JPEG |
| Nome, tipo e dipendenze del modello | `ND:0:*` (compresse) | `PSB_Tokens`: le stringhe si leggono, il significato dei token no |
### 5.1 L'albero delle feature
Si ricostruisce come lo mostra Creo, con questi passi (`formato-prt-feature.md` §6 e §9):
1. `AllFeatur` dà ordine, `id` e **tipo** di ogni feature.
2. I **piani interni** (creati da Creo aprendo uno schizzo) vanno scartati: si riconoscono dal blocco
degli attributi.
3. I **nomi si calcolano**: famiglia + contatore nell'ordine di `AllFeatur` (`Sketch n`,
`Estrusione n`, `Foro n`...). Protrusioni e tagli condividono un solo contatore. I nomi dei
piani stanno in `sect_name`; gruppi (tipo `1104`) e sezioni (`1052`) hanno nomi in `LargeText` e
`Xsections`.
4. Lo storico `MdlStatus` aggiunge nome e icona esatti per le feature che lo contengono.
Tipi di feature riconosciuti: 911 foro, 913 raccordo, 914 smusso, 916 taglio, 917 protrusione, 923
piano, 926 asse, 928 guscio, 931 punto, 949 schizzo/curva, 979 sistema di assi, 1000 componente di
assieme, 1052 sezione, 1104 gruppo. **Estrusione e rivoluzione hanno lo stesso tipo**: li
distingue solo l'icona dello storico.
Limite noto: se una feature è stata cancellata, i contatori possono slittare (Creo chiama "Sketch 4"
uno schizzo che per il file è il terzo).
### 5.2 Quote, schizzi, posizione
- **Quote** (`dim_array`): il valore è affidabile, il *significato* (`dim_type`) solo in parte:
`1`/`2` lineare o diametrale di schizzo, `3` raggio, `4` diametro, `9` distanza o profondità del
filetto, `62` profondità. Le tolleranze (`h7`) sono indici, non stringhe: non decodificate.
- **Schizzi** (`p_saved_result`): linee con estremi `(x, y, z)` nel sistema dello schizzo, cerchi
con centro e raggio. Provato su *Rivoluzione 1* contro Creo.
- **Posizione nello spazio**: ogni piano, asse, schizzo e foro ha una matrice `local_sys` 4×3 = tre
versori più l'**origine**. La posizione assoluta di un foro si legge dall'origine, non dalle quote
di posizionamento.
- **Foro** (`feat_defs_911`): stringhe del filetto (`ISO`, `M8x1.25`), `drillnum`, e istruzioni con
`type` e `offset` (diametro punta, angolo punta, profondità, passo). Un foro è "standard" se ha le
istruzioni di passo e angolo, non dalle sole stringhe.
- **Piano di riferimento** (`feat_defs_923`): una istruzione per ogni riferimento, con `geometry1_id`
risolvibile in `VisibGeom`/`ActDatums` (da cui si risale alla feature d'origine).
- **Raccordi e smussi**: valore nel `dim_array`; le superfici di bordo si risolvono, lo spigolo
preciso no.
### 5.3 Geometria del solido
Il solido si ricava per due strade ([`formato-prt-brep.md`](formato-prt-brep.md)): dai file salvati
da Creo si legge il **B-rep esatto** (`VisibGeom` più le superfici in `ActDatums`) e lo si esporta
in uno STEP che coincide faccia per faccia con quello di Creo; dai file Wildfire, in cui
`VisibGeom` è cifrata, si legge la **mesh** di `SolidPrimdata` e si esporta uno STEP sfaccettato.
Attenzione a `local_sys`: gli assi locali sono le colonne della matrice, non le righe.
## 6. Cosa non si ricava (ancora)
| Dato | Motivo |
|---|---|
| Qualsiasi sezione dei file Wildfire (`1322`, `1375`, `1376`) e sezioni tipo `b` | non decodificate: serve una coppia chiaro/cifrato dello stesso modello |
| Mesh di visualizzazione di una parte dei file Wildfire | tabella dei prefissi `float` nota per 81 tag su 144 |
| Superfici vere (non triangoli) dai file Wildfire | `VisibGeom` cifrata: resta solo la mesh |
| Posizione dei componenti in un assieme | matrice `e1`/`e2`/`e3`/`origin` di `members` non letta |
| Tolleranze, unità lette solo da `BasicText` | `tol_ptr` ha indici, non stringhe |
| Feature nascoste o soppresse in un `.prt` | non individuato dove sia lo stato |
| Estrusione vs rivoluzione, direzione e profondità | non decodificato (solo l'icona dello storico) |
| Opzioni del foro (maschiato, diritto, superficie del filetto) | non individuate |
| Contenuto di ogni istanza di una family table di assiemi | `stamp` porta solo i nomi |
| Annidamento corretto di alcune sezioni (`AllFeatur`, `MdlStatus`, `FeatDefs`, `LargeText`) | i valori sono giusti, il livello di qualche campo può non esserlo |
Quadro d'insieme: oggi si sa con affidabilità *quali* feature ci sono, *di che tipo*, *come si
chiamano*, *quanto misurano* le quote semplici e *che forma ha* uno schizzo di linee. Il solido
si esporta in STEP (§5.3).
## 7. Provarlo
Dalla root del repo (non da `PrepStep/`, dove `dotnet run` avvia la GUI):
```powershell
dotnet run scripts/CreoBom.cs -- raw/<assieme>.asm.<rev> -p <cartella> # BOM ricorsiva di un .asm
dotnet run scripts/Analyze.cs -- raw/<assieme>.asm.<rev> "ConfigName" # dump dei byte attorno a una stringa
python scripts/psb/prt.py <file>.prt.<rev> # indice delle sezioni
python scripts/psb/psb.py <file>.prt.<rev> '*' out # ogni sezione in out/<Nome>.txt
python scripts/psb/unz.py <file>.prt.<rev> out # decomprime le sezioni .Z
```
I parser PSB sono Python (solo libreria standard) e non fanno parte dell'app. Le regole di
sicurezza da mantenere se verranno portati in C# accanto ad `AsmRecordReader`: se una sezione non
si legge fino in fondo, `InvalidDataException`, mai un risultato parziale in silenzio.
## 8. Da dove approfondire
| Domanda | Doc |
|---|---|
| Come è scritto un file, byte per byte | [`formato-psb.md`](formato-psb.md) |
| Come si legge la distinta e perché i casi limite | [`formato-asm-record.md`](formato-asm-record.md) |
| Fallback quando il parser esatto si ferma | [`formato-asm.md`](formato-asm.md) |
| Albero delle feature di un `.prt` | [`formato-prt-feature.md`](formato-prt-feature.md) |
| Quote, schizzi, posizioni, fori | [`formato-prt-geometria.md`](formato-prt-geometria.md) |
| Solido, mesh ed esportazione STEP | [`formato-prt-brep.md`](formato-prt-brep.md) |
| Stato del lavoro e cosa manca | [`history.md`](history.md) |