TextureFractalNoise

TextureFractalNoise#

(Fractal Noise)

Category: /Texture/Procedural
Default object name: fractal_noise
Inherits from: ProjectItem > TextureOperator > Texture > TextureSpatial

Description#

Fractal noise texture based on Perlin noise.

Public Attributes#

Type	Name	Visual Hint	Description
`double[3]`	`color1`	`VISUAL_HINT_COLOR`	Set the high color value.
`double[3]`	`color2`	`VISUAL_HINT_COLOR`	Set the low color value.
`double`	`increment`	`VISUAL_HINT_DEFAULT`	Define how recursion levels are composited.
`double`	`lacunarity`	`VISUAL_HINT_DEFAULT`	Define the scaling of the texture independently from the projection.
`double`	`octaves`	`VISUAL_HINT_DEFAULT`	Define the number of recursions in the noise. Higher values give more detailed textures.
`double`	`contrast`	`VISUAL_HINT_PERCENTAGE`	Contrast the noise value from 0.5 value.
`bool`	`turbulent`	`VISUAL_HINT_DEFAULT`	If checked, do no allow negative noise values.
`bool`	`normalize`	`VISUAL_HINT_DEFAULT`	If checked, normalize the noise values.

Inherited Public Attributes#

Type	Name	Visual Hint	Description
`bool`	`pass_through`	`VISUAL_HINT_DEFAULT`	If checked, the current texture is not evaluated and the value of the attribute selected in Pass Through Attribute is directly forwarded.
`string`	`master_input`	`VISUAL_HINT_TAG`	Name of the attribute that will be used as output if Pass Through is enabled.
`bool`	`invert`	`VISUAL_HINT_DEFAULT`	If checked, the texture is inverted.
`double`	`opacity`	`VISUAL_HINT_PERCENTAGE`	Set the opacity of the texture.
`long`	`projection`	`VISUAL_HINT_DEFAULT`	Define the projection used to evaluate the texture.
`long`	`space`	`VISUAL_HINT_DEFAULT`	Define whether the texture is evaluated in 2D or 3D. In 2D space, the texture is stretched along the projection axis whereas in 3D space all components are used.
`long`	`axis`	`VISUAL_HINT_DEFAULT`	Define the projection axis.
`reference` (`UvSlot`)	`uv_slot`	`VISUAL_HINT_DEFAULT`	Define which UV slot is used when the project mode is set to UV.
`long`	`object_space`	`VISUAL_HINT_DEFAULT`	Set the space in which the object must be considered when computing the projection.
`string`	`reference_positions`	`VISUAL_HINT_TAG`	Set the name of the property that contains reference positions of the geometry that have to be used when computing projections.
`string`	`uv_property`	`VISUAL_HINT_TAG`	Set the name of the property that contains uv's of the geometry that have to be used when computing projections.
`reference` (`Camera`)	`camera`	`VISUAL_HINT_DEFAULT`	Define which camera is used when the texture is in Camera projection mode.
`bool`	`camera_occlusion`	`VISUAL_HINT_DEFAULT`	When on the texture looks for potential occluder between the sample position and the camera. If no occluder is found the sample gets mapped.
`reference` (`Group`)	`camera_occluders`	`VISUAL_HINT_GROUP`	Define which geometries are occluders when camera occlusion is enabled. By default it uses the 3D layer geometries.
`reference` (`SceneItem`)	`reference_object`	`VISUAL_HINT_DEFAULT`	If an object is selected, the texture will use the object's transformation matrix to compute the texture coordinates.
`double[3]`	`projection_translate`	`VISUAL_HINT_DISTANCE`	Offset the position of the projection. Enable with Planar, Cylindrical, Spherical, Cubic.
`double[3]`	`projection_rotate`	`VISUAL_HINT_ANGLE`	Offset the rotation of the projection. Enable with Planar, Cylindrical, Spherical, Cubic.
`double[3]`	`projection_scale`	`VISUAL_HINT_SCALE`	Offset the scaling of the projection. Enable with Planar, Cylindrical, Spherical, Cubic.
`action`	`fit_to_bounding_box`	`VISUAL_HINT_DEFAULT`
`double[3]`	`uv_translate`	`VISUAL_HINT_DISTANCE`	Offset the UV by the specified values in UVW space.
`double[3]`	`uv_rotate`	`VISUAL_HINT_ANGLE`	Rotate the UV by the specified values in UVW space.
`double[3]`	`uv_scale`	`VISUAL_HINT_SCALE`	Scale the UV by the specified values in UVW space.

CID#

class "TextureFractalNoise" "TextureSpatial" {
    #version 0.91
    icon "../icons/object_icons/texture_fractal_noise.iconrc"
    category "/Texture/Procedural"
    doc "Fractal noise texture based on Perlin noise."
    attribute_group "pattern" {
        color "color1" {
            doc "Set the high color value."
            texturable yes
            animatable yes
            value 0.78 0.78 0.78
        }
        color "color2" {
            doc "Set the low color value."
            texturable yes
            animatable yes
            value 0.0 0.0 0.0
        }
        double "increment" {
            doc "Define how recursion levels are composited."
            texturable yes
            animatable yes
            ui_range yes 0.0 5
            value 0.5
        }
        double "lacunarity" {
            doc "Define the scaling of the texture independently from the projection."
            texturable yes
            animatable yes
            ui_range yes 0.01 6
            value 2
        }
        double "octaves" {
            doc "Define the number of recursions in the noise. Higher values give more detailed textures."
            texturable yes
            animatable yes
            ui_range yes 0.01 10
            value 6
        }
        percentage "contrast" {
            doc "Contrast the noise value from 0.5 value."
            texturable yes
            animatable yes
            ui_range yes 0.0 1
            value 0.0
        }
        bool "turbulent" {
            doc "If checked, do no allow negative noise values."
            animatable yes
            value yes
        }
        bool "normalize" {
            doc "If checked, normalize the noise values."
            animatable yes
            value yes
        }
    }
    set "master_input" {
        private no
        hidden no
        saveable yes
        texturable no
        animatable no
        slider no
        numeric_range no 0.0 1
        ui_range no 0.0 1
        dg_active yes
        dg_cyclic no
        dirtiness_pass_through no
        read_only no
        shading_variable no
        experimental no
        advanced no
        overriden no
        promote_attribute no
        allow_expression yes
        localizable yes
        value "color1"
    }
}