고급 · Package v2
낮과 밤이 바뀌는 View 만들기.
태양이 없는 360° 파노라마를 온전한 24시간 Place로 만들어 보세요. 움직이는 햇빛과 하늘 대기, 밤의 별과 달, 시간에 따라 보정되는 지형, 일몰 후 자연스럽게 전환되는 전체 프레임 야간 파노라마를 지원합니다.
Locus 1.4.9 – 1.4.11 이상 필요 · 완전한 Package v2방식 선택
낮/밤 View는 environment.sunPath 의 완전한 Package v2 아카이브에서 구성됩니다(기존 단순 호환 view.json ZIP에서는 이 필드들을 지원하지 않습니다). 아래 매니페스트는 하얀 사구의 새벽(Chalk Dune Dawn) (destination.chalk-dune-dawn 1.4.0) 구성을 따릅니다. 12K 석고 사구 View로, 풀프레임 낮·밤 파노라마, 절차적 맑은 하늘·별/은하수, 햇빛을 받는 3D 중경 사구를 함께 사용합니다.
destination.chalk-dune-dawn-1.4.0.locusplace (123.9 MB ZIP, Locus 예제 라이선스적용; 또한 place-examples.json에도 등록). Locus 1.4.10 / 1.5.0 이상이 필요하며, Locus 1.5.0이 App Store에 출시되면 Gallery에도 공개됩니다.| 방식 | 최소 App 버전 | 제작할 항목 |
|---|---|---|
대기 + 지형 보정 (daySky, panoramaGrade, light) | 1.4.9 | 태양이 없는 주간 파노라마 1장, sky.mask 로 하늘과 전경을 분리하고, 고도 정지점으로 그려진 지형 색조와 룸 태양광을 제어합니다. |
전체 프레임 낮/밤 파노라마 쌍 (+ panoramaBlend) | 1.4.10 | 정렬된 전체 프레임 야간 파노라마와 astc-6x6-srgb KTX1 gpuTextures v2 사이드카를 추가하여 산, 눈, 먼 해안선까지 실제 야간 조명으로 전환합니다. |
실시간 계산 shore 또는 media.dayNight | 1.4.11 | 실시간 계산 해변 파도나 비디오 영역 맵이 동일한 낮/밤 블렌드를 따르게 합니다. |
sky 및 daySky 가 계약에 포함되는 이유. 현재 Package v2 사양에서는 panoramaBlend 에는 다음 두 가지가 모두 필요합니다: environment.sunPath.daySky 및 루트 sky ( sky.mask 및 stars 또는 moon). sky.mask 의 흰색 픽셀은 렌더링된 낮 대기와 밤의 별·은하수를 표시하고, 검은색 픽셀은 낮과 밤 파노라마가 혼합된 이미지를 표시합니다.1 · 준비
이미지 및 마스크 준비
- 주간 파노라마(
panorama.path): 2:1 등장방형 JPEG 또는 PNG(예:8192×4096또는12288×6144), 맑은 낮 조명으로 제작하고 그려진 태양이나 태양 눈부심이 전혀 없어야 함. - 태양이 없는 룸 조명 이미지(
environment.imageBasedLight): 별도의 2:1 JPEG 또는 PNG(1024×512권장), 마찬가지로 그려진 태양이 없어야 합니다. - 하늘 마스크(
sky.mask): 파노라마와 정렬된 2:1 8비트 그레이스케일 PNG(PNG 컬러 타입 0). 열린 하늘은 흰색(255), 지형, 나무, 건물은 검은색(0)으로 칠하고 지평선과 나뭇가지 경계를 깔끔하게 안티앨리어싱하세요. - 선택적 태양 원반 마스크(
environment.sunPath.disc.skyMask): 2:1 8비트 그레이스케일 PNG(최대 너비4096), 흰색 영역이 전경 가장자리 뒤로 이동하는 태양 원반을 표시합니다. - 정렬된 야간 파노라마(
panoramaBlend.path, 1.4.10 이상용): 별도의 2:1 JPEG 또는 PNG이며, 정확히 동일한 픽셀 너비와 높이 를panorama.path. 동일한 지평선, 산맥, 구조물을 유지한 채 야간 조명으로만 재조명해야 합니다. - ASTC GPU 사이드카(
gpuTexturesv2(다음 항목 사용 시 필수:panoramaBlend): 두 이미지를 모두panorama.path및panoramaBlend.path에astc-6x6-srgbKTX1 파일(.ktx)로 변환하고 전체 밉맵과 수평 반복 래핑을 설정합니다. 각 파일의sourceSHA256, 크기 및mipmapLevels. 기존의 단수형gpuTexture는 다음이 존재할 때 거부됩니다:panoramaBlend가 있는 경우 거부됩니다.
sky.mask 전체 영역을 검은색(0)으로 칠하고, 루트의 sky 및 daySky 선언은 규칙대로 유지합니다. 검은색은 sky.mask 에서 파노라마를 완전히 불투명하게 유지하므로 Locus는 절차적 푸른 하늘·별·달을 숨기면서도 24시간 시계, Edit View 태양 위치 스크러빙, panoramaBlend 전환, panoramaGrade및 Room/중경의 동적 조명 변화를 그대로 유지합니다. 다음을 생략하거나 environment.sunPath.disc (또는 전체 검은색 마스크를 disc.skyMask에 전달)하면 태양 원반과 눈부심도 숨겨지며, 움직이는 태양 원반을 유지하려면 하늘을 흰색으로 칠한 별도의 disc.skyMask 마스크를 따로 지정하세요.2 · 매니페스트
작성: destination.json 및 출처 정보
설정: minimumAppVersion 안에 locusplace.json 에 "1.4.9" ( panoramaBlend), "1.4.10" ( panoramaBlend), 또는 "1.4.11" ( panoramaBlend 및 shore 또는 media.dayNight).
안에 destination.json, 모든 sunPath View는 반드시 "sunFreeSky": true 를 설정하고 "sun-free-sky" 컴포넌트를 provenanceDetail:
{
"formatVersion": 2,
"id": "destination.chalk-dune-dawn",
"title": "Chalk Dune Dawn",
"panorama": {
"path": "panorama.jpg",
"projection": "equirectangular",
"width": 12288,
"height": 6144,
"initialYawDegrees": -50
},
"thumbnail": "thumbnail.jpg",
"provenance": "provenance.json",
"provenanceDetail": {
"formatVersion": 1,
"components": [
{
"component": "picture",
"aiGenerated": true,
"providers": ["Google Gemini", "OpenAI"],
"credit": "Locus",
"notes": "Procedural terrain with silhouette-locked horizon detail and night relighting."
},
{
"component": "sun-free-sky",
"aiGenerated": false,
"notes": "Azimuth-symmetric clear sky and IBL with no painted sun disc or glare."
}
]
},
"sky": {
"mask": "sky-mask.png",
"stars": {
"twilight": {"strength": 0},
"milkyWay": {"style": "realistic"}
}
},
"midground": {
"path": "midground.usdz",
"terrainEntities": ["Terrain_Dunes", "Terrain_Pan"]
},
"gpuTextures": [
{
"source": "panorama.jpg",
"path": "panorama.ktx",
"format": "astc-6x6-srgb",
"width": 12288,
"height": 6144,
"mipmapLevels": 14,
"sourceSHA256": "e938e8f8c88f868ed39ec39a3c67c60da2e11281b09f59d79a0953cf8e91154d"
},
{
"source": "panorama-night.jpg",
"path": "panorama-night.ktx",
"format": "astc-6x6-srgb",
"width": 12288,
"height": 6144,
"mipmapLevels": 14,
"sourceSHA256": "efc8fda539be7d867b2181cb8a891f61316ba84d9120d31c62bbad5f96a95e57"
}
],
"environment": {
"imageBasedLight": "lighting-ibl.jpg",
"sunPath": {
"sunFreeSky": true,
"startHour": 6.35,
"dayDurationSeconds": 7200,
"maxElevationDegrees": 55,
"peakIlluminanceLux": 2900,
"nightIlluminanceLux": 0,
"disc": {
"skyMask": "sun-sky-mask.png",
"angularSizeDegrees": 0.53,
"intensity": 1
},
"daySky": {"haze": 0.3, "exposure": 1},
"panoramaGrade": {
"stops": [
{"elevationDegrees": -18, "color": [0.015, 0.014, 0.011]},
{"elevationDegrees": 0, "color": [0.245, 0.198, 0.145]},
{"elevationDegrees": 14, "color": [0.785, 0.588, 0.36]},
{"elevationDegrees": 55, "color": [1.225, 1.108, 0.932]}
]
},
"light": {
"stops": [
{"elevationDegrees": -18, "color": [0, 0, 0], "ambientEV": -2.75},
{"elevationDegrees": 0, "color": [1.25, 0.6, 0.18], "ambientEV": 0.2},
{"elevationDegrees": 14, "color": [1.38, 0.97, 0.56], "ambientEV": 0.16},
{"elevationDegrees": 55, "color": [0.96, 0.92, 0.85], "ambientEV": -0.35}
],
"midground": true
},
"panoramaBlend": {
"path": "panorama-night.jpg",
"dayElevationDegrees": -1,
"nightElevationDegrees": -12,
"nightGrade": [1, 1, 1]
}
}
}
}3 · 보정
고도 정지점 및 블렌드 임계값 조정
daySky:haze(0...1, 기본값0.3)는 지평선과 태양 주변의 에어로졸 빛을 높이고,exposure(0.25...4, 기본값1)는 낮 하늘 순응 곡선의 배율을 조정합니다.panoramaGrade.stops: 엄격히 증가하는elevationDegrees(-90...90) 및 선형 RGBcolor배수(0...4). 밤 파노라마로 전환되기 전 일출·일몰 시 그려진 지형을 어둡고 따뜻하게 보정하는 데 사용합니다.light.stops: 룸의 방향성 태양광(color0...16에 곱해지는peakIlluminanceLux) 및 룸/유리 IBL 노출(ambientEV-6...6, 기본값0). 그런 다음"midground": trueView가 동일한 방향성 태양광을 받을 3Dmidground.path모델에도 동일한 방향성 태양광을 적용할 수 있습니다.panoramaBlend: 태양 고도panorama.path이상에서dayElevationDegrees(기본값-1)에서panoramaBlend.path이하의nightElevationDegrees(기본값-12; 둘 다-18...10및night < day), 선형 RGBnightGrade(0...4).
4 · 검증
패키징, 검증 및 시간대별 확인
python3 tools/pack_locusplace.py --current-app-version 1.4.11 \
/absolute/path/to/MyDayNightView /absolute/path/to/MyDayNightView.locusplace
python3 tools/validate_locusplace.py --current-app-version 1.4.11 \
/absolute/path/to/MyDayNightView.locusplace검증기는 모든 매니페스트 제약을 확인하고 두 gpuTextures v2 KTX1 헤더와 SHA-256 다이제스트를 검증하며, sun_free_sky_check 를 실행해 주간 파노라마나 IBL에 밝은 태양 원반이 남아 있지 않은지 검사합니다.
- Apple Vision Pro에서 가져오기 경로: Places → Import → Import a View → Files 한 다음 Room과 연결하세요.
- Edit View에서 Sun Position 스크럽하기 아침, 정오, 골든 아워, 황혼, 자정까지 확인하며 지평선 실루엣, 룸 유리 반사, 전경-하늘 경계 마스크를 점검하세요.
- 모션 끄기 / 동작 줄이기 확인: View가 다음 시각에서 깔끔하게 정지하는지 확인하세요:
startHour.
공존 규칙 및 제한
- 제외되는 효과:
daySky,panoramaGrade,light및panoramaBlend는 다음과 함께 사용할 수 없습니다:clouds,sky.aurora, 루트water,midground.water,midground.flowingWater또는 기존 비디오media. - 1.4.11+에서 허용되는 조합: 실시간 계산
shore해변 파도(locus.view.water.surf.panorama-blend.v1) 및media.dayNight비디오 맵(locus.view.media.day-night.v1, 각 비디오마다 8비트 RGBlighting및emissionPNG)을 다음과 함께 사용할 수 있습니다:panoramaBlend. - 두 파노라마의 해상도는 정확히 일치해야 합니다. 단 1픽셀만 달라도(
panorama.path및panoramaBlend.path는 거부됩니다.