Qu’est-ce qu’un fichier .bgcode ? Le G-code binaire de Prusa expliqué

Les mêmes commandes dans un autre emballage

Un .bgcode contient exactement les mêmes instructions pour l’imprimante qu’un fichier G-code texte : où va la buse, combien de matière extruder, quelle température maintenir. Seul l’emballage change. Au lieu d’un long texte, le fichier est découpé en blocs, et chaque bloc peut être compressé et porter sa propre somme de contrôle.

Prusa a introduit le format en 2023 avec PrusaSlicer 2.7 et en a publié la spécification dans le dépôt libbgcode sur GitHub. Il est donc ouvert, mais ce n’est pas une norme comme STEP ou 3MF — il appartient à Prusa Research. La bibliothèque qui le lit et l’écrit est sous licence AGPL-3.0.

Ce format a trois raisons d’être. Un fichier plus petit se copie plus vite sur une clé USB et circule plus vite sur le réseau. L’imprimante trouve plus tôt ce dont elle a besoin, car les détails de l’impression et les aperçus sont dans des blocs à part : elle n’a pas besoin de lire tout le parcours pour les obtenir. Et les sommes de contrôle repèrent un fichier abîmé en chemin.

À l’intérieur : un en-tête GCDE et des blocs dans un ordre fixe

Chaque .bgcode commence par les quatre lettres GCDE. Viennent ensuite la version du format (seule la version 1 existe pour l’instant) et le type de somme de contrôle, en pratique CRC32. Les blocs suivent, toujours dans le même ordre :

• métadonnées du fichier — ce qui a produit le fichier,
• métadonnées de l’imprimante — pour quelle imprimante et quelle buse l’impression est prévue,
• vignettes — des images du modèle, une par bloc,
• métadonnées d’impression — durée estimée, filament utilisé,
• métadonnées du trancheur — tous les réglages avec lesquels PrusaSlicer a tranché,
• blocs G-code — le parcours lui-même.

Les métadonnées sont de simples paires clé = valeur. PrusaSlicer compresse le parcours avec Heatshrink, un algorithme conçu pour les appareils qui ont peu de mémoire, et l’encode en plus avec MeatPack, qui écrit les 15 caractères les plus courants du G-code sur quatre bits au lieu de huit. MeatPack était à l’origine un plugin OctoPrint destiné à accélérer les liaisons série lentes vers les imprimantes.

De combien il est plus petit

Selon Prusa, le G-code binaire est ressorti en moyenne environ 70 % plus petit que le texte dans ses tests. Dans les données de test de libbgcode elles-mêmes, un petit cube passe de 641 092 à 149 258 octets — un peu moins d’un quart. Le gain dépend du modèle et des réglages d’impression.

Ce qui le lit et ce qui ne le lit pas

Pourquoi votre imprimante n’affiche pas le fichier

La raison habituelle est un firmware trop ancien. Les imprimantes Prusa dont le firmware Buddy est antérieur à 5.1.0 n’affichent pas du tout les fichiers .bgcode, si bien que la clé USB semble vide. Mettez le firmware à jour, ou convertissez le fichier en G-code texte.

L’autre raison est une imprimante qui ne connaît pas du tout le format. Klipper et les imprimantes d’autres fabricants ne le connaissent pas, et PrusaSlicer ne l’enregistre pas non plus pour elles. Si une personne équipée d’une imprimante Prusa vous a envoyé un .bgcode, convertissez-le.

Du .bgcode au .gcode, et retour

Dans PrusaSlicer, la conversion se trouve dans Fichier → Convertir :

• Convertir le G-code binaire en ASCII transforme un .bgcode en .gcode texte,
• Convertir le G-code ASCII en binaire fait l’inverse.

Si vous préférez la ligne de commande, libbgcode fournit un outil bgcode. bgcode model.bgcode écrit à côté un fichier texte model.gcode.

Pour que PrusaSlicer n’enregistre plus du tout de .bgcode, ouvrez les Préférences (dans le menu PrusaSlicer sur Mac, ⌘ ,), allez dans l’onglet Autre et désactivez Utiliser le G-code binaire lorsque l’imprimante le prend en charge. Ce réglage existe depuis la version 2.7.1. La version 2.7.0 enregistrait du .bgcode par défaut pour toutes les imprimantes qui le prennent en charge — et a cassé au passage l’envoi vers OctoPrint.

Comment voir l’intérieur d’un .bgcode sur Mac, iPad ou iPhone

macOS ne sait rien du .bgcode. Il n’a pas de type de fichier pour lui, le Finder affiche une icône vierge et la barre d’espace (Quick Look) n’affiche rien. Sous Windows, PowerToys s’en charge ; sur Mac, il faut ajouter quelque chose.

• PrusaSlicer l’ouvre dans sa visionneuse de G-code et affiche le parcours couche par couche. Il est gratuit, mais vous lancez tout un trancheur (slicer) pour un seul aperçu.
• ThumbHost3mf ajoute des vignettes dans le Finder, .bgcode compris. Il ne montre pas ce que contient le fichier.
• Preview3D, mon app, ouvre les .bgcode dans sa fenêtre, dans Quick Look et en vignette dans le Finder. Elle dessine le parcours coloré par type (périmètres, remplissage, ponts, supports), propose un curseur de couches, et lit dans les métadonnées la durée d’impression, la longueur de filament, le poids, la hauteur de couche et le matériau. Elle fonctionne de la même façon sur iPad, iPhone et Apple Vision Pro.

Vignettes : QOI pour l’imprimante, PNG pour les ordinateurs

Un fichier issu de PrusaSlicer contient en général plusieurs vignettes. Celles destinées à l’écran de l’imprimante sont au format QOI (Quite OK Image), que Prusa a adopté avec le firmware 5.1.0 parce que décoder du PNG était trop lourd pour l’imprimante. Pour les ordinateurs, PrusaSlicer ajoute une image de plus, en PNG.

Voilà pourquoi certains outils n’affichent aucun aperçu pour un .bgcode : ils ne savent pas lire le QOI. Preview3D utilise le PNG pour le Finder.

Questions fréquentes

Le .bgcode est-il meilleur que le .gcode ?

Pour une imprimante Prusa qui le prend en charge, oui : le fichier est plus petit et les dégâts sont détectés. Pour tout le reste, non — on ne peut pas le lire sans le convertir, et la plupart des logiciels ne le connaissent pas.

D’autres trancheurs que PrusaSlicer peuvent-ils produire du .bgcode ?

À ma connaissance, PrusaSlicer est le seul trancheur répandu qui l’écrit. OrcaSlicer et Bambu Studio ne le prennent pas en charge. Le G-code texte d’un autre trancheur peut être converti dans PrusaSlicer ou avec l’outil bgcode.

OctoPrint prend-il en charge le .bgcode ?

Pas de lui-même. Le plugin BGCode convertit un fichier envoyé en G-code texte. L’équipe d’OctoPrint a refusé une prise en charge native, en faisant valoir que le .bgcode est fait pour être stocké sur l’imprimante, pas pour lui être envoyé.

Puis-je ouvrir un .bgcode dans un éditeur de texte ?

Non, il est binaire. Convertissez-le d’abord en .gcode, comme décrit plus haut.

Un .bgcode contient-il les couleurs et le matériau ?

De la même façon que le G-code : les changements de filament sont dans les commandes, le type de matériau et la quantité utilisée dans les métadonnées. Le modèle 3D et les textures n’y sont pas — seulement le trajet de la buse.

Formats associés

• G-code — la forme texte des mêmes instructions. Comment en voir l’intérieur sans trancheur : Examiner un G-code sur Mac sans lancer le trancheur.
• 3MF — le projet à partir duquel PrusaSlicer tranche le G-code. Voir la visionneuse 3MF pour Mac.

Sources

• La spécification du format dans le dépôt libbgcode
• Base de connaissances Prusa : G-code binaire
• PrusaSlicer 2.7.0 sur GitHub
• Firmware Buddy 5.1.0 sur GitHub
• OctoPrint, ticket n° 4900 et le plugin BGCode
• Repetier-Server 1.4.16

Vous imprimez du .bgcode ailleurs que sur une imprimante Prusa — via Repetier-Server, par exemple, ou OctoPrint avec le plugin ? Écrivez-moi à apps@xfanta.com et dites-moi ce qui fonctionne ; je l’ajouterai au tableau.