Cos'è un file .off? Mesh di Geomview, ModelNet e il Mac

L'intero formato in una schermata

Questo è un cubo con spigoli di 10 unità:

OFF
8 6 0
0 0 0
10 0 0
10 10 0
0 10 0
0 0 10
10 0 10
10 10 10
0 10 10
4 0 3 2 1
4 4 5 6 7
4 0 1 5 4
4 1 2 6 5
4 2 3 7 6
4 3 0 4 7

La parola OFF all'inizio è raccomandata ma facoltativa, secondo il manuale di Geomview, quindi molti file non ce l'hanno. La seconda riga contiene i conteggi: 8 vertici, 6 facce e il numero di spigoli. Quest'ultimo non viene usato né controllato, ma deve esserci, e di solito è 0. Poi vengono le coordinate dei vertici, una per riga. Ogni faccia inizia con il suo numero di vertici, seguito dai loro numeri, contati da zero. OBJ conta da uno, quindi attenzione quando converti a mano. Una faccia può essere concava, ma non può avere fori. I commenti iniziano con #.

Dopo i numeri dei vertici può seguire il colore della faccia: tre o quattro interi da 0 a 255, o decimali da 0 a 1. Antiprism fa notare che questo è ambiguo: 1 0 0 può essere rosso in decimali o quasi nero in interi.

Prefissi: COFF, NOFF, STOFF e altri

La parola chiave può avere prefissi che aggiungono dati a ogni vertice:

Esiste anche una variante binaria, OFF BINARY. OFF non ha unità, né materiali, né più di un oggetto per file.

Dove incontri OFF

• Dataset di machine learning. ModelNet10 e ModelNet40 di Princeton (CVPR 2015) memorizzano i loro modelli CAD come OFF. Alcuni file di ModelNet40 hanno un'intestazione rotta, con i conteggi sulla stessa riga della parola OFF, come OFF6586 5534 0, e i programmi più rigorosi li rifiutano.
• Il Princeton Shape Benchmark. I suoi file sono sempre testo, iniziano sempre con OFF, e il conteggio degli spigoli è sempre 0. Le versioni più vecchie dei modelli contenevano un indice −1 a causa di un errore di conversione.
• Geometria e poliedri. La libreria CGAL legge e scrive OFF, il toolkit Antiprism ci descrive poliedri, e Geomview perfino oggetti quadridimensionali.

Da dove viene OFF

Il nome e la prima descrizione del formato vengono dalla Digital Equipment Corporation. La descrizione oggi su paulbourke.net riporta nell'intestazione il nome di Randi J. Rost e presenta il formato per lo scambio e l'archiviazione di oggetti 3D, come testo o in binario. La variante che oggi legge la maggior parte dei programmi, però, è quella descritta nel manuale di Geomview. Geomview è nato al Geometry Center dell'Università del Minnesota. È partito nell'estate del 1988 con il visualizzatore MinneView (di Pat Hanrahan), e la prima versione di Geomview è stata completata nel gennaio 1992. Geomview è ancora disponibile con licenza GNU LGPL.

Come aprire OFF sul Mac

macOS non conosce OFF. Su macOS 27.0.1 il sistema non ha un tipo di file per esso, e né Anteprima, né Quick Look, né il Finder lo mostrano. Un editor di testo ti mostra numeri, non una forma.

• MeshLab è gratuito, esiste in versione per Apple silicon e per Intel, e apre OFF.
• Python e MATLAB. Chi fa ricerca ha librerie apposite; Princeton offre funzioni MATLAB insieme a ModelNet.
• Preview3D, la mia app, apre i file .off sul Mac nella sua finestra, in Quick Look e come miniature del Finder. Anche su iPad, iPhone e Apple Vision Pro. Così puoi sfogliare la cartella di un dataset come miniature senza scrivere codice.

Preview3D legge OFF tramite la libreria Assimp. L'ho provato nella stessa build che usa l'app, con file scritti a partire dal manuale di Geomview. Ha aperto OFF con e senza la parola chiave, le varianti COFF, NOFF, STOFF e 4OFF, l'intestazione rotta di ModelNet40 e facce con cinque vertici. Non apre OFF binari. L'app non usa i colori del file; mostra la geometria in un unico colore semplice.

Attenzione a una cosa: i commenti. Assimp si blocca sul carattere # quando legge un commento. Un file con un commento prima della riga dei conteggi, o su di essa, nel mio test non si è caricato – la lettura si è bloccata. Un commento tra i vertici e le facce si è invece mangiato una faccia. Quindi per ora rimuovi i commenti prima di aprire il file:

sed -e 's/#.*//' -e '/^[[:space:]]*$/d' model.off > no-comments.off

Il comando cancella tutto da # alla fine della riga, e le righe vuote. Dopo, tutti i miei file di prova si sono caricati per intero.

Info modello riporta le dimensioni nelle unità del file e il numero di triangoli, più un controllo della mesh. Su iPad e iPhone mette il modello sulla tua scrivania in AR, adattato alla scrivania, perché OFF non ha unità.

Convertire OFF in STL, OBJ o PLY

Sul Mac, Preview3D converte da File → Esporta modello come… (⌥⌘E) in STL, OBJ o PLY, senza caricare nulla online. I poligoni vengono divisi in triangoli e i colori vengono scartati. OFF non ha unità, quindi controlla le dimensioni nello slicer.

Domande frequenti

Cos'è un file .off?

Un file di testo con una mesh poligonale: i conteggi, un elenco di vertici e un elenco di facce. Viene dal visualizzatore Geomview e si usa soprattutto nella ricerca.

Perché l'intestazione ha tre numeri se il terzo non si usa?

Il terzo numero è il conteggio degli spigoli. Secondo il manuale di Geomview non viene usato né controllato, ma deve esserci, e di solito è 0.

Come posso sfogliare i file di ModelNet sul Mac?

In Preview3D come miniature del Finder, oppure in MeshLab. Preview3D se la cava anche con intestazioni rotte come OFF6586 5534 0.

In cosa OFF è diverso da OBJ?

OFF conta i vertici da zero, OBJ da uno. OFF tiene i colori direttamente sulle facce o sui vertici e contiene una sola mesh per file; OBJ tiene i materiali in un file .mtl e può contenere più oggetti.

Il Mac apre .off senza un'altra app?

No. macOS 27 non ha un tipo di file per OFF, e né Anteprima né Quick Look lo mostrano.

Come converto OFF in STL o OBJ?

Sul Mac, in Preview3D con File → Esporta modello come…, oppure in MeshLab. Poi controlla le dimensioni.

Pagine correlate

• Il file .obj – un formato mesh di testo con materiali
• Il file .ply – un altro formato della ricerca, per scansioni e nuvole di punti
• Il file .stl – il formato per la stampa

Fonti

• Manuale di Geomview: OFF – sintassi, prefissi, colori, variante binaria
• Manuale di Geomview: storia e licenza
• Paul Bourke: OFF – la descrizione originale della Digital Equipment Corporation
• Princeton Shape Benchmark: il formato OFF
• Princeton ModelNet
• Correggere le intestazioni di ModelNet40 (gist di GitHub)
• Antiprism: il formato OFF – colori ambigui
• Assimp: lettura di OFF e salto delle righe – commenti
• MeshLab

Lavori con ModelNet o con un altro dataset OFF e hai bisogno di sfogliarlo velocemente sul Mac? Scrivimi a apps@xfanta.com e dimmi cosa ti sarebbe utile.