Community이미지github.com

포토 씬 재구성 (Photo Scene Reconstruction)

사진을 동일한 카메라 설정의 Blender 씬으로 재구성합니다. 다중 에이전트 시스템과 렌더-비교 루프를 사용하여 조명과 재질을 사진에서 직접 측정하고, 복잡한 객체는 실제 메쉬를 사용하며, 세밀한 건축물 생성을 위한 코드 생성 기술 순위를 제공합니다.

포토 씬 재구성 (Photo Scene Reconstruction)란 무엇인가요?

이 스킬은 참조 사진을 동일한 카메라 시점의 사실적인 Blender 3D 씬으로 재구성하는 포괄적인 방법론입니다. 사용자는 다중 에이전트 시스템(하네스)을 활용하여 씬을 여러 도메인(조명, 거리, 건물, 소품 등)으로 분할하고, 각 에이전트가 독립적으로 작업한 후 통합합니다. 핵심 기능은 렌더-비교 루프(iterate.sh)를 통한 빠른 피드백, 사진에서 직접 측정한 조명(그림자를 통한 태양 방향)과 재질(알베도 검사), 그리고 복잡한 객체에 대한 '프리미티브 금지' 규칙(실제 메쉬 소싱)을 포함합니다. 주요 플랫폼은 Blender(Cycles 엔진)이며, Python과 에이전트 런타임이 필요합니다. 이 스킬은 사용자가 '사진을 3D로 재구성', '참조 이미지와 일치', '장면 사실감 향상' 또는 '병렬 장면 구축'을 요청할 때 특히 유용합니다. 7단계의 고정된 충실도 순서(실루엣 → 비율 → 색상 → 소형 부품 → 변형 및 마모)를 따르며, 각 단계마다 게이트 조건(CG-틸 검사)을 통과해야 다음으로 넘어갑니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/liangjunglj-cpu/ginkgo-skills/tree/main/skills/photo-scene-reconstruction

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

포토 씬 재구성

이 방법은 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. 리드가 에이전트 시작 전에 설정

리드(메인 세션)는 다음 작업을 단독으로 수행합니다. 모든 작업이 완료된 후에만 에이전트가 시작됩니다.

  1. 실행 폴더. <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/에서 복사합니다.

  2. 카메라 계산 tools/vp.py로 수행합니다. 수직 소실점과 주요 정면을 따라 하나의 수평 소실점을 찾습니다. 그런 다음 tools/solve_cam.py가 다음을 계산합니다:

    • 초점 거리(두 방향이 직각을 이루는 경우, 렌즈를 가정하지 마십시오);
    • 피치(수직 소실점으로부터);
    • 요(정면이 월드 +X 축을 따라가도록 선택).

    결과를 layout/camera.json에 씁니다. 그 후 카메라는 전체 실행 동안 고정됩니다.

  3. 앵커 측정 tools/cam.py로 수행합니다:

    • on_z는 수평면에 닿고, on_y는 수직면에 닿으며, project는 픽셀을 제공하고, ray는 뷰 광선을 제공합니다.
    • 지면선, 정면 평면 및 각 랜드마크의 거리를 측정합니다.
    • 리드의 첫 번째 추정치를 규칙집에 시작 값으로 기록합니다.
    • 얕은 각도에서는 지면선의 한 픽셀이 수 미터의 깊이 차이를 만들 수 있습니다. 단일 지면 지점보다는 알려진 사물의 높이와 너비(문 2.1m, 눈높이 1.6m, 연석 0.12m)를 우선시합니다.
  4. 객체 인벤토리. 사진에 보이는 모든 객체를 나열하고 각각을 scripted 또는 mesh(섹션 3)로 표시합니다. 이 목록은 도메인 분할과 에셋 가져오기를 결정합니다.

  5. 실행을 위한 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)
너무 깨끗한 지면마모, 습기 찬 패치, 낙엽, 조인트

사용자가 충실도를 승인한 후

그런 다음에만 다음을 순서대로 수행합니다:

  1. 리얼리즘 패스: 베벨, 유리 및 지면 마모. 트램 실행은 하나의 모듈(weather 모듈)로 수행했습니다. 피슈브루넨은 각 도메인 내에서 수행했습니다. 둘 다 작동하지만, 하나의 도메인이 각 표면을 소유해야 합니다.
  2. 렌더 품질: 2160px 슈퍼샘플 및 정확한 노이즈 제거.
  3. 센서 마감 (섹션 4.1).
  4. 다른 각도에서의 증명 뷰 (추가 카메라를 렌더링하는 proof.py).
  5. 조명 분위기.
  6. 필름 (섹션 5).

각 체크포인트에서 사진 대 렌더 시트를 보내고 사용자를 기다리십시오.

3. 메쉬: 복잡한 객체에는 프리미티브 사용 금지

규칙: 복잡한 객체는 단순한 기본 지오메트리로 절대 만들지 마십시오. 대신 기존 실제 메쉬를 사용하십시오.

해당 사항

  • 스크립트된 지오메트리는 허용됨 건축 및 인프라: 벽, 슬래브, 지붕, 창문 및 문 프레임, 코니스 및 프로파일 트림, 연석, 포장, 난간, 기둥, 전선, 평평한 표지판.
  • 실제 메쉬가 필요함 유기적이거나 물체와 같은 모든 것: 나무, 관목, 화분에 심은 식물, 사람, 차량, 자전거, 의자, 테이블, 벤치, 화분, 파라솔, 성형된 몸체가 있는 램프, 조각 장식, 조각상, 주름이 있는 직물.
  • 테스트: 사람이 당신의 빌드를 "막대기 위의 구", "네 개의 다리가 있는 상자" 또는 "원기둥"으로 설명한다면, 그것은 프리미티브 대체품이며 사용자에게 보내는 렌더에서 자리 표시자로도 허용되지 않습니다.

소싱 사다리 (맞는 첫 번째에서 중지)

  1. 자체 메쉬 라이브러리. 이전 프로젝트에서 생성했거나 다운로드한 모든 소품 메쉬의 인덱스(카테고리, 크기, 삼각형 수, 경로, 라이선스)를 유지하고 먼저 검색하십시오. 재사용이 구매보다 낫습니다.

  2. Poly Haven CC0, 무료: tools/fetch_ph_model.py <id>(glTF 2k를 gen/ph/<id>/로), tools/fetch_polyhaven.py <id>로 텍스처 및 스카이. 에이전트당 약 150MB 미만으로 다운로드를 유지하십시오.

  3. 생성된 메쉬 (유료, 리드를 통해서만, 사용자가 비용을 확인한 후): 부드럽거나 유기적인 소품 및 장식용으로 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 에이전트를 차단하지 않습니다.
  4. 스크립트된 대체품 (절대 최후의 수단, 사용자에게 공개): 프리미티브는 절대 안 됩니다. 부드러운 유기적 형태를 단계별로 구성하는 스크립트입니다(예: 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 알베도 확인

재질 색상은 사진에서 직접 측정하고 알베도 값으로 확인해야 합니다. 절차:

  1. 사진에서 관심 영역을 자릅니다.
  2. 주변 조명의 색온도를 추정합니다(회색 세계 가정 또는 알려진 중립 물체 사용).
  3. 자르기 영역의 평균 색상을 구합니다.
  4. 이 값을 Blender 재질의 기본 색상(Base Color)으로 설정합니다.
  5. 조명 조건에서 렌더링합니다. 렌더링된 색상이 사진의 자르기 영역과 일치하면 알베도가 정확한 것입니다.

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. 코드 생성 기술 (유기적 건물)

이 섹션은 건물, 특히 유기적이거나 상세한 건축물(예: 고딕 양식의 분수, 장식이 있는 정면, 지붕 라인)을 코드로 생성할 때 사용할 기술의 순위 목록입니다. 각 기술은 충실도, 제어 용이성 및 성능에 따라 순위가 매겨집니다.

순위기술설명최적 사용 사례
1arch.py 파라메트릭 함수arch.build_facade(width, height, floors, windows_per_floor, style)와 같은 사전 구축된 함수. 공통 패턴을 캡슐화하고 완전한 제어를 제공합니다.반복적인 건축 요소(창문, 문, 처마)
2수학적 표면 (절차적)numpy와 Blender의 수학적 표면을 사용하여 유기적 형태를 생성합니다. 예: sin/cos 기반 지붕 곡선, 장식용 나선.부드럽고 수학적으로 정의 가능한 형태
3L-시스템 (식물, 장식)재귀적 규칙 기반 생성을 위한 L-시스템. arch.lsystem 구현.나무, 덩굴, 반복되는 장식 패턴
4노이즈 기반 변형bpy에서 노이즈 텍스처(Perlin, Voronoi)를 사용한 변위 또는 컬러 변형.표면 디테일, 노화, 불규칙성
5B-스플라인/베지어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로 생성된 벤치 및 램프 소품

관련 스킬