RayTraceMaterial : Material

Constructor

rayTraceMaterial ...

Properties

<RaytraceMaterial>.Ambient_Color_On    Float        default: 0.0

If Ambient_Color_On = 0, 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  Float        default: 0.0

If Luminosity_Color_On = 0, 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  Float      default: 0.0

If Transparency_Color_On = 0, 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     Float        default: 0.0

If Reflect_Color_On = 0, 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: 100.0 -- animatable; percentage

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: 100.0 -- animatable; percentage

Sets the size of the wire in wireframe mode.

<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 255 255 255) -- animatable

The color of the density fog.

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

Set the type of reflection:

Default (Reflections are layered with the diffuse color)

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: false

Turns raytracing of reflective objects on or off.

<RaytraceMaterial>.Enable_Raytraced_Refractions  Boolean   default: true

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>.flourescenceMap                             TextureMap default: undefined

The map assigned to the flourescence map channel.

<RaytraceMaterial>.flourescenceMapAmount                       Float default: 100.0

The relative strength of the flourescence map channel.

<RaytraceMaterial>.flourescenceMapEnable                       Boolean default: false

Turn on/off use of the flourescence 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. These properties are not present in 3D Studio 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.

Notes

The following user-interface properties not exposed to MAXScript in 3ds max 3: Shading, 2-Sided, Wire, Face Map, and SuperSample

See also