[Bf-docboard-svn] bf-manual: [9054] branches/blender-3.1-release/blender_docs/manual: Real Snow Documentation

[Aaron Carlisle]

Revision: 9054
          https://developer.blender.org/rBM9054
Author:   Blendify
Date:     2022-02-28 19:53:56 +0100 (Mon, 28 Feb 2022)
Log Message:
-----------
Real Snow Documentation

Author: @PiloeGAO

Differential Revision: https://developer.blender.org/D14200

Modified Paths:
--------------
    branches/blender-3.1-release/blender_docs/manual/addons/object/index.rst

Added Paths:
-----------
    branches/blender-3.1-release/blender_docs/manual/addons/object/real_snow.rst
    branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_example.png
    branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_ui.png

Modified: branches/blender-3.1-release/blender_docs/manual/addons/object/index.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/addons/object/index.rst	2022-02-28 18:19:54 UTC (rev 9053)
+++ branches/blender-3.1-release/blender_docs/manual/addons/object/index.rst	2022-02-28 18:53:56 UTC (rev 9054)
@@ -8,13 +8,14 @@
 .. toctree::
    :maxdepth: 1
 
+   align_tools.rst
    bool_tools.rst
    carver.rst
    cell_fracture.rst
+   edit_linked_library.rst
    greasepencil_tools.rst
    color_rules.rst
-   edit_linked_library.rst
    oscurart_tools.rst
+   real_snow.rst
    scatter_objects.rst
    skinify.rst
-   align_tools.rst

Added: branches/blender-3.1-release/blender_docs/manual/addons/object/real_snow.rst
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/addons/object/real_snow.rst	                        (rev 0)
+++ branches/blender-3.1-release/blender_docs/manual/addons/object/real_snow.rst	2022-02-28 18:53:56 UTC (rev 9054)
@@ -0,0 +1,63 @@
+
+*********
+Real Snow
+*********
+
+This add-on allows you to add snow on top of objects.
+
+The main principle behind this addon is to add a particle system of metaballs
+on top of the selected object and transform it to mesh.
+
+.. figure:: /images/addons_object_real-snow_example.png
+   :align: center
+   :width: 700px
+
+
+Activation
+==========
+
+- Open Blender and go to Preferences then the Add-ons tab.
+- Click Object then Real Snow to enable the script.
+
+
+Usage
+=====
+
+#. Open the `Real Snow` tab available in the N sidebar of the 3D Viewport.
+#. Select objects you want to add snow on top.
+#. Change the parameters and click on the "Add Snow" button to generate the snow.
+
+.. note::
+
+  - The snow material use microdisplacement to achieve realistic result.
+    You need to change the `render engine` to Cycles and `Feature Set`
+    to experimental in order for microdisplacement to be working.
+  - You can also add snow only on part of an object by selecting the faces
+    in edit mode and activating the "Selected Faces" toggle in the panel.
+
+
+Parameters
+==========
+
+.. figure:: /images/addons_object_real-snow_ui.png
+   :align: right
+   :width: 220px
+
+Coverage
+   Percentage of the area to be covered by snow.
+Height
+   Height of the snow to apply (define the radius of the metaballs).
+Selected Faces
+   If enabled, only the selected faces will receive snow otherwise every face pointing up will be covered by snow.
+Add Snow
+   Adds the snow on the selected objects.
+
+.. reference::
+
+   :Category:  Object
+   :Description: Generate snow mesh.
+   :Location: :menuselection:`3D Viewport --> Properties Panel`
+   :File: real_snow.py
+   :Author: Marco Pavanello (Wolf), Leon Zandman (Izandman), Drew Perttula
+   :License: GPL
+   :Note: This add-on is bundled with Blender.


Property changes on: branches/blender-3.1-release/blender_docs/manual/addons/object/real_snow.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_example.png
===================================================================
(Binary files differ)

Index: branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_example.png
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_example.png	2022-02-28 18:19:54 UTC (rev 9053)
+++ branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_example.png	2022-02-28 18:53:56 UTC (rev 9054)

Property changes on: branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_example.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_ui.png
===================================================================
(Binary files differ)

Index: branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_ui.png
===================================================================
--- branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_ui.png	2022-02-28 18:19:54 UTC (rev 9053)
+++ branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_ui.png	2022-02-28 18:53:56 UTC (rev 9054)

Property changes on: branches/blender-3.1-release/blender_docs/manual/images/addons_object_real-snow_ui.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property