Stylized Water 2
4.5.Scripting
By large this is a shader asset. Though because aspects revolving around Buoyancy are related to scripting, there are a couple of C# functions in place that can aid development.
All these functions have IntelliSense summaries, which can be viewed in your IDE, next to any overload variations. If necessary, each parameter is described there.
StylizedWater2.WaterObject.Find
Anything related to sampling the wave height/normal through the Buoyancy class requires a reference to a Water Object
component. This is so the Y-position (water level) and material (wave settings) can be accessed.
This function is a quick way to find a Water Object
below or above a given position. It won’t be efficient to rely entirely on this, especially not every frame. Its performance impact scales up by the number of Water Objects in the scene.
StylizedWater2.Buoyancy.FindWaterLevelIntersection
If you imagine the water being a flat plane, this performs a faux-raycast to find the intersection point where a ray shot from a point, in a specific direction meets the water level (height in world-space).
This can be used as a fast board-phase check, for functionality that doesn’t necessarily need wave-specific accuracy.
StylizedWater2.Buoyancy.Raycast
Emulates a physics-style Raycast, under the hood this uses the FindWaterLevelIntersection
function, and uses the result for the Buoyancy.SampleWaves function.
This could be used to position effects like bullet impacts on the water surface. Unlike a raycast, it cannot return a boolean if it hits or misses an actual Water Object. Instead you could check if the raycast returns a point that’s below the water level (if so, it likely passed through the water surface).
StylizedWater2.Buoyancy.CanTouchWater
Checks if the position falls between the Water Object’s Y-position, and the maximum possible wave height. In this case, it’s possible for a wave to touch the position at some point in time.
This can be used as a fast broad-phase check, before actually using the more expensive Buoyancy.SampleWaves
function.
Network synchronized waves
All the shader effects, including the waves, use the global _TimeParameters
shader value set by Unity as a time index. This translates to UnityEngine.Time.time
.
If you’re running a networked application, it may be important to ensure the waves are identical for all players (especially when using buoyancy). This requires a minor modification to the shader, to have it use a time value defined by your server.
Open the StylizedWater2/Shaders/Libraries/Common.hlsl file and uncomment the line that reads #define USE_CUSTOM_TIME
.
Next, through script, set StylizedWater2.Buoyancy.UseCustomTime
to true. Then pass your time value every frame through StylizedWater2.Buoyancy.SetCustomTime(float value)
. This function will pass the time value to the shader and buoyancy calculations, and keeps them in sync.