MaterialPhysicalAutodeskStandardSurface

MaterialPhysicalAutodeskStandardSurface#

(Autodesk Standard Surface)

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

Description#

A surface material based on the Ai Standard of Arnold 5.3.

Public Attributes#

Type	Name	Visual Hint	Description
`action`	`material_preset`	`VISUAL_HINT_DEFAULT`
`double`	`base_weight`	`VISUAL_HINT_PERCENTAGE`	Weight of the base color of the diffuse and metallic layers.
`double[3]`	`base_color`	`VISUAL_HINT_COLOR`	Base color of the diffuse and metallic layers.
`double`	`diffuse_roughness`	`VISUAL_HINT_PERCENTAGE`	Roughness of the diffuse and thin-walled subsurface layers.
`double`	`metalness`	`VISUAL_HINT_PERCENTAGE`	The metallic-ness (0 = dielectric, 1 = metallic) of the material.
`action`	`specular_IOR_preset`	`VISUAL_HINT_DEFAULT`
`double`	`specular_weight`	`VISUAL_HINT_PERCENTAGE`	Weight of the specular color.
`double[3]`	`specular_color`	`VISUAL_HINT_COLOR`	Color of the specular lobe. If metallic, this color is used to tint the edge.
`double`	`specular_roughness`	`VISUAL_HINT_PERCENTAGE`	Roughness of the specular, transmission and metallic layers.
`double`	`specular_IOR`	`VISUAL_HINT_DEFAULT`	Index of refraction of the thin-film-less specular and non-thin-walled transmission bxdf.
`double`	`specular_anisotropy`	`VISUAL_HINT_PERCENTAGE`	Anisotropy of the specular/metallic brdf.
`double`	`specular_rotation`	`VISUAL_HINT_PERCENTAGE`	Rotation of the anisotropy of the specular/metallic brdf.
`double`	`transmission_weight`	`VISUAL_HINT_PERCENTAGE`	Weight of the transmission color.
`double[3]`	`transmission_color`	`VISUAL_HINT_COLOR`	Color of the transmission
`double`	`transmittance_depth`	`VISUAL_HINT_DISTANCE`	Set the transmittance depth of the material.
`double[3]`	`transmission_scatter`	`VISUAL_HINT_COLOR`	Color of the scattering
`double`	`transmission_scatter_anisotropy`	`VISUAL_HINT_PERCENTAGE`	Anisotropy of the scattering.
`double`	`transmission_extra_roughness`	`VISUAL_HINT_PERCENTAGE`	Add extra roughness to the base transmission. The base transmission roughness is the specular roughness.
`action`	`subsurface_preset`	`VISUAL_HINT_DEFAULT`
`long`	`subsurface_mode`	`VISUAL_HINT_DEFAULT`	Select which SSS mode to use. The Random Walk give better results.
`double`	`subsurface_weight`	`VISUAL_HINT_PERCENTAGE`	Weight of the subsurface color. This weight is used to blend between the diffuse and sss brdf. 1 means full sss, 0 full diffuse.
`double[3]`	`subsurface_color`	`VISUAL_HINT_COLOR`	Color of the subsurface scattering brdf
`double[3]`	`subsurface_radius`	`VISUAL_HINT_COLOR`	Wavelength-dependent mean subsurface scattering distance of the material.
`double`	`subsurface_scale`	`VISUAL_HINT_DISTANCE`	Scaling factor of the mean subsurface scattering distance at all wavelengths.
`double`	`subsurface_anisotropy`	`VISUAL_HINT_PERCENTAGE`	The anistropy of the volumetric phase function. -1 is highly back-scattering, 0 is isotropic and 1 is highly forward-scattering.
`string`	`subsurface_group`	`VISUAL_HINT_TAG`	Name of the group among which illumination propagates between SSS materials.
`action`	`coat_IOR_preset`	`VISUAL_HINT_DEFAULT`
`double`	`coat_weight`	`VISUAL_HINT_PERCENTAGE`	Weight of the coat color. This weight is used to define the coat color by blending a white color with the coat color attribute. 0 means white, 1 means coat color.
`double[3]`	`coat_color`	`VISUAL_HINT_COLOR`	Transmittance of the coat layer.
`double`	`coat_roughness`	`VISUAL_HINT_PERCENTAGE`	Roughness of the coat brdf
`double`	`coat_IOR`	`VISUAL_HINT_DEFAULT`	Index of refraction of the coat brdf.
`double`	`coat_anisotropy`	`VISUAL_HINT_PERCENTAGE`	Anisotropy of the coat brdf.
`double`	`coat_rotation`	`VISUAL_HINT_PERCENTAGE`	Anisotropy rotation of the coat brdf.
`double[3]`	`coat_normal`	`VISUAL_HINT_DISTANCE`	Replace the shading normal by this normal when evaluating the coat component.
`double`	`sheen_weight`	`VISUAL_HINT_PERCENTAGE`	Weight of the sheen color.
`double[3]`	`sheen_color`	`VISUAL_HINT_COLOR`	Color of the sheen brdf.
`double`	`sheen_roughness`	`VISUAL_HINT_PERCENTAGE`	Roughness of the sheen brdf.
`double`	`emission_weight`	`VISUAL_HINT_PERCENTAGE`	Weight of the emission.
`double[3]`	`emission_color`	`VISUAL_HINT_COLOR`	Color of the emission.
`double`	`thin_film_thickness`	`VISUAL_HINT_DEFAULT`	Set the thickness of the thin film in nm (nanometers) on the metallic and specular layers.
`double`	`thin_film_IOR`	`VISUAL_HINT_DEFAULT`	Set the index of refraction of the thin film medium.
`bool`	`thin_walled`	`VISUAL_HINT_DEFAULT`	Defined if the geometry is defined as thin for this material. If true, the transmission IOR will be one with 0 roughness and the SSS will be replaced by a back diffuse.

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`	`diffuse_sampling_multiplier`	`VISUAL_HINT_SCALE`	Material diffuse sample count multiplier.
`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`	`subsurface_sampling_multiplier`	`VISUAL_HINT_SCALE`	Material subsurface 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.
`double`	`multiple_scattering_strength`	`VISUAL_HINT_PERCENTAGE`	Strength of compensation for energy lost by multiple scattering.
`long`	`diffuse_depth`	`VISUAL_HINT_DEFAULT`	Maximum diffuse depth.
`long`	`specular_reflection_depth`	`VISUAL_HINT_DEFAULT`	Maximum specular reflection depth.
`long`	`glossy_reflection_depth`	`VISUAL_HINT_DEFAULT`	Maximum glossy reflection depth.
`long`	`specular_transmission_depth`	`VISUAL_HINT_DEFAULT`	Maximum specular transmission depth.
`long`	`glossy_transmission_depth`	`VISUAL_HINT_DEFAULT`	Maximum glossy transmission depth.
`long`	`volume_depth`	`VISUAL_HINT_DEFAULT`	Maximum volume 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.
`double`	`normal_input`	`VISUAL_HINT_PERCENTAGE`	Override the shading normal by the one given as input. The value controls the blending with the original normal.
`long`	`sidedness`	`VISUAL_HINT_DEFAULT`	Sidedness of this surface used for this material. 'Single' keeps the original normals no matter what. 'Double' may flip the normal to be oriented toward the incomming direction. 'Invert' flips the original normal no matter what.
`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 "MaterialPhysicalAutodeskStandardSurface" "MaterialPhysical" {
    #version 0.96
    icon "material_autodesk.iconrc"
    doc "A surface material based on the Ai Standard of Arnold 5.3."
    attribute_group "base" {
        doc "Set a preset to the material."
        action "material_preset" {
            value <empty>
        }
        percentage "base_weight" {
            doc "Weight of the base color of the diffuse and metallic layers."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            value 1
        }
        color "base_color" {
            doc "Base color of the diffuse and metallic layers."
            texturable yes
            animatable yes
            value 0.5 0.5 0.5
        }
        percentage "diffuse_roughness" {
            doc "Roughness of the diffuse and thin-walled subsurface layers."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1.79769313486232e+308
            ui_range yes 0.0 1
            value 0.0
        }
        percentage "metalness" {
            doc "The metallic-ness (0 = dielectric, 1 = metallic) of the material."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            value 0.0
        }
    }
    attribute_group "specular" {
        doc "Set a preset to the specular IOR."
        action "specular_IOR_preset" {
            value <empty>
        }
        percentage "specular_weight" {
            doc "Weight of the specular color."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            value 1
        }
        color "specular_color" {
            doc "Color of the specular lobe. If metallic, this color is used to tint the edge."
            texturable yes
            animatable yes
            value 1 1 1
        }
        percentage "specular_roughness" {
            doc "Roughness of the specular, transmission and metallic layers."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            value 0.3
        }
        double "specular_IOR" {
            doc "Index of refraction of the thin-film-less specular and non-thin-walled transmission bxdf."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 100
            ui_range yes 1 3
            value 1.5
        }
        percentage "specular_anisotropy" {
            doc "Anisotropy of the specular/metallic brdf."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            value 0.0
        }
        percentage "specular_rotation" {
            doc "Rotation of the anisotropy of the specular/metallic brdf."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            read_only yes
            value 0.0
        }
    }
    attribute_group "transmission" {
        collapsed yes
        percentage "transmission_weight" {
            doc "Weight of the transmission color."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            value 0.0
        }
        color "transmission_color" {
            doc "Color of the transmission"
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        distance "transmittance_depth" {
            doc "Set the transmittance depth of the material."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10000000
            ui_range yes 0.0 100
            read_only yes
            value 0.0
        }
        color "transmission_scatter" {
            doc "Color of the scattering"
            texturable yes
            animatable yes
            read_only yes
            value 0.0 0.0 0.0
        }
        percentage "transmission_scatter_anisotropy" {
            doc "Anisotropy of the scattering."
            texturable yes
            animatable yes
            slider yes
            ui_range yes -1 1
            read_only yes
            value 0.0
        }
        double "dispersion_abbe" {
            doc "Set the Abbe number of the material."
            null_label "Disabled"
            null_value "-1.0"
            hidden yes
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 1 100
            ui_range yes 1 100
            value -1
        }
        percentage "transmission_extra_roughness" {
            doc "Add extra roughness to the base transmission. The base transmission roughness is the specular roughness."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes -1 1
            ui_range yes -1 1
            read_only yes
            value 0.0
        }
    }
    attribute_group "subsurface" {
        doc "Set a preset to the subsuface color and radius."
        collapsed yes
        action "subsurface_preset" {
            value <empty>
        }
        long "subsurface_mode" {
            doc "Select which SSS mode to use. The Random Walk give better results."
            read_only yes
            preset "Diffusion" "0"
            preset "Random Walk" "1"
            value 1
        }
        percentage "subsurface_weight" {
            doc "Weight of the subsurface color. This weight is used to blend between the diffuse and sss brdf. 1 means full sss, 0 full diffuse."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            value 0.0
        }
        color "subsurface_color" {
            doc "Color of the subsurface scattering brdf"
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        color "subsurface_radius" {
            doc "Wavelength-dependent mean subsurface scattering distance of the material."
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        distance "subsurface_scale" {
            doc "Scaling factor of the mean subsurface scattering distance at all wavelengths."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10000
            ui_range yes 0.0 10
            read_only yes
            value 1
        }
        percentage "subsurface_anisotropy" {
            doc "The anistropy of the volumetric phase function. -1 is highly back-scattering, 0 is isotropic and 1 is highly forward-scattering."
            texturable yes
            animatable yes
            slider yes
            ui_range yes -1 1
            read_only yes
            value 0.0
        }
        tag "subsurface_group" {
            doc "Name of the group among which illumination propagates between SSS materials."
            read_only yes
            value ""
        }
    }
    attribute_group "coat" {
        doc "Set a preset to the coat IOR."
        collapsed yes
        action "coat_IOR_preset" {
            value <empty>
        }
        percentage "coat_weight" {
            doc "Weight of the coat color. This weight is used to define the coat color by blending a white color with the coat color attribute. 0 means white, 1 means coat color."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            value 0.0
        }
        color "coat_color" {
            doc "Transmittance of the coat layer."
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        percentage "coat_roughness" {
            doc "Roughness of the coat brdf"
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            read_only yes
            value 0.1
        }
        double "coat_IOR" {
            doc "Index of refraction of the coat brdf."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 100
            ui_range yes 0.0 5
            read_only yes
            value 1.5
        }
        percentage "coat_anisotropy" {
            doc "Anisotropy of the coat brdf."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            read_only yes
            value 0.0
        }
        percentage "coat_rotation" {
            doc "Anisotropy rotation of the coat brdf."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            read_only yes
            value 0.0
        }
        distance[3] "coat_normal" {
            doc "Replace the shading normal by this normal when evaluating the coat component."
            texturable yes
            animatable yes
            read_only yes
            value 0.0 0.0 0.0
        }
    }
    attribute_group "sheen" {
        collapsed yes
        percentage "sheen_weight" {
            doc "Weight of the sheen color."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            value 0.0
        }
        color "sheen_color" {
            doc "Color of the sheen brdf."
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
        percentage "sheen_roughness" {
            doc "Roughness of the sheen brdf."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 1
            ui_range yes 0.0 1
            read_only yes
            value 0.3
        }
    }
    attribute_group "emission" {
        collapsed yes
        percentage "emission_weight" {
            doc "Weight of the emission."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10000000
            ui_range yes 0.0 1
            value 0.0
        }
        color "emission_color" {
            doc "Color of the emission."
            texturable yes
            animatable yes
            read_only yes
            value 1 1 1
        }
    }
    attribute_group "thin_film" {
        collapsed yes
        double "thin_film_thickness" {
            doc "Set the thickness of the thin film in nm (nanometers) on the metallic and specular layers."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10000
            ui_range yes 0.0 2000
            value 0.0
        }
        double "thin_film_IOR" {
            doc "Set the index of refraction of the thin film medium."
            texturable yes
            animatable yes
            slider yes
            numeric_range yes 0.0 10000
            ui_range yes 0.0 3
            read_only yes
            value 0.0
        }
        double "kappa" {
            hidden yes
            texturable yes
            slider yes
            numeric_range yes 0.0 10000
            ui_range yes 0.0 2
            value 0.0
        }
    }
    attribute_group "surface_geometry" {
        bool "thin_walled" {
            doc "Defined if the geometry is defined as thin for this material. If true, the transmission IOR will be one with 0 roughness and the SSS will be replaced by a back diffuse."
            value no
        }
    }
    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 "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
    }
}