user: Give a detailed overview of ShaderNodeTexNoise(ShaderNode): syntax, arguments, return values, common patterns.

assistant: # ShaderNodeTexNoise(ShaderNode)

base classes — [`bpy_struct`](bpy.types.bpy_struct.html#bpy.types.bpy_struct "bpy.types.bpy_struct"), [`Node`](bpy.types.Node.html#bpy.types.Node "bpy.types.Node"), [`NodeInternal`](bpy.types.NodeInternal.html#bpy.types.NodeInternal "bpy.types.NodeInternal"), [`ShaderNode`](bpy.types.ShaderNode.html#bpy.types.ShaderNode "bpy.types.ShaderNode")

*class* bpy.types.ShaderNodeTexNoise(*ShaderNode*)
:   Generate fractal Perlin noise

    color_mapping
    :   Color mapping settings

        Type:
        :   [`ColorMapping`](bpy.types.ColorMapping.html#bpy.types.ColorMapping "bpy.types.ColorMapping"), (readonly, never None)

    noise_dimensions
    :   Number of dimensions to output noise for

        - `1D`
          1D – Use the scalar value W as input.
        - `2D`
          2D – Use the 2D vector (X, Y) as input. The Z component is ignored..
        - `3D`
          3D – Use the 3D vector (X, Y, Z) as input.
        - `4D`
          4D – Use the 4D vector (X, Y, Z, W) as input.

        Type:
        :   enum in [`'1D'`, `'2D'`, `'3D'`, `'4D'`], default `'1D'`

    noise_type
    :   Type of the Noise texture

        - `MULTIFRACTAL`
          Multifractal – More uneven result (varies with location), more similar to a real terrain.
        - `RIDGED_MULTIFRACTAL`
          Ridged Multifractal – Create sharp peaks.
        - `HYBRID_MULTIFRACTAL`
          Hybrid Multifractal – Create peaks and valleys with different roughness values.
        - `FBM`
          fBM – The standard fractal Perlin noise.
        - `HETERO_TERRAIN`
          Hetero Terrain – Similar to Hybrid Multifractal creates a heterogeneous terrain, but with the likeness of river channels.

        Type:
        :   enum in [`'MULTIFRACTAL'`, `'RIDGED_MULTIFRACTAL'`, `'HYBRID_MULTIFRACTAL'`, `'FBM'`, `'HETERO_TERRAIN'`], default `'MULTIFRACTAL'`

    normalize
    :   Normalize outputs to 0.0 to 1.0 range

        Type:
        :   boolean, default False

    texture_mapping
    :   Texture coordinate mapping settings

        Type:
        :   [`TexMapping`](bpy.types.TexMapping.html#bpy.types.TexMapping "bpy.types.TexMapping"), (readonly, never None)

    *classmethod* is_registered_node_type()
    :   True if a registered node type

        Returns:
        :   Result

        Return type:
        :   boolean

    *classmethod* input_template(*index*)
    :   Input socket template

        Parameters:
        :   **index** (*int in* *[**0**,* *inf**]*) – Index

        Returns:
        :   result

        Return type:
        :   [`NodeInternalSocketTemplate`](bpy.types.NodeInternalSocketTemplate.html#bpy.types.NodeInternalSocketTemplate "bpy.types.NodeInternalSocketTemplate")

    *classmethod* output_template(*index*)
    :   Output socket template

        Parameters:
        :   **index** (*int in* *[**0**,* *inf**]*) – Index

        Returns:
        :   result

        Return type:
        :   [`NodeInternalSocketTemplate`](bpy.types.NodeInternalSocketTemplate.html#bpy.types.NodeInternalSocketTemplate "bpy.types.NodeInternalSocketTemplate")

    *classmethod* bl_rna_get_subclass(*id*, *default=None*, */*)
    :   Parameters:
        :   **id** (*str*) – The RNA type identifier.

        Returns:
        :   The RNA type or default when not found.

        Return type:
        :   [`bpy.types.Struct`](bpy.types.Struct.html#bpy.types.Struct "bpy.types.Struct") subclass

    *classmethod* bl_rna_get_subclass_py(*id*, *default=None*, */*)
    :   Parameters:
        :   **id** (*str*) – The RNA type identifier.

        Returns:
        :   The class or default when not found.

        Return type:
        :   type