Maritime Tutorial 6 : Adding an Animated Buoy

Owned by Marc Lievin
Mar 14, 2024
3 min read

This page contains information about our legacy OpenGL renderer. If you follow this tutorial while using our new Vulkan renderer, the graphics options and visualization won't be equivalent.

However, the configuration and behavior of the dynamics extensions remain the same.

In marine scenarios, you might want to add navigation buoys that follow the movements of the water's surface without using dynamics computations, in order to maintain an acceptable level of performance. To avoid these extra computations, make sure you do not add parts or collision geometries to the buoy.

If you need the buoy to collide with other objects in the scene, you will need to create a full mechanism with buoyancy rather than use this extension.

To add an animated buoy:

  1. Create a new scene.
  2. Add an ocean by double-clicking Marine > Ocean in the Toolbox.
  3. This example requires a mechanism with a buoy graphical asset. Double-click Basics > Empty Mechanism.
    1. Rename the mechanism to "Buoy Mechanism" in its Properties panel.
    2. Right-click the mechanism and select Open Mechanism....
    3. In the resulting dialog box, you will be prompted to save changes. Click Save All.
    4. In the mechanism, double-click Graphics > Galleries From Files....
    5. In the resulting dialog box, use the Browse button to select the buoy.vxgraphicgallery file found in your Vortex Studio Sample folder.
  4. Switch back to the scene.
  5. Double-click Marine > Buoy in the Toolbox to add a buoy extension.
    • Rename the Buoy to "Buoy Extension" in its Properties panel.
  6. Double-click Basic > Connection Container in the Toolbox.
  7. Click the buoy extension in the Explorer panel.
  8. From the buoy extension's properties, click and drag its World Transform into the Connection Editor window.
  9. Click the buoy mechanism in the Explorer panel.
  10. From the buoy mechanism's properties, click and drag its Parent Transform into the Connection Editor window.
  11. Connect the World Transform output to the Parent Transform input.
  12. Switch to the 3D View window and play the scene. The buoy will now follow the movement of the waves.

You can also add multiple buoys to a scene and have them all follow the ocean waves. To avoid having to create multiple connections for every mechanism in your scene, you should add the extension and connection directly in the buoy mechanism, then add instances of that mechanism directly to the scene.

To add multiple buoys:

  1. Open the buoy mechanism you created above.
  2. Double-click Marine > Buoy in the Toolbox to add a buoy extension.
  3. Double-click Basics > Connection Container in the Toolbox.
  4. Click the buoy extension in the Explorer panel.
    • Rename the buoy to "Buoy Extension" in its Properties panel.
  5. From the buoy extension's Properties panel, click and drag its World Transform into the Connection Editor window.
  6. Click the buoy Graphics Gallery in the Explorer panel.
  7. From the buoy Graphics Gallery's Properties panel, click and drag its Parent Transform into the Connection Editor window.
  8. Connect the World Transform output to the Parent Transform input.
  9. Create a new scene.
  10. Add an ocean by double-clicking Marine > Ocean in the Toolbox.
  11. Double-click Basics > Mechanism From Files.
    • In the resulting dialog box, use the Browse button to select your buoy mechanism file.
  12. Copy and paste the buoy and place the copies around the scene using the Transform Toolbar.
  13. Play the scene and all the buoys will follow the movements of the ocean waves.