3D 장면: Blender(.blend)·glTF(.glb) — 2026-11-12

3D 장면: Blender(.blend)·glTF(.glb) — 2026-11-12

서울 미니어처 두 지도(경복궁, 여의도)의 3D 장면입니다. 공개판 그림의 「조건 렌더」(이미지 모델로 양식을 바꾸기 전 3D 렌더)를 만든 바로 그 장면입니다.

• .blend: Blender 5.0.1 이상. 열고 F12 를 누르면 그 구역의 조건 렌더가 공개판과 같은 카메라·해상도로 나옵니다. 카메라, 해, 툰 재질, 텍스처가 모두 파일 안에 있습니다.
• .glb: glTF 2.0 바이너리. 게임 엔진(Unity, Unreal, Godot), 웹(three.js 등), 다른 3D 도구용입니다. 재질은 근사이고 툰 명암은 없습니다(아래).
• 랜드마크 .glb: 여의도 랜드마크를 건물(단지) 하나에 파일 하나로 냈습니다. 원점은 바닥 중심, 단위 m, +Y 위.

라이선스

전부 ODbL 1.0(https://opendatacommons.org/licenses/odbl/1-0/)입니다. 형상이 OpenStreetMap 에서 왔기 때문입니다. 이 파일로 렌더한 그림·영상은 ODbL 의 Produced Work 라서 출처만 표시하면 원하는 조건으로 낼 수 있습니다. 파일을 고쳐 다시 배포하면 고친 파일도 ODbL 1.0 으로 내야 합니다. 공개판 그림·타일(CC BY 4.0)과는 라이선스가 다릅니다. 자세한 안내는 저장소의 docs/REUSE.md, 판단 근거는 docs/LICENSING.md 에 있습니다.

출처 표시(그대로 복사):

여의도: 3D 장면: 서울 미니어처 by midagedev, https://github.com/midagedev/seoul-miniature · © OpenStreetMap contributors, ODbL 1.0
경복궁: 3D 장면: 서울 미니어처 by midagedev, https://github.com/midagedev/seoul-miniature · © OpenStreetMap contributors, ODbL 1.0 · Overture Maps Foundation · East Asian Buildings (Shi et al. 2023, CC BY 4.0) · 건물 높이 국토교통부 GIS건물통합정보(공공누리 제1유형)

• 국가유산청 3D 모델은 들어 있지 않습니다. 경복궁 파일의 전각 46건과 광화문 자리에는 OSM 윤곽과 높이로 만든 대체 모형이 서 있습니다. 원래 모델은 국가유산청 디지털 서비스(digital.khs.go.kr)에서 직접 받아 pipeline3d/gyeongbokgung/insert_khs.py 로 끼우세요. 끼운 파일에는 국가유산청 자료가 들어가므로 다시 올리지 마세요.
• 실제 지도가 아닙니다. 높이·지붕·창 상당 부분은 추정이거나 규칙으로 만든 것입니다. 실제 건물의 생김새에는 별도 권리가 있을 수 있습니다(3D 프린트 상품 등 판매 목적 복제는 docs/REUSE.md 「주의」).
• 이 문서는 법률 자문이 아닙니다.

파일

구역 나눔: 공개판 그림은 지도마다 8 × 8 렌더 타일(타일 하나 2752 × 1696 px)입니다. 한 파일에 다 넣으면 Blender 에서 열기 무거워서 2 × 2 구역으로 나눴고, 구역 하나가 4 × 4 타일을 맡습니다. 파일 이름 q{가로}{세로} 의 0·1 이 각각 왼쪽·오른쪽, 위·아래 절반입니다. 경복궁은 6.25 cm/px(구역 하나 688 × 424 m 화면 폭), 여의도는 12.5 cm/px(1376 × 848 m)입니다.

파일	크기	맡은 타일	sha256
gyeongbokgung_q00.blend	48.1 MB	i 0–3, j 0–3	4ae97d1dc867a7b2aafd99eaf6174e25f405b80287c05d3404c2ecdcef0d07b6
gyeongbokgung_q00.glb	129.1 MB	i 0–3, j 0–3	9c0950b0aa63724314028a6e56026d54bba300ce1eb5c8840eaa4a7bbd3419d2
gyeongbokgung_q10.blend	33.3 MB	i 4–7, j 0–3	c442573148f4cd0b361ec410f743289b6b0c7a744fe0db4ebd5668ebd6a7a358
gyeongbokgung_q10.glb	88.7 MB	i 4–7, j 0–3	a1602a1d8dd588858d9dd503bd894f64c2b5e792f205e4a61677864cae532807
gyeongbokgung_q01.blend	31.7 MB	i 0–3, j 4–7	70d54b4eced4f9a5388b5c4191e07c6d43af1025304fcdf1b08ca2aabc9133da
gyeongbokgung_q01.glb	97.0 MB	i 0–3, j 4–7	e41c4180648f7cd89d6a9f4fcca159609628b8b1460be56d2564b6be7647c82d
gyeongbokgung_q11.blend	54.3 MB	i 4–7, j 4–7	95358cbbb097d1a07cd96505a5369c27e0f55ecc2082b9eaca5337a87c732b85
gyeongbokgung_q11.glb	133.2 MB	i 4–7, j 4–7	1eee8708533467e4e72274dee6e7d3c0f8128bf3cbfdb38659e79d0e20033545
yeouido_q00.blend	70.3 MB	i 0–3, j 0–3	59d578a3d09f95733dd975cbe8b5f20b22e68ab8901c1ee58cd834c410375b6f
yeouido_q00.glb	166.3 MB	i 0–3, j 0–3	df2e7222c9f67ef2355768fcf44aa174e83513fcd1a0121b0295a4234f6fc7a1
yeouido_q10.blend	78.5 MB	i 4–7, j 0–3	f3d7025e5a442494c173c5b405d124661905b11035c26f201e34d732c0ee3b29
yeouido_q10.glb	187.8 MB	i 4–7, j 0–3	fe39ccebe774cfbeb17e12dbe65893f313f662f6d905345799a35698563fd318
yeouido_q01.blend	58.8 MB	i 0–3, j 4–7	dc45f89bdf0f8a966040cd572f680842391546476cb955828718b3a24fcec533
yeouido_q01.glb	113.1 MB	i 0–3, j 4–7	e144a5754b06b493d7264447a54fded6e41eaf93a66192e8574a7b8301a42331
yeouido_q11.blend	74.2 MB	i 4–7, j 4–7	7feb6010ae69198482f2196ef4641145db90130323d8e8300fc35ffd8a6138d3
yeouido_q11.glb	162.2 MB	i 4–7, j 4–7	2280eadfa41af69a24bd68cdffb4cd897923f1d0133059295f16eb88e3f9056b

랜드마크(여의도):

파일	건물	크기	가로 × 세로 × 높이(m)	sha256
yeouido_63_building.glb	63빌딩	191 KB	140 × 134 × 276	766c291af5d442fb2160215957df533cfb9cbf3a07780569278c3985ccebea4d
yeouido_anchor_one.glb	앵커원	30 KB	52 × 48 × 178	20cd10f549628c8d5026d4f84e87f30ef97a6267a316e33dbee369c0e169c612
yeouido_conrad_seoul.glb	콘래드 서울	40 KB	62 × 68 × 198	9c201b096615cca08fd71c41d622301b69f54fb2de495e9dddaf1fea78493bd2
yeouido_fki_tower.glb	FKI타워(전경련회관)와 컨퍼런스센터	42 KB	132 × 104 × 248	fb1e4d724c584fa7d332366f118d519dc47d24561ce84280028b12c130793a56
yeouido_ifc_seoul.glb	IFC 서울(One·Two·Three IFC, 몰 입구)	105 KB	165 × 210 × 288	ba726000cd0f3c56a6f22a87b89dce198595352fa980cdbf66746eb67e2f24ba
yeouido_kbs_annex.glb	KBS 별관	63 KB	52 × 47 × 41	0819ef3dc82ff52603b0d9be202756b23b23c4fe2c1ec281691d99389cb50c66
yeouido_kbs_main.glb	KBS 신관	183 KB	140 × 142 × 31	75f870101b2e53bb43d4153a2f72ba0ddb55c9b8b948ff75b8a32fa328596638
yeouido_krx_seoul_office.glb	한국거래소 서울사무소	19 KB	89 × 90 × 27	681ac2dc1c399cc73df746686c58aec9b9040560f41ad65b9328ae68d1ff5ae5
yeouido_lg_twin_towers.glb	LG트윈타워	193 KB	165 × 113 × 147	ef2efdf3178460fa0d8e6909742f042a8f23c681ec47411c792d1495e1dbd088
yeouido_national_assembly.glb	국회의사당	253 KB	254 × 290 × 63	7f89f9b7ba38afdf5c59a0dc73e1291207e745b6c3fddd0aececb447e4ac329d
yeouido_national_assembly_communication_hall.glb	국회소통관	23 KB	119 × 117 × 26	c3ab776fcfe54310086795b94c8185c092582db5d8f8c4b5812e0f93cebac95c
yeouido_national_assembly_library.glb	국회도서관	23 KB	103 × 107 × 31	c1a765dd1a297d5e0985eaf31f20c74fe9bacf6fe348dfaf18d2e334ea839ea5
yeouido_national_assembly_members_office.glb	국회의원회관	27 KB	120 × 135 × 43	db0b6edf27b69ad2177e181c1dd1012c59df7f7a735009583e8e667c6727f189
yeouido_national_assembly_museum.glb	국회박물관	30 KB	73 × 100 × 15	8397d5a93e0f8fe7c4bb4270b0b3f214d3176be6c0997a0d677775bbda171c8a
yeouido_national_assembly_uijeonggwan.glb	국회의정관	26 KB	71 × 88 × 38	557c30ee6cf52956287e3c4cbe5ba72db87bbd63ace9662f34ca50460b318fdd
yeouido_parc_one.glb	파크원(타워1·NH금융타워)	197 KB	133 × 118 × 333	3db1ac4274e77868711cc73b775dde9e6d322eb53c83b7b1368dc0ff38f093f7
yeouido_the_hyundai_seoul.glb	더현대 서울	301 KB	180 × 191 × 51	d5fae7137fe31e275793fcb5ad7a30b4b803ed89db28a724552f42228ae07ae4
yeouido_yeouido_post_tower.glb	여의도우체국	35 KB	86 × 84 × 167	af5d92089e37e91a46a7650bd1c57aaa700e52dff3141285ea64a2e033394312
yeouido_yoido_full_gospel_church.glb	여의도순복음교회	24 KB	58 × 61 × 51	531172cd8d7dc229d9766366cc7bc7e9a94519f09fa69ea319bc5c3ee74ac620

여는 법

# 구역 전체 렌더: Blender 에서 열고 F12. 명령줄이면
blender -b yeouido_q00.blend -f 1
# 타일 하나만(저장소의 pipeline3d/common/render_window.py, x0·y0 는 지도 전체 화면 좌표 px)
python render_window.py gyeongbokgung_q01.blend $((3*2752)) $((4*1696)) 2752 1696 t_3_4.png

• 메모리: 타일 하나를 렌더할 때 최대 메모리(8 스레드)는 여의도 약 3 GB, 경복궁 약 14 GB 입니다. 경복궁의 기와 지붕은 그림 두 장(높이·색) + 지오메트리 노드 P3D_RoofGrid 로 들어 있어서 열 때 5–8 cm 격자 메시를 다시 만들기 때문입니다. 메모리가 모자라면 노드 그룹 안의 정수 노드 Step 을 2–4 로 올리세요(render_window.py --roof-step 2). 2 에서 약 7 GB 이고, 공개판과의 차이는 MAE 7.3(원래 격자는 2.7) / 255 입니다.
• 오브젝트의 pass_index 가 건물 ID, 장면 속성 p3d_meta 가 ID → 종류 표입니다. 그 밖의 장면 속성 p3d_* 에 창 위치, 해상도, 샘플 수, 라이선스가 있습니다. 텍스트 블록 README 에 같은 안내가 있습니다.
• 경복궁: 컬렉션 KHS_SLOTS 의 빈 오브젝트가 전각 자리(속성 khs_model, theta, tx, ty, tz)이고, KHS_STANDIN/<자리> 가 대체 모형입니다.

GLB 에서 달라지는 것

• 재질은 glTF 표준 재질(기본색, 창 격자·입면 텍스처)만 있습니다. Blender 노드로 만든 툰 명암(3단 계단 음영, 붉은 부재 테두리)은 glTF 로 옮겨지지 않습니다. 텍스처 샘플러는 NEAREST(픽셀 결 유지)입니다.
• 경복궁 기와 지붕은 약 20 cm 격자 메시로 줄였습니다(기와 골은 꼭짓점 색으로만).
• 카메라와 해는 없습니다. 오브젝트 속성(extras)에 건물 종류, 전각 자리, 라이선스가 들어 있습니다.
• Draco·meshopt 압축을 쓰지 않았습니다(어디서나 열리게).
• 좌표: 구역 GLB 는 장면 좌표 그대로라 여러 파일이 서로 맞물립니다. 랜드마크 GLB 는 원점이 바닥 중심이고, extras.scene_offset_m 이 장면 안 원래 위치입니다.

국가유산청 모델 끼우기(경복궁)

python insert_khs.py gyeongbokgung_q01.blend ~/khs-downloads/ out_khs.blend --list   # 자리와 찾은 원본
python insert_khs.py gyeongbokgung_q01.blend ~/khs-downloads/ out_khs.blend

받은 zip 을 받은 이름 그대로(예: 국보_경복궁_경회루.zip) 한 폴더에 두면 됩니다. 광화문은 SM_GwanghwamunComplex.fbx 가 든 폴더를 두세요. 이 스크립트는 국가유산청에서 받은 zip 129개로 gyeongbokgung_q01.blend 의 전각 자리 17곳에 모두 끼워 시험했습니다(약 4.5분, 최대 메모리 18 GB). 끼운 파일로 렌더한 타일은 국가유산청 모델로 렌더한 공개판 조건 렌더와 전각 자리 안에서 MAE 1.21 이었습니다. 광화문은 이 폴더에 FBX 가 없어 시험하지 못했습니다.

확인한 것

• 다시 열어 렌더한 타일을 공개판 조건 렌더와 비교했습니다(MAE 는 0–255 단위의 화소 평균 차이). 경복궁은 대체 모형이 선 전각 자리(조건 렌더의 전각 ID 영역과 대체 모형 영역을 64 px 넓힌 곳)를 빼고 쟀습니다.

타일	비교 범위	MAE	24 넘게 다른 화소	건물 ID 일치
경복궁 t_3_4	전각 자리 밖(92.6%)	0.28	0.094%	99.976%
경복궁 t_5_2	전각 자리 밖(72.3%)	0.178	0.015%	99.999%
경복궁 t_6_6	전체(전각 없음)	0.085	0%	100%
여의도 t_0_0	전체	1.433	0.339%	99.999%
여의도 t_2_5	전체	0.266	0%	100%
여의도 t_6_4	전체	0.664	0.006%	99.999%
경복궁 t_3_4 + insert_khs.py(전각 17곳 끼움)	전체	0.196	0.001%	99.898%
같은 타일, 전각 자리 안만	18.5만 화소	1.21	0.001%

남은 차이는 타일 밖 물체가 주는 간접광, 여의도 노면 표시 점선의 시작 위치(잘린 선에서 다시 시작)처럼 렌더 창 경계에서 생기는 것입니다.

• GLB 는 Blender 로 다시 불러와 렌더해 모양과 색을 봤습니다(구역 2개, 랜드마크 19개 앞모습).
• 파일 위생: .blend 는 압축을 푼 바이트, .glb 는 JSON 전체(그림 uri, 이름, extras)에서 작업 장비 경로, 장비·계정 이름, 국가유산청 캐시 경로를 찾아 0 건이었습니다. 그림은 모두 파일 안에 있습니다. 참조 사진이나 이미지 평면은 없습니다.
• 만든 도구: Blender Python 모듈 bpy 5.0.1, 압축 저장(zstd).

---

English. 3D scenes behind the Seoul Miniature pictures. .blend (Blender 5.0.1+, open and press F12 to reproduce the published condition render of that section) and .glb (glTF 2.0 for game engines and the web; base colours and textures only, the toon shading does not carry over). Yeouido landmarks come as one .glb per building, origin at the base centre, metres, +Y up. All files: ODbL 1.0, © OpenStreetMap contributors; credit "Seoul Miniature by midagedev". The Gyeongbokgung files contain no Korea Heritage Service models (OSM stand-ins; insert_khs.py puts your own downloads in). Not a factual map. Not legal advice.