¿Qué es un archivo .bgcode? El G-code binario de Prusa, explicado

Los mismos comandos en otro envoltorio

Un .bgcode lleva exactamente las mismas instrucciones para la impresora que un archivo G-code de texto: adónde va la boquilla, cuánto extruir, qué temperatura mantener. Solo cambia el envoltorio. En lugar de un único texto largo, el archivo se divide en bloques, y cada bloque puede ir comprimido y llevar su propia suma de comprobación.

Prusa presentó el formato en 2023 con PrusaSlicer 2.7 y publicó la especificación en el repositorio libbgcode de GitHub. Así que es abierto, pero no es un estándar como STEP o 3MF: pertenece a Prusa Research. La biblioteca que lo lee y lo escribe tiene licencia AGPL-3.0.

Hay tres motivos para ello. Un archivo más pequeño se copia a una memoria USB y viaja por la red más rápido. La impresora encuentra antes lo que necesita, porque los datos de la impresión y las vistas previas van en sus propios bloques y no tiene que leer toda la trayectoria para llegar a ellos. Y las sumas de comprobación detectan un archivo que se ha dañado por el camino.

Por dentro: una cabecera GCDE y bloques en un orden fijo

Todo .bgcode empieza con las cuatro letras GCDE. Después vienen la versión del formato (hasta ahora solo existe la versión 1) y el tipo de suma de comprobación, que en la práctica es CRC32. A continuación van los bloques, siempre en el mismo orden:

• metadatos del archivo: qué lo generó,
• metadatos de la impresora: para qué impresora y boquilla es la impresión,
• miniaturas: imágenes del modelo, una por bloque,
• metadatos de la impresión: tiempo estimado, filamento usado,
• metadatos del laminador (slicer): todos los ajustes con los que laminó PrusaSlicer,
• bloques de G-code: la trayectoria en sí.

Los metadatos son simples pares clave = valor. PrusaSlicer comprime la trayectoria con Heatshrink, un algoritmo pensado para dispositivos con poca memoria, y además la codifica con MeatPack, que escribe los 15 caracteres más comunes del G-code en cuatro bits en lugar de ocho. MeatPack nació como plugin de OctoPrint para acelerar las lentas conexiones serie con las impresoras.

Cuánto más pequeño es

Prusa dice que en sus pruebas el G-code binario salió, de media, alrededor de un 70 % más pequeño que el de texto. En los datos de prueba de la propia libbgcode, un cubo pequeño baja de 641.092 a 149.258 bytes: algo menos de una cuarta parte. Cuánto ahorras depende del modelo y de los ajustes de impresión.

Qué lo lee y qué no

Por qué tu impresora no muestra el archivo

La razón habitual es un firmware antiguo. Las impresoras Prusa con un firmware Buddy anterior a la 5.1.0 no muestran los archivos .bgcode en absoluto, así que la memoria USB parece vacía. Actualiza el firmware o convierte el archivo a G-code de texto.

La otra razón es una impresora que no conoce el formato en absoluto. Klipper y las impresoras de otros fabricantes no lo conocen, y PrusaSlicer tampoco lo guarda para ellas. Si alguien con una impresora Prusa te ha enviado un .bgcode, conviértelo.

De .bgcode a .gcode y viceversa

En PrusaSlicer, la conversión está en Archivo → Convertir (en inglés, File → Convert):

• Convertir un archivo de código G binario a ASCII convierte un .bgcode en un .gcode de texto,
• Convertir un archivo de código G ASCII a binario hace el camino inverso.

Si prefieres la línea de comandos, libbgcode trae la herramienta bgcode. bgcode model.bgcode escribe al lado un model.gcode de texto.

Para que PrusaSlicer deje de guardar .bgcode por completo, abre Preferencias (en el Mac, en el menú PrusaSlicer, ⌘ ,), ve a la pestaña Otro y desactiva Utilizar código G binario cuando la impresora lo admita. Esa opción existe desde la 2.7.1. La versión 2.7.0 guardaba .bgcode por defecto para todas las impresoras que lo admiten y, de paso, rompió las subidas a OctoPrint.

Cómo ver el interior de un .bgcode en el Mac, el iPad o el iPhone

macOS no sabe nada de .bgcode. No tiene ningún tipo de archivo para él, el Finder muestra un icono en blanco y la barra espaciadora (Quick Look) no muestra nada. En Windows lo cubre PowerToys; en el Mac tienes que añadir algo.

• PrusaSlicer lo abre en su visor de G-code y muestra la trayectoria capa a capa. Es gratis, pero arrancas todo un laminador para una sola vista previa.
• ThumbHost3mf añade miniaturas en el Finder, también para .bgcode. No muestra lo que hay dentro del archivo.
• Preview3D, mi app, abre .bgcode en su ventana, en Quick Look y como miniatura del Finder. Dibuja la trayectoria coloreada por tipo (perímetros, relleno, puentes, soportes), tiene un control de capas y lee de los metadatos el tiempo de impresión, la longitud y el peso del filamento, la altura de capa y el material. Funciona igual en el iPad, el iPhone y el Apple Vision Pro.

Miniaturas: QOI para la impresora, PNG para el ordenador

Un archivo de PrusaSlicer suele llevar varias miniaturas. Las de la pantalla de la impresora están en QOI (Quite OK Image), que Prusa adoptó con el firmware 5.1.0 porque decodificar PNG era demasiado pesado para la impresora. Para los ordenadores, PrusaSlicer añade una imagen más en PNG.

Eso explica por qué algunas herramientas no muestran ninguna vista previa de un .bgcode: no saben leer QOI. Preview3D usa el PNG para el Finder.

Preguntas frecuentes

¿Es .bgcode mejor que .gcode?

Para una impresora Prusa que lo admite, sí: el archivo es más pequeño y los daños se detectan. Para todo lo demás, no: no puedes leerlo sin convertirlo y la mayoría del software no lo conoce.

¿Pueden crear .bgcode otros laminadores aparte de PrusaSlicer?

Que yo sepa, PrusaSlicer es el único laminador de uso extendido que lo escribe. OrcaSlicer y Bambu Studio no lo admiten. El G-code de texto de otro laminador se puede convertir en PrusaSlicer o con la herramienta bgcode.

¿OctoPrint admite .bgcode?

Por sí solo, no. El plugin BGCode convierte un archivo subido a G-code de texto. El equipo que mantiene OctoPrint rechazó darle soporte nativo, con el argumento de que .bgcode está pensado para guardarse en la impresora, no para enviárselo.

¿Puedo abrir un .bgcode en un editor de texto?

No, es binario. Conviértelo antes a .gcode, como se explica arriba.

¿Lleva un .bgcode los colores y el material?

Igual que el G-code: los cambios de filamento están en los comandos, y el tipo de material y la cantidad usada están en los metadatos. El modelo 3D y las texturas no van dentro: solo el recorrido de la boquilla.

Formatos relacionados

• G-code: la forma de texto de las mismas instrucciones. Cómo ver su interior sin un laminador: G-code sin laminador.
• 3MF: el proyecto a partir del cual PrusaSlicer lamina el G-code. Consulta el visor 3MF para Mac.

Fuentes

• La especificación del formato en el repositorio libbgcode
• Base de conocimientos de Prusa: G-code binario
• PrusaSlicer 2.7.0 en GitHub
• Firmware Buddy 5.1.0 en GitHub
• Issue #4900 de OctoPrint y el plugin BGCode
• Repetier-Server 1.4.16

¿Imprimes .bgcode en algún sitio que no sea una impresora Prusa, por ejemplo con Repetier-Server u OctoPrint con el plugin? Escríbeme a apps@xfanta.com y cuéntame qué funciona; lo añadiré a la tabla.