[Bf-docboard-svn] bf-manual: [8475] trunk/blender_docs/manual/modeling/geometry_nodes: Geometry Nodes: Massive Cleanup and Organization
Dalai Felinto
noreply at blender.org
Thu Oct 14 18:36:43 CEST 2021
Revision: 8475
https://developer.blender.org/rBM8475
Author: dfelinto
Date: 2021-10-14 18:36:42 +0200 (Thu, 14 Oct 2021)
Log Message:
-----------
Geometry Nodes: Massive Cleanup and Organization
This is a preparation to have the Geometry Nodes 3.0 nodes documented.
Right now the categories are up-to-date, and the index.rst have all the
nodes included until rB2341ca990c17.
Notes:
* The bpy.types of most of the nodes is still wrong.
* A lot of the existing nodes pages need update.
* The non-node pages are still mostly outdated.
Some nodes have a similar version coming up. But since they were not in
master yet, I just removed their old page.
(the old unused images are still around though).
---
Current nodes without documentation:
* attribute_statistic.rst
* capture_attribute.rst
* fillet_curve.rst
* sample_curve.rst
* curve_handle_position.rst
* curve_parameter.rst
* curve_tangent.rst
* curve_tilt.rst
* is_spline_cyclic.rst
* spline_length.rst
* spline_resolution.rst
* set_curve_radius.rst
* set_curve_tilt.rst
* set_handle_positions.rst
* set_handle_type.rst
* set_spline_cyclic.rst
* set_spline_resolution.rst
* set_position.rst
* color.rst
* input_index.rst
* normal.rst
* position.rst
* radius.rst
* realize_instances.rst
* rotate_instances.rst
* scale_instances.rst
* translate_instances.rst
* material_index.rst
* material_selection.rst
* set_material_index.rst
* points_to_vertices.rst
* is_shade_smooth.rst
* set_shade_smooth.rst
* points_to_vertices.rst
* set_point_radius.rst
* join_strings.rst
* special_characters.rst
* string_length.rst
* string_substring.rst
* string_to_curves.rst
* value_to_string.rst
* noise_texture.rst
* white_noise_texture.rst
* random_value.rst
* rotate_euler.rst
Modified Paths:
--------------
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve_primitives/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/geometry/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/input/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/material/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh_primitives/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/volume/index.rst
Added Paths:
-----------
trunk/blender_docs/manual/modeling/geometry_nodes/curve_primitives/curve_circle.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve_primitives/curve_line.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve_primitives/curve_spiral.rst
trunk/blender_docs/manual/modeling/geometry_nodes/geometry/separate_geometry.rst
trunk/blender_docs/manual/modeling/geometry_nodes/instances/
trunk/blender_docs/manual/modeling/geometry_nodes/instances/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/instances/instance_on_points.rst
trunk/blender_docs/manual/modeling/geometry_nodes/material/set_material.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/subdivide_mesh.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh_primitives/mesh_circle.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh_primitives/mesh_line.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/distribute_points_on_faces.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/points_to_volume.rst
trunk/blender_docs/manual/modeling/geometry_nodes/text/
trunk/blender_docs/manual/modeling/geometry_nodes/text/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/texture/
trunk/blender_docs/manual/modeling/geometry_nodes/texture/index.rst
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/align_euler_to_vector.rst
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare_floats.rst
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/float_to_integer.rst
Removed Paths:
-------------
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_clamp.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_color_ramp.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_combine_xyz.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_compare.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_convert.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_curve_map.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_fill.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_map_range.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_math.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_mix.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_proximity.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_randomize.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_remove.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_sample_texture.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_separate_xyz.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_transfer.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_vector_math.rst
trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_vector_rotate.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/curve_endpoints.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/curve_to_points.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve/mesh_to_curve.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve_primitives/circle.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve_primitives/line.rst
trunk/blender_docs/manual/modeling/geometry_nodes/curve_primitives/spiral.rst
trunk/blender_docs/manual/modeling/geometry_nodes/geometry/raycast.rst
trunk/blender_docs/manual/modeling/geometry_nodes/input/random_float.rst
trunk/blender_docs/manual/modeling/geometry_nodes/material/assign_material.rst
trunk/blender_docs/manual/modeling/geometry_nodes/material/select_by_material.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh/subdivide.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh_primitives/circle.rst
trunk/blender_docs/manual/modeling/geometry_nodes/mesh_primitives/line.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/align_rotation_to_vector.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/point_distribute.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/point_instance.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/point_rotate.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/point_scale.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/point_separate.rst
trunk/blender_docs/manual/modeling/geometry_nodes/point/point_translate.rst
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/compare_float.rst
trunk/blender_docs/manual/modeling/geometry_nodes/utilities/float_to_int.rst
trunk/blender_docs/manual/modeling/geometry_nodes/volume/points_to_volume.rst
Deleted: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_clamp.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_clamp.rst 2021-10-14 16:33:54 UTC (rev 8474)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_clamp.rst 2021-10-14 16:36:42 UTC (rev 8475)
@@ -1,61 +0,0 @@
-.. index:: Geometry Nodes; Attribute Clamp
-.. _bpy.types.GeometryNodeAttributeClamp:
-
-********************
-Attribute Clamp Node
-********************
-
-.. warning::
-
- This node is considered legacy and will be removed in Blender 4.0.
-
- Please use the :doc:`/modeling/geometry_nodes/utilities/clamp` instead.
-
-.. figure:: /images/modeling_geometry-nodes_attribute_attribute-clamp_node.png
- :align: right
-
- The Attribute Clamp node.
-
-This node inputs one attribute and clamps the values and writes these to the result attribute.
-
-
-Inputs
-======
-
-Geometry
- Standard geometry input.
-
-Attribute
- Name of the attribute that is to be clamped.
-
-Result
- Name of the attribute where the computed result is stored.
- If an attribute with this name does not exist yet, a new attribute is added.
- If it does exist, the values of the attribute are overridden.
-
-Min
- Minimum value. This socket changes according to data type selected.
-
-Max
- Maximum value. This socket changes according to data type selected.
-
-
-Properties
-==========
-
-Data Type
- This determines the data type of the result attribute.
- This also changes the Min and Max inputs to match the data type.
-
-Operation
- This determines how the data is clamped.
-
- :Min Max: Constrain value between min and max.
- :Range: Constrain value between min and max, swapping inputs when min is greater than max.
-
-
-Output
-======
-
-Geometry
- Standard geometry output.
Deleted: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_color_ramp.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_color_ramp.rst 2021-10-14 16:33:54 UTC (rev 8474)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_color_ramp.rst 2021-10-14 16:36:42 UTC (rev 8475)
@@ -1,49 +0,0 @@
-.. index:: Geometry Nodes; Attribute Color Ramp
-.. _bpy.types.GeometryNodeAttributeColorRamp:
-
-*************************
-Attribute Color Ramp Node
-*************************
-
-.. warning::
-
- This node is considered legacy and will be removed in Blender 4.0.
-
- Please use the :doc:`/modeling/geometry_nodes/color/color_ramp` instead.
-
-Maps values from a float attribute to their corresponding color, based on a color ramp.
-The resulting colors are stored on the geometry in a color attribute.
-
-.. figure:: /images/modeling_geometry-nodes_attribute_attribute-color-ramp_node.png
- :align: center
-
- Attribute Color Ramp Node.
-
-
-Inputs
-======
-
-Geometry
- Standard geometry input.
-
-Attribute
- Name of the attribute that is used as input.
- It should be a float attribute with values between zero and one.
-
-Result
- Name of the attribute where the output is stored.
- If the attribute does not exist yet, it is created.
-
-
-Properties
-==========
-
-Color Ramp
- For controls see :ref:`ui-color-ramp-widget`.
-
-
-Outputs
-=======
-
-Geometry
- Standard geometry output.
Deleted: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_combine_xyz.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_combine_xyz.rst 2021-10-14 16:33:54 UTC (rev 8474)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_combine_xyz.rst 2021-10-14 16:36:42 UTC (rev 8475)
@@ -1,52 +0,0 @@
-.. index:: Geometry Nodes; Attribute Combine XYZ
-
-**************************
-Attribute Combine XYZ Node
-**************************
-
-.. warning::
-
- This node is considered legacy and will be removed in Blender 4.0.
-
- Please use the :doc:`/modeling/geometry_nodes/vector/combine_xyz` instead.
-
-.. figure:: /images/modeling_geometry-nodes_attribute_attribute-combine-xyz_node.png
- :align: right
-
- Attribute Combine XYZ Node.
-
-The *Attribute Combine XYZ Node* combines a vector attribute from individual components.
-
-
-Inputs
-======
-
-Geometry
- Standard geometry input.
-
-X, Y, Z
- The inputs to the components of the vector.
-
-Result
- The name of the attribute where the computed vector is stored.
- A new attribute with that name is added if it does not exist yet.
- If it does exist, the values of the existing attribute are overridden.
-
-.. note::
-
- The resulting vector is not normalized.
-
-
-Properties
-==========
-
-X, Y, Z
- :Attribute: The input is a text field that expects an attribute name.
- :Float: The input is a float number.
-
-
-Output
-======
-
-Geometry
- Standard geometry output.
Deleted: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_compare.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_compare.rst 2021-10-14 16:33:54 UTC (rev 8474)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_compare.rst 2021-10-14 16:36:42 UTC (rev 8475)
@@ -1,67 +0,0 @@
-.. index:: Geometry Nodes; Attribute Compare
-.. _bpy.types.GeometryNodeAttributeCompare:
-
-**********************
-Attribute Compare Node
-**********************
-
-.. warning::
-
- This node is considered legacy and will be removed in Blender 4.0.
-
- Please use the :doc:`/modeling/geometry_nodes/utilities/compare_float` instead.
-
-.. figure:: /images/modeling_geometry-nodes_attribute_attribute-compare_node.png
- :align: right
-
- The Attribute Compare node.
-
-This node reads two input attributes as floats and allows for basic elementwise comparison operations.
-Like the :doc:`Attribute Math </modeling/geometry_nodes/attribute/attribute_math>` node,
-it is also possible to switch to using single values as inputs. This node can be combined with
-the :doc:`Point Separate </modeling/geometry_nodes/point/point_separate>` node for more control over
-which points to separate to the second output geometry.
-
-
-Inputs
-======
-
-Geometry
- Standard geometry input.
-
-A, B
- The first and second input to the math operation.
- Depending on the *Type* input, this is either an attribute name or an input of the specified data type.
-
-Threshold
- This value is used as a threshold for still considering the two inputs as equal for
- the *Equal* and *Not Equal* operations.
-
-Result
- Name of the attribute where the computed result is stored.
- If an attribute with this name does not exist yet, a new attribute with a Boolean data type is added.
- If it does exist, the values of the existing attribute are overridden.
-
-
-Properties
-==========
-
-Operation
- The math function to apply.
-
- .. note::
-
- For operations besides *Equal* and *Not Equal*, the input attributes
- are converted implicitly to the float data type.
- For the equality operations on vectors, the distance between
- the vector inputs is used.
-
-Type A, B
- Controls whether to use an attribute or a single value of the specified data type as an input.
-
-
-Output
-======
-
-Geometry
- Standard geometry output.
Deleted: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_convert.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_convert.rst 2021-10-14 16:33:54 UTC (rev 8474)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_convert.rst 2021-10-14 16:36:42 UTC (rev 8475)
@@ -1,74 +0,0 @@
-.. index:: Geometry Nodes; Attribute Convert
-.. _bpy.types.GeometryNodeAttributeConvert:
-
-**********************
-Attribute Convert Node
-**********************
-
-.. warning::
-
- This node is considered legacy and will be removed in Blender 4.0.
-
-.. figure:: /images/modeling_geometry-nodes_attribute_attribute-convert_node.png
- :align: right
-
- The Attribute Convert node.
-
-This node reads one input attribute and converts the data type and domain to the result attribute.
-The data type conversion is determined by a set of built-in implicit conversion rules.
-These rules are also used when connecting sockets with different data types. Additional information can be found
-in the :doc:`Node Socket </interface/controls/nodes/parts>` section of the manual.
-
-.. note::
-
- The data conversion rules are not editable. When converting a vector to a float,
- the implicit rule may not be desired. In this case it is recommended to
- use :doc:`Attribute Math </modeling/geometry_nodes/attribute/attribute_math>` nodes
- together with :doc:`Attribute Combine </modeling/geometry_nodes/attribute/attribute_combine_xyz>`
- and :doc:`Attribute Separate </modeling/geometry_nodes/attribute/attribute_separate_xyz>` nodes to
- achieve the desired result.
-
-
-Inputs
-======
-
-Geometry
- Standard geometry input.
-
-Attribute
- Name of the attribute that is to be converted.
-
-Result
- Name of the attribute where the computed result is stored.
- If an attribute with this name does not exist yet, a new attribute is added.
- If it does exist, the values of the attribute are overridden.
-
-
-Properties
-==========
-
-Domain
- This determines which domain is to be used to save the result attribute.
- Where the source attribute resides on a different domain, the data is interpolated.
-
- :Auto:
- Chooses the domain based on the following rules.
-
- #. If the result attribute already exists, use that domain.
- #. If the result attribute doesn't exist, use the source attribute domain.
- #. Otherwise use the default domain (points).
- :Point: Store the resulting attribute per point.
- :Edge: Store the resulting attribute per edge.
- :Face: Store the resulting attribute per face.
- :Face Corner: Store the resulting attribute per face corner.
-
-Data Type
- This determines the data type of the result attribute.
- If this is set to *Auto*, the data type from the original attribute is used.
-
-
-Output
-======
-
-Geometry
- Standard geometry output.
Deleted: trunk/blender_docs/manual/modeling/geometry_nodes/attribute/attribute_curve_map.rst
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list