manual/modeling/geometry_nodes/index.rst

@@ -60,6 +60,14 @@ Node Types
 
 -----
 
+.. toctree::
+   :maxdepth: 3
+   :titlesonly:
+   
+   sound/index.rst
+
+-----
+
 .. toctree::
    :maxdepth: 3
    :titlesonly:

manual/modeling/geometry_nodes/input/constant/index.rst

@@ -14,6 +14,7 @@ Nodes used mainly as input to other nodes.
    integer.rst
    material.rst
    rotation.rst
+   sound.rst
    string.rst
    value.rst
    vector.rst

manual/modeling/geometry_nodes/input/constant/sound.rst

@@ -0,0 +1,38 @@
+.. index:: Geometry Nodes; Sound
+.. _bpy.types.GeometryNodeInputSound:
+
+**********
+Sound Node
+**********
+
+.. figure:: /images/node-types_GeometryNodeInputSound.webp
+   :align: right
+   :width: 300px
+
+   Sound node.
+
+The *Sound* node provides access to a sound file.
+
+.. seealso::
+
+   :doc:`/modeling/geometry_nodes/sound/sound_info`
+
+
+Inputs
+======
+
+This node has no inputs.
+
+
+Properties
+==========
+
+Sound Data-Block
+   The :ref:`data-block selector <ui-data-block>` to select an existing sound or open a sound from the file browser.
+
+
+Outputs
+=======
+
+Sound
+   The sound file chosen from the data-block selector.

manual/modeling/geometry_nodes/sound/index.rst

@@ -0,0 +1,10 @@
+
+###############
+  Sound Nodes
+###############
+
+.. toctree::
+   :maxdepth: 1
+
+   sample_sound.rst
+   sound_info.rst

manual/modeling/geometry_nodes/sound/sample_sound.rst

@@ -0,0 +1,57 @@
+.. index:: Geometry Nodes; Sample Sound
+.. _bpy.types.GeometryNodeSampleSound:
+
+*****************
+Sample Sound Node
+*****************
+
+.. figure:: /images/node-types_GeometryNodeSampleSound.webp
+   :align: center
+   :alt: Sample Sound node.
+
+The *Sample Sound* node retrieves amplitude from a sound at a specific time.
+
+Inputs
+======
+
+Sound
+   The sound to retrieve the amplitude from.
+
+Time
+   Sample time of the sound.
+
+Downmix to Mono
+   Downmix multiple audio channels into a single one (overrides the value of the Channel input).
+
+Channel
+   Which channel to be sampled from the input *Sound*.
+
+Low
+   The lower bound of frequency to be sampled.
+
+High
+   The upper bound of frequency to be sampled.
+
+Properties
+==========
+
+Window
+   Type of window function to apply.
+
+FFT Size
+   FFT size to use when sampling sound. Larger value means more frequency details and less
+   temporal details, while smaller value does the opposite.
+
+Outputs
+=======
+
+Amplitude
+   The amplitude computed from the source *Sound* input.
+
+Examples
+========
+
+.. figure:: /images/modeling_geometry-nodes_sample_sound-example.png
+   :align: center
+
+   Here the node is used to visualize part of the spectrum of a sound.

manual/modeling/geometry_nodes/sound/sound_info.rst

@@ -0,0 +1,36 @@
+.. index:: Geometry Nodes; Sound Info
+.. _bpy.types.GeometryNodeSoundInfo:
+
+***************
+Sound Info Node
+***************
+
+.. figure:: /images/node-types_GeometryNodeSoundInfo.webp
+   :align: right
+   :alt: Sound Info node.
+   :width: 300px
+
+
+The *Sound Info* node gets information from sound.
+This can be useful to generate parameters in the geometry node for arbitrary sounds.
+
+Inputs
+======
+
+Sound
+   Source sound to get parameters from.
+
+Properties
+==========
+
+This node has no properties.
+
+
+Outputs
+=======
+
+Audio Channels
+   Total channel amount of the sound.
+
+Sample Rate
+   Sample rate (in Hz) of the sound.