README.txt 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292
  1. **************************************
  2. * VOLUMETRIC FOG & MIST 2 *
  3. * Created by Kronnect *
  4. * README FILE *
  5. **************************************
  6. Requirements
  7. ------------
  8. Volumetric Fog & Mist 2 currently works only with Universal Rendering Pipeline (v7.1.8 or later)
  9. Make sure you have Universal RP package imported in the project before using Volumetric Fog & Mist 2.
  10. Demo Scenes
  11. -----------
  12. There's a demo scene which lets you quickly check if Volumetric Fog & Mist 2 is working correctly in your project.
  13. Note: make sure you have Universal RP 7.5 or later installed from Package Manager and also a URP pipeline asset assigned to Graphics Settings.
  14. Documentation/API reference
  15. ---------------------------
  16. The PDF is located in the Documentation folder. It contains instructions on how to use this asset as well as a useful Frequent Asked Question section.
  17. Support
  18. -------
  19. Please read the documentation PDF and browse/play with the demo scenes and sample source code included before contacting us for support :-)
  20. * Support-Web: https://kronnect.com/support
  21. * Support-Discord: https://discord.gg/EH2GMaM
  22. * Email: contact@kronnect.com
  23. * Twitter: @Kronnect
  24. Future updates
  25. --------------
  26. All our assets follow an incremental development process by which a few beta releases are published on our support forum (kronnect.com).
  27. We encourage you to signup and engage our forum. The forum is the primary support and feature discussions medium.
  28. Of course, all updates of Volumetric Fog & Mist will be eventually available on the Asset Store.
  29. Version history
  30. ---------------
  31. Current
  32. - Added "Enable Update Mode Options" to inspector. Useful to improve performance by avoiding updates on fog volumes that're not visible.
  33. - Fog of war editor improvements
  34. V12.6
  35. - Added option to use optimized depth only shader for depth prepass
  36. - [Fix] Fixed Volumetric Fog Manager null reference issue in certain cases
  37. V12.5.4
  38. - Improvements to fog of war restore handling
  39. V12.5.3
  40. - Improvements and fixes to Terrain Fit feature
  41. V12.5.1
  42. - Volumetric Fog Renderer Feature optimizations & fixes
  43. V12.5
  44. - Fog Layer field no longer needed in Volumeric Fog Manager
  45. - Fog Layer Mask option added to Volumetric Fog Renderer Feaure (allows using 2 render features to render some fog volumes before transparent objects and others after transparent objects)
  46. - Terrain Fit capture optimizations and fixes
  47. V12.4.1
  48. - [Fix] Prefab isolation mode fixes
  49. V12.4
  50. - New demo scene "Fans"
  51. - [Fix] Fixed shadows with rotated volumes
  52. V12.3
  53. - "Alpha" property (transparency) added to Volumetric Fog inspector (previously was integrated with the albedo color)
  54. - Fog transparency no longer changes when fog of war editor mode is enabled
  55. - Constant density fog option is now affected by albedo and daytime light
  56. - Changes to certain properties in the inspector are now reflected in the scene more quickly
  57. V12.2
  58. - Added "Constant Density" option (does not use noise textures creating a smooth fog effect with slightly better performance)
  59. - Added "Max Distance on X/Z" option in Shader Options
  60. - Reduced banding on areas with thick fog
  61. - Presets adjustments
  62. - "Distance option" Shader optimizations
  63. V12.1
  64. - Added new demo scene "Ancient Lands"
  65. - Added fog presets (folder Demo/Presets). They're showcased in the Ancient Lands demo scene.
  66. - Added "Custom Volume Height" to profile. This option will override the fog volume height, making it easier to store full appearance settings into a profile.
  67. - Added "Enable Follow" option. Makes the fog volume follow a target automatically, with options.
  68. - Added distant fog render queue option
  69. V12.0
  70. - Added Unity 2022 (URP 14) Forward+ support
  71. - Added new options to Volumetric Fog Manager (Shader Options) related to Forward+
  72. V11.1
  73. - Added "Cull Mode" option for depth prepass render feature (set in Volumetric Fog Manager)
  74. - [Fix] Fixed an issue with an allocation in Volumetric Fog Render Feature when no scattering, blur or downscaling was used
  75. - [Fix] Fixed shadows issue with Unity 2021.3.x in builds due to shader keyword changes in URP codebase vs 2020
  76. V11.0
  77. - Added "Distant Fog" feature (new section in fog profile)
  78. - Added "Shadows Max Distance" parameter (for optimization purposes)
  79. V10.2
  80. - Added SunColor and SunIntensity profile properties (can be used when Day/Night Cycle option is disabled)
  81. - [Fix] Fixed a material reference issue when duplicating fog volumes
  82. V10.1
  83. - Added "Shadow Fog Cancellation" option. Enable it in Shader Options inside Volumetric Fog Manager
  84. - Added "Directional Light Cookie Fog Cancellation" option. Enable it in Shader Options inside Volumetric Fog Manager
  85. - Added scattering "High Quality" option
  86. V10.0
  87. - New "Scattering" feature. Enable it in Volumetric Fog Manager to create even more immersion.
  88. - Improvements to fog material serialization
  89. - [Fix] Fixed vertical offset parameter affecting shadow position
  90. V9.7.1
  91. - [Fix] Fixed fog of war restore issue
  92. - [Fix] Fixed a shader library compatibility issue with Unity 2022.2.12
  93. V9.7
  94. - API: SetFogOfWarAlpha overload that accepts a collider
  95. V9.6
  96. - Added "Max Distance" and "Max Distance FallOff" options to profile
  97. - Border option in profile is now disabled by default, can be enabled in Volumetric Fog Manager's Shader Options section
  98. V9.5.2
  99. - [Fix] Fixed an issue with Volumetric Lights when disabling the render feature
  100. V9.5
  101. - Added "Custom Detail Noise Wind Direction" option
  102. - Added in-editor size handles to subvolume gizmo
  103. - [Fix] Fixed some properties not transitioning correctly when using subvolumes
  104. V9.4
  105. - Added "Ambient Light" multiplier under Directional Light section
  106. - Terrain Fit: occlusion cam now uses an exclusive renderer to avoid issues with other render features
  107. - API: added "RestoreToAlpha" parameter to SetFogOfWar methods
  108. V9.3
  109. - Added support for directional light cookie (requires Unity 2021.3 or later)
  110. - [Fix] Fixed some fog of war traces when two or more user clear fog calls act on the same area
  111. - [Fix] Fixed rendering issue with transparent & alpha-cutout prepass in VR Single Pass Instanced
  112. V9.2
  113. - Added Camera Layer Mask option to the render feature
  114. - Option to allow render feature to run on reflection probes
  115. - Improved volumetric fog inspector
  116. - Ensures only one fog manager exists when loading multiple scenes
  117. V9.1
  118. - Improvements to fog composition when using downscaling & blur
  119. - Fog distance now takes into account 3d distance instead of 2d distance
  120. - [Fix] Fixed issue when SSAO render feature is used in Unity 2021
  121. - [Fix] Fixed depth gradient wrapping colors issue on Android
  122. V9.0
  123. - Added support for Unity 2022
  124. - Depth / Height Gradient options now take into account alpha values for transparency
  125. - Added "Use Day Night Cycle" option to inspector
  126. V8.3
  127. - Added option to allow rotation of fog volumes in Volumetric Fog Manager (Shader Options section)
  128. - Minimum Unity version required is now 2020.3.16
  129. V8.2
  130. - Fade option: changed fade distance meaning. Fog volume blendings now starts when reference controller is within this fade distance to any volume edge.
  131. - [Fix] Fixed transparency issue which prevents full opacity under certain circumstances (like using very large volumes)
  132. V8.1.1
  133. - Fog volumes now completely disable if they become completely transparent
  134. - [Fix] Fixed a material issue when duplicating a fog volume
  135. V8.1
  136. - Added new shader option to Volumetric Fog Manager: support for fog void rotation (example: https://youtu.be/rtS1ayn28X0)
  137. - Added new shader option to Volumetric Fog Manager: world-space aligned noise
  138. V8.0
  139. - A new section called "Shader Options" has been added to Volumetric Fog Manager which allows easy management of static options
  140. - Added blur HDR option
  141. - Added support for blue-noise (check documentation to learn how to enable it)
  142. V7.2 16/Mar/2022
  143. - Unique file name will now be assured when creating a new fog of war texture asset
  144. - [Fix] Fixed an issue that prevented refresh the fog of war texture when assigning it from scripting
  145. V7.1 1/Feb/2022
  146. - Added downscaling option to Volumetric Fog Manager to boost performance
  147. - Change: height gradient option now goes from bottom to top of fog volume instead of mirroring around the center
  148. - Prevents fog render features to run on terrain fit cam
  149. v7.0 26/Dec/2021
  150. - Added new blur options to Volumetric Fog Manager
  151. - [Fix] Fixed light diffusion intensity when there's no Sun in the scene
  152. v6.3 12/Dec/2021
  153. - Added "Depth Gradient Color" and "Height Gradient Color" options to add stylized distance-based gradient color
  154. - Added support for Unity 2021.2
  155. - Reduced shader variants
  156. - [Fix] Fixed distance falloff not applied when user saves scene until scene restart
  157. v6.2 28/Nov/2021
  158. - Added shader option "FAST_POINT_LIGHT_OCCLUSION" in PointLights.cginc
  159. - Improved reliability of fog of war delayed transitions
  160. v6.1
  161. - Added "Moon" slot to Volumetric Fog Manager
  162. v6.0
  163. - Added support for Unity native lights including spot lights with shadows
  164. - Fast point lights management optimizations
  165. - [Fix] Fixed wind direction
  166. v5.4
  167. - Fog of War: added "Is Local" option: makes the fog of war center local to the fog volume (moves with it)
  168. - [Fix] Changes to profiles used in subvolumes didn't affect the fog instance at runtime
  169. v5.3.3
  170. - [Fix] Fixed issue with fade out option
  171. v5.3.1
  172. - [Fix] Fixed issue with SetFogOfWarAlpha using the default fog of war texture
  173. v5.3
  174. - Added "Fade Out" option
  175. - Depth pre-pass now uses an internal shader to avoid dependency on standard urp/unlit
  176. - [Fix] Fixed a fog void issue during scene unload
  177. v5.2
  178. - Optimization: point lights are now excluded if they're behing camera and beyond light range
  179. - Optimization: faster fog void registration
  180. - Optimization: added MAX_ITERATIONS global setting to CommonsURP.hlsl
  181. v5.1
  182. - Fog Voids are now fully 3D
  183. - API: added "settings" accessor so fog properties can be changed without affecting the profile (similar to material vs sharedMaterial)
  184. v5.0
  185. - New Terrain Fit option: https://youtu.be/yBT4no45g2Q
  186. - Fog void changes: removed radius, now size is controlled with transform scale.
  187. - New "Roundness" option to fog void, allows rectangles, rounded rectangles and circular shapes
  188. v4.1
  189. - Added "Alpha Clipping" transparency support for improving results with special objects like fur or hair.
  190. - Sub-Volumes is now a separate option from Fade section.
  191. v4.0
  192. - Added "Fade" option. Allows smooth transitioning when moving from outside into the fog volume.
  193. - Added "Show Boundary" option. Shows an overlay on the fog volume in Game View.
  194. - Added "Sub-Volume" support. Allows customizing fog properties in different areas within the same volume.
  195. v3.4
  196. - Added "Alpha CutOff" option when "Include Transparent" option is enabled
  197. v3.3
  198. - Improved "Border" appearance
  199. - Ability to use only 3D noise when Noise Final Multiplier is set to 0 (this only affects to the base/2D noise)
  200. v3.2
  201. - Added "Raymarch Min Step" parameter
  202. - Added "Detail Offset" parameter
  203. - [Fix] Fixed point lights issue with orthographic camera
  204. v3.1
  205. - Added orthographic camera support
  206. v3.0.1
  207. - [Fix] Fixed "Flip Depth Texture" option issue which prevented it from being applied
  208. v3.0
  209. - Added Detail Noise option with custom strength and scale
  210. - Added Boundary section (new boundary type: sphere)
  211. - Added Vertical Offset option
  212. v2.2.1 29-APR-2020
  213. - [Fix] Fixed fog not rendering at distance due to camera far clip issue
  214. v2.2 April / 2020
  215. - [Fix] Fixed VR issues
  216. v2.1 April / 2020
  217. - Shader optimizations
  218. - [Fix] Workaround for shadows issue on WebGL 2.0
  219. v1.0 Febrary / 2020
  220. First release