- 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>
241 lines
15 KiB
Markdown
241 lines
15 KiB
Markdown
# 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) |
|