# 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 `#`, 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 \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` (``, id del membro) | la BOM stampa l'istanza, il disco contiene il generico | | Istanza da pattern/array feature | `ConfigName` con suffisso `#AF` | il suffisso va tolto: non è una family table | | Istanza scritta dentro `name` | `` 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 (.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/.asm. -p # BOM ricorsiva di un .asm dotnet run scripts/Analyze.cs -- raw/.asm. "ConfigName" # dump dei byte attorno a una stringa python scripts/psb/prt.py .prt. # indice delle sezioni python scripts/psb/psb.py .prt. '*' out # ogni sezione in out/.txt python scripts/psb/unz.py .prt. 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) |