水中シーンの表現
posim_gz_rendering は Ogre2 の PBR 表面に、水中のかすみ、RGB 吸収、深度による日光減衰、コースティクス、浮遊粒子を適用します。粒子はマリンスノーを簡易的に表し、初期状態では無効です。
Gazebo のシーン、RGB カメラ、RGBD のカラー画像で同じ効果を使います。数値深度と衝突形状は変わりません。別の深度ベース画像フィルターは水中カメラを参照してください。
システムは同じ場所の描画補助ライブラリと share/posim/underwater のシェーダーを自動で探します。renderer_library と shader_directory で上書きできます。海洋サンプルの起動ではカメラのパススルーフラグを自動設定します。独自の起動で両システムを使う場合は手動で設定してください。
ビルドして組み込む
サーバーに合う Gazebo Jetty/Ogre2 開発環境を用意します。準備済みのターミナル Aで POSIM ソースからビルドします。macOS では RDP デスクトップ内の Linux ターミナルを使います。
cd "$POSIM_WS/src/posim"
export PKG_CONFIG_PATH="/opt/ros/lyrical/opt/gz_ogre_next_vendor/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}"
cmake -S gazebo/posim_gz_rendering -B build/underwater \
-DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX="$PWD/install/underwater"
cmake --build build/underwater --parallel 2
cmake --install build/underwater
CMake は Gazebo 開発パッケージと、pkg-config の OGRE-Next、OGRE-Next-Hlms を必要とします。このコマンドは Ubuntu の ROS パッケージ gz_ogre_next_vendor のパスを追加します。同じビルドのライブラリ、ヘッダー、シェーダーを使ってください。
<world> 内に追加し、/absolute/underwater を上のインストール先に置き換えます。Gazebo プロセスにつき 1 インスタンスとし、セッションごとに異なる session_nonce を指定します。
<plugin filename="/absolute/underwater/lib/posim_underwater.so"
name="posim::Underwater">
<session_nonce>appearance_example</session_nonce>
</plugin>
Linux では .so を使い、macOS の Docker/RDP 内でも同じです。macOS 向けに直接ビルドしたライブラリは .dylib を使います。センサー画像を生成するにはシーンに有効なカメラが必要です。
UnderwaterCamera も使う場合は、サーバー環境の POSIM_UNDERWATER_PLUGIN を読み込み済みシステムのパスに設定します。着色済み画素をそのまま通し、二重の減衰を防ぎます。シーンシステムをインストールして読み込んだ場合にのみ設定してください。
効果と既定値
| 設定 | 効果 | 既定値 |
|---|---|---|
| 水中光学効果 | 光学効果全体の切り替え | 有効 |
| かすみ | 水中の光路長に応じた色の混合 | 有効 |
| RGB 吸収 | 波長に応じた色の減衰 | 有効 |
| 日光減衰 | 深くなるほど弱まる平行光 | 有効 |
| コースティクス | 水中表面を動く日光模様 | 有効 |
| 浮遊粒子/マリンスノー | 疎らに生成する明るい点 | 無効 |
| 海底テクスチャ | 海底に指定した PBR マップの細部 | 有効 |
| 海底グリッド | 間隔 10 m、1~500 m で調整可能 | 無効 |
| 等深線 | 間隔 5 m、1~50 m で調整可能 | 無効 |
光学効果を切っても、テクスチャ・グリッド・等深線の選択は保持されます。海底の重ね表示は seabed または shallow という visual を認識し、Gazebo の完全なスコープ名にも対応します。テクスチャは地形アセットに含めます。ハイトマップ地形を参照してください。
マリンスノーを有効にする
ワールドを起動し、準備済みのターミナル B で状態を読みます。
gz service -s /posim/appearance/appearance_example/state \
--reqtype gz.msgs.Empty --reptype gz.msgs.Double_V --timeout 3000 --req ''
先頭 13 個の値は次の順です。インデックスは 0 始まりです。
| インデックス | 値 |
|---|---|
| 0~1 | スキーマ 1、リビジョン |
| 2~5 | 光学効果、海底テクスチャ、グリッド、等深線 |
| 6~10 | かすみ、吸収、日光減衰、コースティクス、粒子 |
| 11~12 | グリッドと等深線の間隔、m |
起動直後のリビジョン 0 では、次のリクエストが他の既定値を保ったまま粒子を有効にします。
gz service -s /posim/appearance/appearance_example/set \
--reqtype gz.msgs.Double_V --reptype gz.msgs.Double_V --timeout 3000 \
--req 'data: [1, 1, 1, 1, 0, 0, 1, 1, 1, 1, 1, 10, 5]'
以降は必要な設定を保持し、リビジョンを 1 増やします。真偽値は 0 または 1 です。同一リクエストの再送も可能です。
描画後に /state を再度読みます。インデックス 13~15 に ready、カメラ数、renderer_failed が追加されます。要求したリビジョン、ready = 1、renderer_failed = 0 を確認してください。/set の応答だけでは受領の確認にとどまります。
起動時から粒子を有効にする場合は、最初のリクエストの代わりに次のタグをプラグインへ追加します。
<initial_settings>1 0 1 1 0 0 1 1 1 1 1 10 5</initial_settings>
WWW-POSIM はこの公開レンダラーに、独自の外観パネル、セッション管理、設定保存を追加しています。
モデルの範囲と比較
水中の光路長は z = 0 m の平均水面を基準に計算し、個々の波頂には追従しません。コースティクスと粒子は視覚的な近似で、校正された粒子濃度や光学センサーノイズは再現しません。
局所光源は直接照明を保ちます。空へのレイには水中減衰がかかりますが、unlit 材質や独自の海面シェーダーは自身の描画を保ちます。波面の裏側は海面材質の設定で扱います。
水面上と水中、RGB と RGBD カラー、各切り替えを比較します。姿勢と照明を固定し、深度がバイト単位で同一なこと、時間依存の効果がシミュレーションの一時停止に合わせて止まること、描画エラーが報告されることを確認します。公開パッケージには RGB/RGBD 確認用の例、シェーダー、ビルド情報があります。