¿Qué es un archivo .off? Mallas de Geomview, ModelNet y el Mac

Todo el formato en una pantalla

Este es un cubo con aristas de 10 unidades:

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 palabra OFF del principio es recomendable pero opcional, según el manual de Geomview, así que a muchos archivos les falta. La segunda línea contiene los recuentos: 8 vértices, 6 caras y el número de aristas. Este último no se usa ni se comprueba, pero tiene que estar, y suele ser 0. Después vienen las coordenadas de los vértices, una por línea. Cada cara empieza con su número de vértices, seguido de los números de esos vértices, contados desde cero. OBJ cuenta desde uno, así que ojo al convertir a mano. Una cara puede ser cóncava, pero no puede tener agujeros. Los comentarios empiezan con #.

Tras los números de vértice puede ir un color de cara: tres o cuatro enteros de 0 a 255, o decimales de 0 a 1. Antiprism señala que esto es ambiguo: 1 0 0 puede ser rojo en decimales o casi negro en enteros.

Prefijos: COFF, NOFF, STOFF y más

La palabra clave puede llevar prefijos que añaden datos a cada vértice:

También existe una variante binaria, OFF BINARY. OFF no tiene unidades ni materiales, ni más de un objeto por archivo.

Dónde te encuentras OFF

• Conjuntos de datos de aprendizaje automático. ModelNet10 y ModelNet40 de Princeton (CVPR 2015) guardan sus modelos CAD en OFF. Algunos archivos de ModelNet40 tienen una cabecera rota, con los recuentos en la misma línea que la palabra OFF, como OFF6586 5534 0, y los programas más estrictos los rechazan.
• El Princeton Shape Benchmark. Sus archivos son siempre de texto, siempre empiezan por OFF y el número de aristas es siempre 0. Las versiones antiguas de los modelos contenían un índice −1 por un error de conversión.
• Geometría y poliedros. La biblioteca CGAL lee y escribe OFF, el conjunto de herramientas Antiprism describe poliedros con él, y Geomview incluso objetos de cuatro dimensiones.

De dónde viene OFF

El nombre y la primera descripción del formato vienen de Digital Equipment Corporation. La descripción que hay hoy en paulbourke.net lleva en la cabecera el nombre de Randi J. Rost y presenta el formato para intercambiar y archivar objetos 3D, en texto o en binario. Sin embargo, la variante que leen hoy la mayoría de los programas es la descrita en el manual de Geomview. Geomview salió del Geometry Center de la Universidad de Minnesota. Empezó en el verano de 1988 con el visor MinneView (de Pat Hanrahan), y la primera versión de Geomview se terminó en enero de 1992. Geomview sigue disponible con licencia GNU LGPL.

Cómo abrir OFF en el Mac

macOS no conoce OFF. En macOS 27.0.1 el sistema no tiene ningún tipo de archivo para él, y ni Vista Previa, ni Quick Look, ni el Finder lo muestran. Un editor de texto te muestra números, no una forma.

• MeshLab es gratuito, tiene versiones para Apple silicon e Intel y abre OFF.
• Python y MATLAB. En investigación hay bibliotecas para ello; Princeton ofrece funciones de MATLAB junto a ModelNet.
• Preview3D, mi app, abre archivos .off en el Mac en su ventana, en Quick Look y como miniaturas del Finder. También en el iPad, el iPhone y el Apple Vision Pro. Así puedes recorrer la carpeta de un conjunto de datos como miniaturas sin escribir código.

Preview3D lee OFF a través de la biblioteca Assimp. Lo probé con la misma compilación que usa la app, con archivos escritos a partir del manual de Geomview. Abrió OFF con y sin la palabra clave, las variantes COFF, NOFF, STOFF y 4OFF, la cabecera rota de ModelNet40 y caras de cinco vértices. No abre OFF binario. La app no usa los colores del archivo; muestra la geometría en un único color liso.

Ojo con una cosa: los comentarios. Assimp se queda atascado en el carácter # al leer un comentario. Un archivo con un comentario antes de la línea de recuentos, o en ella, no se cargó en mi prueba: la lectura se quedó atascada. Un comentario entre los vértices y las caras, en cambio, se tragó una cara. Así que, de momento, quita los comentarios antes de abrirlo:

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

El comando borra todo lo que va desde # hasta el final de la línea, y las líneas en blanco. Después, todos mis archivos de prueba se cargaron completos.

Información del modelo tiene las dimensiones en las unidades del archivo y el número de triángulos, además de una comprobación de malla. En el iPad y el iPhone coloca el modelo sobre tu mesa en RA, ajustado a la mesa, porque OFF no tiene unidad.

Convertir OFF a STL, OBJ o PLY

En el Mac, Preview3D convierte desde Archivo → Exportar modelo como… (⌥⌘E) a STL, OBJ o PLY, sin subir nada. Los polígonos se dividen en triángulos y los colores se descartan. OFF no tiene unidad, así que comprueba el tamaño en el laminador (slicer).

Preguntas frecuentes

¿Qué es un archivo .off?

Un archivo de texto con una malla poligonal: los recuentos, una lista de vértices y una lista de caras. Viene del visor Geomview y se usa sobre todo en investigación.

¿Por qué la cabecera tiene tres números si el tercero no se usa?

El tercer número es el de aristas. Según el manual de Geomview, no se usa ni se comprueba, pero tiene que estar, y suele ser 0.

¿Cómo puedo revisar archivos de ModelNet en el Mac?

En Preview3D, como miniaturas del Finder, o en MeshLab. Preview3D también se las arregla con cabeceras rotas como OFF6586 5534 0.

¿En qué se diferencia OFF de OBJ?

OFF cuenta los vértices desde cero; OBJ, desde uno. OFF guarda los colores directamente en las caras o los vértices y contiene una malla por archivo; OBJ guarda los materiales en un archivo .mtl y puede contener varios objetos.

¿El Mac abre .off sin otra app?

No. macOS 27 no tiene ningún tipo de archivo para OFF, y ni Vista Previa ni Quick Look lo muestran.

¿Cómo convierto OFF a STL u OBJ?

En el Mac, en Preview3D con Archivo → Exportar modelo como…, o en MeshLab. Después comprueba el tamaño.

Páginas relacionadas

• El archivo .obj: un formato de malla en texto, con materiales
• El archivo .ply: otro formato de investigación, para escaneos y nubes de puntos
• El archivo .stl: el formato de impresión

Fuentes

• Manual de Geomview: OFF: sintaxis, prefijos, colores, variante binaria
• Manual de Geomview: historia y licencia
• Paul Bourke: OFF: la descripción original de Digital Equipment Corporation
• Princeton Shape Benchmark: el formato OFF
• Princeton ModelNet
• Cómo arreglar las cabeceras de ModelNet40 (GitHub gist)
• Antiprism: el formato OFF: colores ambiguos
• Assimp: lectura de OFF y cómo salta líneas: comentarios
• MeshLab

¿Trabajas con ModelNet u otro conjunto de datos en OFF y necesitas revisarlo rápido en el Mac? Escríbeme a apps@xfanta.com y cuéntame qué te ayudaría.