Tutorial: Adding an Animated Buoy

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.

Note
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 MarineOcean in the Toolbox.
  3. This example requires a mechanism with a buoy graphical asset. Double-click BasicsEmpty 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 GraphicsGalleries From Files....
    5. In the resulting dialog box, use the Browse button to select the buoy.vxgraphicgallery file found in your Vortex Studio Demo Scenes folder.
  4. Switch back to the scene.
  5. Double-click MarineBuoy in the Toolbox to add a buoy extension.
  6. Double-click BasicConnection 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.
    Buoy connections
  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 MarineBuoy in the Toolbox to add a buoy extension.
  3. Double-click BasicsConnection Container in the Toolbox.
  4. Click the buoy extension in the Explorer 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 MarineOcean in the Toolbox.
  11. Double-click BasicsMechanism From Files.
  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.