사례 연구 · 2026년 11월 16일
열대의 얕은 만: 라군 View를 낮과 밤 버전으로 바꾸기.
태양 없는 12K 실시간 얕은 바다 파노라마에서 출발해, 유료 이미지 API 호출 없이 24시간 태양 경로, 별, 따뜻한 골든아워, 보존된 적운, 먼 섬 뒤의 선명한 일몰 가림까지 더해 봅니다.
실시간 물 + 낮/밤 조합에는 Locus 1.5.1 이상 필요 · 이중 마스크 구름 보존 기법은 Locus 1.4.9+에서 동작
1 · 기준선
태양 없는 실시간 라군 수면에서 출발하기
열대의 얕은 만 에는 이미 12288×6144 파노라마, ASTC GPU 사이드카, 해저 수심 데이터, 접촉 보정 해안 프록시 지오메트리, 파도 오디오가 들어 있으며 원래 낮 하늘에는 그려진 태양이 전혀 없습니다.
새 파노라마 유료 생성 없이 Tropical Shallow Bay를 24시간 낮과 밤 View로 바꾸세요. 기존 텍스처를 바이트 단위로 그대로 재사용하면서 실시간 라군 수면 위에 낮 하늘, 별, 은하수, 일몰 및 밤 색감 보정을 더해 주세요.
기존 베이스 이미지, 물 마스크, 해안 접촉 프록시를 그대로 유지하므로 업그레이드에 새 이미지 생성이 필요 없습니다. Locus 1.5.1 이상에서는 루트 water 및 water.contactCalibration 와(과) 직접 결합할 수 있으며 environment.sunPath (설정 항목: daySky, panoramaGrade 및 light)을(를) 직접 결합해 사용합니다(기능 ID: locus.view.water.day-night.v1 — 매니페스트 destination.json 파일 안에 선언합니다.
2 · 하늘 마스크
하늘 전체를 지우지 않고 그려진 구름 살리기
첫 번째 테스트에서는 반구 위쪽 전체를 절차적 daySky (으)로 교체하면서 sky.mask 의 하늘 영역을 모두 흰색으로 칠했습니다. Apple Vision Pro에서 낮과 밤 전환 자체는 매끄러웠지만 원래 있던 열대 적운이 전부 사라져 수평선이 어색할 만큼 텅 비어 버렸습니다.
낮과 밤 전환 효과는 좋지만 하늘의 원래 구름이 사라졌습니다. 기본 파노라마의 구름을 그대로 유지하고 밤에는 구름 사이로 별이 빛나며 구름 가장자리에 검은 테두리가 생기지 않게 해 주세요.

- 맑고 트인 파란 하늘 틈새만 절차적 하늘로 허용: 단순 밝기 임계값으로 자르지 말고 원본 하늘 각 픽셀이 얼마나 맑고 파란지를 측정한 뒤 보수적인 램프(
smoothstep(0.36, 0.90) ** 1.15)을(를) 거친 뒤 4096×2048 마스크에 0.35 px의 완만한 가우시안 페더링을 더하세요. 흰색 픽셀(255)은 낮에 절차적 하늘을, 밤에 별과 은하수를 보여 주고 검은색 픽셀(0)은 그려진 구름과 수면 반사를 그대로 유지합니다. - 수평선 연무 페이드 아웃 및 경계면 자연스러운 연결: 어두운 보라색 테두리나 밝은 구름 하이라이트와의 충돌을 피하려면 두꺼운 적운 중심부와 낮은 수평선 연무를
sky.mask안에서 검은색(0)으로 유지한 뒤 수평 순환 블러를 적용해 ±180° 경계 이음새를 없애세요. - 접촉 보정 구면에서는 시선 레이 재투영: View가
water.contactCalibration을(를) 활성화하고referenceSkyCenterMeters오프셋이 0이 아닌 경우(예: 반경 80 m 구체 안에서 눈높이 +1.3 m), 해당 눈 원점에서 파노라마 픽셀을 단위 방향(yaw, elevation)으로 재투영한 뒤 보정된sky.mask을(를) 저장해 셰이더의 하늘 조회 방향과 정확히 일치시키세요.
3 · 태양광 투과율
두꺼운 구름 뒤에서 태양이 자연스럽게 흐려지게 하기
만약 sky.mask 및 environment.sunPath.disc.skyMask 에 같은 이진 마스크를 함께 쓰면 흰 구름 픽셀이 햇빛을 100% 가려 얇은 구름 끝을 태양이 지날 때 종이 오리기처럼 보입니다. 두 마스크의 역할을 나누어 주세요.
구름 두께에 따라 태양이 구름 뒤에서 은은하게 비쳐 보이도록 해 주세요. 두꺼운 적운 중심부 뒤에서는 희미하게 번지고 얇은 구름 끝에서는 부드럽게 비쳐 나와야 합니다.

태양 원반과 태양 눈부심 모두에 disc.skyMask의 회색조 값이 연속적으로 곱해집니다. 추정한 구름의 광학 깊이를 지수 투과율(exp(-2.5 * optical ** 1.2))으로 변환하면 빈 하늘은 255, 얇은 구름 가장자리는 115–215, 두꺼운 구름 중심은 20–50, 육지와 바다는 0으로 기록됩니다. 이 이중 마스크 기법은 sky.mask (1.2.4+), disc.skyMask (1.3.0+), 그리고 daySky 및 panoramaGrade (1.4.9+)만 사용하므로 물 효과가 없는 View에서도 Locus 1.4.9+부터 그대로 쓸 수 있습니다.
4 · 수평선 지오메트리
일몰 햇빛이 먼 섬을 투과하는 현상 막기
헤드셋에서 일몰을 테스트하는 동안 낮은 고도의 태양 눈부심이 수평선 위 어두운 섬 실루엣을 희미하게 투과했습니다. 이 현상은 두 가지 별개 원인이 겹쳐 발생했습니다.
해가 질 때 수평선 위 작은 섬을 햇빛이 그대로 통과해 새어 나오는 것 같습니다. 마스크나 시차가 어긋났는지 확인하고 투과 현상을 고쳐 주세요.

- 태양 원반 원점을 눈 시차와 정렬: 기존에는 태양 원반이 원점 (0, 0, 0)에 있고 접촉 보정된 시점이 유한 구체 안의 (0, +1.3, 0)에 있어 겉보기 일몰 궤적이 약 0.62° 아래로 내려가 있었습니다.
referenceOrigin을(를) 원반의 원점 오프셋으로 적용하고 천구 반경을 안쪽 하늘 구체 근처까지 넓혀 정확한 수평선 정렬을 복구했습니다. - 태양 중심뿐 아니라 프래그먼트별로 눈부심 가림 처리: 이전에는
SkyMask에서SunDirection한 곳에서만 샘플링해 태양 중심이 능선보다 살짝 위에 있을 때마다 넓은 눈부심이 어두운 섬 위로 번졌습니다. 각 프래그먼트의 시선 방향을 따라FragMask을(를) 샘플링하고 또렷한FragSilhouette게이트를 곱하면 눈부심 번짐을 완전히 막으면서도sun-sky-mask.png의 2.5 px 능선 페더링도 그대로 살릴 수 있습니다.
5 · 색감 보정
골든아워의 따뜻한 색감을 깊게 하고 밤 구름을 어둡게 유지하기
네—— sunPath 에서는 태양 고도에 따라 색온도가 자동으로 변해 정오의 맑은 중성 흰색에서 수평선 부근의 주황·호박빛으로 이어집니다. 첫 번째 버전에서는 두 가지가 이 따뜻함을 눌렀습니다. 눈부심 셰이더가 모든 고도에서 순백색을 60% 고정 혼합했고 light 및 panoramaGrade 의 낮은 고도 커브가 너무 중립적으로 보정되어 있었습니다.
태양이 내려갈수록 색온도가 자연스럽게 따뜻해지도록 해 주세요. 수면, 구름 아래쪽, Room 바닥에서 골든아워의 따스함이 분명히 느껴지고 밤 구름은 은하수 주변에서 차분하고 어둡게 유지되어야 합니다.

- 태양 고도에 반응하는 눈부심 색감: Locus 1.5.1은 동적 낮과 밤 View에 태양 고도 연동 백색 혼합을 적용해 고도 2° 미만에서는 백색 혼합을 18%로 낮추고 22° 이상에서 60%로 부드럽게 전환하여 낮은 햇살의 풍부한 호박빛 채도를 지킵니다.
- 정오 최고 고도를 낮추고 따뜻한 0°–8° 스톱 구성: 상한 제한:
maxElevationDegrees최댓값을 32°로 제한하고 따뜻한 호박빛 커브(0°에서 [0.56, 0.35, 0.22], 4°에서 [0.88, 0.58, 0.36])를panoramaGrade및light.stops)을(를) 적용하면 구름, 바다 윤슬, Room 실내가 풍부한 골든아워 빛으로 물듭니다. - 낮고 차분한 야간 커브: -12°와 -18° 스톱을 낮고 차가운 [0.0055, 0.0075, 0.0125]로 설정해
panoramaGrade에 적용하면 보존된 적운이 별빛과 은하수 앞에서 뿌연 회색 얼룩이 아닌 차분하고 어두운 실루엣으로 남습니다. - 배포 전 밝은 구름 꼭대기 점검: 낮 파노라마의 밝은 흰색 적운 꼭대기는 그대로 남아 있으므로 먼저
tools/sun_free_sky_check.py의 검출 결과를 픽셀 단위로 확인해 그려진 태양이 전혀 없음을 확인한 뒤sunFreeSky: true을(를) 매니페스트에 기록하세요.
6 · 파일
‘열대의 얕은 만’ 다운로드 또는 패턴 활용하기
‘열대의 얕은 만’은 Locus 예제 라이선스에 따라 무료 예제 Package v2 아카이브로 배포됩니다. Gallery에서 모든 리비전과 메타데이터 카드도 확인할 수 있습니다.