Floor Settings

Floors and their settings can be accessed in the General tab of the Physics node.

There are two types of floors : Floor and Water.

Both are represented by a box whose settings can be modified, and both can be used in combination.

Above the floor settings a Gravity setting can be set which will affect all bodies as they are enabled, and exert a constant force until it is stopped either by another body or by one of the two floors.

The floor is represented by a box with the top of the box representing the solid surface of the floor.

The following properties are available for the floor :

Property	Description
Enable floor	Toggle to activate/deactivate the floor
Draw floor debug	Toggle drawing the floor in the debug
Position	X, Y, Z position of the floor in space
Rotation	X, Y, Z rotation of the floor in space
Size	X, Y, Z size of the floor

If the size of the floor is changed the Validate button will become red and the size difference will only be taken into account by the physics engine when validated.

Water settings

The water floor is represented by a box where the surface of the water is at the center of the height of the box.

The following properties are available for the water floor :

Property	Description
Enable floor	Toggle to activate/deactivate the floor
Draw floor debug	Toggle drawing the water in the debug
Position	X, Y, Z position of the water in space
Rotation	X, Y, Z rotation of the water in space
Size	X, Y, Z size of the water
Wave Amplitude	Amplitude (height) of the waves. (%) of the height of the water floor
Wave orientation	Orientation of the waves (degree)
Wave cycle length	Distance between two waves
Wave cycle time	Time between two wave cycles

In the following screen captures, the dark blue portion is a side view of the Water Floor settings and a light blue plane has been materialised in the center to view the water’s surface.

Default water

Buoyancy

A solid floor has been added under the water floor to highlight sinking bodies.

Buoyancy defines how much an object floats:

Buoyancy < 1.0 the object sinks
Buoyancy = 1.0 the object floats, but barely
Buoyancy > 1.0 the object floats more and more

You can observe below the reaction of an object to the water floor with different values of Buoyancy:


Buyoancy = 0.0	Buyoancy = 1.0

Buyoancy = 3.0 (default)	Buyoancy = 10.0

Linear drag

The linear drag property of bodies defines how much the water will slow the body’s linear movement.


Red Linear drag: 0.5 (default) Blue Linear drag: 0.5 (default) Both are set in motion with a force Fx = 2.0	Red Linear drag: 0.5 Blue Linear drag: 10.0 Both are set in motion with a force Fx = 2.0

Angular drag

The angular drag property of bodies defines how much the water slows the body’s angular movement.


Red Angular drag: 0.7 (default) Blue Angular drag: 0.7 (default) Both are set in motion with a force TAy* = 2.0*	Red Angular drag: 0.5 Blue Angular drag: 5.0 Both are set in motion with a force TAy* = 2.0*

Waves

The water floor has a wave property that can be adjusted to further simulate a fluid on which the bodies would be floating.

Wave Amplitude

This property expresses the height of a wave as a percentage of the total height of the water floor.

Without waves, the water surface is at the center of this height, the waves make it move up and down following a sine.

Note that the following views have been done with an orthographic camera to avoid distortion due to forcing a perspective view.



Wave Amplitude: 20%	Wave Amplitude: 40%

Wave Amplitude: 80%	Wave Amplitude: 100%

Other properties are:

Wave Orientation: 0.0
Wave Cycle Length: 8.0
Wave Cycle Time: 4.0

Wave Orientation

This property defines the orientation of the wave sine relative to the X axis.

By default, the sine wave will propagate along the X axis.



Wave Orientation: 0.0 Wave propagates from +X to -X	Wave Orientation: 180.0 Wave propagates from -X to +X

Wave Orientation: 90.0 Wave propagates from -Z to +Z	Wave Orientation: 270.0 Wave propagates from +Z to -Z

Wave Cycle Length

This property describes how long (in distance) the sine waves are.

In this example each sphere has a diameter of 0.5 and are separated from each other by a distance of 0.5.

Size and disposition of bodies may affect how lower values of Wave Cycle Length affect bodies.



Wave Cycle Length: 2.0	Wave Cycle Length: 4.0

Wave Cycle Length: 8.0	Wave Cycle Length: 16.0


Wave Cycle Length: 32.0	Wave Cycle Length: 64.0