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

15 KiB
Raw Blame History

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:

  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 §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):

  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): 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