RayTraceMaterial : Material

RaytraceMaterial - superclass: material; super-superclass:MAXWrapper - classID: #(655953908, 849023086)

Constructor

rayTraceMaterial ...

Properties

<RaytraceMaterial>.Ambient_Color_On Boolean default: true -- animatable; boolean

If Ambient_Color_On is false, Ambient_Amount is used, otherwise Ambient is used

<RaytraceMaterial>.Ambient Color default: (color 0 0 0) -- animatable

Sets the degree to which the material absorbs ambient light.

<RaytraceMaterial>.Ambient_Amount Float default: 0.0 -- animatable; percentage

The amount that the ambient map affects the material expressed as a percentage of full intensity.

<RaytraceMaterial>.Luminosity_Color_On Boolean default: true -- animatable; boolean

If Luminosity_Color_On is false, Self_Illum__Amount is used, otherwise Luminosity is used

<RaytraceMaterial>.Luminosity Color default: (color 0 0 0) -- animatable

The self-illumination color of the material.

<RaytraceMaterial>.Self_Illum_Amount Float default: 0.0 -- animatable; percentage

The amount that the self-illumination map affects the material expressed as a percentage of full intensity.

<RaytraceMaterial>.Diffuse Color default: (color 127.5 127.5 127.5) -- animatable

Sets the diffuse color.

<RaytraceMaterial>.Transparency_Color_On Boolean default: true

If Transparency_Color_On is false, Transparency_Amount is used, otherwise Transparecy is used

<RaytraceMaterial>.Transparecy Color default: (color 0 0 0) -- animatable

The filter color of the material.

<RaytraceMaterial>.Transparency_Amount Float default: 0.0 -- animatable; percentage

The amount that the transparency map affects the material expressed as a percentage of full intensity.

<RaytraceMaterial>.Reflect_Color_On Integer default: 1 -- animatable

If Reflect_Color_On is false, Reflect_Amount is used, otherwise Reflect is used

<RaytraceMaterial>.Reflect Color default: (color 0 0 0) -- animatable

The specular reflection color.

<RaytraceMaterial>.Reflect_amount Float default: 0.0 -- animatable; percentage

The amount that the reflection map affects the material expressed as a percentage of full intensity.

<RaytraceMaterial>.Index_of_Refraction Float default: 1.55 -- animatable; float

The index of refraction (IOR) controls how severely the material refracts transmitted light. At 1.0, the IOR of air, the object behind the transparent object does not distort. At 1.5, the object behind distorts greatly, like a glass marble. At an IOR slightly less than 1.0, the object reflects along its edges, like a bubble seen from under water.

<RaytraceMaterial>.Spec__Color Color default: (color 255 255 255) -- animatable

Sets the color of specular highlights.

<RaytraceMaterial>.Specular_Level Float default: 50.0 -- animatable; percentage

Sets the intensity of specular highlights. Set the Specular Level to a very high value for very strong, tight highlights.

<RaytraceMaterial>.Glossiness Float default: 40.0 -- animatable; percentage

Affects the size of the specular highlight. As you increase the value, the highlight gets smaller and the material appears shinier.

<RaytraceMaterial>.Soften Float default: 0.1 -- animatable

Softens the effect of highlights formed by glancing light.

<RaytraceMaterial>.Extra_Lighting Color default: (color 0 0 0) -- animatable

Adds light to the surface of objects with the Raytrace material.

<RaytraceMaterial>.translucency Color default: (color 0 0 0) -- animatable

Creates a translucent effect. The Translucency color is a non-directional diffuse reflection.

<RaytraceMaterial>.Fluorescence Color default: (color 0 0 0) -- animatable

Creates an effect similar to black light on a black light poster. The light from a black light is largely ultraviolet, outside the visible spectrum. Under black light, fluorescent paints flare or glow. The fluorescence in Raytrace material takes whatever light it sees in the scene, applies the Bias to it, and then, regardless of the color of the lights in the scene, illuminates the fluorescent material as if it were lit by white light.

<RaytraceMaterial>.Fluorescence_Bias Float default: 70.0 -- animatable; percentage

At 0.5, The Bias makes Fluorescence behave just like diffuse coloring. Bias values higher than 0.5 increase the fluorescent effect, making the object brighter than other objects in the scene. Bias values lower than 0.5 make the object dimmer than other objects in the scene.

<RaytraceMaterial>.Wire_Size Float default: 1.0 -- animatable;

Sets the size of the wire in wireframe mode.

<RaytraceMaterial>.wireUnits Integer default: 0 --

Sets the units to use with the .wiresize value:

0- Pixels

1- Units

<RaytraceMaterial>.Color_Density_Enable Boolean default: false—animatable

Turns on/off the color density controls.

<RaytraceMaterial>.Color_Density_Start Float default: 0.0 -- animatable

The position in the object where the density color begins to appear.

<RaytraceMaterial>.Color_Density_End Float default: 25.0 -- animatable

The position in the object where the density color reaches its full Amount value.

<RaytraceMaterial>.Color_Density_Amount Float default: 1.0 -- animatable

The amount of density color. It can range from 0 to 1.0. Reducing this value reduces the density color effect.

<RaytraceMaterial>.Color_Density_Color Color default: (color 255 255 255) -- animatable

Sets a transmission color based on thickness. While filter (Transparency) color tints objects behind the transparent object, the density color gives the appearance of color within the object itself, like tinted glass.

<RaytraceMaterial>.Fog_Enable Boolean default: false—animatable

Turn on/off the use of density fog in the raytrace material.

<RaytraceMaterial>.Fog_Start Float default: 0.0 -- animatable

The position in the object where the density fog begins to appear.

<RaytraceMaterial>.Fog_End Float default: 25.0 -- animatable

The position in the object where the density fog reaches its full Amount value.

<RaytraceMaterial>.Fog_Amount Float default: 1.0 -- animatable

Controls the amount of density fog. It can range from 0 to 1.0. Reducing this value reduces the density fog effect and makes the fog translucent.

<RaytraceMaterial>.Fog_Color Color default: (color 0 0 0) -- animatable

The color of the density fog.

<RaytraceMaterial>.Reflection_Type Integer default: 0 -- animatable

Set the type of reflection:

  1. Default (Reflections are layered with the diffuse color)

  2. Additive (Refelections are added to the diffuse color)

<RaytraceMaterial>.Reflection_Gain Float default: 0.5 -- animatable

Controls reflection brightness. The lower the gain value, the brighter the reflection. At a gain of 1.0, no reflection is visible.

<RaytraceMaterial>.Enable_Raytraced_Reflections Boolean default: true -- animatable

Turns raytracing of reflective objects on or off.

<RaytraceMaterial>.Enable_Raytraced_Refractions Boolean default: true -- animatable

Turns raytracing of transparent objects on or off.

<RaytraceMaterial>.Reflection_Falloff_Mode Integer default: 0 -- animatable

When on, dims reflections to black at distance specified by Reflection_Falloff_End_Distance:

0- Off (Turns off attenuation)

1- Linear

2- Inverse Square (Inverse square is the actual attenuation rate for light in the real world.)

3- Exponential

<RaytraceMaterial>.Reflection_Falloff_End_Distance Float default: 100.0 -- animatable

The distance in world units where the reflected ray is fully attenuated.

<RaytraceMaterial>.Refraction_Falloff_Mode   Integer default: 0 -- animatable

Sets the falloff mode for refraction in the raytrace material:

0- Off (Turns off attenuation)

1- Linear

2- Inverse Square (Inverse square is the actual attenuation rate for light in the real world.)

3- Exponential

<RaytraceMaterial>.Refraction_Falloff_End_Distance Float default: 100.0 -- animatable

The distance in world units where the refracted ray is fully attenuated.

<RaytraceMaterial>.Bump_Map_Effect Float default: 1.0 -- animatable

Adjusts the effect of bump maps on raytraced reflections and refractions.

<RaytraceMaterial>.Override_Global_Antialiasing_Settings Boolean default: false—animatable

If Override_Global_Antialiasing_Settings = false, Global Antialiasing Settings are used. If true, the antialiaser is determined by Adaptive_Antialiasing_On.

<RaytraceMaterial>.Adaptive_Antialiasing_On Boolean default: false—animatable

If Adaptive_Antialiasing_On = true, the Multiresolution Adaptive Antialiaser is used; otherwise the Fast Adaptive Antialiaser is used. This property only has an effect if Override_Global_Antialiasing_Settings = true.

The following properties are associated with the Options dialog

<RaytraceMaterial>.Options___Raytracer_Enable Boolean default: true -- animatable

Turns the raytracer on or off.

<RaytraceMaterial>.Options___Antialiasing_Enable Boolean default: true -- animatable

Turns antialiasing on or off.

<RaytraceMaterial>.Options___Self_Reflect_Refract Boolean default: true -- animatable

Turns self reflection/refraction on or off.

<RaytraceMaterial>.Options___Raytrace_Atmospherics Boolean default: true -- animatable

Turns the raytracing of atmospheric effects on or off. Atmospheric effects include fire, fog, volume light, and so on.

<RaytraceMaterial>.Options___Reflect_Refract_Material_ID_s Boolean default: true -- animatable

When on, the material reflects effects assigned to material IDs in the renderer’s G-Buffer.

<RaytraceMaterial>.Options___Raytrace_Objects_in_Glass Boolean default: true -- animatable

Turns the raytracing of objects inside raytraced objects on or off.

<RaytraceMaterial>.Options___Raytrace_Atmospherics_in_Glass Boolean default: true -- animatable

Turns the raytracing of atmospherics inside raytraced objects on or off.

<RaytraceMaterial>.Options___Color_Density___Fog_Enable Boolean default: true -- animatable

Turns the color density and fog features on or off.

The following properties are associated with the Antialiaser configuration dialogs.

<RaytraceMaterial>.Local_Threshold Float default: 0.1 -- animatable

The sensitivity of the adaption algorithm. This value can range from 0 to 1, where 0 always casts the maximum number of rays and 1 always casts only the minimum number of rays.

<RaytraceMaterial>.Local_Min__Rays Integer default: 4 -- animatable

The minimum number of rays that the algorithm casts.

<RaytraceMaterial>.Local_Max__Rays Integer default: 32 -- animatable

The maximum number of rays the algorithm casts.

<RaytraceMaterial>.Local_Blur_Offset Float default: 0.0 -- animatable

The sharpness or blurriness of reflections or refractions without regard to distance. This value is specified in pixels.

<RaytraceMaterial>.Local_Blur_Aspect Float default: 1.0 -- animatable

Changes the shape of the blur by changing the aspect ratio.

<RaytraceMaterial>.Local_Defocus Float default: 0.0 -- animatable

Blurs based on distance. Objects near the surface are not blurred, but objects farther away are blurred. The rays cast are spread as they leave the surface of the raytrace map object.

<RaytraceMaterial>.Local_Defocus_Aspect Float default: 1.0 -- animatable

Changes the shape of the defocusing by changing the aspect ratio.

The following properties are associated with the Maps rollout.

<RaytraceMaterial>.ambientMap TextureMap default: undefined

The map assigned to the ambient map channel.

<RaytraceMaterial>.ambientMapAmount Float default: 100.0

The relative strength of the ambient map channel.

<RaytraceMaterial>.ambientMapEnable Boolean default: false

Turn on/off use of the ambient map channel.

<RaytraceMaterial>.bumpMap TextureMap default: undefined

The map assigned to the bump map channel.

<RaytraceMaterial>.bumpMapAmount Float default: 100.0

The relative strength of the bump map channel.

<RaytraceMaterial>.bumpMapEnable Boolean default: false

Turn on/off use of the bump map channel.

<RaytraceMaterial>.diffuseMap TextureMap default: undefined

The map assigned to the diffuse map channel.

<RaytraceMaterial>.diffuseMapAmount Float default: 100.0

The relative strength of the diffuse map channel.

<RaytraceMaterial>.diffuseMapEnable Boolean default: false

Turn on/off use of the diffuse map channel.

<RaytraceMaterial>.displacementMap TextureMap default: undefined

The map assigned to the displacement map channel.

<RaytraceMaterial>.displacementMapAmount Float default: 100.0

The relative strength of the displacement map channel.

<RaytraceMaterial>.displacementMapEnable Boolean default: false

Turn on/off use of the displacement map channel.

<RaytraceMaterial>.reflectionMap TextureMap default: undefined

The map assigned to the reflection map channel.

<RaytraceMaterial>.reflectionMapAmount Float default: 100.0

The relative strength of the reflection map channel.

<RaytraceMaterial>.reflectionMapEnable Boolean default: false

Turn on/off use of the reflection map channel.

<RaytraceMaterial>.refractionMap TextureMap default: undefined

The map assigned to the refraction map channel.

<RaytraceMaterial>.refractionMapAmount Float default: 100.0

The relative strength of the refraction map channel.

<RaytraceMaterial>.refractionMapEnable Boolean default: false

Turn on/off use of the refraction map channel.

<RaytraceMaterial>.glossinessMap TextureMap default: undefined

The map assigned to the glossiness map channel.

<RaytraceMaterial>.glossinessMapAmount Float default: 100.0

The relative strength of the glossiness map channel.

<RaytraceMaterial>.glossinessMapEnable Boolean default: false

Turn on/off use of the glossiness map channel.

<RaytraceMaterial>.specularLevelMap TextureMap default: undefined

The map assigned to the specularLevel map channel.

<RaytraceMaterial>.specularLevelMapAmount Float default: 100.0

The relative strength of the specularLevel map channel.

<RaytraceMaterial>.specularLevelMapEnable Boolean default: false

Turn on/off use of the specularLevel map channel.

<RaytraceMaterial>.luminosityMap TextureMap default: undefined

The map assigned to the luminosity map channel.

<RaytraceMaterial>.luminosityMapAmount Float default: 100.0

The relative strength of the luminosity map channel.

<RaytraceMaterial>.luminosityMapEnable Boolean default: false

Turn on/off use of the luminosity map channel.

<RaytraceMaterial>.transparencyMap TextureMap default: undefined

The map assigned to the transparency map channel.

<RaytraceMaterial>.transparencyMapAmount Float default: 100.0

The relative strength of the transparency map channel.

<RaytraceMaterial>.transparencyMapEnable Boolean default: false

Turn on/off use of the transparency map channel.

<RaytraceMaterial>.environmentMap TextureMap default: undefined

The map assigned to the environment map channel.

<RaytraceMaterial>.environmentMapAmount Float default: 100.0

The relative strength of the environment map channel.

<RaytraceMaterial>.environmentMapEnable Boolean default: false

Turn on/off use of the environment map channel.

<RaytraceMaterial>.transEnvMap TextureMap default: undefined

The map assigned to the transEnv map channel.

<RaytraceMaterial>.transEnvMapAmount Float default: 100.0

The relative strength of the transEnv map channel.

<RaytraceMaterial>.transEnvMapEnable Boolean default: false

Turn on/off use of the transEnv map channel.

<RaytraceMaterial>.iorMap TextureMap default: undefined

The map assigned to the ior map channel.

<RaytraceMaterial>.iorMapAmount Float default: 100.0

The relative strength of the ior map channel.

<RaytraceMaterial>.iorMapEnable Boolean default: false

Turn on/off use of the ior map channel.

<RaytraceMaterial>.translucencyMap TextureMap default: undefined

The map assigned to the translucency map channel.

<RaytraceMaterial>.translucencyMapAmount Float default: 100.0

The relative strength of the translucency map channel.

<RaytraceMaterial>.translucencyMapEnable Boolean default: false

Turn on/off use of the translucency map channel.

<RaytraceMaterial>.extraLightingMap TextureMap default: undefined

The map assigned to the extraLighting map channel.

<RaytraceMaterial>.extraLightingMapAmount Float default: 100.0

The relative strength of the extraLighting map channel.

<RaytraceMaterial>.extraLightingMapEnable Boolean default: false

Turn on/off use of the extraLighting map channel.

<RaytraceMaterial>.fluorescenceMap TextureMap default: undefined

The map assigned to the fluorescence map channel.

<RaytraceMaterial>.fluorescenceMapAmount Float default: 100.0

The relative strength of the fluorescence map channel.

<RaytraceMaterial>.fluorescenceMapEnable Boolean default: false

Turn on/off use of the fluorescence map channel.

<RaytraceMaterial>.colorDensityMap TextureMap default: undefined

The map assigned to the colorDensity map channel.

<RaytraceMaterial>.colorDensityMapAmount Float default: 100.0

The relative strength of the colorDensity map channel.

<RaytraceMaterial>.colorDensityMapEnable Boolean default: false

Turn on/off use of the colorDensity map channel.

<RaytraceMaterial>.fogColorMap TextureMap default: undefined

The map assigned to the fogColor map channel.

<RaytraceMaterial>.fogColorMapAmount Float default: 100.0

The relative strength of the fogColor map channel.

<RaytraceMaterial>.fogColorMapEnable Boolean default: false

Turn on/off use of the fogColor map channel.

<RaytraceMaterial>.diffusionMap TextureMap default: undefined

The map assigned to the diffusion map channel.

<RaytraceMaterial>.diffusionMapAmount Float default: 100.0

The relative strength of the diffusion map channel.

<RaytraceMaterial>.diffusionMapEnable Boolean default: false

Turn on/off use of the diffusion map channel.

<RaytraceMaterial>.specularMap TextureMap default: undefined

The map assigned to the specular color map channel.

<RaytraceMaterial>.specularMapAmount Float default: 100.0

The relative strength of the specular color map channel.

<RaytraceMaterial>.specularMapEnable Boolean default: false

Turn on/off use of the specular color map channel.

The following properties are associated with the Dynamics Properties rollout.

Note: These properties are not present in Autodesk VIZ.

<RaytraceMaterial>.Bounce_Coefficient Float default: 1.0 -- animatable

Sets how far an object bounces after hitting a surface. The higher the value, the greater the bounce. A value of 1 represents a "perfectly elastic collision" or a bounce in which no kinetic energy is lost.

<RaytraceMaterial>.Static_Friction Float default: 0.0 -- animatable

Sets how difficult it is for the object to start moving along a surface. The higher this value, the more difficult.

<RaytraceMaterial>.Sliding_Friction Float default: 0.0 -- animatable

Sets how difficult it is for the object to keep moving over a surface. The higher this value, the more difficult for the object to keep moving.

The following properties do not correspond to any user-interface items, but appear to be used by the raytracer. These properties appear to be similar to the corresponding properties for the Raytrace TextureMap.

<RaytraceMaterial>.Attenuation_Start Float default: 0.0

The distance in world units where attenuation begins.

<RaytraceMaterial>.Attenuation_Exponent Float default: 2.0

The distance in world units where the ray is fully attenuated.

<RaytraceMaterial>.Attenuation_Color_Mode Integer default: 0

This affects the behavior of light rays as they attenuate out:

0- Background (As the ray attenuates out, returns the background (either the scene’s background or the background specified locally in the Raytracer Parameters rollout) rather than the actual color of what the reflected/refracted ray sees.)

1- Use Attenuation_Color

<RaytraceMaterial>.Attenuation_Color Color default: (color 0 0 0)

The color used for attenuation.

<RaytraceMaterial>.Attenuation_Near Float default: 1.0

The strength of the reflected/refracted ray at the start range distance. This is a normalized percentage that can range from 0.0 to 1.0.

<RaytraceMaterial>.Attenuation_Control_1 Float default: 0.6666

Controls the shape of the curve near the curve start.

<RaytraceMaterial>.Attenuation_Control_2 Float default: 0.3333

Controls the shape of the curve near the curve end.

<RaytraceMaterial>.Attenuation_Far Float default: 0.0

Sets the strength of the reflected/refracted ray at the end range distance. This is a normalized percentage that can range from 0.0 to 1.0.

<RaytraceMaterial>.Blur_Map Boolean default: false

When on, the software uses a map to apply the Blur Offset value. That is, where the map is white, blur offset is fully applied, and where it is black, it is ignored. For example, if the map is a Checker map, blur offset is applied only in every other square. Values between black and white cause less blur.

<RaytraceMaterial>.Defocus_Map Boolean default: false

When on, uses a map to apply the Defocus value. That is, where the map is white, Defocus is fully applied, and where it is black, it is ignored. For example, if the map is a Checker map, Defocus is applied only in every other square. Values between black and white cause less defocusing.

<RaytraceMaterial>.Enable_Reflection_Falloff Boolean default: false

Turns on/off falloff of reflection.

<RaytraceMaterial>.Reflection_Falloff_Distance Float default: 0.0

The distance until the reflections are fully attenuated.

<RaytraceMaterial>.Enable_Refraction_Falloff Boolean default: false

Turns on/off falloff of refraction.

<RaytraceMaterial>.Refraction_Falloff_Distance Float default: 0.0

The distance until the refractions are fully attenuated.

<RaytraceMaterial>.supersample Boolean default: false

Toggle Supersampling on and off.

<RaytraceMaterial>.ShaderType  Integer default: 1

The shader index:

1- Phong

2- Metal

3- Blinn

4- Oren Nayar-Blinn

5- Anisotropy

<RaytraceMaterial>.shaderByName String default: "Phong"

Sets the type of shader with a string, rather than a number. Enter "phong", "metal", "blinn", "ONB" or "Anisotropic"

Note:

The .shaderType and .shaderByName are linked and will automatically change each others values.

<RaytraceMaterial>.TwoSided  Boolean default: false

Turns on/off the 2-Sided property

<RaytraceMaterial>.Wire  Boolean default: false

Turns on/off wireframe mode

<RaytraceMaterial>.FaceMap  Boolean default: false

Turns on/off face mapping

The following additional properties have been exposed since 3ds Max 5:

<RaytraceMaterial>.Anisotropy Float default: 50.0 -- animatable; percentage

Get/Set the Anisotropy percentage.

<RaytraceMaterial>.Orientation Float default: 0.0 -- animatable; percentage

Get/Set the Anisotropy Orientation percentage.

<RaytraceMaterial>.sampler_param_block SubAnim default: SubAnim:sampler_Param_Block -- SubAnim

Read-only access to the Sampler Parameters.

<RaytraceMaterial.sampler_param_block>.sampler_on Boolean default: false -- animatable

Get/Set the Sampler enabled state.

<RaytraceMaterial.sampler_param_block>.sampler_quality Float default: 0.5 -- animatable

Get/Set the Sampler quality value.

Notes

MacroRecorder gives incorrect property names when changing SuperSampling rollout items.

Some items in SuperSampling rollout are not scriptable.

RaytraceMaterial interfaces:

Interface: ExposureMaterialControl

Properties:

.noExposureControl : boolean : Read|Write

When set to true, Exposure Controls will ignore the material.

.exposureControlInvertSelfIllum : boolean : Read|Write

When set to true, Self-Illumination values from this material will be inverted.

.exposureControlInvertReflection : boolean : Read|Write

When set to true, Reflection values from this material will be inverted.

.exposureControlInvertRefraction : boolean : Read|Write

When set to true, Refraction values from this material will be inverted.

See also

Material Common Properties, Operators, and Methods

MAXWrapper Common Properties, Operators, and Methods

Value Common Properties, Operators, and Methods