.bgcode 파일이란? Prusa의 바이너리 G-code 알아보기

같은 명령, 다른 포장

.bgcode에는 텍스트 G-code 파일과 똑같은 프린터 명령이 들어 있습니다. 노즐이 어디로 갈지, 얼마나 압출할지, 몇 도를 유지할지입니다. 다른 것은 포장뿐입니다. 하나의 긴 텍스트 대신 파일이 여러 블록으로 나뉘고, 각 블록은 압축될 수 있으며 자체 체크섬을 가질 수 있습니다.

Prusa는 2023년 PrusaSlicer 2.7과 함께 이 형식을 내놓았고, 사양을 GitHub의 libbgcode 저장소에 공개했습니다. 즉 공개된 형식이지만 STEP이나 3MF 같은 표준은 아니며, Prusa Research의 것입니다. 이 형식을 읽고 쓰는 라이브러리는 AGPL-3.0 라이선스입니다.

이유는 세 가지입니다. 파일이 작으면 USB 메모리에 더 빨리 복사되고 네트워크로도 더 빨리 전송됩니다. 출력 정보와 미리보기 이미지가 별도 블록에 있어서, 프린터는 툴패스 전체를 읽지 않고도 필요한 것을 더 빨리 찾습니다. 그리고 체크섬은 전송 중에 손상된 파일을 잡아냅니다.

내부 구조: GCDE 헤더와 정해진 순서의 블록

모든 .bgcode는 네 글자 GCDE로 시작합니다. 이어서 형식 버전(지금까지는 버전 1만 있습니다)과 체크섬 종류가 오는데, 실제로는 CRC32입니다. 그 뒤로 블록이 항상 같은 순서로 이어집니다.

• 파일 메타데이터 – 파일을 만든 프로그램
• 프린터 메타데이터 – 어떤 프린터와 노즐을 위한 출력인지
• 미리보기 이미지 – 모델 그림, 블록마다 하나씩
• 출력 메타데이터 – 예상 시간, 사용한 필라멘트
• 슬라이서 메타데이터 – PrusaSlicer가 슬라이싱에 사용한 전체 설정
• G-code 블록 – 툴패스 자체

메타데이터는 단순한 key = value 쌍입니다. PrusaSlicer는 툴패스를 메모리가 적은 기기를 위해 만든 알고리즘인 Heatshrink로 압축하고, MeatPack으로도 인코딩합니다. MeatPack은 G-code에서 가장 흔한 문자 15개를 8비트 대신 4비트로 씁니다. MeatPack은 원래 프린터와의 느린 시리얼 연결을 빠르게 하려고 만든 OctoPrint 플러그인이었습니다.

얼마나 작아지나

Prusa에 따르면 자체 테스트에서 바이너리 G-code는 텍스트보다 평균 약 70% 작았습니다. libbgcode의 자체 테스트 데이터에서는 작은 큐브 하나가 641,092바이트에서 149,258바이트로, 4분의 1이 조금 안 되는 크기로 줄어듭니다. 얼마나 줄어드는지는 모델과 출력 설정에 따라 다릅니다.

읽을 수 있는 것과 없는 것

프린터에 파일이 보이지 않는 이유

흔한 이유는 오래된 펌웨어입니다. Buddy 펌웨어가 5.1.0보다 오래된 Prusa 프린터는 .bgcode 파일을 목록에 아예 표시하지 않기 때문에 USB 메모리가 비어 있는 것처럼 보입니다. 펌웨어를 업데이트하거나 파일을 텍스트 G-code로 변환하세요.

다른 이유는 이 형식을 전혀 모르는 프린터입니다. Klipper와 다른 제조사의 프린터는 이 형식을 모르며, PrusaSlicer도 그런 프린터용으로는 이 형식으로 저장하지 않습니다. Prusa 프린터를 쓰는 사람이 .bgcode를 보냈다면 변환하세요.

.bgcode에서 .gcode로, 그리고 그 반대로

PrusaSlicer에서 변환 기능은 File → Convert 아래에 있습니다.

• Convert binary G-code to ASCII는 .bgcode를 텍스트 .gcode로 바꾸고
• Convert ASCII G-code to binary는 그 반대로 바꿉니다.

명령줄이 편하다면 libbgcode에 들어 있는 bgcode 도구를 쓸 수 있습니다. bgcode model.bgcode를 실행하면 같은 위치에 텍스트 파일 model.gcode가 만들어집니다.

PrusaSlicer가 .bgcode로 아예 저장하지 않게 하려면 Preferences(Mac에서는 PrusaSlicer 메뉴, ⌘ ,)를 열고 Other 탭에서 Use binary G-code when the printer supports it를 끄세요. 이 스위치는 2.7.1부터 있습니다. 버전 2.7.0은 이 형식을 지원하는 모든 프린터에 기본으로 .bgcode를 저장했고, 그 바람에 OctoPrint로의 업로드가 망가졌습니다.

Mac, iPad, iPhone에서 .bgcode 안을 들여다보는 방법

macOS는 .bgcode를 전혀 모릅니다. 이 형식의 파일 유형이 없어서 Finder에는 빈 아이콘이 표시되고, 스페이스바(훑어보기)를 눌러도 아무것도 나오지 않습니다. Windows에서는 PowerToys로 해결되지만, Mac에서는 무언가를 따로 설치해야 합니다.

• PrusaSlicer는 파일을 G-code 뷰어에서 열고 툴패스를 레이어별로 보여줍니다. 무료지만, 미리보기 하나를 보려고 슬라이서 전체를 실행하게 됩니다.
• ThumbHost3mf는 .bgcode를 포함해 Finder 미리보기 이미지를 추가합니다. 파일 안의 내용은 보여주지 않습니다.
• 제 앱 Preview3D는 .bgcode를 창에서, 훑어보기에서, Finder 미리보기 이미지로 보여줍니다. 툴패스를 종류별(외벽, 채움, 브리지, 서포트)로 색을 구분해 그리고, 레이어 슬라이더가 있으며, 메타데이터에서 출력 시간, 필라멘트 길이, 무게, 레이어 높이, 소재를 읽습니다. iPad, iPhone, Apple Vision Pro에서도 똑같이 작동합니다.

미리보기 이미지: 프린터에는 QOI, 컴퓨터에는 PNG

PrusaSlicer에서 나온 파일에는 보통 미리보기 이미지가 여러 개 들어 있습니다. 프린터 화면용 이미지는 QOI(Quite OK Image) 형식인데, PNG 디코딩이 프린터에 너무 무거워서 Prusa가 펌웨어 5.1.0과 함께 채택했습니다. 컴퓨터용으로는 PrusaSlicer가 PNG 이미지를 하나 더 넣습니다.

일부 도구가 .bgcode의 미리보기를 보여주지 못하는 이유가 여기에 있습니다. QOI를 읽지 못하기 때문입니다. Preview3D는 Finder용으로 PNG를 사용합니다.

자주 묻는 질문

.bgcode가 .gcode보다 나은가요?

이 형식을 지원하는 Prusa 프린터라면 그렇습니다. 파일이 더 작고 손상이 감지됩니다. 그 밖의 경우에는 아닙니다. 변환하지 않으면 읽을 수 없고, 대부분의 소프트웨어가 이 형식을 모릅니다.

PrusaSlicer 말고 다른 슬라이서도 .bgcode를 만들 수 있나요?

제가 아는 한, 널리 쓰이는 슬라이서 중에서 이 형식으로 저장하는 것은 PrusaSlicer뿐입니다. OrcaSlicer와 Bambu Studio는 지원하지 않습니다. 다른 슬라이서에서 나온 텍스트 G-code는 PrusaSlicer나 bgcode 도구로 변환할 수 있습니다.

OctoPrint는 .bgcode를 지원하나요?

자체적으로는 지원하지 않습니다. BGCode 플러그인이 업로드된 파일을 텍스트 G-code로 변환합니다. OctoPrint 관리자들은 .bgcode가 프린터로 보내기 위한 것이 아니라 프린터에 저장하기 위한 형식이라며 기본 지원을 거절했습니다.

.bgcode를 텍스트 편집기로 열 수 있나요?

아니요, 바이너리 파일입니다. 위에서 설명한 대로 먼저 .gcode로 변환하세요.

.bgcode에 색과 소재 정보가 들어 있나요?

G-code와 같은 방식으로 들어 있습니다. 필라멘트 교체는 명령에, 소재 종류와 사용량은 메타데이터에 있습니다. 3D 모델과 텍스처는 들어 있지 않고, 노즐이 지나가는 경로만 있습니다.

관련 형식

• G-code – 같은 명령의 텍스트 형태입니다. 슬라이서 없이 안을 들여다보는 방법: 슬라이서를 켜지 않고 G-code 들여다보기.
• 3MF – PrusaSlicer가 G-code를 슬라이싱하는 원본 프로젝트입니다. Mac용 3MF 뷰어를 참고하세요.

출처

• libbgcode 저장소의 형식 사양
• Prusa Knowledge Base: Binary G-code
• GitHub의 PrusaSlicer 2.7.0
• GitHub의 Buddy 펌웨어 5.1.0
• OctoPrint 이슈 #4900 및 BGCode 플러그인
• Repetier-Server 1.4.16

Prusa 프린터가 아닌 곳에서 .bgcode로 출력하고 계신가요? 예를 들어 Repetier-Server나 플러그인을 설치한 OctoPrint로요. apps@xfanta.com으로 무엇이 되는지 알려 주시면 표에 추가하겠습니다.