MaterialPhysicalHair

MaterialPhysicalHair#

(Hair)

Category: /Material/Physical
Default object name: hair
Inherits from: ProjectItem > Material > MaterialPhysical

Description#

Hair material.

Public Attributes#

Type	Name	Visual Hint	Description
`double[3]`	`primary_albedo`	`VISUAL_HINT_COLOR`	Albedo of the primary highlight (aka R lobe).
`double`	`primary_gain`	`VISUAL_HINT_PERCENTAGE`	Gain of the primary highlight (aka R lobe).
`double`	`primary_shift`	`VISUAL_HINT_ANGLE`	Longitudinal shift of the primary highlight (aka R lobe): a negative value pushes it towards the root, whereas a positive one pushes it towards the tip.
`double`	`primary_length`	`VISUAL_HINT_ANGLE`	Length, or longitudinal width of the primary highlight (aka R lobe).
`double[3]`	`secondary_albedo`	`VISUAL_HINT_COLOR`	Albedo of the secondary highlight (aka TRT-g lobe, or TRT without the glints).
`double`	`secondary_gain`	`VISUAL_HINT_PERCENTAGE`	Gain of the secondary highlight (aka TRT-g lobe, or TRT without the glints).
`double`	`secondary_shift`	`VISUAL_HINT_ANGLE`	Longitudinal shift of the secondary highlight (aka TRT-g lobe, or TRT without the glints): a negative value pushes it towards the root, whereas a positive one pushes it towards the tip. When empty, the value is computed from the primary highlight.
`double`	`secondary_length`	`VISUAL_HINT_ANGLE`	Length, or longitudinal width of the secondary highlight (aka TRT-g lobe, or TRT without the glints). When empty, the value is computed from the primary highlight.
`double[3]`	`transmission_albedo`	`VISUAL_HINT_COLOR`	Albedo of the transmission highlight (aka TT lobe).
`double`	`transmission_gain`	`VISUAL_HINT_PERCENTAGE`	Gain of the transmission highlight (aka TT lobe).
`double`	`transmission_shift`	`VISUAL_HINT_ANGLE`	Longitudinal shift of the transmission highlight (aka TT lobe): a negative value pushes it towards the root, whereas a positive one pushes it towards the tip. When empty, the value is computed from the primary highlight.
`double`	`transmission_length`	`VISUAL_HINT_ANGLE`	Length, or longitudinal width of the transmission highlight (aka TT lobe). When empty, the value is computed from the primary highlight.
`double`	`transmission_width`	`VISUAL_HINT_ANGLE`	Width, or azimuthal width of the transmission highlight (aka TT lobe).
`double[3]`	`glints_albedo`	`VISUAL_HINT_COLOR`	Albedo of the glints (aka g lobe, part of the full TRT lobe). Note that it is multiplied by the secondary highlight albedo.
`double`	`glints_gain`	`VISUAL_HINT_PERCENTAGE`	Gain of the glints (aka g lobe, part of the full TRT lobe). Note that it is multiplied by the secondary highlight albedo.
`double`	`glints_spacing`	`VISUAL_HINT_ANGLE`	Spacing, or half-angle between the glints (aka g lobe, part of the full TRT lobe).
`double`	`glints_width`	`VISUAL_HINT_ANGLE`	Width, or azimuthal width of the glints (aka g lobe, part of the full TRT lobe).

Inherited Public Attributes#

Type	Name	Visual Hint	Description
`bool`	`export_aovs`	`VISUAL_HINT_DEFAULT`	Compute and write Aovs defined in the shading graph
`reference` (`AovStore`)	`arbitrary_output_variables`	`VISUAL_HINT_DEFAULT`	Set the list of extra channels to write to the image.
`string`	`light_path_expression_label`	`VISUAL_HINT_DEFAULT`	Set the material label in light path expressions.
`long`	`material_sample_count`	`VISUAL_HINT_SAMPLE_PER_PIXEL`	Material sample count per pixel.
`double`	`glossy_reflection_sampling_multiplier`	`VISUAL_HINT_SCALE`	Material glossy reflection sample count multiplier.
`double`	`glossy_transmission_sampling_multiplier`	`VISUAL_HINT_SCALE`	Material glossy transmission sample count multiplier.
`double`	`russian_roulette`	`VISUAL_HINT_PERCENTAGE`	Amount of Russian roulette used on the material samples.
`double`	`roughness_noise_optimization`	`VISUAL_HINT_PERCENTAGE`	Noise reduction strategy along rough light path.
`long`	`glossy_reflection_depth`	`VISUAL_HINT_DEFAULT`	Maximum glossy reflection depth.
`long`	`glossy_transmission_depth`	`VISUAL_HINT_DEFAULT`	Maximum glossy transmission depth.
`double[3]`	`opacity`	`VISUAL_HINT_COLOR`	Opacity of the material.
`long`	`normal_mode`	`VISUAL_HINT_DEFAULT`	Define which geometric normal to use for the shading.
`long`	`shadow_casting_mode`	`VISUAL_HINT_DEFAULT`	Defines the properties of the material when casting shadows: fully opaque (regardless of the actual value of the opacity of the material), artistic (user-defined opacity and coloring), pseudo-caustics (cheaply emulating actual refractive caustics) or physical (intrinsic transparency of the material), where the last three are modulated by the opacity of the material.
`double`	`shadow_opacity`	`VISUAL_HINT_PERCENTAGE`	Defines how dark the shadows cast by this material are.
`double`	`shadow_coloring`	`VISUAL_HINT_PERCENTAGE`	Defines how much refraction and absorption colors affect shadowing.
`long`	`reflective_caustics`	`VISUAL_HINT_DEFAULT`	Reflective caustics computation mode.
`long`	`refractive_caustics`	`VISUAL_HINT_DEFAULT`	Refractive caustics computation mode.

CID#

class "MaterialPhysicalHair" "MaterialPhysical" {
    #version 0.91
    icon "material_hair.iconrc"
    doc "Hair material."
    attribute_group "backward_compatibility" {
        bool "enable_backward_compatibility" {
            doc "Enable ad-hoc Fresnel-boosting in primary highlight to better match illumination levels of legacy version of the shader."
            hidden yes
            value no
        }
    }
    attribute_group "primary_highlight" {
        color "primary_albedo" {
            doc "Albedo of the primary highlight (aka R lobe)."
            texturable yes
            animatable yes
            value 0.2 0.18 0.16
        }
        percentage "primary_gain" {
            doc "Gain of the primary highlight (aka R lobe)."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            value 1
        }
        angle "primary_shift" {
            doc "Longitudinal shift of the primary highlight (aka R lobe): a negative value pushes it towards the root, whereas a positive one pushes it towards the tip."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes -45 45
            ui_range yes -45 45
            value -3
        }
        angle "primary_length" {
            doc "Length, or longitudinal width of the primary highlight (aka R lobe)."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 1 45
            ui_range yes 1 45
            value 8
        }
    }
    attribute_group "secondary_highlight" {
        color "secondary_albedo" {
            doc "Albedo of the secondary highlight (aka TRT-g lobe, or TRT without the glints)."
            texturable yes
            animatable yes
            value 0.2 0.18 0.16
        }
        percentage "secondary_gain" {
            doc "Gain of the secondary highlight (aka TRT-g lobe, or TRT without the glints)."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            value 1
        }
        angle "secondary_shift" {
            doc "Longitudinal shift of the secondary highlight (aka TRT-g lobe, or TRT without the glints): a negative value pushes it towards the root, whereas a positive one pushes it towards the tip. When empty, the value is computed from the primary highlight."
            null_label "Use Physical Value"
            null_value "-100.0"
            texturable yes
            animatable yes
            slider yes
            numeric_range yes -45 45
            ui_range yes -45 45
            value -100
        }
        angle "secondary_length" {
            doc "Length, or longitudinal width of the secondary highlight (aka TRT-g lobe, or TRT without the glints). When empty, the value is computed from the primary highlight."
            null_label "Use Physical Value"
            null_value "-100.0"
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 1 45
            ui_range yes 1 45
            value -100
        }
    }
    attribute_group "transmission_highlight" {
        color "transmission_albedo" {
            doc "Albedo of the transmission highlight (aka TT lobe)."
            texturable yes
            animatable yes
            value 0.2 0.18 0.16
        }
        percentage "transmission_gain" {
            doc "Gain of the transmission highlight (aka TT lobe)."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            value 1
        }
        angle "transmission_shift" {
            doc "Longitudinal shift of the transmission highlight (aka TT lobe): a negative value pushes it towards the root, whereas a positive one pushes it towards the tip. When empty, the value is computed from the primary highlight."
            null_label "Use Physical Value"
            null_value "-100.0"
            texturable yes
            animatable yes
            slider yes
            numeric_range yes -45 45
            ui_range yes -45 45
            value -100
        }
        angle "transmission_length" {
            doc "Length, or longitudinal width of the transmission highlight (aka TT lobe). When empty, the value is computed from the primary highlight."
            null_label "Use Physical Value"
            null_value "-100.0"
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 1 45
            ui_range yes 1 45
            value -100
        }
        angle "transmission_width" {
            doc "Width, or azimuthal width of the transmission highlight (aka TT lobe). "
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 1 90
            ui_range yes 1 45
            value 30
        }
    }
    attribute_group "glints" {
        color "glints_albedo" {
            doc "Albedo of the glints (aka g lobe, part of the full TRT lobe). Note that it is multiplied by the secondary highlight albedo."
            texturable yes
            animatable yes
            value 0.5 0.5 0.5
        }
        percentage "glints_gain" {
            doc "Gain of the glints (aka g lobe, part of the full TRT lobe). Note that it is multiplied by the secondary highlight albedo."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10
            ui_range yes 0.0 1
            value 1
        }
        angle "glints_spacing" {
            doc "Spacing, or half-angle between the glints (aka g lobe, part of the full TRT lobe)."
            null_label "Use Physical Value"
            null_value "-100.0"
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 90
            ui_range yes 0.0 45
            value -100
        }
        angle "glints_width" {
            doc "Width, or azimuthal width of the glints (aka g lobe, part of the full TRT lobe)."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 1 45
            ui_range yes 1 45
            value 15
        }
    }
    set "diffuse_sampling_multiplier" {
        null_label "Use Renderer Settings"
        null_value "-1.0"
        private no
        hidden yes
        saveable yes
        texturable no
        animatable no
        slider no
        numeric_range yes 0.0 1000
        ui_range yes 0.0 10
        dg_active yes
        dg_cyclic no
        dirtiness_pass_through no
        read_only no
        shading_variable yes
        experimental no
        advanced no
        overriden no
        promote_attribute no
        allow_expression yes
        localizable yes
        value -1
    }
    set "subsurface_sampling_multiplier" {
        null_label "Use Renderer Settings"
        null_value "-1.0"
        private no
        hidden yes
        saveable yes
        texturable no
        animatable no
        slider no
        numeric_range yes 0.0 1000
        ui_range yes 0.0 10
        dg_active yes
        dg_cyclic no
        dirtiness_pass_through no
        read_only no
        shading_variable yes
        experimental no
        advanced no
        overriden no
        promote_attribute no
        allow_expression yes
        localizable yes
        value -1
    }
    set "volume_sampling_multiplier" {
        null_label "Use Renderer Settings"
        null_value "-1.0"
        private no
        hidden yes
        saveable yes
        texturable no
        animatable no
        slider no
        numeric_range yes 0.0 1000
        ui_range yes 0.0 10
        dg_active yes
        dg_cyclic no
        dirtiness_pass_through no
        read_only no
        shading_variable yes
        experimental no
        advanced no
        overriden no
        promote_attribute no
        allow_expression yes
        localizable yes
        value -1
    }
    set "multiple_scattering_strength" {
        private no
        hidden yes
        saveable yes
        texturable no
        animatable no
        slider no
        numeric_range yes 0.0 1
        ui_range yes 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 1
    }
    set "diffuse_depth" {
        null_label "Use Renderer Settings"
        null_value "-1"
        private no
        hidden yes
        saveable yes
        texturable no
        animatable no
        slider no
        numeric_range yes 0.0 65536
        ui_range yes 0.0 16
        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 -1
    }
    set "specular_reflection_depth" {
        null_label "Use Renderer Settings"
        null_value "-1"
        private no
        hidden yes
        saveable yes
        texturable no
        animatable no
        slider no
        numeric_range yes 0.0 65536
        ui_range yes 0.0 16
        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 -1
    }
    set "specular_transmission_depth" {
        null_label "Use Renderer Settings"
        null_value "-1"
        private no
        hidden yes
        saveable yes
        texturable no
        animatable no
        slider no
        numeric_range yes 0.0 65536
        ui_range yes 0.0 16
        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 -1
    }
    set "volume_depth" {
        null_label "Use Renderer Settings"
        null_value "-1"
        private no
        hidden yes
        saveable yes
        texturable no
        animatable no
        slider no
        numeric_range yes 0.0 65536
        ui_range yes 0.0 16
        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 -1
    }
    set "normal_input" {
        private no
        hidden yes
        saveable yes
        texturable yes
        animatable yes
        slider no
        numeric_range yes 0.0 1
        ui_range yes 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 1
    }
    set "sidedness" {
        private no
        hidden yes
        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
        preset "Single" "0"
        preset "Double" "1"
        preset "Invert" "2"
        value 0
    }
    set "shadow_casting_mode" {
        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
        preset "Opaque" "0"
        preset "Artistic" "1"
        preset "Physical" "3"
        preset "Pseudo-Caustics" "2"
        value 2
    }
}