mia_material
 
 
 

Category: mental ray > Materials

Shader Family: Surface Material

Output: Color

Related Softimage shader: Architectural

This shader is designed to support most physical materials used by architectural and product design renderings. It supports most hard surface materials such as metal, wood, and glass. It is tuned especially for glossy reflections and refractions and high-quality glass.

You can use this shader on its own or also with any of these other architectural shaders: mia_physicalsun, mia_physicalsky, mia_roundcorners, mia_exposure_simple, etc.

Name

The name of the shader node displayed in the render tree. Enter any name you like, or leave the default.

diffuse_weight

Sets the desired level (and diffuses the color) of the diffuse reflectivity. Since the material is energy conserving, the actual diffuse level used depends on the Reflectivity and Transparency values set (below).

diffuse

Defines the Diffuse surface color in the illuminated area of the object.

diffuse_roughness

Sets the roughness of the diffuse surface using the Oren-Nayar shading model. When this value is 0, it is identical to Lambert shading: with higher values, the surface gets a more powdery look.

reflectivity

The amount that the surface reflects its environment. The Reflectivity and Reflection Color together define the level of reflection, as well as the intensity of the specular highlight.

This value is the maximum value of reflectivity. The actual value also depends on the angle of the surface defined by the View Angle Dependent (BRDF) parameter.

refl_color

Color used for the reflection.

refl_gloss

Amount of glossiness of the reflection, ranging from a value of 1 (mirror) to 0 (a diffusely reflective surface). This also defines how sharp or blurry the refraction/transparency is.

refl_gloss_samples

Defines the maximum number of samples (rays) that are shot to create the glossy reflections. Higher values render more slowly but create a smoother result. Lower values render faster, but create a grainier result. A value of 32 is adequate for most cases.

If the Glossiness value is 1 (equals a mirror), it is meaningless to shoot multiple rays, so only one reflection ray is shot.

If this parameter's value is set to 0, the reflections will be a mirror (and only one ray shot) regardless of the actual Glossiness value. This can be used to boost performance for surfaces with very weak reflections. The highlight still considers the Glossiness value.

refl_interpolate

Activates interpolation for reflections.

refl_hl_only

Displays only highlighted and emulated reflections, so no actual reflection rays are traced, which saves rendering time. Only the highlights are shown, as well as soft reflections emulated by final gathering (if it's active). This is useful when the surface is not so reflective or doesn't require accurate glossy reflections, or for using on objects that are less important in the scene.

refl_is_metal

Influences the reflection in the same way as a metallic object influences the color of its reflection.

When this option is on, the Diffuse parameter defines the color of the reflection, and the Reflectivity parameter sets the weight between diffuse reflections and glossy (metallic) reflections.

transparency

Defines the level of transparency of the material. This value is the maximum value of refraction. The actual value also depends on the Reflectivity and the angle of the surface as defined by the View Angle Dependent (BRDF) parameter.

refr_color

Defines the color of the transparency.

refr_gloss

Determines the smoothness of the surface for refraction only: the lower the value, the rougher the material; the higher the value, the smoother the surface.

refr_ior

The amount that a ray of light bends when entering a material. Which direction the light bends depends on whether it is entering or exiting the object. The shader uses the direction of the surface normal as the primary cue for figuring out whether the light is entering or exiting.

A value of 1 equals air (no refraction across the material), with a value of 1.2 being glass and 1.5 being very refractive glass.

refr_gloss_samples

Specifies the number of times the light ray is sampled: a low value is grainy; a high value is smooth.

refr_interpolate

Activates interpolation for refractions.

Translucency: Makes the object appear translucent, which allows some light to pass through it. This is primarily used for thin-walled objects in a scene, such as curtains, screens, and rice paper. There must be some level of Transparency set on the object for Translucency to have an effect.

refr_translucency

Activates the Translucency options.

refr_trans_color

Color of the translucency.

refr_trans_weight

Determines the amount of translucency is used in the transparency. At a value of 1, the translucency is 100% of the transparency (that is, no transparency); at a value of 0, no translucency is used in the transparency.

anisotropy

Sets the ratio between the width and height of the highlights to create anistropic reflections. At a value of 1, there is no effect, but any other value changes the shape of the highlight.

anisotropy_rotation

Rotates the anistropic effect. A value of 0 is no rotation, and a value of 1 is a full revolution (360 degrees). This helps to direct the angle of the reflection when there is a texture map applied.

anisotropy_channel

Undocumented xxx

View Angle Dependent (BRDF): The reflectivity of a surface is often view angle dependent, also known as BRDF (bidirectional reflectance distribution function). The following parameters define how much a material reflects when seen from various angles. Many materials have this quality, such as glass and water, as well as lacquered wood and plastic.

brdf_fresnel

Defines the index of refraction in degrees (incident angle). A value of 0 is used for surfaces facing the view and a value of 90 is used for surfaces perpendicular to the view.

brdf_0_degree_refl

Defines the reflectivity for surfaces that are directly facing the viewer (incident ray). Metals are usually uniformly reflective, so you can set this value high (0.8 to 1), but other materials such as linoleum or lacquered wood have lower values (0.1 to 0.3).

brdf_90_degree_refl

Defines the reflectivity for surfaces that are perpendicular to the viewer. Most materials show strong reflections at grazing angles so this parameter can generally be kept at 1 (and using the Reflectivity parameter to guide the overall reflectivity).

brdf_curve

Defines the falloff of the view dependent angle (BRDF) curve.

brdf_conserve_energy

Ensures that the incoming light energy is properly distributed to the diffuse reflection and refraction areas of the surface (Diffuse+Reflectivity+Refraction <=1). If you increase the Reflectivity, the Diffuse and Transparency are reduced accordingly; if you increase the Transparency, the Diffuse level is reduced accordingly.

This option also links the level of highlights to the Glossiness of the surface. A high Glossiness value causes a narrower but more intense highlight, while a lower value causes a wider but less intense highlights because the light energy is spread out and dissipates over a larger area.

Interpolate Reflection/Refraction: Glossy reflections and refractions can be interpolated so that they render faster and become smoother. Interpolation uses an algorithm that allows rays to be reused and smoothed. The result is faster and smoother, but less accurate, glossy reflections.

Interpolation works by precalculating glossy reflections in a grid across the image. The number of samples (rays) taken at each point is determined by Refraction or Reflection Samples parameters.

Interpolation is done on a low-resolution grid which may cause artifacts. For this reason, it works best on flat surfaces, but not on wavy or detailed surfaces, or those using bump maps.

intr_grid_density

Sets the resolution of the grid that is used by interpolation for the precalculation of glossy reflections across an image.

  • 0 = grid resolution is double that of the rendering

  • 1 = grid resolution is same as that of the rendering

  • 2 = grid resolution is half of that of the rendering

  • 3 = grid resolution is one third of that of the rendering

  • 4 = grid resolution is one quarter of that of the rendering

  • 5 = grid resolution is one fifth of that of the rendering

intr_refl_samples

Sets the number of samples (rays) shot for calculating reflections for interpolation.

intr_refl_ddist_on

Activates the intr_refl_ddist parameter.

intr_refl_ddist

Defines the radius in which a second set of detail rays is traced to create a clearer version of the objects within this radius.

intr_refr_samples

Sets the number of samples (rays) shot for calculating refraction for interpolation.

single_env_sample

Samples the environment only once for reflection and refraction rays.

refl_falloff_on

Activates the refl_falloff_dist parameter.

refl_falloff_dist

Limits the reflections to within a certain distance, which speeds up rendering as well as avoiding the calculation of glossy reflections of distant objects.

refl_falloff_color_on

Activates the refl_falloff_color parameter.

refl_falloff_color

Reflections fade out to this color. If this parameter is not active, the reflections fade out to the environment color. Using this color tends to be more useful for indoor scenes, while using the environment color is better for outdoor scenes.

refl_depth

Sets the maximum trace depth for each material. When this value is reached, the material displays only highlighted and emulated reflections. If this value is 0, the global trace depth value is used.

refl_cutoff

The threshold at which reflections are not traced anymore. This is a relative value; that is, the default of 0.01 means that rays that contribute less than 1% to the final pixel are ignored.

refr_falloff_on

Activates the refr_falloff_dist parameter.

refr_falloff_dist

Limits the refractions to within a certain distance, which speeds up rendering as well as avoiding the calculation of glossy refractions of distant objects.

refr_falloff_color_on

Activates the refr_falloff_color parameter.

refr_falloff_color

Refractions fade out to this color. If this parameter is not active, the refractions fades out to the environment color. Using this color tends to be more useful for indoor scenes, while using the environment color is better for outdoor scenes.

refr_depth

Sets the maximum trace depth for each material. When this value is reached, the material displays only highlighted and emulated reflections. If this value is 0, the global trace depth value is used.

refr_cutoff

The threshold at which refractions are not traced anymore. This is a relative value; that is, the default of 0.01 means that rays that contribute less than 1% to the final pixel are ignored.

Global Illumination/Caustics/Final Gathering: This shader is designed to be used in a realistic lighting environment, using both full direct and indirect illumination. To generate indirect light, you can use final gathering and/or global illumination (photons). You need to at least use final gathering, but combining final gathering with global illumination gives better quality results.

If you are using an environment for your reflections, make sure the same environment (or a blurred copy of it) is used to light the scene with final gathering.

indirect_multiplier

An indirect multiplier that lets you tweak how strongly the material responds to indirect light. The default of 1 uses the global value.

fg_quality

A local multiplier for the number of final gathering rays shot by the material. The default of 1 uses the global value.

fg_quality_w

Aids in mapping textures that are mapped to this parameter. When this value is 0, the fg_quality_w value is the raw quality setting; with a non-zero value (minimum of 1), the actual quality used is the product of this value with the fg_quality_w value.

This means that with a color texture mapped to fg_quality_w and this parameter set to 5, black in the texture results in a quality of 1 (the number of final gather rays shot is the global default), and white in the texture results in a quality of 5 (five times as many rays are shot).

ao_on

Activates the calculation of ambient occlusion, which is how occluded (blocked) an area of the surface is from receiving light. This is used to emulate the look of global illumination.

You must have either indirect illumination (final gathering or global illumination) or an ambient light source defined for ambient occlusion to have an effect.

ao_samples

Sets the number of samples (rays) shot for creating ambient occlusion. Higher values create smoother results, but are slower; lower values are faster, but the results are grainier. The default value is 16, but 64 is more useful in most situations.

ao_distance

Defines the radius in which the occluding objects are located. Smaller values restrict the ambient occlusion effect to only small crevices, but are faster to render; larger values cover larger areas but are slower to render.

ao_dark

Sets the darkness of the ambient occlusion shadows. It is used as a multiplier value for completely occluded surfaces, meaning that black makes the ambient occlusion effect very dark, while a medium gray makes the effect brighter (less obvious).

ao_ambient

Creates the effect of an ambient light that is then attenuated by the ambient occlusion to create shadows, which can help to lighten some particularly dark corners.

ao_do_details

Activates the enhancement of details when used with indirect illumination. This is used to apply short distance ambient occlusion multiplying it with the indirect illumination, thus bringing out the details of an object.

thin_walled

Determines whether a material causes refractions (as if it was made of a solid transparent material) or not (as if it was made of thin sheets of a transparent material).

no_visible_area_hl

Causes visible area lights to lose their highlights and appear only as reflections on the surface. Otherwise, if both the reflection of the visible area light and the highlight are rendered, the light is added twice, causing an unrealistic brightening.

skip_inside_refl

Ignores faint reflections that are on the inside of transparent objects, which saves rendering time.

do_refractive_caustics

Enables refractive caustics for only this material; if this is off, caustics are enabled for all elements in a scene. For example, you may want caustics to be calculated for objects such as a glass bottle or ball, but not all refractive objects in a scene, such as window panes.

backface_cull

Makes surfaces invisible to the camera when seen from the reverse side. This is useful for creating see-though walls in a room so that you can look at an interior from the outside.

propagate_alpha

Refractions and other transparency effects propagate the alpha channel information of the background through the transparent object.

If this is off, transparent objects have an opaque alpha channel.

hl_vs_refl_balance

Determines the balance between the highlight and the reflectivity on the object. The default value of 1 is the "physically correct" setting (that is, the highlight intensity is appropriate for the reflectivity), but you may want to change this value to alter the balance for other more artistic effects.

cutout_opacity

Applies an opacity map to completely remove parts of objects. This is useful for mapping an image of a tree to a flat plane and then using opacity to cut away the parts of the tree that are not there.

additional_color

Input to which you can apply any shader. The output of this shader is added on top of the shading done by this Architectural Material shader and can be used for self-illumination type effects, as well as for adding any additional shading you may want.

Bump

The bump input accepts a shader that perturbs the normal for bump mapping.

no_diffuse_bump

Applies bumps to all components except the Diffuse parameter. This means that bumps are seen in reflections, highlights, etc., but not in the diffuse shading. The effect looks like a smooth diffuse surface covered in a bumpy lacquer coating.

When off, the bumps apply to all shading components (difuse, highlights, reflections, refractions, etc.).

mode

The mode selector for the light list. For more information, see Setting the Light List Mode [Direct Illumination].

Lights

Creates a light list to specifiy which lights should produce the effect. For more information, see Using Light Lists [Direct Illumination].