water-demo - GitLite

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #go #linux #nodejs #windows #cli #kubernetes #awesome-list #security #mcp #openai #open-source

water-demo

(★ 337)

A port of Evan Wallace's "Water Demo" for WebGL to Unity.

파일 탐색기

최종 버전 다운로드 (.zip)

- Caustics Texture View.mat
- Caustics Texture View.mat.meta
- Cube.mat
- Cube.mat.meta
- CustomRenderTexture_WaterIntegrate.mat
- CustomRenderTexture_WaterIntegrate.mat.meta
- Unlit_Caustics.mat
- Unlit_Caustics.mat.meta
- Unlit_Sphere.mat
- Unlit_Sphere.mat.meta
- Unlit_Water Above.mat
- Unlit_Water Above.mat.meta
- Unlit_Water Below.mat
- Unlit_Water Below.mat.meta
- Water Texture View.mat
- Water Texture View.mat.meta
- Hexahedron.asset
- Hexahedron.asset.meta
- Sphere.asset
- Sphere.asset.meta
- Water Plane.asset
- Water Plane.asset.meta
- cube-of-water.unity
- cube-of-water.unity.meta
- CameraOrbit.cs
- CameraOrbit.cs.meta
- GeometryBuilder.cs
- GeometryBuilder.cs.meta
- MaterialUpdater.cs
- MaterialUpdater.cs.meta
- WaterSimulation.cs
- WaterSimulation.cs.meta
- Caustics.shader
- Caustics.shader.meta
- Cube.shader
- Cube.shader.meta
- HelperFunctions.cginc
- HelperFunctions.cginc.meta
- Sphere.shader
- Sphere.shader.meta
- TextureView.shader
- TextureView.shader.meta
- Water.shader
- Water.shader.meta
- WaterIntegrate.shader
- WaterIntegrate.shader.meta
- caustics texture.renderTexture
- caustics texture.renderTexture.meta
- sky cubemap.cubemap
- sky cubemap.cubemap.meta
- test water height.png
- test water height.png.meta
- tiles.jpg
- tiles.jpg.meta
- water custom texture.asset
- water custom texture.asset.meta
- water.renderTexture
- water.renderTexture.meta
- xneg.jpg
- xneg.jpg.meta
- xpos.jpg
- xpos.jpg.meta
- ypos.jpg
- ypos.jpg.meta
- zneg.jpg
- zneg.jpg.meta
- zpos.jpg
- zpos.jpg.meta
clickable.gif
clickable.gif.meta
LICENSE
LICENSE.meta
Materials.meta
Models.meta
README.md
README.md.meta
Scenes.meta
Scripts.meta
Shaders.meta
Textures.meta
todo.org
todo.org.meta
water-demo.gif
water-demo.gif.meta

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Water Demo
==========

![Water demo GIF showing caustics.](https://raw.githubusercontent.com/shanecelis/water-demo/master/water-demo.gif)

This is a port of Evan Wallace's [Water Demo](http://madebyevan.com/webgl-water/) from WebGL to Unity.

Motivation
----------

I ported this as an exercise to investigate different real-time caustics implementations.  I've only surveyed a handful of research papers on real-time caustics, but it seems like [Evan's work](https://medium.com/@evanwallace/rendering-realtime-caustics-in-webgl-2a99a29a0b2c) would be suitable for publication for both its simplicity and performance.

Requirements
------------

* Unity 2018.2.17f1

Usage
-----

Create a new project using Unity 2018.2.17f1. Clone this repo into the "Assets" directory.  Open the "cube-of-water" scene and hit play.

![Click on water to cause a wave.](https://raw.githubusercontent.com/shanecelis/water-demo/master/clickable.gif)

You can click on the water to cause a wave.  You can drag to move the camera around.  Hit "space" key to pause water simulation.  Hit "n" key to update the simulation one time step.

Implementation Notes
--------------------

This is a pretty faithful reproduction of Evan's demo.  As such there are a number of cases where it deviates from Unity's conventions.

For instance, the shader that renders the sphere has variable `sphereCenter`, so the sphere rendering object is expected to located at the origin and if you change that, it probably will not look right.

The light direction is provided to shaders as a direction vector.  It doesn't use Unity's lighting at all.

The shaders do not use the models' UV coordinates.  For instance the cube's minimum and maximum model position are (-1, -1, -1) and (1, 1, 1), so any point on its surface is often just mapped directly to a UV coordinate [0, 1]^2 by transforming the point p by `p * 0.5 + 0.5`.  This works fine for the purposes of the demo, but one would probably want to switch to UV coordinates in the future.

A lot of this is smoke and mirrors. The cube knows where the sphere is, so it renders its shadow. Great for a tech demo, but if you want to allow for multiple spheres or other objects, this will need to be reformulated significantly.

Bugs
----

* WebGL build not working (major regression from original project).

* Not all UI elements from original are preserved.

* Underside of water does not reflect like it should.  Seems like a HLSL lerp problem.

See the `todo.org` file for more details.

License
-------

This project is released under the MIT license.

The tiles texture appears to be [Patrick Hoesly's](https://www.flickr.com/photos/zooboing/3682834083) and was released under the Creative Commons Attribution (CC-BY) license.

Contact
-------

I won't be providing any support for this, but if you want to follow me and the strange things I make you can find me on twitter [@shanecelis](https://twitter.com/shanecelis).