[Bf-docboard-svn] bf-manual: [8878] trunk/blender_docs/manual: Geometry Nodes: new Geometry to Instance node

[Hans Goudey]

Revision: 8878
          https://developer.blender.org/rBM8878
Author:   HooglyBoogly
Date:     2022-01-26 06:07:47 +0100 (Wed, 26 Jan 2022)
Log Message:
-----------
Geometry Nodes: new Geometry to Instance node

rB565b33c0ad31966b860123837d2c4b5a8cbedad2

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_instance.png
    trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_node.png
    trunk/blender_docs/manual/modeling/geometry_nodes/geometry/geometry_to_instance.rst

Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_instance.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_instance.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_instance.png	2022-01-26 04:49:07 UTC (rev 8877)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_instance.png	2022-01-26 05:07:47 UTC (rev 8878)

Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_instance.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_node.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_node.png
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_node.png	2022-01-26 04:49:07 UTC (rev 8877)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_node.png	2022-01-26 05:07:47 UTC (rev 8878)

Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_geometry_geometry-to-instance_node.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property
Added: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/geometry_to_instance.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/geometry_to_instance.rst	                        (rev 0)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/geometry_to_instance.rst	2022-01-26 05:07:47 UTC (rev 8878)
@@ -0,0 +1,60 @@
+.. index:: Geometry Nodes; Geometry to Instance
+.. _bpy.types.GeometryNodeGeometryToInstance:
+
+*************************
+Geometry to Instance Node
+*************************
+
+.. figure:: /images/modeling_geometry-nodes_geometry_geometry-to-instance_node.png
+   :align: right
+
+   The Geometry to Instance node.
+
+The *Geometry to Instance* node turns every connected input geometry into an instance.
+Visually, the node has a similar result as the :doc:`/modeling/geometry_nodes/geometry/join_geometry`,
+but it outputs the result as separate instances instead. The geometry data itself isn't actually
+joined.
+
+The node can be used in combination with the *Pick Instances* option in the
+:doc:`/modeling/geometry_nodes/instances/instance_on_points`, as a way to pick
+between geometry generated in the node tree (as opposed to picking from separate
+instances from the :doc:`/modeling/geometry_nodes/input/collection_info`, for example).
+
+.. tip::
+
+   This node can be much faster than the join geometry node when the inputs are large geometries.
+   This is because the join geometry node must actually create a larger mesh, or a larger curve.
+   Even though the operation is simple, just creating a large mesh can have a significant cost.
+   This node can be better, because instead of merging large geometries, it just groups them
+   together as instances.
+
+
+Inputs
+======
+
+Geometry
+   Geometry that will be joined. Multiple inputs are allowed.
+   When the node is muted, only the first link will be passed through.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Output
+======
+
+Geometry
+   Standard geometry output.
+
+
+Examples
+========
+
+.. figure:: /images/modeling_geometry-nodes_geometry_geometry-to-instance_instance.png
+   :align: center
+
+The node used in combination with the :doc:`/modeling/geometry_nodes/instances/instance_on_points`
+to choose between multiple primitives for instancing.


Property changes on: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/geometry_to_instance.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst	2022-01-26 04:49:07 UTC (rev 8877)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst	2022-01-26 05:07:47 UTC (rev 8878)
@@ -12,6 +12,7 @@
    convex_hull.rst
    delete_geometry.rst
    geometry_proximity.rst
+   geometry_to_instance.rst
    join_geometry.rst
    raycast.rst
    separate_components.rst