Update README.md

README.md

@@ -6,7 +6,7 @@
 # _THIS IS A WORK IN PROGRESS, INCLUDING DOCUMENTATION_
 
 
-The shader can be edited through [Amplify Shader Editor](http://amplify.pt/unity/amplify-shader-editor) and contributions to the project are always welcome!
+This shader can be edited through [Amplify Shader Editor](http://amplify.pt/unity/amplify-shader-editor) and contributions to the project are always welcome!
 
 ---
 
@@ -27,12 +27,12 @@ Third-party (free) assets used in this project:
 # Table of contents
 1. [Getting started](#getting-started)
 2. [Usage & parameters](#usage-parameters)
-    - 2.1 [Fresnel settings](#fresnel-settings)
-    - 2.2 [Texture settings](#texture-settings)
-    - 2.3 [Noise settings](#noise-settings)
-    - 2.4 [Distortion settings](#distoriton-settings)
-    - 2.5 [Pulsation settings](#pulsation-settings)
-    - 2.6 [Tessellation settings](#tessellation-settings)
+    - 2.1 [Fresnel](#fresnel)
+    - 2.2 [Texture](#texture)
+    - 2.3 [Noise](#noise)
+    - 2.4 [Distortion](#distoriton)
+    - 2.5 [Pulsation](#pulsation)
+    - 2.6 [Tessellation](#tessellation)
 3. [Examples](#examples)
 4. [Donate](#donate)
 5. [License](#license)
@@ -48,6 +48,91 @@ This shader is comprised of a few "modules", that work independently and can be
 
 ![Parameters](Media/Parameters.jpg)
 
+## Fresnel
+
+This shader provides several ways to customize the final look of your sci-fi shield, and the main/base look is achieved through the fresnel effect.
+
+![Fresnel](Media/Param_fresnel.jpg)
+
+Fresnel settings determine the `Scale`, `Color` and `Power` of the "edge". How far and how bright the edge extends towards the inside. Modifying `Bias` is rarely needed.
+
+Default values for `Inner opacity` and `Edge opacity` are 0 and 1 respectively. It means the area covered by the fresnel effect is fully visible, whereas the area not covered by it is completely invisible. Inverting these values results in an invisible edge, and a fully visible interior.
+
+_For more information on the Fresnel effect check [this](https://www.dorian-iten.com/fresnel/)_.
+
+## Texture
+
+But just a simple edge is quite boring, isn't it?
+
+![Textures](Media/Param_textures.jpg)
+
+Add up to two textures that can be made to scroll (`Panning speed`) in any direction to achieve a more dynamic look. Even the simplest of textures can look good.
+
+Tweak their `Intensity`, `Tint` color or `Invert` them. _Important to note: all textures will be converted to grayscale and then tinted._
+
+In this case, we've got a slow honeycomb pattern as the main texture, and a simple horizontal stripe for a fast sweeping effect.
+
+![Textures_ex](Media/Holoshield_Basic_textures.gif)
+
+## Noise
+
+![Noise](Media/Param_noise.jpg)
+
+In addition to these textures, we can also add some procedural noise for a gritty look. Alternatively, we can sharpen it and go for a stylized look:
+
+![Noise2](Media/Holoshield_Noise_light.gif)
+
+## Distortion
+
+This is what makes this shader interesting, because we don't always want a completellyperfect sphere, that's rather boring.
+
+![Distortion](Media/Param_distortion.jpg)
+
+Play around with `Scale` and `Extra roughness` to achieve the desired look and then animate the surface by giving it some `Speed`.
+
+This example showcases high amplitude, low frequency distortion versus low amplitude, high frequency distortion:
+
+![Distortion2](Media/Shields3_light.gif)
+
+## Pulsation
+
+Pretty self-explanatory, make it dance!
+
+![Pulsation](Media/Param_pulsation.jpg)
+
+A sine wave controls the scale, and thus you can tweak its `Amplitude`, `Frequency` and `Phase`, as well as the `Offset`.
+
+![Pulsation2](Media/Holoshield_Pulsation.gif)
+
+## Tessellation
+
+![Tessellation](Media/Param_pulsation.jpg)
+
+Tessellation helps achieve a higher resolution when the amount of distortion we apply is too much in comparison to the amount of vertices of our mesh.
+
+At the beginning of this document, we mentioned we are using built-in Unity spheres, but these spheres are relatively low-poly, and thus not detailed enough for high frequency distortion.
+
+Tessellation allows us to subdivide the mesh so that there are more vertices in between the original ones.
+
+_For more information on Tessellation, check [this](https://en.wikipedia.org/wiki/Tessellation_(computer_graphics))._
+
+This example shows the same base mesh and distortion settings, but different tessellation. The one on the right is much more high-res because there are more vertices to push around.
+
+![Tessellation](Media/Holoshield_tess_gifski_light.gif)
+
+You can really appreciate the difference these settings make by switching to 'Wireframe' or 'Shaded wireframe' modes under 'Scene display mode' (next to the 3D/2D toggle button).
+
+## Examples
+
+Of course you can use your own meshes, remember to set UVs according to the effect you want to achieve.
+
+![Pickup](Media/Holoshield_Pickup_light.gif)
+![Sun](Media/Holoshield_Sun2_gifski.gif)
+![Pickup](Media/Humanoid_holoshield_light.gif)
+![Shield2](Media/Shield2_light.gif)
+![Shield2](Media/Shields_distortion.gif)
+
+