경량 통합본 안내: 이 ZIP에는 Blender 편집 파일을 담고 GLB는 제외했습니다. 아래 GLB 설명과 검사 기록은 별도로 제작·검증한 원본 교환 파일에 대한 내용입니다.

# 경복궁 근정전 · 편집형 일반 3D 모델

2026-10-04 제작 · Blender 4.3.2 · 본채 + 2단 월대 + 계단 범위

## 파일과 사용법

- `Geunjeongjeon_editable.blend`: 주 편집 원본. 부품별 한국어/영어 컬렉션, 재질, 검증 카메라 포함
- `Geunjeongjeon.glb`: 스튜디오 배경·조명·카메라를 제외한 교환본. 텍스처 포함. GLB는 Blender 원본보다 컬렉션/수정자 편집정보가 제한됨
- `renders/`: 동일 모델의 전면, 측면, 후면, 사선, 상부, 근거리 및 낮은 사선 렌더
- `scripts/build_geunjeongjeon.py`: 처음부터 독립 장면을 생성하는 재현 스크립트. 기존 모델을 덮어쓰지 않도록 별도 폴더에서 실행
- `textures/`: 직접 그린 단청 머리초와 연화 단면 무늬. 원본 사진을 붙인 텍스처가 아님
- `validation/`: 재열기·메시·내보내기·재반입 검사 결과

원본을 열면 카메라 시점으로 보인다. Numpad 0으로 카메라를 벗어나 부품을 편집할 수 있다. 기와는 독립 객체 수만 개가 아니라 지붕면별로 묶은 메시다. 뷰포트가 무거우면 `10_기와_TileCourses`, `12_단청_Dancheong` 컬렉션을 잠시 숨긴다. 상세 창살과 공포는 각각 별도 메시이므로 부분 수정이 가능하다.

## 좌표와 치수

Blender 1 unit = 1m. X는 동쪽, Y는 북쪽, Z는 위. 정면은 -Y. XY 원점은 본채 주열 중심, Z=0은 평탄화한 전정 남쪽 지면이다. 실물 지반경사는 재현하지 않았다.

| 항목 | 모델 기준 | 근거/정밀도 |
|---|---:|---|
| 하층 정면 기둥 중심간 총폭 | 30.210m | 2000 실측보고서 p91 및 국가유산포털 원형기록 평면도 |
| 하층 정면 칸폭 | 5.300 / 6.400 / 6.845 / 6.405 / 5.260m | 정면값을 사용. 배면의 미세 비대칭은 평균화 |
| 하층 측면 주열 깊이 | 21.049m | 동서 실측 21.043~21.055m의 평균형 |
| 하층 측면 칸폭 | 약5.261 / 3.503 / 3.507 / 3.512 / 5.266m | 앞뒤 큰 퇴칸과 가운데 좁은 3칸 보존 |
| 상층 정면 주열 | 27.208m | 상층 끝칸만 줄어드는 별도 칸폭 적용 |
| 상층 측면 주열 | 약18.12m | 실측 범위 18.099~18.160m 안의 평균형 |
| 별도 본채 기단 | 약34.515×25.350m | 기단 외곽 실측; 상부 갑석은 미세 돌출 |
| 상월대 | 43.60×45.245m | 남북 폭43.443~43.758m를 직사각형으로 근사 |
| 하월대 | 52.75×55.945m | 실측 구간 합산값을 직사각형으로 근사; 상하월대 전후 단차 여유는 평균화 |
| 월대 앞 높이 | 하1.774m / 상3.168m | 남측 도면 수준값. 뒷면도 같은 높이로 단순화 |
| 본채 기단 위 | 3.538m | 남측 도면값 |
| 최고 취두 | 약26.81m, 상월대에서 약23.65m | 2000 단면의 상월대 기준23.607m에 맞춰 근사; 둥근 장식 끝의 약4cm 차이 |

서로 다른 단면 도면의 임의 기준선/손글씨 레벨을 혼합하지 않았다. 높이·지붕 형상은 하나의 통일된 모델 기준으로 근사한 값이다. 2000년 해체수리 전 실측을 이용했으며 현재(2026) 실측/BIM으로 주장하지 않는다.

## 근거를 보존한 구조

- 정면5칸 × 측면5칸, 양층 팔작지붕과 겹처마
- 넓은 상층 완전 팔작지붕과 상층 둘레를 감싸는 얕은 하층 지붕
- 상층 지붕 정면 폭이 하층의 약94%인 큰 폭 관계
- 본채가 월대 북쪽에 치우쳐 전면 의식공간을 넓게 남기는 배치
- 외진20 + 내진12 + 귀고주4 = 지상 기둥36개. 상층 노출 기둥은 별도 단편 부재
- 하층 공포군80, 상층72의 외곽 배치. 실측 주간포 개수 적용
- 공포 외3출목·내4출목이라는 실측 분류를 참고했으나, 실제 결구·목재 단면과 모든 내출목을 정밀 복원한 모델은 아님
- 상층 바닥 없음. 실내는 통층이며 실측 평면의 내진 고주 위치를 유지
- 앙곡과 평면 안허리곡을 따로 적용해 처마 끝이 위로 들리고 평면 모서리가 뻗어 나옴
- 용마루, 귀마루, 합각, 기와 골, 두 겹 서까래, 정면 현판, 전면 중앙 답도와 양옆 계단
- 정면 현판은 전통적인 오른쪽→왼쪽 읽기 순서의 勤政殿. 글씨는 Noto Serif CJK의 자체 조형 대체이며 원 현판 서체를 복각하지 않음

## 관찰 기반 해석·단순화·제외

이 모델은 외관 중심의 교육·시각화용 재구성이다. 수리용 실측 CAD, 문화재 복원 설계, 완전한 디지털 트윈, 구조해석 자료, 3D 프린팅용 수밀 메시가 아니다.

- 지붕 곡면·기와 간격·모서리 들림은 정면/측면/상부 실사진과 입면 비교에 맞춘 파라미터 해석이며 기와 한 장씩 실측하지 않음
- 공포는 층진 살미/첨차·소로·도리·받침목·서까래를 구분한 외형 단순화. 목재 접합부, 귀포 전체 복잡한 사선구조, 내부4출목의 완전 상세는 미구현
- 단청은 관찰된 녹청 바탕, 붉은 선, 머리초와 연화 단면의 계층을 직접 그린 해석. 원본 문양의 정확한 도상·노후도·붓질 복원이 아님
- 창호는 대각 격자와 구조적 문살을 분리해 단순화. 모든 꽃살의 정확한 꽃잎/금속장식은 재현하지 않음
- 취두·용두·잡상은 작은 실루엣 위주. 각 동물의 세밀한 조각·도상은 해석이며 일대일 스캔 아님
- 난간·월대 석재 단위와 연결부는 합리적인 반복 치수로 근사. 난간 주변 석수 동물상의 세밀 조각은 미제작
- 내부 고주는 구조 위치 확인용. 어좌·일월오악도·보개천장·금룡·정밀 공포 내부·현대 설비는 제작하지 않음
- 궁궐 전체, 근정문, 주변 회랑, 광범위한 전정 품계석은 범위 밖
- 자료에 보이는 2022년 공사 가설재·해체 상태는 반영하지 않음

## 원자료 출처와 이용 경계

모델 메시와 단청 텍스처는 이 작업에서 직접 제작했다. 외부 완성 3D 자산, 공식 STL, 포토그래메트리 메시를 가져오지 않았다. 공식 STL은 사용하지 않았다.

1. 문화재청, 『근정전 실측조사보고서(하)』, 2000
   https://heritage.go.kr/heri/cul/linkSelectEbookDetail.do?bbsId=BBSMSTR_1021&nttId=19132&pageNo=2_4_1_1
   p91~94 평면/입면, p97·102 단면, p123 기둥, p152~159 공포, p248~251 처마곡선, p285~288 월대의 치수·구조 사실관계를 참고했다. 게시물 공공누리4 조건 때문에 원문 PDF/캡처/편집도면은 이 납품물에 포함하지 않았고 모델 텍스처로 사용하지 않았다.
2. 국가유산청/국가유산포털, 근정전 원형기록정보 도면
   1층 평면도(보수): https://www.heritage.go.kr/heri/cul/chartImgHeritage.do?file_seq=2839335
   정면도(보수): https://www.heritage.go.kr/heri/cul/chartImgHeritage.do?file_seq=2839530
   횡단면도: https://www.heritage.go.kr/heri/cul/chartImgHeritage.do?file_seq=2839751
   각 페이지 공공누리1 확인. 사실관계 교차검증에 사용했으며 원 그림은 번들에서 제외했다.
3. 국가유산청/국가유산포털, 근정전 외관·단청 사진
   정면: https://www.heritage.go.kr/heri/cul/imgHeritage.do?ccimId=1611706&ccbaKdcd=11&ccbaAsno=0002230000000&ccbaCtcd=11
   측면: https://www.heritage.go.kr/heri/cul/imgHeritage.do?ccimId=1611708&ccbaKdcd=11&ccbaAsno=0002230000000&ccbaCtcd=11
   현판/단청: https://www.heritage.go.kr/heri/cul/imgHeritage.do?ccimId=1611709&ccbaKdcd=11&ccbaAsno=0002230000000&ccbaCtcd=11
   공공누리1 사진을 관찰했으나 사진 픽셀을 모델의 이미지 텍스처로 사용하지 않았다.
4. 한국학중앙연구원, 한양도성 타임머신, 허호 촬영(2022-11-09)
   R2206-A004-0544 상부, R2206-A004-0591 후면 사진을 관찰해 지붕 평면·뒷면 검증. 원사진 미포함
5. 문화재청 2007 문화재 관리자·수리기술 교육 p144: 외3출목·내4출목 교차확인
6. Noto Serif CJK: 현판의 대체 활자 윤곽 사용. 외부 폰트 파일을 요구하지 않도록 메시로 변환

기술 검증과 외형의 정확성은 다르다. 재열기·내보내기 성공은 실측 일치나 학술적 복원 승인을 뜻하지 않는다. 실제 확인한 렌더와 기술검사 결과를 각각 제공한다.

## 재생성 메모

기본 편집·열기는 외부 폰트나 사진 파일이 필요 없다. 완전 재생성 스크립트는 Blender 4.3.2, Pillow, 설치된 Noto Serif CJK 경로를 사용한다. 다른 운영체제에서는 스크립트의 폰트 경로를 바꿔야 한다. 텍스처를 다시 그린 뒤 MODEL_STAGE=detail 환경변수로 build_geunjeongjeon.py를 실행하면 상세판을 만든다. 모델 원본은 별도 폴더에 복사해 두고 재생성하는 것이 안전하다. 새 프로그램 설치나 외부 API 호출은 하지 않는다.