Skip to content

MaterialPhysicalHair

MaterialPhysicalHair#

(Hair)

Go to User page.

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
    }
}