方式を選ぶ

昼夜 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.

併用ルールと制限