방식 선택

낮/밤 View는 environment.sunPath 의 완전한 Package v2 아카이브에서 구성됩니다(기존 단순 호환 view.json ZIP에서는 이 필드들을 지원하지 않습니다). 아래 매니페스트는 하얀 사구의 새벽(Chalk Dune Dawn) (destination.chalk-dune-dawn 1.4.0) 구성을 따릅니다. 12K 석고 사구 View로, 풀프레임 낮·밤 파노라마, 절차적 맑은 하늘·별/은하수, 햇빛을 받는 3D 중경 사구를 함께 사용합니다.

Chalk Dune Dawn 예제 살펴보기. 다운로드 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.dayNight1.4.11실시간 계산 해변 파도나 비디오 영역 맵이 동일한 낮/밤 블렌드를 따르게 합니다.
왜 sky 및 daySky 가 계약에 포함되는 이유. 현재 Package v2 사양에서는 panoramaBlend 에는 다음 두 가지가 모두 필요합니다: environment.sunPath.daySky 및 루트 sky ( sky.mask 및 stars 또는 moon). sky.mask 의 흰색 픽셀은 렌더링된 낮 대기와 밤의 별·은하수를 표시하고, 검은색 픽셀은 낮과 밤 파노라마가 혼합된 이미지를 표시합니다.

1 · 준비

이미지 및 마스크 준비

Locus의 절차적 하늘 대신 직접 그린 하늘 사용하기. 다음을 칠합니다: 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 · 보정

고도 정지점 및 블렌드 임계값 조정

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에 밝은 태양 원반이 남아 있지 않은지 검사합니다.

  1. Apple Vision Pro에서 가져오기 경로: Places → Import → Import a View → Files 한 다음 Room과 연결하세요.
  2. Edit View에서 Sun Position 스크럽하기 아침, 정오, 골든 아워, 황혼, 자정까지 확인하며 지평선 실루엣, 룸 유리 반사, 전경-하늘 경계 마스크를 점검하세요.
  3. 모션 끄기 / 동작 줄이기 확인: View가 다음 시각에서 깔끔하게 정지하는지 확인하세요: startHour.

공존 규칙 및 제한