Cos'è un file .bgcode? Il G-code binario di Prusa, spiegato

Gli stessi comandi in un altro involucro

Un .bgcode contiene esattamente le stesse istruzioni per la stampante di un file G-code di testo: dove va l'ugello, quanto estrudere, quale temperatura mantenere. Cambia solo la confezione. Invece di un unico lungo testo, il file è diviso in blocchi, e ogni blocco può essere compresso e avere il proprio checksum.

Prusa ha introdotto il formato nel 2023 con PrusaSlicer 2.7 e ne ha pubblicato la specifica nel repository libbgcode su GitHub. È quindi aperto, ma non è uno standard come STEP o 3MF – appartiene a Prusa Research. La libreria che lo legge e lo scrive è distribuita con licenza AGPL-3.0.

I motivi sono tre. Un file più piccolo si copia su una chiavetta USB e viaggia in rete più in fretta. La stampante trova prima ciò che le serve, perché i dati di stampa e le anteprime stanno in blocchi propri e non deve leggere tutto il percorso di stampa per arrivarci. E i checksum scoprono un file che si è danneggiato lungo la strada.

Dentro: un'intestazione GCDE e blocchi in ordine fisso

Ogni .bgcode inizia con le quattro lettere GCDE. Seguono la versione del formato (finora esiste solo la versione 1) e il tipo di checksum, che in pratica è CRC32. Poi vengono i blocchi, sempre nello stesso ordine:

• metadati del file – cosa ha prodotto il file,
• metadati della stampante – per quale stampante e quale ugello è pensata la stampa,
• miniature – immagini del modello, una per blocco,
• metadati di stampa – tempo stimato, filamento usato,
• metadati dello slicer – tutte le impostazioni con cui PrusaSlicer ha fatto lo slicing,
• blocchi G-code – il percorso di stampa vero e proprio.

I metadati sono semplici coppie chiave = valore. PrusaSlicer comprime il percorso di stampa con Heatshrink, un algoritmo pensato per dispositivi con poca memoria, e in più lo codifica con MeatPack, che scrive i 15 caratteri più comuni del G-code in quattro bit invece di otto. MeatPack è nato come plugin di OctoPrint per velocizzare i lenti collegamenti seriali con le stampanti.

Quanto è più piccolo

Secondo Prusa, nei suoi test il G-code binario è risultato in media più piccolo del testo di circa il 70%. Nei dati di test di libbgcode stesso, un piccolo cubo scende da 641.092 a 149.258 byte – poco meno di un quarto. Quanto risparmi dipende dal modello e dalle impostazioni di stampa.

Cosa lo legge e cosa no

Perché la stampante non mostra il file

Il motivo più comune è un firmware vecchio. Le stampanti Prusa con firmware Buddy precedente alla 5.1.0 non elencano affatto i file .bgcode, quindi la chiavetta USB sembra vuota. Aggiorna il firmware o converti il file in G-code di testo.

L'altro motivo è una stampante che il formato non lo conosce proprio. Klipper e le stampanti di altri produttori non lo conoscono, e PrusaSlicer non lo salva nemmeno per loro. Se qualcuno con una stampante Prusa ti ha mandato un .bgcode, convertilo.

Da .bgcode a .gcode e ritorno

In PrusaSlicer la conversione si trova nel menu File → Converti (nell'interfaccia inglese File → Convert):

• Converti G-code binario in ASCII trasforma un .bgcode in un .gcode di testo,
• Converti G-code ASCII in binario fa il percorso inverso.

Se preferisci la riga di comando, libbgcode include lo strumento bgcode. bgcode model.bgcode scrive accanto al file un model.gcode di testo.

Perché PrusaSlicer smetta del tutto di salvare .bgcode, apri Preferenze (sul Mac nel menu PrusaSlicer, ⌘ ,), vai alla scheda Altro e disattiva Usa il G-code binario quando la stampante lo supporta. Questa opzione esiste dalla 2.7.1. La versione 2.7.0 salvava .bgcode in automatico per ogni stampante che lo supporta – e così facendo ha rotto i caricamenti su OctoPrint.

Come guardare dentro un .bgcode su Mac, iPad o iPhone

macOS non sa nulla di .bgcode. Non ha un tipo di file per esso, il Finder mostra un'icona vuota e la barra spaziatrice (Quick Look) non mostra niente. Su Windows ci pensa PowerToys; sul Mac devi aggiungere qualcosa.

• PrusaSlicer lo apre nel suo visualizzatore di G-code e mostra il percorso di stampa layer per layer. È gratuito, ma per una sola anteprima avvii un intero slicer.
• ThumbHost3mf aggiunge le miniature nel Finder, .bgcode compreso. Non mostra cosa c'è dentro il file.
• Preview3D, la mia app, apre .bgcode nella sua finestra, in Quick Look e come miniatura del Finder. Disegna il percorso di stampa colorato per tipo (perimetri, riempimento, ponti, supporti), ha un cursore dei layer e legge dai metadati il tempo di stampa, la lunghezza del filamento, il peso, l'altezza del layer e il materiale. Funziona allo stesso modo su iPad, iPhone e Apple Vision Pro.

Miniature: QOI per la stampante, PNG per i computer

Un file di PrusaSlicer di solito contiene più miniature. Quelle per il display della stampante sono in QOI (Quite OK Image), che Prusa ha adottato con il firmware 5.1.0 perché decodificare PNG era troppo pesante per la stampante. Per i computer PrusaSlicer aggiunge un'altra immagine in PNG.

Questo spiega perché alcuni strumenti non mostrano alcuna anteprima di un .bgcode: non sanno leggere QOI. Preview3D usa il PNG per il Finder.

Domande frequenti

Il .bgcode è meglio del .gcode?

Per una stampante Prusa che lo supporta, sì: il file è più piccolo e i danni vengono scoperti. Per tutto il resto, no – non puoi leggerlo senza convertirlo, e la maggior parte dei software non lo conosce.

Anche slicer diversi da PrusaSlicer possono creare .bgcode?

Per quanto ne so, PrusaSlicer è l'unico slicer diffuso che lo scrive. OrcaSlicer e Bambu Studio non lo supportano. Il G-code di testo di un altro slicer si può convertire in PrusaSlicer o con lo strumento bgcode.

OctoPrint supporta .bgcode?

Da solo no. Il plugin BGCode converte un file caricato in G-code di testo. I maintainer di OctoPrint hanno rifiutato il supporto nativo, sostenendo che .bgcode è pensato per essere conservato sulla stampante, non per esserle inviato.

Posso aprire un .bgcode in un editor di testo?

No, è binario. Prima convertilo in .gcode, come descritto sopra.

Un .bgcode contiene i colori e il materiale?

Allo stesso modo del G-code: i cambi di filamento sono nei comandi, e il tipo di materiale e la quantità usata sono nei metadati. Il modello 3D e le texture non ci sono – solo il percorso dell'ugello.

Formati correlati

• G-code – la forma testuale delle stesse istruzioni. Come guardarci dentro senza slicer: G-code senza slicer.
• 3MF – il progetto da cui PrusaSlicer genera il G-code. Vedi il visualizzatore 3MF per Mac.

Fonti

• La specifica del formato nel repository libbgcode
• Prusa Knowledge Base: Binary G-code
• PrusaSlicer 2.7.0 su GitHub
• Firmware Buddy 5.1.0 su GitHub
• Issue #4900 di OctoPrint e il plugin BGCode
• Repetier-Server 1.4.16

Stampi .bgcode da qualche parte che non sia una stampante Prusa – tramite Repetier-Server, per esempio, o OctoPrint con il plugin? Scrivimi a apps@xfanta.com e raccontami cosa funziona; lo aggiungerò alla tabella.