Was ist eine .bgcode-Datei? Der binäre G-Code von Prusa erklärt

Dieselben Befehle in anderer Verpackung

Eine .bgcode-Datei enthält genau dieselben Anweisungen für den Drucker wie eine G-Code-Textdatei: wohin die Düse fährt, wie viel extrudiert wird, welche Temperatur gehalten wird. Anders ist nur die Verpackung. Statt eines einzigen langen Textes ist die Datei in Blöcke aufgeteilt, und jeder Block kann komprimiert sein und eine eigene Prüfsumme tragen.

Prusa hat das Format 2023 mit PrusaSlicer 2.7 eingeführt und die Spezifikation im Repository libbgcode auf GitHub veröffentlicht. Offen ist es also, aber kein Standard wie STEP oder 3MF – es gehört Prusa Research. Die Bibliothek, die es liest und schreibt, steht unter der Lizenz AGPL-3.0.

Dafür gibt es drei Gründe. Eine kleinere Datei ist schneller auf einen USB-Stick kopiert und schneller übers Netzwerk übertragen. Der Drucker findet schneller, was er braucht, weil die Druckangaben und Vorschaubilder in eigenen Blöcken liegen und er dafür nicht den ganzen Werkzeugweg lesen muss. Und die Prüfsummen erkennen eine Datei, die unterwegs beschädigt wurde.

Innen: ein GCDE-Header und Blöcke in fester Reihenfolge

Jede .bgcode-Datei beginnt mit den vier Buchstaben GCDE. Danach kommen die Formatversion (bisher gibt es nur Version 1) und der Prüfsummentyp, in der Praxis CRC32. Es folgen die Blöcke, immer in derselben Reihenfolge:

• Datei-Metadaten – womit die Datei erzeugt wurde,
• Drucker-Metadaten – für welchen Drucker und welche Düse der Druck bestimmt ist,
• Vorschaubilder – Bilder des Modells, eines pro Block,
• Druck-Metadaten – geschätzte Druckzeit, verbrauchtes Filament,
• Slicer-Metadaten – die vollständigen Einstellungen, mit denen PrusaSlicer gesliced hat,
• G-Code-Blöcke – der Werkzeugweg selbst.

Die Metadaten sind einfache Paare aus Schlüssel = Wert. PrusaSlicer komprimiert den Werkzeugweg mit Heatshrink, einem Algorithmus für Geräte mit wenig Speicher, und kodiert ihn zusätzlich mit MeatPack, das die 15 häufigsten G-Code-Zeichen mit vier statt acht Bits schreibt. MeatPack war ursprünglich ein OctoPrint-Plugin, das langsame serielle Verbindungen zu Druckern beschleunigen sollte.

Wie viel kleiner sie ist

Laut Prusa war binärer G-Code in den eigenen Tests im Schnitt etwa 70 % kleiner als Text. In den Testdaten von libbgcode schrumpft ein kleiner Würfel von 641.092 auf 149.258 Byte – auf knapp ein Viertel. Wie viel du sparst, hängt vom Modell und von den Druckeinstellungen ab.

Was sie liest und was nicht

Warum dein Drucker die Datei nicht anzeigt

Meist liegt es an älterer Firmware. Prusa-Drucker mit einer Buddy-Firmware älter als 5.1.0 listen .bgcode-Dateien gar nicht auf, der USB-Stick wirkt also leer. Aktualisiere die Firmware oder wandle die Datei in Text-G-Code um.

Der andere Grund ist ein Drucker, der das Format überhaupt nicht kennt. Klipper und Drucker anderer Hersteller kennen es nicht, und PrusaSlicer speichert es für sie auch nicht. Hat dir jemand mit einem Prusa-Drucker eine .bgcode-Datei geschickt, wandle sie um.

Von .bgcode zu .gcode und zurück

In PrusaSlicer findest du die Umwandlung unter Datei → Umwandeln (englisch File → Convert):

• Binären G-Code in ASCII umwandeln macht aus einer .bgcode-Datei eine .gcode-Textdatei,
• ASCII G-Code in binär umwandeln geht den umgekehrten Weg.

Wenn du lieber mit der Kommandozeile arbeitest: libbgcode bringt das Werkzeug bgcode mit. bgcode model.bgcode schreibt daneben eine Textdatei model.gcode.

Damit PrusaSlicer gar keine .bgcode-Dateien mehr speichert, öffne die Einstellungen (auf dem Mac im Menü PrusaSlicer, ⌘ ,), wechsle zum Tab Sonstige und schalte Binären G-Code verwenden, wenn der Drucker ihn unterstützt aus. Diesen Schalter gibt es seit 2.7.1. Version 2.7.0 speicherte .bgcode standardmäßig für jeden Drucker, der es unterstützt – und legte dabei das Hochladen zu OctoPrint lahm.

So siehst du in eine .bgcode-Datei auf Mac, iPad oder iPhone

macOS weiß nichts von .bgcode. Es hat keinen Dateityp dafür, der Finder zeigt ein leeres Symbol und die Leertaste (Quick Look) zeigt nichts. Unter Windows erledigen das die PowerToys; auf dem Mac musst du etwas nachrüsten.

• PrusaSlicer öffnet sie in seinem G-Code-Viewer und zeigt den Werkzeugweg Schicht für Schicht. Er ist kostenlos, aber du startest einen ganzen Slicer für eine einzige Vorschau.
• ThumbHost3mf ergänzt Miniaturen im Finder, auch für .bgcode. Was in der Datei steckt, zeigt es nicht.
• Preview3D, meine App, öffnet .bgcode in ihrem Fenster, in Quick Look und als Miniatur im Finder. Sie zeichnet den Werkzeugweg nach Typ eingefärbt (Perimeter, Infill, Brücken, Stützen), hat einen Schichtregler und liest Druckzeit, Filamentlänge, Gewicht, Schichthöhe und Material aus den Metadaten. Auf iPad, iPhone und Apple Vision Pro funktioniert sie genauso.

Vorschaubilder: QOI für den Drucker, PNG für Computer

Eine Datei aus PrusaSlicer enthält meist mehrere Vorschaubilder. Die für das Display des Druckers sind QOI (Quite OK Image), das Prusa mit der Firmware 5.1.0 eingeführt hat, weil das Dekodieren von PNG für den Drucker zu aufwendig war. Für Computer legt PrusaSlicer noch ein Bild als PNG bei.

Das erklärt, warum manche Programme zu einer .bgcode-Datei keine Vorschau zeigen: Sie können QOI nicht lesen. Preview3D verwendet für den Finder das PNG.

Häufige Fragen

Ist .bgcode besser als .gcode?

Für einen Prusa-Drucker, der es unterstützt, ja: Die Datei ist kleiner, und Beschädigungen werden erkannt. Für alles andere nein – ohne Umwandlung kannst du sie nicht lesen, und die meiste Software kennt sie nicht.

Können auch andere Slicer als PrusaSlicer .bgcode erzeugen?

Soweit ich weiß, ist PrusaSlicer der einzige verbreitete Slicer, der es schreibt. OrcaSlicer und Bambu Studio unterstützen es nicht. Text-G-Code aus einem anderen Slicer lässt sich in PrusaSlicer oder mit dem Werkzeug bgcode umwandeln.

Unterstützt OctoPrint .bgcode?

Von sich aus nicht. Das BGCode-Plugin wandelt eine hochgeladene Datei in Text-G-Code um. Die Verantwortlichen von OctoPrint haben eine native Unterstützung abgelehnt, mit dem Argument, .bgcode sei zum Speichern auf dem Drucker gedacht, nicht zum Senden an ihn.

Kann ich eine .bgcode-Datei in einem Texteditor öffnen?

Nein, sie ist binär. Wandle sie zuerst in .gcode um, wie oben beschrieben.

Enthält eine .bgcode-Datei Farben und das Material?

Genauso wie G-Code: Filamentwechsel stehen in den Befehlen, Materialart und verbrauchte Menge in den Metadaten. Das 3D-Modell und Texturen sind nicht darin – nur der Weg der Düse.

Verwandte Formate

• G-Code – die Textform derselben Anweisungen. Wie du ohne Slicer hineinsiehst: G-Code ohne Slicer.
• 3MF – das Projekt, aus dem PrusaSlicer den G-Code erzeugt. Siehe den 3MF-Viewer für Mac.

Quellen

• Die Formatspezifikation im Repository libbgcode
• Prusa Knowledge Base: Binärer G-Code
• PrusaSlicer 2.7.0 auf GitHub
• Buddy-Firmware 5.1.0 auf GitHub
• OctoPrint-Issue #4900 und das BGCode-Plugin
• Repetier-Server 1.4.16

Druckst du .bgcode auch woanders als auf einem Prusa-Drucker – etwa über Repetier-Server oder mit OctoPrint und dem Plugin? Schreib mir an apps@xfanta.com, was funktioniert; ich nehme es in die Tabelle auf.