Water Body

• BodyWater class to handle a body by UnigineScript
• The article on water object
• ObjectWaterGlobal class to edit water objects via UnigineScript

Liquidity defines the viscosity of water (or any other liquid): it determines how readily it splashes and the resulting shaping of the waves. It multiplies the speed with which water particles pass velocity vectors to the neighboring ones.

• The higher the value is, the more viscous the water is and the smaller the waves risen by the objects. For example, tap water is made runny by setting a high value, while syrup would have a low liquidity value.
• Be careful not to set too hight or too low values, because it may lead to unstable simulation and blowing up of the water. To regain stability, try to tweak Interaction.

Density of the water determines the buoyancy of objects according to Archimedes' principle. Based on the volume of the submerged part of the shape and its mass, buoyancy force is applied to its center of mass and thrusts the object upwards, whereto the mean normal of the grid covered by submerged shape points.

• By the minimum value of 0, the objects will not float in the water, but rather fall through it not encountering any resistance.
• Increasing the value dictates the greater buoyant force. If set too high, the immersed objects start to be pushed out in the air.

Physical object that is submerged into the water (or any other liquid) has its velocity vector. On the other side, all the water particles that are covered by this physical body or surround it, are calculated their own integrated velocity vector that approximate the state of water. Interaction value is a coefficient that determines how much the object's velocity influences the velocities of water particles and thus generate waves.

• By the minimum value of 0, an object produces no disturbances on the water surface, as its velocity does not influences water particles at all.
• Increasing the value conditions that water surface is disturbed more intensely and the waves from moving objects become higher.
• Too high values may blow the water up, as the law of conservation of energy does not constrain the system! Try decreasing damping values to regain stability.

Objects getting into the water are expected to slow down, as resistance of the water is higher than the drag in the air. Damping values work the other way around compared to Interaction coefficient:
Linear damping defines how much linear velocity of the submerged object is decreased over time when influenced by velocities of surrounding water particles. And similarly, angular damping defines the gradual decrease in the object's rotation. Both linear and angular damping forces are accumulated before being applied.

• By the minimum value of 0, objects movement is not hindered by the water. As a result, there are waves in the water.
• Increasing the value leads to the the linear or angular velocities more damped, and object slowing down faster as they get into the water. Higher values also result in more pronounced waves from the objects, as the energy of the system increases.
• The water may blow up in case the values are be very high. Try decreasing interaction value to regain stability.

An additional visual effect of small droplets, splashes or bubbles on the water when objects falls into it can be created. For that, particle system is made a child node to the water mesh and a spark emitter is chosen to spawn particles. They will be generated only when the object contacts the water surface, while already submerged bodies will float without spawning them.

Waves considerably differ in size depending on the water depth. When formed in the deep water, the waves fully develop in size, arise high and move fast. When formed over a shallow bottom, they only ripple water surface, slow and small in length. Defining different depth allows simulating either puddles and shoals, or profundity.

• With the minimum value of 0, the objects raise no waves in the water.
• Increasing the value simulates conditions of deeper bottom waters and moving objects will form higher waves.

Intersection of water with the underlying terrain is necessary, for example, to estimate the actual depth of the basin. To do so, the Intersection box should be checked, and the water mesh object made a child node of the terrain or static mesh.

Intersection is implemented in the following way: from the water mesh surface the rays are traced downwards, as far as the depth distance. If on that line intersection with the parent node has occurred, the obtained depth is used in calculations. If no intersection happened, or this option is not enabled, the depth is considered of the set value.

Intersection is also traced upward to check if the water is under terrain and there is no need to render it.

Absorption is an option that creates either an effect of open water surface that does not have marked boundaries or, on the contrary, of the limited basin.

• If Absorption box is checked, the waves are dispersed along the mesh perimeter. Take notice, that in this case the water level at mesh edges will gradually fall down to zero level.
• If unchecked, the backwash from the wall is simulated: the wave when reaching the brink of the water is reflected and returns in the direction it came from.