3ds Max C++ API Reference
Material Requirements Flags

Macros

#define MTLREQ_2SIDE   (1<<0)
 The material is 2-sided. More...
 
#define MTLREQ_WIRE   (1<<1)
 The material is wire frame material. More...
 
#define MTLREQ_WIRE_ABS   (1<<2)
 Wire frame material, absolute size. More...
 
#define MTLREQ_TRANSP   (1<<3)
 The material uses transparency. More...
 
#define MTLREQ_UV   (1<<4)
 The material requires UVW coordinates. More...
 
#define MTLREQ_FACEMAP   (1<<5)
 The material uses "face map" UV coordinates. More...
 
#define MTLREQ_XYZ   (1<<6)
 The material requires object XYZ coordinates. More...
 
#define MTLREQ_OXYZ   (1<<7)
 The material requires object ORIGINAL XYZ coordinates. More...
 
#define MTLREQ_BUMPUV   (1<<8)
 The Material requires UV bump vectors. More...
 
#define MTLREQ_BGCOL   (1<<9)
 The material requires background color (e.g. More...
 
#define MTLREQ_PHONG   (1<<10)
 The material requires interpolated normal. More...
 
#define MTLREQ_AUTOREFLECT   (1<<11)
 The material needs to build auto-reflect map. More...
 
#define MTLREQ_AUTOMIRROR   (1<<12)
 The material needs to build auto-mirror map. More...
 
#define MTLREQ_NOATMOS   (1<<13)
 This is used by the Matte material for example. More...
 
#define MTLREQ_ADDITIVE_TRANSP   (1<<14)
 Normally, if this is not specified, the background color is attenuated. More...
 
#define MTLREQ_VIEW_DEP   (1<<15)
 Maps or materials which depend on the view should set this bit in their Requirements() method. More...
 
#define MTLREQ_UV2   (1<<16)
 The material requires second uv channel values (vertex colors). More...
 
#define MTLREQ_BUMPUV2   (1<<17)
 The material requires second uv channel bump vectors. More...
 
#define MTLREQ_PREPRO   (1<<18)
 Pre-processing. More...
 
#define MTLREQ_DONTMERGE_FRAGMENTS   (1<<19)
 No longer used. More...
 
#define MTLREQ_DISPLACEMAP   (1<<20)
 Material has a Displacement map channel. More...
 
#define MTLREQ_SUPERSAMPLE   (1<<21)
 This tells the scanline renderer that you want super sampling - the Standard material uses this. More...
 
#define MTLREQ_WORLDCOORDS   (1<<22)
 This flag is set by UVGen and XYZGen when world coordinates are involved. More...
 
#define MTLREQ_TRANSP_IN_VP   (1<<23)
 This flag should be returned true for any material that wants to be transparent in the viewport. More...
 
#define MTLREQ_FACETED   (1<<24)
 The material should be rendered faceted in the viewports. More...
 
#define MTLREQ_NOEXPOSURE   (1<<25)
 Do not do the tone-op (ie, for matte/shadow material, etc) More...
 
#define MTLREQ_SS_GLOBAL   (1<<26)
 Material requires supersampling but use global sampler. More...
 
#define MTLREQ_REND1   (1<<28)
 USED IN RENDERER. More...
 
#define MTLREQ_REND2   (1<<29)
 USED IN RENDERER. More...
 
#define MTLREQ_REND3   (1<<30)
 USED IN RENDERER. More...
 
#define MTLREQ_REND4   (1<<31)
 USED IN RENDERER. More...
 

Detailed Description

See also
Class MtlBase, Class RenderInstance

Macro Definition Documentation

◆ MTLREQ_2SIDE

#define MTLREQ_2SIDE   (1<<0)

The material is 2-sided.

◆ MTLREQ_WIRE

#define MTLREQ_WIRE   (1<<1)

The material is wire frame material.

◆ MTLREQ_WIRE_ABS

#define MTLREQ_WIRE_ABS   (1<<2)

Wire frame material, absolute size.

◆ MTLREQ_TRANSP

#define MTLREQ_TRANSP   (1<<3)

The material uses transparency.

◆ MTLREQ_UV

#define MTLREQ_UV   (1<<4)

The material requires UVW coordinates.

◆ MTLREQ_FACEMAP

#define MTLREQ_FACEMAP   (1<<5)

The material uses "face map" UV coordinates.

◆ MTLREQ_XYZ

#define MTLREQ_XYZ   (1<<6)

The material requires object XYZ coordinates.

◆ MTLREQ_OXYZ

#define MTLREQ_OXYZ   (1<<7)

The material requires object ORIGINAL XYZ coordinates.

◆ MTLREQ_BUMPUV

#define MTLREQ_BUMPUV   (1<<8)

The Material requires UV bump vectors.

◆ MTLREQ_BGCOL

#define MTLREQ_BGCOL   (1<<9)

The material requires background color (e.g.

Matte mtl).

◆ MTLREQ_PHONG

#define MTLREQ_PHONG   (1<<10)

The material requires interpolated normal.

◆ MTLREQ_AUTOREFLECT

#define MTLREQ_AUTOREFLECT   (1<<11)

The material needs to build auto-reflect map.

◆ MTLREQ_AUTOMIRROR

#define MTLREQ_AUTOMIRROR   (1<<12)

The material needs to build auto-mirror map.

◆ MTLREQ_NOATMOS

#define MTLREQ_NOATMOS   (1<<13)

This is used by the Matte material for example.

The matte material samples the background itself and handles the fogging characteristics, so it does not need to have the atmospheric shader do this again. This suppresses the atmospheric shader. (used by Matte mtl)

◆ MTLREQ_ADDITIVE_TRANSP

#define MTLREQ_ADDITIVE_TRANSP   (1<<14)

Normally, if this is not specified, the background color is attenuated.

For instance, for a material that 30% transparent (70% opaque), you take 30% of the background color and 70% of the material color.

Setting this flag causes the computation to be done by multiplying 0.7 times the material color and then adding this to the background color, which is left un-attenuated. Specifies that transparent composites are done additively.

◆ MTLREQ_VIEW_DEP

#define MTLREQ_VIEW_DEP   (1<<15)

Maps or materials which depend on the view should set this bit in their Requirements() method.

◆ MTLREQ_UV2

#define MTLREQ_UV2   (1<<16)

The material requires second uv channel values (vertex colors).

◆ MTLREQ_BUMPUV2

#define MTLREQ_BUMPUV2   (1<<17)

The material requires second uv channel bump vectors.

◆ MTLREQ_PREPRO

#define MTLREQ_PREPRO   (1<<18)

Pre-processing.

MtlBase::BuildMaps is called on every frame.

◆ MTLREQ_DONTMERGE_FRAGMENTS

#define MTLREQ_DONTMERGE_FRAGMENTS   (1<<19)

No longer used.

◆ MTLREQ_DISPLACEMAP

#define MTLREQ_DISPLACEMAP   (1<<20)

Material has a Displacement map channel.

◆ MTLREQ_SUPERSAMPLE

#define MTLREQ_SUPERSAMPLE   (1<<21)

This tells the scanline renderer that you want super sampling - the Standard material uses this.

This takes multiple samples spread around in the pixel which provides an additional level of anti-aliasing. The material requires supersampling

◆ MTLREQ_WORLDCOORDS

#define MTLREQ_WORLDCOORDS   (1<<22)

This flag is set by UVGen and XYZGen when world coordinates are involved.

The renderer looks at this and if it is set, takes the validity interval of the Node's transform matrix into account in computing the validity of a displacement mapped mesh. The material has world coordinates are used in material/map evaluation.

◆ MTLREQ_TRANSP_IN_VP

#define MTLREQ_TRANSP_IN_VP   (1<<23)

This flag should be returned true for any material that wants to be transparent in the viewport.

The material is transparent in the viewport ( opacity < 100, or opacity map & ShowMapInVP set).

◆ MTLREQ_FACETED

#define MTLREQ_FACETED   (1<<24)

The material should be rendered faceted in the viewports.

◆ MTLREQ_NOEXPOSURE

#define MTLREQ_NOEXPOSURE   (1<<25)

Do not do the tone-op (ie, for matte/shadow material, etc)

◆ MTLREQ_SS_GLOBAL

#define MTLREQ_SS_GLOBAL   (1<<26)

Material requires supersampling but use global sampler.

◆ MTLREQ_REND1

#define MTLREQ_REND1   (1<<28)

USED IN RENDERER.

◆ MTLREQ_REND2

#define MTLREQ_REND2   (1<<29)

USED IN RENDERER.

◆ MTLREQ_REND3

#define MTLREQ_REND3   (1<<30)

USED IN RENDERER.

◆ MTLREQ_REND4

#define MTLREQ_REND4   (1<<31)

USED IN RENDERER.