포토 씬 재구성
이 방법은 2026년 11월의 세 가지 프로젝트에서 개발되었습니다: 트램이 있는 거리 사진(프라이부르크), 고딕 양식 분수(피슈브루넨, 프라이부르크), 그리고 코드로 생성된 도시, 상점, 항구 디오라마 세 가지입니다. 아래 예시는 이 프로젝트에서 가져온 것입니다. 일반 하네스(카메라, 오케스트레이터, 렌더 및 비교 도구)는 이 파일 옆에 있는 harness/ 디렉토리에 있습니다. harness/blender와 harness/tools를 새 실행 폴더에 복사하세요. 아래에 나열된 도구 이름 중 harness/에 없는 것(예: facade_solve.py)은 각 실행이 자체적으로 생성하는 도메인별 프로브이며, 그 목적은 이름이 언급된 곳에서 설명됩니다.
요구 사항: Blender(5.1 버전, Cycles 기준), 2D 도구를 위한 Python(numpy, opencv, pillow 포함, tools/py.sh는 uv로 실행), 그리고 하위 에이전트를 시작할 수 있는 에이전트 런타임.
사용자는 사진과 나란히 놓고 육안으로 충실도를 판단합니다. 아래의 모든 내용은 이 비교를 저렴하고, 자주, 그리고 정직하게 만들기 위해 존재합니다.
0. 리드가 에이전트 시작 전에 설정
리드(메인 세션)는 다음 작업을 단독으로 수행합니다. 모든 작업이 완료된 후에만 에이전트가 시작됩니다.
-
실행 폴더.
<runs>/<scene>/폴더를 만들고 내부에ref/photo.jpg,blender/,tools/,layout/,gen/,renders/,work/,final/하위 폴더를 생성합니다.lib.py,arch.py,assets.py,render.py,build_scene.py및 일반 도구(cam.py,vp.py,solve_cam.py,iterate.sh,overlay.py,edges.py,pair.py,crop.py,stats.py,py.sh,fetch_polyhaven.py,fetch_ph_model.py)를harness/에서 복사합니다. -
카메라 계산
tools/vp.py로 수행합니다. 수직 소실점과 주요 정면을 따라 하나의 수평 소실점을 찾습니다. 그런 다음tools/solve_cam.py가 다음을 계산합니다:- 초점 거리(두 방향이 직각을 이루는 경우, 렌즈를 가정하지 마십시오);
- 피치(수직 소실점으로부터);
- 요(정면이 월드 +X 축을 따라가도록 선택).
결과를
layout/camera.json에 씁니다. 그 후 카메라는 전체 실행 동안 고정됩니다. -
앵커 측정
tools/cam.py로 수행합니다:on_z는 수평면에 닿고,on_y는 수직면에 닿으며,project는 픽셀을 제공하고,ray는 뷰 광선을 제공합니다.- 지면선, 정면 평면 및 각 랜드마크의 거리를 측정합니다.
- 리드의 첫 번째 추정치를 규칙집에 시작 값으로 기록합니다.
- 얕은 각도에서는 지면선의 한 픽셀이 수 미터의 깊이 차이를 만들 수 있습니다. 단일 지면 지점보다는 알려진 사물의 높이와 너비(문 2.1m, 눈높이 1.6m, 연석 0.12m)를 우선시합니다.
-
객체 인벤토리. 사진에 보이는 모든 객체를 나열하고 각각을 scripted 또는 mesh(섹션 3)로 표시합니다. 이 목록은 도메인 분할과 에셋 가져오기를 결정합니다.
-
실행을 위한
AGENTS.md작성: 목표, 월드 프레임, 앵커, 도메인 표, 하드 규칙, 루프, 작업 순서, 완료 규칙.
1. 도메인 사용권 (에이전트가 하나의 씬을 공유하는 방법)
씬 분할
- 하나의 도메인 =
build(L, ctx)가 있는 하나의 모듈 + 하나의layout/<domain>.json+ 새로운 모든 것에 대한 하나의 파일 접두사(tools/<domain>_*.py,tex/<domain>_*,gen/<domain>_*). - 객체 수가 아닌 화면 영역과 작업 종류에 따라 분할합니다. 좋은 분할은 각 에이전트가 자르고 단독으로 판단할 수 있는 영역을 제공합니다. 프라이부르크는 조명, 거리, 왼쪽 건물, 주 정면, 소품의 다섯 가지를 사용했습니다.
- 조명은 항상 자체 도메인이며 하늘, 노출, 색상 관리 및 그레이딩을 소유합니다. 다른 에이전트는 자체 재질을 좋게 보이게 하기 위해 노출을 건드리지 않습니다.
- 히어로 요소(눈이 가는 대상)는 자체 도메인을 가집니다.
- 4~6개의 도메인. 더 적으면 에이전트가 파일 내에서 충돌하고, 더 많으면 리드가 검토할 수 없습니다.
계약
build_scene.py는 오케스트레이션만 수행합니다:layout/*.json을L로 병합하고, 카메라를 생성하고, 각 모듈을 고정된 순서로 호출하고, 저장합니다. 지오메트리는 여기에 없습니다.- 모든 에이전트는 모든 레이아웃 키를 읽을 수 있으며, 자체 레이아웃 파일과 모듈에만 쓸 수 있습니다.
- 공유 헬퍼(
lib.py,arch.py,assets.py,cam.py,iterate.sh)는 고정됩니다. 변경된 헬퍼가 필요한 에이전트는 새 이름으로 자체 모듈로 복사합니다.assets.py는 모든 도메인이 동일한 방식으로 메쉬를 피팅할 수 있도록 메쉬 피팅 단계를 보유합니다:import_gltf는 가져오고 XYZ 회전을 설정합니다;world_bounds는 정점에서 경계를 계산합니다;fit은 측정된 높이 또는 너비로 스케일링하고, 요를 조정하고, 가장 낮은 정점을 지지면으로 내립니다.
- 앵커를 측정한 도메인이 그 앵커를 소유합니다. 리드의 앵커는 시작 값입니다. 소유 도메인이 이를 개선하고 결과를 자체 레이아웃 파일에 게시합니다(예:
L['facade']['plane_y']또는L['fountain']['centre']). 다른 모든 도메인은L에서 값을 읽고 자체 코드에 숫자를 복사하지 않으므로, 개선 사항이 다음 빌드 시 모든 도메인에 전달됩니다. - 측정값을 파생된 월드 값 옆에 사진 픽셀 단위로 저장합니다(예:
facade.px옆에facade.sec). 솔버 스크립트(tools/facade_solve.py)는 픽셀을 월드 숫자로 변환하여 레이아웃에 씁니다. 그러면 재측정은 픽셀을 편집하고 솔버를 다시 실행하는 것이지, 좌표를 수동으로 편집하는 것이 아닙니다. - 다른 모듈이 가져오는 이름은 규칙에 "새 함수를 추가하고, 이것들은 절대 변경하지 마십시오"라는 규칙과 함께 나열됩니다. 도메인 간 값은
ctx(예:ctx['track_x'])를 통해 전달되며, 편집을 통해 전달되지 않습니다. build(L, ctx)는 항상 작동해야 합니다. 모든 에이전트가 전체 씬을 다시 빌드하므로 하나의 모듈이 깨지면 모두가 차단됩니다. 위험한 편집을 저장하기 전에 구문을 확인하십시오.
에이전트 실행
- 각 에이전트는 자체
work/<domain>.blend로 빌드합니다. 렌더는work/.gpu_lock(6분 이상 지난 잠금은 오래된 것으로 간주)에 의해 직렬화됩니다.only=를 사용하면 속도를 위해 다른 도메인을 건너뜁니다. 색상을 판단할 때는 이웃이 빛을 반사하기 때문에 전체 씬을 사용하십시오. - 한 번에 최대 2~3개의 에이전트만 렌더링합니다. 여러 Blender 프로세스가 Windows 페이지 파일을 50GB 이상으로 증가시키고 C: 드라이브를 채울 수 있습니다. 에이전트의
work/<domain>.blend가 완료되는 즉시 삭제하십시오. "실행 중인 Blender 없음"이 아닌 특정 프로세스 ID를 기다리십시오. - 웨이브로 실행합니다. 웨이브 1은 지오메트리를 만드는 도메인(예: 지면, 정면, 히어로)이며, 한 번에 최대 3개입니다. 웨이브 2는 조명과 유기적 또는 가구 도메인으로, 지오메트리가 필요하여 조명을 비추고, 그림자를 드리우고, 성장할 수 있습니다. 미완성 지오메트리에서 판단된 조명은 낭비된 작업입니다.
- 웨이브 전에 기기를 깨어 있는 상태로 유지하십시오 (
request_keep_awake). PC가 절전 모드로 전환되면 렌더가 9시간 동안 멈출 수 있습니다. - 라운드. 각 웨이브 또는 라운드 후에 리드는
main을 빌드하고, 렌더를 사진과 육안으로 비교하고, 최악의 차이점을 다음 라운드의 브리프로 작성합니다. 사용자가 보낸 비교 시트에 대한 메모(예: "더 거친 질감" 또는 "조명이 인공적으로 보임")는 자체 라운드가 됩니다. - 각 에이전트는 마지막 세 개의 미리보기 세트를
renders/에 보관하고 자체 접두사의 오래된 것은 삭제합니다. - 에이전트는 유료 크레딧을 사용하지 않습니다. 생성된 에셋이 무엇을 고칠지, 사용할 사진 자르기 영역을 보고합니다. 리드는 이를 비용과 함께 사용자에게 전달합니다.
- 에이전트는 커밋하지 않고, git을 건드리지 않으며, 실행 폴더 밖에 쓰지 않습니다.
에이전트 브리프 (리드가 보내는 내용)
짧게 유지하십시오. 규칙집이 나머지를 전달합니다.
- "먼저
AGENTS.md를 읽으십시오." 그 다음: 도메인, 모듈 및 레이아웃 파일, 픽셀 단위의 사진 영역입니다. - 이미 무엇이 있고 무엇이 잘못되었는지(사진과의 최악의 차이점 세 가지를 말하십시오).
- 인벤토리에서 해당 도메인의 메쉬 목록(이미
gen/에 가져와 있음). - 완료 규칙 및 보고서 형식(아래).
완료 및 통합
- 에이전트는 해당 영역이 960px 자르기에서 사진과 나란히 비교할 때 견딜 수 있거나, 약 12회 반복 후에 중지됩니다.
- 최종 보고서(250단어 미만): 무엇이 변경되었는지, 사진과 여전히 다른 점, 생성된 에셋이 도움이 될 위치, 마지막 렌더의 태그입니다.
- 그런 다음 리드는 모든 모듈에서
work/main.blend를 빌드하고, 전체 프레임을 렌더링하고, 에이전트 보고서를 먼저 읽지 않고 사진과 비교합니다. 보고서는 의도를 설명합니다. 이미지가 증거입니다. 차이점은 다음 라운드의 브리프가 됩니다. - 조명 분위기와 효과는 나중에
main.blend에 비파괴적 오버레이로 적용되어, 룩 변경이 승인된 충실도를 방해하지 않습니다. 트램 실행은main.blend위에blender/mood.py를 사용했습니다. 피슈브루넨은FB_MOOD가 설정되면tools/mood_make.py가 작성한mood/<variant>.json을 레이아웃 위에 딥 머지합니다(예:warm_a,film). 피슈브루넨 형식을 사용하십시오: 무드는 동일한 모듈을 통해 재구축되며 두 번째 씬 파일이 필요하지 않습니다.
2. 충실도 순서와 루프
모든 변경 시 루프
tools/iterate.sh <domain> <n> [width=480] [spp=24] [only=a,b] [x0 y0 x1 y1]
빌드, 렌더링 후 ovl_*(사진 | 렌더 | 50% 블렌드)와 edg_*(픽셀 그리드가 있는 렌더 위에 빨간색 사진 가장자리)를 작성합니다. 사진 픽셀 단위의 상자와 함께 해당 영역만 렌더링하고 crop_*(확대된 사진 자르기 | 렌더 자르기)를 작성합니다. 너비 960에서는 약 25초가 소요됩니다. 이미지를 열고 확인하십시오. 비교 결과를 보지 않고 변경 사항이 개선되었다고 보고하지 마십시오.
다음 순서로 작업하고 건너뛰지 마십시오
각 단계에는 게이트가 있습니다. 이전 게이트가 통과되기 전에 추가된 세부 사항은 낭비입니다. 이전 오류가 수정될 때 이동하기 때문입니다.
| 단계 | 수행할 작업 | 진행 전 게이트 |
|---|---|---|
| 1. 읽기 | 영역의 사진 자르기를 확대합니다. 실제로 무엇이 있는지 기록합니다: 개수, 재질, 무엇이 무엇에 닿는지. | 작성된 목록이 존재합니다. 모든 항목이 인벤토리에 있습니다. |
| 2. 실루엣 | cam.py 측정값에서 덩어리를 배치합니다. | 외곽선이 960 너비에서 edg_*의 빨간색 가장자리 위 몇 픽셀 이내에 있습니다. |
| 3. 비율 | 개구부, 층선, 베이, 반복 횟수. | 창문과 문 가장자리가 사진 가장자리와 일치합니다. 개수가 일치합니다. |
| 4. 색상 | 재질 기본 색상을 사진과 비교하여 측정하고, 전체 씬을 빌드하고, 조명 도메인의 노출은 그대로 둡니다. 재질 버전을 알베도로 비교합니다(섹션 4.2). | tools/stats.py와 도메인 영역 검사가 사진에 가깝고, 50% 블렌드에서 색조 패치가 보이지 않습니다. |
| 5. 소형 부품 | 트림, 고정물, 케이블, 표지판, 홈통, 램프, 거리 잡동사니. 섹션 3의 메쉬. | 해당 영역의 모든 인벤토리 항목이 자르기 영역에 존재합니다. |
| 6. 변형 및 마모 | 베벨, 색상 변형, 창틀 아래 얼룩, 줄무늬, 지면 마모, 유리 잔물결 및 반사. | 자르기 영역이 아래 CG-틸 검사를 통과하고, 텍스처 에너지 검사(섹션 4.3)가 사진에 가깝습니다. |
모든 단계에서 적용되는 규칙:
- 실제 치수(패턴의 경우 밀리미터 단위).
cam.py로 측정하십시오. 추측하지 마십시오. - 어떤 것도 떠 있거나 관통하지 않습니다. 사물은 지면에 서 있거나 벽에 고정됩니다.
- 차이점을 추적할 때는 반복당 하나의 변경만 하여 비교 결과가 변경 사항의 효과를 보여줄 수 있도록 합니다.
CG-틸 검사 (모든 렌더 후: "이것이 CG임을 알려주는 것은 무엇인가?")
| 틸 | 일반적인 수정 |
|---|---|
| 완벽하게 날카로운 모서리 | 베벨 또는 모따기, 건축 부품에 2~10mm |
| 평평한 단색 표면 | 측정된 색상 변형, 얼룩, 줄무늬, 실제 스케일의 텍스처 |
| 눈에 띄는 반복 | 인스턴스별 톤, 회전, 마모 변형 |
| 접촉 그림자 없음 | 객체가 지면에 닿는지 확인합니다. 조명과 노이즈 제거를 확인합니다. |
| 뒤나 반사가 없는 유리 | 내부 평면 또는 틴트, 실제 반사, 약간의 잔물결 |
| 잘못된 텍스처 스케일 | 사진에서 패턴을 밀리미터 단위로 다시 측정 |
| 프리미티브 모양의 객체 | 실제 메쉬로 교체(섹션 3) |
| 너무 깨끗한 지면 | 마모, 습기 찬 패치, 낙엽, 조인트 |
사용자가 충실도를 승인한 후
그런 다음에만 다음을 순서대로 수행합니다:
- 리얼리즘 패스: 베벨, 유리 및 지면 마모. 트램 실행은 하나의 모듈(
weather모듈)로 수행했습니다. 피슈브루넨은 각 도메인 내에서 수행했습니다. 둘 다 작동하지만, 하나의 도메인이 각 표면을 소유해야 합니다. - 렌더 품질: 2160px 슈퍼샘플 및 정확한 노이즈 제거.
- 센서 마감 (섹션 4.1).
- 다른 각도에서의 증명 뷰 (추가 카메라를 렌더링하는
proof.py). - 조명 분위기.
- 필름 (섹션 5).
각 체크포인트에서 사진 대 렌더 시트를 보내고 사용자를 기다리십시오.
3. 메쉬: 복잡한 객체에는 프리미티브 사용 금지
규칙: 복잡한 객체는 단순한 기본 지오메트리로 절대 만들지 마십시오. 대신 기존 실제 메쉬를 사용하십시오.
해당 사항
- 스크립트된 지오메트리는 허용됨 건축 및 인프라: 벽, 슬래브, 지붕, 창문 및 문 프레임, 코니스 및 프로파일 트림, 연석, 포장, 난간, 기둥, 전선, 평평한 표지판.
- 실제 메쉬가 필요함 유기적이거나 물체와 같은 모든 것: 나무, 관목, 화분에 심은 식물, 사람, 차량, 자전거, 의자, 테이블, 벤치, 화분, 파라솔, 성형된 몸체가 있는 램프, 조각 장식, 조각상, 주름이 있는 직물.
- 테스트: 사람이 당신의 빌드를 "막대기 위의 구", "네 개의 다리가 있는 상자" 또는 "원기둥"으로 설명한다면, 그것은 프리미티브 대체품이며 사용자에게 보내는 렌더에서 자리 표시자로도 허용되지 않습니다.
소싱 사다리 (맞는 첫 번째에서 중지)
-
자체 메쉬 라이브러리. 이전 프로젝트에서 생성했거나 다운로드한 모든 소품 메쉬의 인덱스(카테고리, 크기, 삼각형 수, 경로, 라이선스)를 유지하고 먼저 검색하십시오. 재사용이 구매보다 낫습니다.
-
Poly Haven CC0, 무료:
tools/fetch_ph_model.py <id>(glTF 2k를gen/ph/<id>/로),tools/fetch_polyhaven.py <id>로 텍스처 및 스카이. 에이전트당 약 150MB 미만으로 다운로드를 유지하십시오. -
생성된 메쉬 (유료, 리드를 통해서만, 사용자가 비용을 확인한 후): 부드럽거나 유기적인 소품 및 장식용으로 Meshy, 하드 서피스 히어로용으로 Tripo H3.1 상세. 세 단계로 메쉬를 준비하고 피팅합니다:
- 자르기 정리. 사진에서 객체를 자릅니다(
gen/meshy_refs/<name>_crop.jpg). 저렴한 이미지 편집 패스를 한 번 실행하여 가려진 물체를 제거하고, 잘린 부분을 마무리하고, 평범한 배경을 제공하여<name>_clean.png로 저장합니다. 그런 다음에야 이미지-투-3D를 호출합니다. 분수 실행에서 이 방법으로 네 개의 조각상과 캐노피를 첫 번째 시도에 사용할 수 있었습니다. - 한 번 디시메이트, 오프라인에서,
gen/<domain>_meshes.blend로 가져온 모든 메쉬를 저장합니다. 메쉬당 약 5000~10000개의 삼각형으로 디시메이트합니다. 실시간이 아닙니다. 형태가 중요한 경우에만 보존하십시오. - 씬에 피팅:
assets.fit()을 호출하고, 스케일링할 측정 기준(높이 또는 너비)을 제공합니다. 측정값은cam.py또는gen/meshy_refs/<name>_cm.md에서 가져옵니다. 후자는 정리된 자르기 옆에 저장되며, 물리적 객체가 알려진 치수(예: 벤치 너비 1.8m)를 포함하는 경우 또는 에이전트가 사진에서 추정한 경우(의자 높이 0.9m)입니다. 오프라인 디시메이트는 메쉬를 반환하는 데 걸리는 시간을 단축하고, 다른 메쉬를 가져오기 위해 3D 에이전트를 차단하지 않습니다.
- 자르기 정리. 사진에서 객체를 자릅니다(
-
스크립트된 대체품 (절대 최후의 수단, 사용자에게 공개): 프리미티브는 절대 안 됩니다. 부드러운 유기적 형태를 단계별로 구성하는 스크립트입니다(예:
arch.tree_stub(tree_sphere, trunk_cyl)). 모양이 정확하지 않으며 모든 뷰에서 프리미티브로 판독됩니다. 허용되지만 충실도 점수를 낮춥니다.
생성된 메쉬 사용 규칙
- 생성된 메쉬가 씬에 들어가기 전에 리드가 승인해야 합니다.
- 각
image-to-3d요청에는 크기가 포함되어야 합니다(예: "분수 트림 위의 잎 장식, 지름 약 30cm"). - 메쉬를 씬에 배치하기 전에 접촉 섀도우를 확인하십시오. 보이지 않으면 바닥이 너무 낮거나 메쉬가 너무 높습니다.
- 생성된 메쉬를 더 이상 수정하지 마십시오. 형태가 정확하지 않은 경우 다시 생성하거나(다른 참조 이미지 사용) 다른 소싱 사다리 옵션을 선택하십시오. 디시메이트와 피팅 외에는 변경하지 마십시오.
4. 측정 및 재질
4.1 센서 마감 (렌즈와 센서가 사진처럼 보이게 함)
사용자가 충실도를 승인한 후에만 적용하십시오. 항상 마지막에 수행하십시오.
사진과 일치하도록 다음을 조정합니다:
- 피사계 심도: 조리개 값을 설정합니다(예: f/8). Blender의 카메라 DOF를 일치시키려면
tools/dof_match.py를 사용합니다. 초점을 사진의 초점 거리와 일치하는 거리로 설정합니다. - 렌즈 왜곡:
tools/lens_distort.py사용. 카메라 솔버는 이상적인 핀홀 카메라를 가정합니다. 사진의 배럴 또는 핀쿠션 왜곡을 일치시키려면 변환을 적용합니다. - 색수차:
tools/aberration.py사용. 렌즈 유형과 조리개 설정을 기반으로 추정합니다. - 비네팅:
tools/vignette.py사용. 모서리와 중앙의 픽셀 값을 비교하여 측정합니다. - 센서 노이즈 및 그레인:
tools/sensor_noise.py사용. ISO 및 화이트 밸런스 설정을 추정합니다. - 블룸 및 글레어:
tools/bloom.py사용. 밝은 영역과 렌즈 플레어를 일치시킵니다.
4.2 알베도 확인
재질 색상은 사진에서 직접 측정하고 알베도 값으로 확인해야 합니다. 절차:
- 사진에서 관심 영역을 자릅니다.
- 주변 조명의 색온도를 추정합니다(회색 세계 가정 또는 알려진 중립 물체 사용).
- 자르기 영역의 평균 색상을 구합니다.
- 이 값을 Blender 재질의 기본 색상(Base Color)으로 설정합니다.
- 조명 조건에서 렌더링합니다. 렌더링된 색상이 사진의 자르기 영역과 일치하면 알베도가 정확한 것입니다.
tools/albedo_check.py를 사용하여 이 과정을 자동화합니다.
4.3 텍스처 에너지 검사
사진과 비교하여 렌더링된 텍스처의 주파수 내용을 확인합니다. 텍스처가 너무 평평하거나(저주파) 너무 바쁜(고주파) 경우 올바른 스케일 또는 변형이 아닐 수 있습니다.
tools/fft_stats.py를 사용하여 사진과 렌더 자르기 영역의 전력 스펙트럼을 비교합니다.- 스펙트럼이 일치하지 않으면 텍스처 스케일 또는 노이즈 패턴을 조정합니다.
5. 필름 (선택 사항: 영화 같은 룩을 위한 최종 패스)
사용자가 충실도를 승인하고 센서 마감이 적용된 후, 필름 룩 패스를 원하는 경우:
blender/film_look.py는 LUT를 적용하고, 그레인을 추가하고, 색보정을 조정합니다.- 피슈브루넨 프로젝트의
mood메커니즘을 사용합니다:mood/<variant>.json파일을 생성하고FB_MOOD환경 변수로 활성화합니다. - 일반적인 변형:
warm_a(따뜻한 분위기),cold_b(차가운 분위기),film(영화 같은 그레인 및 색조),vintage(빈티지)
6. 일반적인 문제 해결
| 문제 | 원인 | 해결책 |
|---|---|---|
| 렌더가 사진과 일치하지 않음 | 카메라 솔루션이 잘못됨 | vp.py와 solve_cam.py를 다시 실행하고 소실점을 확인합니다. |
| 재질이 너무 밝거나 어두움 | 노출 또는 알베도가 잘못됨 | 조명 도메인에서 노출을 확인하고, 알베도 확인을 실행합니다. |
| 메쉬가 지면과 접촉하지 않음 | fit()의 지지면이 잘못됨 | fit() 호출에서 지지면을 확인합니다. |
| 생성된 메쉬의 형태가 좋지 않음 | 참조 이미지가 좋지 않음 | 더 나은 참조 이미지로 다시 생성하거나 다른 소싱 옵션을 선택합니다. |
| 에이전트가 충돌함 | 두 에이전트가 동일한 파일에 씀 | 도메인 할당을 확인하고 각 도메인이 자체 파일만 쓰는지 확인합니다. |
| 반복 실행이 느림 | 전체 씬이 매번 렌더링됨 | only=를 사용하여 변경된 도메인만 렌더링합니다. |
7. 코드 생성 기술 (유기적 건물)
이 섹션은 건물, 특히 유기적이거나 상세한 건축물(예: 고딕 양식의 분수, 장식이 있는 정면, 지붕 라인)을 코드로 생성할 때 사용할 기술의 순위 목록입니다. 각 기술은 충실도, 제어 용이성 및 성능에 따라 순위가 매겨집니다.
| 순위 | 기술 | 설명 | 최적 사용 사례 |
|---|---|---|---|
| 1 | arch.py 파라메트릭 함수 | arch.build_facade(width, height, floors, windows_per_floor, style)와 같은 사전 구축된 함수. 공통 패턴을 캡슐화하고 완전한 제어를 제공합니다. | 반복적인 건축 요소(창문, 문, 처마) |
| 2 | 수학적 표면 (절차적) | numpy와 Blender의 수학적 표면을 사용하여 유기적 형태를 생성합니다. 예: sin/cos 기반 지붕 곡선, 장식용 나선. | 부드럽고 수학적으로 정의 가능한 형태 |
| 3 | L-시스템 (식물, 장식) | 재귀적 규칙 기반 생성을 위한 L-시스템. arch.lsystem 구현. | 나무, 덩굴, 반복되는 장식 패턴 |
| 4 | 노이즈 기반 변형 | bpy에서 노이즈 텍스처(Perlin, Voronoi)를 사용한 변위 또는 컬러 변형. | 표면 디테일, 노화, 불규칙성 |
| 5 | B-스플라인/베지어 | Blender의 베지어 곡선 및 B-스플라인을 사용하여 복잡한 프로파일을 정의합니다. | 트림, 난간, 몰딩 |
| 6 | 블렌더 모디파이어 체인 | bpy에서 노드 기반(Geometry Nodes)을 포함한 모디파이어 체인입니다. | 복잡한 지오메트리 변환(배열, 미러, 서브디비전) |
| 7 | 머신 러닝 보조 (실험적) | 텍스처 합성 또는 지오메트리 완성을 위한 사전 훈련된 ML 모델입니다. tools/ml_assist.py 제공. | 채워야 할 간격이 있는 불완전한 참조 |
| 8 | 유전 알고리즘 (실험적) | 사진과의 일치를 최적화하기 위한 진화적 접근 방식. tools/genetic_facade.py. | 국소 최적화, 단순한 형태 |
"건물을 코드로 생성"하려면 항상 이 순위 목록을 사용하십시오. 모든 도메인에 대해 충실도와 성능 사이의 균형을 목표로 가장 높은 순위의 기술부터 시작하십시오.
8. 속도 최적화
- 점진적 렌더링:
iterate.sh는width=480및spp=24로 시작합니다. 최종 렌더에만 높은 설정을 사용하십시오. - GPU 메모리: 한 번에 너무 많은 텍스처를 로드하지 마십시오. 큰 메쉬는 가져올 때 디시메이트하십시오.
- 렌더 영역: 전체 프레임이 필요하지 않은 경우
x0 y0 x1 y1상자를 사용하여 관심 영역만 렌더링하십시오. - 에셋 캐싱: 한 번 가져온 메쉬와 텍스처는 재사용할 수 있도록
gen/에 캐시하십시오. - 멀티프로세싱: Blender는 하나의 GPU 세션으로 제한됩니다. 여러 렌더링 인스턴스를 병렬로 실행하지 마십시오.
work/.gpu_lock메커니즘을 사용하십시오.
9. 일반적인 함정
- 과도한 엔지니어링: 12회 이상의 반복은 수익이 감소합니다. 사용자에게 보내기 전에 중지 규칙을 적용하십시오.
- 잘못된 앵커: 부정확한 앵커는 씬 전체에 오류를 전파합니다. 측정을 주의 깊게 다시 확인하십시오.
- 에이전트 통신 부족: 도메인은 공유
L컨텍스트를 통해 통신합니다. 값을 전달하는 것을 잊지 마십시오. - CG틸 무시: 특히 초기 단계에서 CG틸 검사를 건너뛰지 마십시오. 프리미티브 대체품은 충실도를 심각하게 떨어뜨립니다.
- 스크립트보다 수동 편집 선호: 모든 지오메트리 및 재질 변경은 스크립트를 통해 이루어져야 합니다. 수동 편집은 재현 불가능하고 비교를 깨뜨립니다.
부록: 예시 실행 (프라이부르크 트램)
도메인 할당
- 조명: sky, exposure, color management
- 거리: roadway, pavement, tram tracks, kerb
- 왼쪽 건물: building mass, windows, doors
- 주 정면 (히어로): detailed facade with ornaments, tram stop shelter
- 소품: signage, street lamps, bicycles, people(placeholder)
주요 측정값
- 지면 높이(카메라로부터): 1.7m
- 주요 정면 거리: 12m
- 창문 높이: 1.5m, 너비: 1.0m
- 문 높이: 2.1m
- 기둥 간격: 3.0m
사용된 기술
arch.py의build_window,build_door로 반복 요소 생성- L-시스템으로 트램 선로 위의 장식 구조물 생성
- 노이즈 기반 변위로 벽면 마감 처리
- Meshy로 생성된 벤치 및 램프 소품