POSIM v1.0.1Platform for Ocean Simulation · Dokumentation
Dokumentationsmenü
POSIM / Plugin-Referenz

Effekte für Unterwasserszenen

posim_gz_rendering wendet Unterwasserdunst, RGB-Absorption, tiefenabhängiges Sonnenlicht, Kaustiken und Schwebeteilchen auf Ogre2-PBR-Flächen an. Die Teilchen ähneln Meeresschnee und sind anfangs ausgeschaltet.

Gazebo-Szene, RGB-Kameras und RGBD-Farbbilder teilen diese Effekte. Numerische Tiefe und Kollisionsgeometrie bleiben erhalten. Den separaten tiefenbasierten Bildfilter beschreibt Unterwasserkamera.

Das installierte System findet die benachbarte Renderbibliothek und die Shader unter share/posim/underwater automatisch. renderer_library und shader_directory bleiben optionale Pfadüberschreibungen. Ozean-Demostarts setzen das Kamera-Durchleitungsflag automatisch; eigene Starts mit beiden Systemen müssen es setzen.

System bauen und einbinden

Verwenden Sie eine zum Server passende Gazebo-Jetty/Ogre2-Entwicklungsumgebung. Bauen Sie im vorbereiteten Terminal A aus den POSIM-Quellen; unter macOS im Linux-Terminal des RDP-Desktops:

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 benötigt Gazebo-Entwicklungspakete sowie die pkg-config-Einträge OGRE-Next und OGRE-Next-Hlms. Der Befehl ergänzt den Pfad des ROS-Pakets gz_ogre_next_vendor unter Ubuntu. Verwenden Sie Bibliotheken, Header und Shader aus demselben Build.

Fügen Sie dieses Plugin unter <world> ein. Ersetzen Sie /absolute/underwater durch das Installationspräfix von oben. Laden Sie eine Instanz pro Gazebo-Prozess und vergeben Sie je Sitzung eine eigene session_nonce:

<plugin filename="/absolute/underwater/lib/posim_underwater.so"
        name="posim::Underwater">
  <session_nonce>appearance_example</session_nonce>
</plugin>

Linux verwendet .so, auch in Docker/RDP unter macOS. Direkt für macOS gebaute Bibliotheken verwenden .dylib. Zum Erzeugen von Sensorbildern braucht die Szene eine aktive Kamera.

Bei zusätzlichem UnderwaterCamera setzen Sie POSIM_UNDERWATER_PLUGIN in der Serverumgebung auf den Pfad des geladenen Systems. Bereits eingefärbte Pixel werden dadurch ohne zweite Dämpfung weitergegeben. Setzen Sie es nur, wenn das Szenensystem installiert und geladen ist.

Effekte und Standardwerte

Einstellung Wirkung Standard
Wasseroptik Hauptschalter für optische Effekte Ein
Unterwasserdunst Farbmischung abhängig vom Lichtweg im Wasser Ein
RGB-Absorption Wellenlängenabhängiger Farbverlust Ein
Sonnenlichtdämpfung Schwächeres gerichtetes Licht mit der Tiefe Ein
Kaustiken Bewegte Lichtmuster auf untergetauchten Flächen Ein
Schwebeteilchen / Meeresschnee Vereinzelt verteilte prozedurale Lichtpunkte Aus
Bodentextur Details aus den PBR-Karten des Meeresbodens Ein
Bodengitter Abstand 10 m, einstellbar von 1 bis 500 m Aus
Tiefenlinien Abstand 5 m, einstellbar von 1 bis 50 m Aus

Beim Ausschalten der Wasseroptik bleiben Textur-, Gitter- und Tiefenlinienauswahl erhalten. Bodenüberlagerungen erkennen Visuals namens seabed oder shallow, einschließlich vollständiger Gazebo-Namen. Stellen Sie Texturen in den Geländeressourcen bereit; siehe Gelände mit Höhenkarten.

Meeresschnee einschalten

Lesen Sie bei laufender Welt den Zustand im vorbereiteten Terminal B:

gz service -s /posim/appearance/appearance_example/state \
  --reqtype gz.msgs.Empty --reptype gz.msgs.Double_V --timeout 3000 --req ''

Die ersten 13 Werte haben diese Reihenfolge; die Indizes beginnen bei null:

Index Wert
0–1 Schema 1, Revision
2–5 Wasseroptik, Bodentextur, Gitter, Tiefenlinien
6–10 Dunst, Absorption, Sonnenlichtdämpfung, Kaustiken, Teilchen
11–12 Gitter- und Tiefenlinienabstand, m

Bei einem frisch gestarteten System mit Revision 0 aktiviert diese Anfrage Teilchen und erhält die übrigen Standardwerte:

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]'

Behalten Sie bei späteren Änderungen die gewünschten Einstellungen und erhöhen Sie die Revision um eins. Boolesche Werte sind 0 oder 1. Eine identische Anfrage darf wiederholt werden.

Lesen Sie nach dem Rendern erneut /state: Die Indizes 13–15 ergänzen ready, Kamerazahl und renderer_failed. Prüfen Sie die gewünschte Revision, ready = 1 und renderer_failed = 0. Die /set-Antwort bestätigt nur den Empfang.

Für Teilchen direkt beim Start setzen Sie diesen Tag in das Plugin, anstelle der ersten Anfrage:

<initial_settings>1 0 1 1 0 0 1 1 1 1 1 10 5</initial_settings>

WWW-POSIM verwendet diesen öffentlichen Renderer und ergänzt ein eigenes Einstellungsfenster, Sitzungssteuerung und gespeicherte Einstellungen.

Modellgrenzen und Vergleich

Die Berechnung der Lichtweglänge unter Wasser verwendet eine mittlere Meeresspiegelebene bei z = 0 m und folgt nicht einzelnen Wellenkämmen. Kaustiken und Teilchen sind visuelle Näherungen ohne kalibrierte Partikelkonzentrationen oder optisches Sensorrauschen.

Lokale Lampen behalten direkte Beleuchtung. Himmelsstrahlen werden unter Wasser gedämpft; unbeleuchtete Materialien und eigene Shader der Wasseroberfläche behalten ihr Rendering. Die Wellenunterseite hängt daher vom Oberflächenmaterial ab.

Vergleichen Sie Ansichten über/unter Wasser, RGB und RGBD-Farbe sowie jeden Schalter. Halten Sie Pose und Licht konstant. Prüfen Sie byte-identische Tiefe, mit der Simulationszeit pausierende Effekte und gemeldete Rendererfehler. Das öffentliche Paket enthält RGB/RGBD-Prüfbeispiele, Shader und Build-Details.