파일 형식과 오픈 데이터
📍 현재 위치: 3부 · 소프트웨어 스택 — 16장 중 9장. 모델을 만들고, 슬라이싱하고, 프린터로 보내는 도구를 보았습니다. 이제 그 도구들이 주고받는 봉투, 즉 파일 형식과 누가 재사용할 수 있는지를 정하는 라이선스를 열어 봅니다.
파일 형식은 포장 목록이 붙은 배송 상자입니다. STL은 포장 목록이 전혀 없는 삼각형 상자입니다. 숫자가 밀리미터인지 인치인지, 무엇이 무슨 색인지 알려 주지 않습니다. 3MF는 단위, 빌드 배치, 선택적 부가 정보가 적힌 라벨 붙은 상자입니다. STEP은 납작한 타일 더미 대신 건축가의 정확한 도면입니다. G-code는 모델이 아니라 기계의 할 일 목록입니다. 어떤 상자를 고르느냐가 여행 중에 정보가 얼마나 살아남는지를 정합니다.
이 장에서 다루는 내용
3D 프린팅 작업 흐름이 실제로 접하는 형식을 부품이 만나는 순서대로 봅니다. 설계 단계의 STEP, 교환 단계의 STL과 3MF, 기계 단계의 G-code입니다. 삼각형 메시가 아닌 두 가지 기하 기술 방식(볼륨과 암시적 함수), 형식이 담을 수 있는 메타데이터와 없는 메타데이터, 온라인 저장소의 설계를 공유하고 재사용하는 실무 규칙도 만납니다. 실행해 본 짧은 스크립트 두 개로 형식 사이의 차이를 실제 바이트로 확인할 수 있습니다.
STL과 그 한계
STL은 1980년대 말 3D Systems의 스테레오리소그래피 장비용으로 도입되어 래피드 프로토타이핑과 3D 프린팅의 사실상 표준이 되었습니다. 1988년의 인터페이스 사양에 처음 문서화되었으며, 미국 의회도서관의 형식 설명은 원본 사양 사본을 찾지 못했다고 밝힙니다 [1] [2]. 표면 형상만 저장합니다. 바이너리 형태는 80바이트 헤더, 4바이트 리틀엔디언 삼각형 개수, 그리고 삼각형당 50바이트(32비트 부동소수점 12개, 즉 법선 하나와 꼭짓점 셋, 그리고 보통 0이어야 하는 2바이트 속성 필드)로 이루어지며, 이 구조는 아래 스크립트가 파일 크기로 확인합니다. ASCII 형태는 같은 데이터를 solid, facet normal, vertex 텍스트 줄로 감쌉니다. STL 파일에 대한 고전적 분석은 파일로부터 다면체 자료구조를 만들어 이런 삼각형 더미의 결함을 찾아내는 방법을 설명합니다 [3]. 표준 적층제조 교재들은 STL 파일을 CAD와 기계 사이의 데이터 준비 사슬의 한 단계로 다룹니다 [4].
한계는 이 설계에서 곧바로 나옵니다.
- 단위 없음. 파일 어디에도 밀리미터인지 인치인지 적혀 있지 않아, 소프트웨어가 묻거나 추측해야 합니다. 위의 어떤 필드에도 단위는 들어 있지 않습니다.
- 색상과 재료 없음. 비표준 바이너리 변형은 헤더나 속성 바이트에 색을 숨기는데, 서로 방식이 다릅니다. 의회도서관의 설명은 서로 호환되지 않는 두 가지 색상 관례를 기록합니다 [1].
- 공유 꼭짓점 없음. 삼각형마다 자기 꼭짓점 셋을 따로 나열하므로 연결 관계를 다시 만들어야 하고, 메시는 닫혀 있고 자기 교차가 없어야만 출력할 수 있는데 형식이 이를 강제하지 않습니다. 틈이나 구멍 같은 테셀레이션 오류가 흔해서 출력 전에 검사와 수리가 필요한 경우가 많습니다 [2] [3]. 슬라이서에서 인용한 공정 계획 서베이가 수리 방법들을 정리합니다 [5].
- 곡선은 근사. 삼각형으로는 완벽한 원통을 만들 수 없고, 정확도는 파일 크기로 치릅니다.
실제 출력에서 이 중복을 볼 수 있습니다. 구멍 네 개와 둥근 모서리를 가진 장착 플레이트를 CadQuery(오픈 CAD와 코드 기반 설계 참고)에서 바이너리 STL로 내보내니 삼각형 2,556개, 즉 저장된 꼭짓점 7,668개였고 서로 다른 꼭짓점은 1,272개뿐이었습니다. 직접 작성한 스크립트로 파일 하나에서 센 값이며, 비율은 메시에 따라 달라집니다.
3MF: 현대적인 컨테이너
3D Manufacturing Format(3MF)은 Linux Foundation 계열의 Joint Development Foundation 프로젝트인 3MF Consortium이 개발합니다. 명세는 자유롭게 구할 수 있고 로열티가 없으며, 사이트는 이제 핵심 명세를 국제 표준 ISO/IEC 25422:2025로 소개합니다 [6]. 핵심 명세 문서는 공개 GitHub 저장소에 BSD-2-Clause 라이선스로 게시되어 있으며 단위, 꼭짓점, 삼각형, 메타데이터를 정의합니다 [7]. 3MF 사이트에 나열된 확장에는 Materials and Properties, Production, Slice, Beam Lattice, Boolean Operations, Displacement, Secure Content, Volumetric, Toolpath가 있으며, 마지막 둘은 최근에 추가되었습니다(사이트는 Volumetric 확장의 날짜를 2025-11-13으로 적고 있습니다) [6].
3MF 파일의 속은 ZIP 패키지입니다. CadQuery와 lib3mf 라이브러리가 쓴 파일을 풀어 보니 모두 [Content_Types].xml, _rels/.rels, 3D/3dmodel.model을 담고 있었습니다. 마지막은 루트 요소에 unit 속성(두 경우 모두 millimeter)이 있고 꼭짓점을 한 번만 나열하며 삼각형은 인덱스로 가리키는 XML 파일입니다.
각 형식은 서로 다른 질문에 답합니다. 어떤 모양인가, 기계가 어떻게 움직이는가, 어떤 볼륨인가.
저자가 AI의 도움을 받아 직접 제작한 그림입니다.
차이를 눈으로 확인하는 스크립트
이 스크립트는 파이썬 표준 라이브러리만 사용합니다. 10 mm 큐브를 바이너리 STL과 직접 만든 3MF 패키지로 쓰고, 각각 꼭짓점을 어떻게 저장하는지 출력합니다.
import struct
import zipfile
s = 10.0
V = [(0, 0, 0), (s, 0, 0), (s, s, 0), (0, s, 0), (0, 0, s), (s, 0, s), (s, s, s), (0, s, s)]
F = [(0, 2, 1), (0, 3, 2), (4, 5, 6), (4, 6, 7), (0, 1, 5), (0, 5, 4),
(1, 2, 6), (1, 6, 5), (2, 3, 7), (2, 7, 6), (3, 0, 4), (3, 4, 7)]
def normal(a, b, c):
u = [b[i] - a[i] for i in range(3)]
v = [c[i] - a[i] for i in range(3)]
n = [u[1] * v[2] - u[2] * v[1], u[2] * v[0] - u[0] * v[2], u[0] * v[1] - u[1] * v[0]]
length = sum(x * x for x in n) ** 0.5
return [x / length for x in n]
# --- binary STL: 80-byte header, uint32 triangle count, 50 bytes per triangle ---
with open("cube.stl", "wb") as f:
f.write(b"cube".ljust(80, b" "))
f.write(struct.pack("<I", len(F)))
for a, b, c in F:
tri = (V[a], V[b], V[c])
f.write(struct.pack("<12fH", *normal(*tri), *tri[0], *tri[1], *tri[2], 0))
# --- 3MF: a ZIP package with a content-types list, a relationship, and one XML model ---
model = ('<?xml version="1.0" encoding="UTF-8"?>\n'
'<model unit="millimeter" xml:lang="en-US" xmlns="http://schemas.microsoft.com/3dmanufacturing/core/2015/02">\n'
' <metadata name="Title">cube</metadata>\n'
' <resources><object id="1" type="model"><mesh>\n <vertices>\n'
+ "".join(f' <vertex x="{x}" y="{y}" z="{z}"/>\n' for x, y, z in V)
+ ' </vertices>\n <triangles>\n'
+ "".join(f' <triangle v1="{a}" v2="{b}" v3="{c}"/>\n' for a, b, c in F)
+ ' </triangles>\n </mesh></object></resources>\n'
' <build><item objectid="1"/></build>\n</model>\n')
content_types = ('<?xml version="1.0" encoding="UTF-8"?>\n'
'<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">\n'
' <Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>\n'
' <Default Extension="model" ContentType="application/vnd.ms-package.3dmanufacturing-3dmodel+xml"/>\n'
'</Types>\n')
rels = ('<?xml version="1.0" encoding="UTF-8"?>\n'
'<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">\n'
' <Relationship Target="/3D/3dmodel.model" Id="rel0" '
'Type="http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel"/>\n</Relationships>\n')
with zipfile.ZipFile("cube_handmade.3mf", "w", zipfile.ZIP_DEFLATED) as z:
z.writestr("[Content_Types].xml", content_types)
z.writestr("_rels/.rels", rels)
z.writestr("3D/3dmodel.model", model)
print(f"STL: {len(F)} triangles x 3 = {3 * len(F)} stored vertices; no unit field")
print(f"3MF: {len(V)} vertices shared by {len(F)} triangles; unit=millimeter")
실행 상태: 파이썬 3.14(표준 라이브러리)로 실행했습니다. 출력은 STL: 12 triangles x 3 = 36 stored vertices; no unit field와 3MF: 8 vertices shared by 12 triangles; unit=millimeter였습니다. STL은 684바이트로 84 + 50 x 12와 같습니다. 이어서 cube_handmade.3mf를 lib3mf 파이썬 패키지(2.5.0, 제 시험에서는 pip install lib3mf로 설치)로 읽었더니 꼭짓점 8개와 삼각형 12개를 읽었고, 메시가 매니폴드이며 방향이 일관됨, 단위가 밀리미터라고 보고했습니다. 이 검사는 리더 하나의 의견일 뿐 적합성 인증이 아닙니다.
검증에 대한 주의. CadQuery 2.8.0이 제 장착 플레이트용으로 쓴 3MF 파일은 lib3mf 2.5.0에서 "Content Types does not contain extension for relatioship"라는 오류로 거부되었습니다. 그 부분을 고쳐 넣자 이번에는 "No Model Object ID has been given"으로 실패했습니다. 어느 쪽 잘못인지는 밝혀내지 못했으며, 더 관대한 리더는 그 파일을 열 수도 있습니다. 실용적 교훈은 다른 사람의 프린터에 파일을 보내기 전에, 가능하면 엄격한 리더로 내보낸 파일을 시험해 보라는 것입니다.
AMF
Additive Manufacturing File Format은 ISO/ASTM 52915입니다. ISO는 2020년판(AMF 버전 1.2)을 현행으로 두고 있으며 2026년에 검토·확정되었다고 표시합니다. 색상, 텍스처, 재료, 하부 구조를 지원하여 STL을 대체하는 것을 목표로, 공개된 XSD 스키마를 갖춘 XML 기반 교환 형식을 규정합니다 [8]. 이 책의 도구 중 CadQuery는 AMF 내보내기를 나열하며 [9], OpenSCAD 매뉴얼도 마찬가지입니다 [10]. AMF 왕복 변환은 시험하지 않았고, 프린터가 얼마나 널리 읽는지에 대한 자료도 없습니다.
STEP: 설계를 위한 정확한 형상
STEP(ISO 10303)은 CAD 교환 계열입니다. 그중 응용 프로토콜 242 "Managed model-based 3D engineering"은 AP203과 AP214의 후계이며 공차 같은 제품 제조 정보도 다룹니다 [11]. STEP 파일은 삼각형이 아니라 정확한 B-rep 표면을 저장합니다. CadQuery에서 플레이트를 내보내니 파일은 ISO-10303-21;로 시작하는 평문 텍스트였고, FILE_SCHEMA 줄은 더 오래된 자동차 설계 스키마(214)를 가리켰습니다. 이것은 STEP이 할 수 있는 일이 아니라 그 버전의 기본 Open CASCADE 쓰기 도구가 하는 일을 알려 줍니다. STEP은 정확한 표면을 유지하므로 다른 CAD 사용자에게 보낼 때 더 좋은 파일이고, 슬라이서에는 메시가 더 좋은 파일이지만 일부 슬라이서는 STEP을 직접 가져옵니다. PrusaSlicer 2.5.0의 릴리스 노트는 "STEP file import"를 나열합니다 [12]. Formlabs의 Foxtrot이라는 오픈 STEP 뷰어가 있지만, 제작자들은 이를 개념 증명이며 일부 표면은 삼각분할에 실패할 수 있다고 설명합니다 [13].
G-code와 그 방언
G-code는 텍스트 명령 언어이며 "방언"은 펌웨어에 따라 달라집니다. Marlin은 G1을 X, Y, Z, E, F를 쓰는 직선 이동으로 문서화합니다 [14]. Klipper는 표준 부분집합(예: G0, G1, G28, M104, M109, M140, M190)을 지원하지만 가능한 모든 명령을 지원하는 것이 목표는 아니라고 밝히고, 대신 SET_HEATER_TEMPERATURE HEATER=<heater_name> TARGET=<temperature>나 SET_PRESSURE_ADVANCE ADVANCE=<value> 같은 사람이 읽기 쉬운 확장 명령을 더합니다 [15]. 드문 명령은 gcode_macro로 만들 수 있습니다 [15]. 그래서 슬라이서가 내는 G-code는 펌웨어에 맞춰져 있으며, 시작·종료 매크로와 확장 명령이 기계에 있어야 합니다.
평문은 읽기 쉽지만 부피가 큽니다. Prusa의 libbgcode는 바이너리 G-code(.bgcode)를 정의합니다. 메타데이터와 G-code를 별도 블록으로 두고, 인코딩과 압축으로 크기를 줄이며, 체크섬을 갖추었고 AGPL-3.0입니다 [16]. 어느 펌웨어 버전이 이를 읽는지는 확인하지 못했습니다.
볼륨과 암시적 모델
모든 형상이 표면은 아닙니다. OpenVDB는 DreamWorks Animation이 만들고 지금은 Academy Software Foundation이 유지하는, 3차원 격자 위의 희소 볼륨 데이터용 오픈소스 C++ 라이브러리로, Apache License 2.0으로 공개됩니다(README는 Mozilla Public License 2.0에서의 재라이선스가 완료되었다고 밝힙니다) [17]. 핵심 자료구조는 2013년에 동적 위상을 가진 계층형 희소 볼륨으로 발표되었습니다 [18]. 재단 사이트는 추가 개요입니다 [19]. libfive는 고체를 수학 함수로 정의하고 이를 워터타이트한 매니폴드 삼각형 메시로 변환합니다 [20]. 3MF Consortium은 복셀과 암시적 데이터를 위한 Volumetric 확장을 나열하는데, 이는 표준이 이런 모델을 출력 파이프라인으로 들여오기 시작했음을 보여 줍니다 [6]. 볼륨형 3MF를 소비하는 프린터나 슬라이서는 시험하지 못했습니다. 이는 아직 자리 잡은 작업 흐름이 아니라 떠오르는 영역입니다.
메타데이터와 공유
STL에는 작성자, 단위, 라이선스를 넣을 곳이 없습니다. 3MF는 XML 안에 metadata 항목을 담습니다. 위 스크립트의 Title 항목과 CadQuery 파일에서 본 애플리케이션 및 생성 날짜 항목이 그 예입니다. 형식과 상관없이 모델 옆에 짧은 README나 라이선스 파일을 함께 두는 습관이 실용적입니다.
재사용에는 크리에이티브 커먼즈 라이선스가 공통 어휘입니다. CC BY는 출처 표기를 조건으로 상업적 재사용을 포함한 재사용을 허용하고, CC BY-SA는 개작물을 같은 조건으로 공유하도록 더하며, NC 변형은 비상업적 사용만 허용하고, ND 변형은 개작본을 금지합니다 [21]. 연구자들은 라이선스 필드를 데이터로 쓰기도 했습니다. Thingi10K 데이터셋(데이터셋 자체의 arXiv 논문으로, DOI가 없지만 1차 출처로 유지)은 온라인 공유 사이트에서 모델 10,000개를 모아 형상과 라이선스, 태그 같은 맥락을 분석하고, 수집물과 통계를 자유롭게 공개했습니다 [22]. 이 장을 쓰면서 Printables와 Thingiverse의 공식 라이선스 페이지는 열지 못했고(요청이 거부되었습니다) 찾은 제3자 요약은 권위 있는 자료가 아니므로, 각 사이트가 어떤 라이선스를 제공하거나 기본값으로 삼는지는 주장하지 않습니다. 쓰려는 모델 페이지의 약관을 읽으세요. 설계 라이선스와 하드웨어 라이선스의 관계는 라이선스와 개방의 경제학에서 다룹니다.
개방 표준을 위한 노력
여기서 개방 형식은 두 방향에서 옵니다. 컨소시엄(3MF, 회원들의 로열티 없는 특허 약속 [6])과 공식 표준 기구(AMF용 ISO/ASTM 52915 [8], 3MF용 ISO/IEC 25422:2025 [6], STEP용 ISO 10303 [11])입니다. G-code에는 모든 펌웨어가 따르는 단일 규범 문서가 없으며, Klipper와 Marlin의 예가 이를 보여 줍니다.
왜 중요한가
형식은 각 인계 과정에서 어떤 정보가 살아남는지를 결정합니다. STL로 보낸 모델은 단위도 재료도 없이 도착하고, 잘못된 펌웨어에 보낸 G-code는 출력 도중에 실패할 수 있습니다. 형식을 의도적으로 고르는 편이 그 결과를 디버깅하는 것보다 쌉니다.
실제 현장에서는
흔한 방법은 이렇습니다. 매개변수형 도구로 설계하고, 소스를 보관하고, CAD 협업자에게는 STEP을, 슬라이서에는 3MF나 STL을 내보내고, 소스와 라이선스를 함께 공개합니다. 출력물이 엉뚱한 크기로 나오면 먼저 단위를 의심하세요.
핵심 용어
- STL — 단위, 색상, 메타데이터 없이 서로 연결되지 않은 삼각형으로 이루어진 메시 형식.
- 3MF — 메시, 단위, 메타데이터, 선택적 확장을 담는 3MF Consortium의 ZIP·XML 형식.
- AMF — ISO/ASTM 52915로 표준화된 XML 기반 적층제조 파일 형식.
- STEP — 정확한 형상을 저장하는 ISO 10303 계열의 CAD 교환 형식.
- B-rep — 삼각형이 아닌 정확한 경계면으로 기술한 고체.
- G-code 방언 — 특정 펌웨어가 이해하는 명령의 집합.
- 바이너리 G-code — Prusa의 libbgcode가 정의한 압축된 블록 구조의 G-code 형식(
.bgcode). - OpenVDB — 3차원 격자 위의 희소 볼륨 데이터를 위한 오픈소스 라이브러리.
- 암시적 모델 — 각 점이 안쪽인지를 알려 주는 함수로 정의한 형상.
- 크리에이티브 커먼즈 라이선스 — 창작물 재사용을 위한 표준 조건 모음(BY, SA, NC, ND).
다음 이야기
소프트웨어와 데이터를 다루었으니, 4부는 데스크톱을 벗어납니다. 이 기계들에 공급되는 재료와 그것을 재활용하는 방법입니다. 다음은 오픈 재료, 재활용, 분산 제조입니다.