Soubor .bgcode: binární G-code od firmy Prusa a jak se do něj podívat

Stejné příkazy, jiné balení

Uvnitř .bgcode jsou úplně stejné instrukce pro tiskárnu jako v textovém G-code: kam má tryska jet, kolik materiálu vytlačit, jakou teplotu držet. Liší se jen balení. Místo jednoho dlouhého textu je soubor rozdělený do bloků a každý blok může být komprimovaný a mít vlastní kontrolní součet.

Prusa formát představila v roce 2023 s PrusaSlicerem 2.7 a specifikaci zveřejnila v repozitáři libbgcode na GitHubu. Formát je tedy otevřený, ale není to norma jako STEP nebo 3MF – patří Prusa Research. Knihovna, která ho čte a zapisuje, je pod licencí AGPL-3.0.

Důvody jsou tři. Menší soubor se rychleji kopíruje na flashku a posílá po síti. Tiskárna v něm rychleji najde, co potřebuje, protože údaje o tisku a náhledy leží v samostatných blocích a kvůli nim nemusí číst celou dráhu. A kontrolní součty odhalí soubor, který se cestou poškodil.

Uvnitř: hlavička GCDE a bloky v pevném pořadí

Každý .bgcode začíná čtyřmi písmeny GCDE. Za nimi je číslo verze formátu (zatím existuje jen verze 1) a typ kontrolního součtu, v praxi CRC32. Pak přijdou bloky, vždy ve stejném pořadí:

• metadata souboru – kdo soubor vytvořil,
• metadata tiskárny – pro jakou tiskárnu a trysku je tisk připravený,
• náhledy – obrázky modelu, každý ve vlastním bloku,
• metadata tisku – odhad času, spotřeba filamentu,
• metadata sliceru – kompletní nastavení, se kterým PrusaSlicer tisk připravil,
• bloky G-code – samotná dráha tisku.

Metadata jsou obyčejné dvojice klíč = hodnota. Dráhu tisku PrusaSlicer komprimuje algoritmem Heatshrink, který vznikl pro zařízení s malou pamětí, a navíc ji kóduje metodou MeatPack. Ta zapíše 15 nejčastějších znaků G-code čtyřmi bity místo osmi. MeatPack původně vznikl jako plugin pro OctoPrint, aby zrychlil pomalé sériové spojení s tiskárnou.

O kolik je menší

Prusa uvádí, že binární G-code je v jejích testech v průměru asi o 70 % menší než textový. V testovacích datech knihovny libbgcode se malá kostka zmenšila ze 641 092 na 149 258 bajtů, tedy na necelou čtvrtinu. Kolik ušetříte vy, záleží na modelu a nastavení tisku.

Kdo ho přečte a kdo ne

Proč tiskárna soubor nevidí

Nejčastější důvod je starší firmware. Tiskárny Prusa s firmwarem Buddy starším než 5.1.0 soubory .bgcode vůbec nezobrazí, takže to vypadá, jako by na flashce nic nebylo. Pomůže aktualizovat firmware, nebo soubor převést na textový G-code.

Druhý důvod je, že tiskárna formát neumí vůbec. Klipper ani tiskárny jiných značek .bgcode neznají a PrusaSlicer ho pro ně ani neuloží. Pokud vám ho poslal někdo s tiskárnou Prusa, převeďte ho.

Z .bgcode na .gcode a zpátky

V PrusaSliceru je převod v menu Soubor → Převést (v angličtině File → Convert):

• Převod binárního G-code na ASCII udělá z .bgcode textový .gcode,
• Převod ASCII G-code na binární jde opačným směrem.

Kdo dá přednost příkazové řádce, má nástroj bgcode z knihovny libbgcode. Příkaz bgcode model.bgcode vedle souboru uloží textový model.gcode.

Pokud nechcete, aby PrusaSlicer .bgcode ukládal vůbec, vypněte v Nastavení (na Macu v menu PrusaSlicer, ⌘ ,) na kartě Ostatní volbu Použít binární G-code, pokud jej tiskárna podporuje. Tahle volba existuje od verze 2.7.1. Verze 2.7.0 ukládala .bgcode rovnou pro každou tiskárnu, která ho umí, a nahrávání do OctoPrintu tím přestalo fungovat.

Jak se do .bgcode podívat na Macu, iPadu a iPhonu

macOS o .bgcode neví nic. Nemá pro něj typ souboru, Finder ukáže prázdnou ikonu a mezerník (Quick Look) nezobrazí nic. Na Windows to řeší PowerToys, na Macu musíte něco doinstalovat.

• PrusaSlicer soubor otevře ve svém prohlížeči G-codu a ukáže dráhu po vrstvách. Je zdarma, ale kvůli jednomu náhledu spouštíte celý slicer.
• ThumbHost3mf přidá do Finderu miniatury, i z .bgcode. Dovnitř souboru se s ním ale nepodíváte.
• Preview3D, moje aplikace, otevře .bgcode v okně, v Quick Looku i jako miniaturu ve Finderu. Dráhu kreslí v barvách podle typu (perimetry, výplň, mosty, podpěry), má posuvník vrstev a z metadat ukáže čas tisku, spotřebu filamentu, hmotnost, výšku vrstvy a materiál. Stejně to funguje na iPadu, iPhonu i Apple Vision Pro.

Náhledy: QOI pro tiskárnu, PNG pro počítač

V souboru z PrusaSliceru bývá několik náhledů. Pro displej tiskárny jsou ve formátu QOI (Quite OK Image), který Prusa zavedla s firmwarem 5.1.0, protože dekódování PNG bylo pro tiskárnu příliš náročné. Pro počítače přidává PrusaSlicer ještě jeden obrázek PNG.

To vysvětluje, proč některé programy u .bgcode náhled neukážou: QOI neumějí. Preview3D si pro Finder vezme ten PNG.

Časté otázky

Je .bgcode lepší než .gcode?

Pro tiskárnu Prusa, která ho umí, ano: soubor je menší a poškození se pozná. Pro všechno ostatní ne, protože bez převodu ho nepřečtete a většina programů ho nezná.

Umí .bgcode vytvořit i jiný slicer než PrusaSlicer?

Z rozšířených slicerů ho pokud vím zapisuje jen PrusaSlicer. OrcaSlicer ani Bambu Studio ho nepodporují. Textový G-code z jiného sliceru se dá převést v PrusaSliceru nebo nástrojem bgcode.

Podporuje .bgcode OctoPrint?

Přímo ne. Plugin BGCode nahraný soubor převede na textový G-code. Správci OctoPrintu nativní podporu odmítli s tím, že .bgcode je formát pro ukládání v tiskárně a ne pro přenos do ní.

Dá se .bgcode otevřít v textovém editoru?

Ne, je binární. Nejdřív ho převeďte na .gcode, postup je výše.

Nese .bgcode barvy a materiál?

Stejně jako G-code: výměny filamentu jsou v příkazech, typ materiálu a jeho spotřeba v metadatech. Samotný 3D model ani textury v něm nejsou, jen dráha trysky.

Související formáty

• G-code – textová podoba stejných instrukcí. Jak se do něj podívat bez sliceru, popisuje článek G-code bez sliceru.
• 3MF – projekt, ze kterého PrusaSlicer G-code připraví. Viz prohlížeč 3MF pro Mac.

Zdroje

• Specifikace formátu v repozitáři libbgcode
• Prusa Knowledge Base: Binary G-code
• PrusaSlicer 2.7.0 na GitHubu
• Firmware Buddy 5.1.0 na GitHubu
• OctoPrint, issue #4900 a plugin BGCode
• Repetier-Server 1.4.16

Tisknete .bgcode i jinde než na tiskárně Prusa, třeba přes Repetier-Server nebo s pluginem v OctoPrintu? Napište mi na apps@xfanta.com, s čím vám to funguje – doplním to do tabulky.