ケーススタディ · 2026年11月16日
熱帯の浅い湾:ラグーンの View を昼夜対応にする。
リアルタイム浅瀬を備えた太陽なしの 12K 熱帯湾パノラマをベースに、有料画像生成 API を一切使わず、24 時間太陽パス・星空・暖かなゴールデンアワー・元の積雲の保持・遠くの島影での鮮明な日没遮蔽を追加した実例です。
リアルタイム水面 + 昼夜には Locus 1.5.1 以降が必要 · 2 種類のマスクによる雲保持手法は 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 では視点レイを投影: View が
water.contactCalibrationを有効にし、referenceSkyCenterMetersのオフセットが 0 でない場合(例:半径 80 m のソース球内で視点高 +1.3 m)、その視点原点から各ピクセルを単位方向(yaw, elevation)を算出してから較正済みsky.maskを書き出すことで、シェーダーの空ルックアップと厳密に一致します。
3 · 太陽光の透過率
厚い雲の背後で太陽を自然に弱める
もし sky.mask および environment.sunPath.disc.skyMask に同じ二値マスクを共用すると、白い雲ピクセルが太陽光を 100% 遮ってしまい、薄い雲の縁を太陽が通るとき切り絵のように不自然に見えます。2 枚のマスクを役割分担させましょう。
雲の厚みに応じて太陽が雲の後ろから見え隠れするようにしてください。厚い積雲の中心ではわずかに滲む程度にとどめ、薄い雲の縁からは柔らかく透けて見えるようにします。

太陽ディスクと太陽グレアの双方に、 disc.skyMaskのグレースケール値が連続的に掛け合わされます。推定した雲の光学的厚みを指数透過率(exp(-2.5 * optical ** 1.2))へ変換すると、澄んだ空は 255、薄い雲縁は 115–215、濃い雲核は 20–50、陸地や海面は 0 になります。この 2 マスク手法で使うのは sky.mask (1.2.4+), disc.skyMask (1.3.0+)、さらに daySky および panoramaGrade (1.4.9+)のみを使うため、水面の無い View でも Locus 1.4.9+ から利用できます。
4 · 水平線のジオメトリ
日没の太陽光が遠くの島を透けるのを防ぐ
ヘッドセットでの日没テスト中、低い太陽のグレアが水平線上の暗い島のシルエットをうっすら透過して見えました。原因は 2 つの独立した問題にありました。
日が沈むとき、水平線の小さな島を太陽が透けて見えているように見えます。マスクか視差がずれていないか調べて、光漏れを直してください。

- 太陽ディスクの原点を視点の視差に合わせる: 従来は太陽ディスクが原点 (0, 0, 0) に置かれ、接触較正済みの視点が有限球内の (0, +1.3, 0) にあったため、見かけの日没軌道が約 0.62° 下にずれていました。
referenceOriginをディスクの原点オフセットとして適用し、天体半径を内側天球近くまで広げることで、水平線との正確な一致を取り戻しました。 - 太陽中心だけでなくフラグメント単位でグレアを遮蔽: 以前は
SkyMaskでSunDirectionのみでサンプリングしていたため、太陽中心が尾根より少し上にあるだけで広いグレアが島の木々に漏れ出していました。各フラグメントの視線方向に沿ってFragMaskをサンプリングし、くっきりとしたFragSilhouetteゲートを掛ければグレアの光漏れを完全に止めつつ、sun-sky-mask.pngの 2.5 px 稜線フェザーも保てます。
5 · カラーグレーディング
ゴールデンアワーの暖かみを深め、夜の雲を暗く落ち着かせる
はい—— sunPath では太陽の色温度が高度に応じて自動的に変化し、正午の澄んだニュートラルホワイトから水平線付近のオレンジ・アンバーへ移ろいます。最初の版では 2 点がこの暖かみを抑えていました。グレアシェーダーが全高度で一律に 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 · ファイル
「熱帯の浅い湾」をダウンロードまたはパターンを応用する
「熱帯の浅い湾」は無料サンプル Package v2 アーカイブとして Locus サンプルライセンスのもとで公開されています。Gallery ではすべてのリビジョンやメタデータカードも確認できます。