[Bf-docboard-svn] bf-manual: [8536] trunk/blender_docs/manual: Geometry Nodes: Texture nodes
Charlie Jolly
noreply at blender.org
Wed Oct 27 11:48:12 CEST 2021
Revision: 8536
https://developer.blender.org/rBM8536
Author: charlie
Date: 2021-10-27 11:48:11 +0200 (Wed, 27 Oct 2021)
Log Message:
-----------
Geometry Nodes: Texture nodes
Copy shader content and move notes below title.
Modified Paths:
--------------
trunk/blender_docs/manual/modeling/geometry_nodes/texture/brick.rst
trunk/blender_docs/manual/modeling/geometry_nodes/texture/checker.rst
trunk/blender_docs/manual/modeling/geometry_nodes/texture/gradient.rst
trunk/blender_docs/manual/modeling/geometry_nodes/texture/image.rst
trunk/blender_docs/manual/modeling/geometry_nodes/texture/magic.rst
trunk/blender_docs/manual/modeling/geometry_nodes/texture/musgrave.rst
trunk/blender_docs/manual/modeling/geometry_nodes/texture/noise.rst
trunk/blender_docs/manual/modeling/geometry_nodes/texture/voronoi.rst
trunk/blender_docs/manual/modeling/geometry_nodes/texture/wave.rst
trunk/blender_docs/manual/modeling/geometry_nodes/texture/white_noise.rst
Added Paths:
-----------
trunk/blender_docs/manual/images/modeling_geometry-nodes_texture-nodes_image_texture_node_example.jpg
Added: trunk/blender_docs/manual/images/modeling_geometry-nodes_texture-nodes_image_texture_node_example.jpg
===================================================================
(Binary files differ)
Index: trunk/blender_docs/manual/images/modeling_geometry-nodes_texture-nodes_image_texture_node_example.jpg
===================================================================
--- trunk/blender_docs/manual/images/modeling_geometry-nodes_texture-nodes_image_texture_node_example.jpg 2021-10-27 05:35:18 UTC (rev 8535)
+++ trunk/blender_docs/manual/images/modeling_geometry-nodes_texture-nodes_image_texture_node_example.jpg 2021-10-27 09:48:11 UTC (rev 8536)
Property changes on: trunk/blender_docs/manual/images/modeling_geometry-nodes_texture-nodes_image_texture_node_example.jpg
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/texture/brick.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/texture/brick.rst 2021-10-27 05:35:18 UTC (rev 8535)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/texture/brick.rst 2021-10-27 09:48:11 UTC (rev 8536)
@@ -1,6 +1,9 @@
.. index:: Geometry Nodes; Texture
-.. _bpy.types.ShaderNodeTexBrick:
+******************
+Brick Texture Node
+******************
+
.. note::
This node is ported from shader nodes. The manual and images are
@@ -8,4 +11,64 @@
This node accepts field inputs and outputs.
When not connected the Vector input has an implicit ``position`` attribute value.
-.. include:: /render/shader_nodes/textures/brick.rst
+.. figure:: /images/render_shader-nodes_textures_brick_node.png
+ :align: right
+
+ Brick Texture node.
+
+The *Brick Texture* is used to add a procedural texture producing bricks.
+
+
+Inputs
+======
+
+Color 1/2
+ Color of the bricks.
+Mortar
+ The color of the area between bricks.
+Scale
+ Overall texture scale.
+Mortar Size
+ The size of the filling between the bricks known as "mortar"; 0 means no mortar.
+Mortar Smooth
+ Blurs/softens the edge between the mortar and the bricks.
+ This can be useful with a texture and displacement textures.
+Bias
+ The color variation between *Color 1/2*.
+ Values of -1 and 1 only use one of the two colors; values in between mix the colors.
+Brick Width
+ The width of the bricks.
+Row Height
+ The height of the brick rows.
+
+
+Properties
+==========
+
+Offset
+ Determines the brick offset of the various rows.
+Frequency
+ Determines the offset frequency. A value of 2 gives an even/uneven pattern of rows.
+Squash
+ Amount of brick squashing.
+Frequency
+ Brick squashing frequency.
+
+
+Outputs
+=======
+
+Color
+ Texture color output.
+Factor
+ Mortar mask (1 = mortar).
+
+
+Examples
+========
+
+.. figure:: /images/render_shader-nodes_textures_brick_example.jpg
+ :width: 200px
+
+ Brick texture: Colors changed, Squash 0.62, Squash Frequency 3.
+
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/texture/checker.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/texture/checker.rst 2021-10-27 05:35:18 UTC (rev 8535)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/texture/checker.rst 2021-10-27 09:48:11 UTC (rev 8536)
@@ -1,6 +1,9 @@
.. index:: Geometry Nodes; Texture
-.. _bpy.types.ShaderNodeTexChecker:
+********************
+Checker Texture Node
+********************
+
.. note::
This node is ported from shader nodes. The manual and images are
@@ -8,4 +11,55 @@
This node accepts field inputs and outputs.
When not connected the Vector input has an implicit ``position`` attribute value.
-.. include:: /render/shader_nodes/textures/checker.rst
+.. figure:: /images/render_shader-nodes_textures_checker_node.png
+ :align: right
+
+ Checker Texture Node.
+
+The *Checker Texture* is used to add a checkerboard texture.
+
+
+Inputs
+======
+
+Vector
+ Texture coordinate to sample texture at;
+ defaults to Generated texture coordinates if the socket is left unconnected.
+
+ .. warning::
+
+ This node can have precision issues with some vector inputs.
+ See the notes for the :doc:`White Noise Texture </render/shader_nodes/textures/white_noise>`
+ for ways to mitigate this issue.
+
+Color1, Color 2
+ Color of the checkers.
+Scale
+ Overall texture scale. The scale is a factor of the bounding box of the face divided by the scale.
+ For example, a scale of 15 will result in 15 alternate patterns over the overall UV bounding box.
+ Different patterns could be achieved using other nodes to give different input patterns to this socket.
+ For example, using the Math Node.
+
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Color
+ Texture color output.
+Factor
+ Checker 1 mask (1 = Checker 1).
+
+
+Examples
+========
+
+.. figure:: /images/render_shader-nodes_textures_checker_example.jpg
+ :width: 200px
+
+ Default Checker texture.
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/texture/gradient.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/texture/gradient.rst 2021-10-27 05:35:18 UTC (rev 8535)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/texture/gradient.rst 2021-10-27 09:48:11 UTC (rev 8536)
@@ -1,6 +1,9 @@
.. index:: Geometry Nodes; Texture
-.. _bpy.types.ShaderNodeTexGradient:
+*********************
+Gradient Texture Node
+*********************
+
.. note::
This node is ported from shader nodes. The manual and images are
@@ -8,5 +11,53 @@
This node accepts field inputs and outputs.
When not connected the Vector input has an implicit ``position`` attribute value.
-.. include:: /render/shader_nodes/textures/gradient.rst
+.. figure:: /images/render_shader-nodes_textures_gradient_node.png
+ :align: right
+ Gradient Texture Node.
+
+The *Gradient Texture* node generates interpolated color and intensity values based on the input vector.
+
+
+Inputs
+======
+
+Vector
+ Texture coordinate to sample texture at;
+ defaults to Generated texture coordinates if the socket is left unconnected.
+
+
+Properties
+==========
+
+Type
+ Controls the type of gradient generated.
+
+ :Linear: Directly outputs the input X coordinate.
+ :Quadratic: Interpolates the input X coordinate quadratically.
+ :Easing: Uses a combination of quadratic and linear interpolation
+ to generate a smooth gradient from the input X coordinate.
+ :Diagonal: Averages the input X and Y coordinates.
+ :Spherical: Creates an inverse gradient using the length of the input vector; the maximum value is at (0, 0, 0).
+ :Quadratic Sphere: The same as Spherical, except interpolated quadratically.
+ :Radial: Outputs a value based on the angle of the input around the Z axis.
+
+
+Outputs
+=======
+
+Color
+ Texture color output.
+Factor
+ Texture intensity output.
+
+
+Examples
+========
+
+.. figure:: /images/render_shader-nodes_textures_gradient_example.jpg
+ :width: 200px
+
+ Gradient texture using object coordinates.
+
+
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/texture/image.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/texture/image.rst 2021-10-27 05:35:18 UTC (rev 8535)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/texture/image.rst 2021-10-27 09:48:11 UTC (rev 8536)
@@ -1,6 +1,10 @@
.. index:: Geometry Nodes; Texture
.. _bpy.types.GeoNodeImageTexture:
+******************
+Image Texture Node
+******************
+
.. note::
Unlike the other texture nodes, this node operates differently
@@ -7,12 +11,6 @@
in geometry nodes compared to the equivalent shader node.
When not connected the Vector input has an implicit ``position`` attribute value.
-.. _bpy.types.ShaderNodeTexImage:
-
-******************
-Image Texture Node
-******************
-
.. figure:: /images/modeling_geometry-nodes_texture-nodes_image_texture_node.jpg
:align: right
@@ -60,7 +58,15 @@
=======
Color
- RGBA color from the image. If the image has alpha, the color is premultiplied with alpha
- if the Alpha output is used, and unpremultiplied or straight if the Alpha output is not used.
+ RGBA color from the image.
Alpha
Alpha channel from image.
+
+Examples
+========
+
+.. figure:: /images/modeling_geometry-nodes_texture-nodes_image_texture_node_example.jpg
+
+ Image Texture displacing a plane.
+
+
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/texture/magic.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/texture/magic.rst 2021-10-27 05:35:18 UTC (rev 8535)
+++ trunk/blender_docs/manual/modeling/geometry_nodes/texture/magic.rst 2021-10-27 09:48:11 UTC (rev 8536)
@@ -1,6 +1,9 @@
.. index:: Geometry Nodes; Texture
-.. _bpy.types.ShaderNodeTexMagic:
+******************
+Magic Texture Node
+******************
+
.. note::
This node is ported from shader nodes. The manual and images are
@@ -8,4 +11,46 @@
This node accepts field inputs and outputs.
When not connected the Vector input has an implicit ``position`` attribute value.
-.. include:: /render/shader_nodes/textures/magic.rst
+.. figure:: /images/render_shader-nodes_textures_magic_node.png
+ :align: right
+
+ Magic Texture Node.
+
+The *Magic Texture* node is used to add a psychedelic color texture.
+
+
+Inputs
+======
+
+Vector
+ Texture coordinate to sample texture at;
+ defaults to Generated texture coordinates if the socket is left unconnected.
+Scale
+ Scale of the texture.
+Distortion
+ Amount of distortion.
+
+
+Properties
+==========
+
+Depth
+ Number of iterations.
+
+
+Outputs
+=======
+
+Color
+ Texture color output.
+Factor
+ Texture intensity output.
+
+
+Examples
+========
+
+.. figure:: /images/render_shader-nodes_textures_magic_example.jpg
+ :width: 200px
+
+ Magic texture: Depth 10, Distortion 2.0.
Modified: trunk/blender_docs/manual/modeling/geometry_nodes/texture/musgrave.rst
===================================================================
--- trunk/blender_docs/manual/modeling/geometry_nodes/texture/musgrave.rst 2021-10-27 05:35:18 UTC (rev 8535)
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list