TextureMultiBlend

TextureMultiBlend#

(Multi Blend)

Category: Texture/Color
Default object name: multi_blend
Inherits from: ProjectItem > TextureOperator > Texture

Description#

Provides a comprehensive blend node with 8 layers instead of 2.

Public Attributes#

Type	Name	Visual Hint	Description
`bool`	`enable_layer_1`	`VISUAL_HINT_DEFAULT`	Enables/disables the first layer.
`string`	`layer_1_label`	`VISUAL_HINT_DEFAULT`	Label of the first layer. Purely cosmetic, to help remember what the layer is about.
`double[3]`	`layer_1_color`	`VISUAL_HINT_COLOR`	Color of the first layer.
`double`	`layer_1_weight`	`VISUAL_HINT_PERCENTAGE`	Mask of the first layer.
`bool`	`enable_layer_2`	`VISUAL_HINT_DEFAULT`	Enables/disables the second layer.
`string`	`layer_2_label`	`VISUAL_HINT_DEFAULT`	Label of the second layer. Purely cosmetic, to help remember what the layer is about.
`long`	`layer_2_mode`	`VISUAL_HINT_DEFAULT`	Blending mode of the second layer.
`double[3]`	`layer_2_color`	`VISUAL_HINT_COLOR`	Color of the second layer.
`double`	`layer_2_mix`	`VISUAL_HINT_PERCENTAGE`	Mask of the second layer.
`bool`	`enable_layer_3`	`VISUAL_HINT_DEFAULT`	Enables/disables the third layer.
`string`	`layer_3_label`	`VISUAL_HINT_DEFAULT`	Label of the third layer. Purely cosmetic, to help remember what the layer is about.
`long`	`layer_3_mode`	`VISUAL_HINT_DEFAULT`	Blending mode of the third layer.
`double[3]`	`layer_3_color`	`VISUAL_HINT_COLOR`	Color of the third layer.
`double`	`layer_3_mix`	`VISUAL_HINT_PERCENTAGE`	Mask of the third layer.
`bool`	`enable_layer_4`	`VISUAL_HINT_DEFAULT`	Enables/disables the fourth layer.
`string`	`layer_4_label`	`VISUAL_HINT_DEFAULT`	Label of the fourth layer. Purely cosmetic, to help remember what the layer is about.
`long`	`layer_4_mode`	`VISUAL_HINT_DEFAULT`	Blending mode of the fourth layer.
`double[3]`	`layer_4_color`	`VISUAL_HINT_COLOR`	Color of the fourth layer.
`double`	`layer_4_mix`	`VISUAL_HINT_PERCENTAGE`	Mask of the fourth layer.
`bool`	`enable_layer_5`	`VISUAL_HINT_DEFAULT`	Enables/disables the fifth layer.
`string`	`layer_5_label`	`VISUAL_HINT_DEFAULT`	Label of the fifth layer. Purely cosmetic, to help remember what the layer is about.
`long`	`layer_5_mode`	`VISUAL_HINT_DEFAULT`	Blending mode of the fifth layer.
`double[3]`	`layer_5_color`	`VISUAL_HINT_COLOR`	Color of the fifth layer.
`double`	`layer_5_mix`	`VISUAL_HINT_PERCENTAGE`	Mask of the fifth layer.
`bool`	`enable_layer_6`	`VISUAL_HINT_DEFAULT`	Enables/disables the sixth layer.
`string`	`layer_6_label`	`VISUAL_HINT_DEFAULT`	Label of the sixth layer. Purely cosmetic, to help remember what the layer is about.
`long`	`layer_6_mode`	`VISUAL_HINT_DEFAULT`	Blending mode of the sixth layer.
`double[3]`	`layer_6_color`	`VISUAL_HINT_COLOR`	Color of the sixth layer.
`double`	`layer_6_mix`	`VISUAL_HINT_PERCENTAGE`	Mask of the sixth layer.
`bool`	`enable_layer_7`	`VISUAL_HINT_DEFAULT`	Enables/disables the seventh layer.
`string`	`layer_7_label`	`VISUAL_HINT_DEFAULT`	Label of the seventh layer. Purely cosmetic, to help remember what the layer is about.
`long`	`layer_7_mode`	`VISUAL_HINT_DEFAULT`	Blending mode of the seventh layer.
`double[3]`	`layer_7_color`	`VISUAL_HINT_COLOR`	Color of the seventh layer.
`double`	`layer_7_mix`	`VISUAL_HINT_PERCENTAGE`	Mask of the seventh layer.
`bool`	`enable_layer_8`	`VISUAL_HINT_DEFAULT`	Enables/disables the eighth layer.
`string`	`layer_8_label`	`VISUAL_HINT_DEFAULT`	Label of the eighth layer. Purely cosmetic, to help remember what the layer is about.
`long`	`layer_8_mode`	`VISUAL_HINT_DEFAULT`	Blending mode of the eighth layer.
`double[3]`	`layer_8_color`	`VISUAL_HINT_COLOR`	Color of the eighth layer.
`double`	`layer_8_mix`	`VISUAL_HINT_PERCENTAGE`	Mask of the eighth layer.
`bool`	`enable_clamping`	`VISUAL_HINT_DEFAULT`	Enables/disables clamping of the overall result. When disabled, the result can take any values, including negative ones.
`double`	`min_value`	`VISUAL_HINT_DEFAULT`	Minimum value over which each channel of the result will be clamped.
`double`	`max_value`	`VISUAL_HINT_DEFAULT`	Maximum value under which each channel of the result will be clamped.

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.

CID#

class "TextureMultiBlend" "Texture" {
    #version 1
    icon "../icons/object_icons/texture_multiblend.iconrc"
    category "Texture/Color"
    doc "Provides a comprehensive blend node with 8 layers instead of 2."
    attribute_group "input>layer_1" {
        bool "enable_layer_1" {
            doc "Enables/disables the first layer."
            value yes
        }
        string "layer_1_label" {
            doc "Label of the first layer. Purely cosmetic, to help remember what the layer is about."
            output "none"
            value ""
        }
        color "layer_1_color" {
            doc "Color of the first layer."
            texturable yes
            animatable yes
            value 1 1 1
        }
        percentage "layer_1_weight" {
            doc "Mask of the first layer."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            value 1
        }
    }
    attribute_group "input>layer_2" {
        bool "enable_layer_2" {
            doc "Enables/disables the second layer."
            value yes
        }
        string "layer_2_label" {
            doc "Label of the second layer. Purely cosmetic, to help remember what the layer is about."
            output "none"
            value ""
        }
        long "layer_2_mode" {
            doc "Blending mode of the second layer."
            preset "Over" "0"
            preset "Multiply" "1"
            preset "Divide" "2"
            preset "Screen" "3"
            preset "Overlay" "4"
            preset "Difference" "5"
            preset "Addition" "6"
            preset "Subtract" "7"
            preset "Darken only" "8"
            preset "Lighten only" "9"
            preset "Normal mapping" "10"
            value 0
        }
        color "layer_2_color" {
            doc "Color of the second layer."
            texturable yes
            animatable yes
            value 1 1 1
        }
        percentage "layer_2_mix" {
            doc "Mask of the second layer."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            value 1
        }
    }
    attribute_group "input>layer_3" {
        collapsed yes
        bool "enable_layer_3" {
            doc "Enables/disables the third layer."
            value no
        }
        string "layer_3_label" {
            doc "Label of the third layer. Purely cosmetic, to help remember what the layer is about."
            output "none"
            read_only yes
            value ""
        }
        long "layer_3_mode" {
            doc "Blending mode of the third layer."
            read_only yes
            preset "Over" "0"
            preset "Multiply" "1"
            preset "Divide" "2"
            preset "Screen" "3"
            preset "Overlay" "4"
            preset "Difference" "5"
            preset "Addition" "6"
            preset "Subtract" "7"
            preset "Darken only" "8"
            preset "Lighten only" "9"
            preset "Normal mapping" "10"
            value 0
        }
        color "layer_3_color" {
            doc "Color of the third layer."
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        percentage "layer_3_mix" {
            doc "Mask of the third layer."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            read_only yes
            value 1
        }
    }
    attribute_group "input>layer_4" {
        collapsed yes
        bool "enable_layer_4" {
            doc "Enables/disables the fourth layer."
            value no
        }
        string "layer_4_label" {
            doc "Label of the fourth layer. Purely cosmetic, to help remember what the layer is about."
            output "none"
            read_only yes
            value ""
        }
        long "layer_4_mode" {
            doc "Blending mode of the fourth layer."
            read_only yes
            preset "Over" "0"
            preset "Multiply" "1"
            preset "Divide" "2"
            preset "Screen" "3"
            preset "Overlay" "4"
            preset "Difference" "5"
            preset "Addition" "6"
            preset "Subtract" "7"
            preset "Darken only" "8"
            preset "Lighten only" "9"
            preset "Normal mapping" "10"
            value 0
        }
        color "layer_4_color" {
            doc "Color of the fourth layer."
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        percentage "layer_4_mix" {
            doc "Mask of the fourth layer."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            read_only yes
            value 1
        }
    }
    attribute_group "input>layer_5" {
        collapsed yes
        bool "enable_layer_5" {
            doc "Enables/disables the fifth layer."
            value no
        }
        string "layer_5_label" {
            doc "Label of the fifth layer. Purely cosmetic, to help remember what the layer is about."
            output "none"
            read_only yes
            value ""
        }
        long "layer_5_mode" {
            doc "Blending mode of the fifth layer."
            read_only yes
            preset "Over" "0"
            preset "Multiply" "1"
            preset "Divide" "2"
            preset "Screen" "3"
            preset "Overlay" "4"
            preset "Difference" "5"
            preset "Addition" "6"
            preset "Subtract" "7"
            preset "Darken only" "8"
            preset "Lighten only" "9"
            preset "Normal mapping" "10"
            value 0
        }
        color "layer_5_color" {
            doc "Color of the fifth layer."
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        percentage "layer_5_mix" {
            doc "Mask of the fifth layer."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            read_only yes
            value 1
        }
    }
    attribute_group "input>layer_6" {
        collapsed yes
        bool "enable_layer_6" {
            doc "Enables/disables the sixth layer."
            value no
        }
        string "layer_6_label" {
            doc "Label of the sixth layer. Purely cosmetic, to help remember what the layer is about."
            output "none"
            read_only yes
            value ""
        }
        long "layer_6_mode" {
            doc "Blending mode of the sixth layer."
            read_only yes
            preset "Over" "0"
            preset "Multiply" "1"
            preset "Divide" "2"
            preset "Screen" "3"
            preset "Overlay" "4"
            preset "Difference" "5"
            preset "Addition" "6"
            preset "Subtract" "7"
            preset "Darken only" "8"
            preset "Lighten only" "9"
            preset "Normal mapping" "10"
            value 0
        }
        color "layer_6_color" {
            doc "Color of the sixth layer."
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        percentage "layer_6_mix" {
            doc "Mask of the sixth layer."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            read_only yes
            value 1
        }
    }
    attribute_group "input>layer_7" {
        collapsed yes
        bool "enable_layer_7" {
            doc "Enables/disables the seventh layer."
            value no
        }
        string "layer_7_label" {
            doc "Label of the seventh layer. Purely cosmetic, to help remember what the layer is about."
            output "none"
            read_only yes
            value ""
        }
        long "layer_7_mode" {
            doc "Blending mode of the seventh layer."
            read_only yes
            preset "Over" "0"
            preset "Multiply" "1"
            preset "Divide" "2"
            preset "Screen" "3"
            preset "Overlay" "4"
            preset "Difference" "5"
            preset "Addition" "6"
            preset "Subtract" "7"
            preset "Darken only" "8"
            preset "Lighten only" "9"
            preset "Normal mapping" "10"
            value 0
        }
        color "layer_7_color" {
            doc "Color of the seventh layer."
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        percentage "layer_7_mix" {
            doc "Mask of the seventh layer."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            read_only yes
            value 1
        }
    }
    attribute_group "input>layer_8" {
        collapsed yes
        bool "enable_layer_8" {
            doc "Enables/disables the eighth layer."
            value no
        }
        string "layer_8_label" {
            doc "Label of the eighth layer. Purely cosmetic, to help remember what the layer is about."
            output "none"
            read_only yes
            value ""
        }
        long "layer_8_mode" {
            doc "Blending mode of the eighth layer."
            read_only yes
            preset "Over" "0"
            preset "Multiply" "1"
            preset "Divide" "2"
            preset "Screen" "3"
            preset "Overlay" "4"
            preset "Difference" "5"
            preset "Addition" "6"
            preset "Subtract" "7"
            preset "Darken only" "8"
            preset "Lighten only" "9"
            preset "Normal mapping" "10"
            value 0
        }
        color "layer_8_color" {
            doc "Color of the eighth layer."
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        percentage "layer_8_mix" {
            doc "Mask of the eighth layer."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            read_only yes
            value 1
        }
    }
    attribute_group "input>clamping" {
        collapsed yes
        bool "enable_clamping" {
            doc "Enables/disables clamping of the overall result. When disabled, the result can take any values, including negative ones."
            value no
        }
        double "min_value" {
            doc "Minimum value over which each channel of the result will be clamped."
            ui_range yes -10 10
            read_only yes
            value 0.0
        }
        double "max_value" {
            doc "Maximum value under which each channel of the result will be clamped."
            ui_range yes -10 10
            read_only yes
            value 1
        }
    }
}