- 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>
15 KiB
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-asm-record.md, formato-prt-feature.md
e 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). 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.
#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:
- L'ultimo campo della prima riga (
000002cc) è la costante da sommare agli offset dell'indice. - Ogni sezione comincia con una riga
#<Nome>, compresa nell'offset e nella lunghezza. - L'indice è a catena:
NEXT_TOC_ENTRYpunta 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-ffsono marcatori, gli altri sono dati.e0 <tipo> <nome>\0dichiara 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 grezzee8-ebef5/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 informato-psb.md§3.2.floata 32 bit (tipo06, usato nella mesh di visualizzazione): la tabella dei prefissi50-dfnon è 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 §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 §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):
AllFeaturdà ordine,ide tipo di ogni feature.- I piani interni (creati da Creo aprendo uno schizzo) vanno scartati: si riconoscono dal blocco degli attributi.
- 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 insect_name; gruppi (tipo1104) e sezioni (1052) hanno nomi inLargeTexteXsections. - Lo storico
MdlStatusaggiunge 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/2lineare o diametrale di schizzo,3raggio,4diametro,9distanza o profondità del filetto,62profondità. 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_sys4×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 contypeeoffset(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, congeometry1_idrisolvibile inVisibGeom/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): 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):
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 |
| Come si legge la distinta e perché i casi limite | formato-asm-record.md |
| Fallback quando il parser esatto si ferma | formato-asm.md |
Albero delle feature di un .prt |
formato-prt-feature.md |
| Quote, schizzi, posizioni, fori | formato-prt-geometria.md |
| Solido, mesh ed esportazione STEP | formato-prt-brep.md |
| Stato del lavoro e cosa manca | history.md |