上級 · 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-bit グレースケール PNG(PNG カラータイプ 0)。空の領域を白(255)、地形・木々・建物を黒(0)。地平線や枝の輪郭は滑らかにアンチエイリアス処理してください。 - 任意の太陽円盤マスク(
environment.sunPath.disc.skyMask): 2:1 の 8-bit グレースケール 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: 2〜16 個のストップでルームの指向性太陽光(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)。リニア RGB のnightGrade(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-bit RGB のlightingおよびemissionPNG)は次と併用できます:panoramaBlend. - 両方のパノラマは解像度が完全に一致している必要があります。 1 ピクセルでも差があると(
panorama.pathおよびpanoramaBlend.pathは拒否されます。