DwaMixMaterial

Overview


DwaMixMaterial allows for multiple materials to be blended sequentially, and it supports up to 64 material inputs. The bindable mix attribute is responsible for selecting the material, and it ranges from 0 to 63. The range can be specified from 0 to 1, but only if the remap_mix_to_inputs attribute, which scales [0, 1] to [0, num_materials - 1], is true.

Any mix values that fall between material selections will blend the materials together. This blending is the same style of blending performed by the DwaLayerMaterial. In essence, this material provides a combination of the ability to select materials like DwaSwitchMaterial and the ability to blend between them like DwaLayerMaterial.


Attribute Reference

Advanced attributes

blend_color_space

Int enum
  0 = “RGB” (default)
  1 = “HSV”
  2 = “HSL”

Color space used when blending the two material's color parameters

fallback_bssrdf

Int enum
  0 = “normalized diffusion” (default)
  1 = “dipole”
  2 = “random walk”

If child materials disagree on the type of bssrdf, this type will be used instead.

fallback_clearcoat_use_bending

Bool
default: True

If child materials disagree on the type of clearcoat use bending, this type will be used instead.

fallback_outer_specular_model

Int enum
  0 = “Beckmann”
  1 = “GGX” (default)

If child materials disagree on the type of outer specular model, this type will be used instead.

fallback_prevent_light_culling

Bool
default: False

If child materials disagree on prevent light culling, this will be used instead.

fallback_specular_model

Int enum
  0 = “Beckmann”
  1 = “GGX” (default)

If child materials disagree on the type of specular model, this type will be used instead.

fallback_thin_geometry

Bool
default: True

If child materials disagree on the type of thin geometry, this type will be used instead.

sss_trace_set

TraceSet
default: None

By default, only the geometry associated with this material contributes to subsurface. The DwaLayerMaterial ignores the sss trace sets of the submaterials. If you want adjacent geometry with different material to contribute as well, specify all those parts here.

Glitter Fallback attributes

fallback_glitter_LOD_quality

Float
default: 0.5

controls quality of glitter at distances where individual flakes cannot be perceived; at lower values, approximation kicks in earlier. This parameter will only be used when layering two distinct glitter materials.

fallback_glitter_debug_mode

Int enum
  0 = “off” (default)
  1 = “blend”
  2 = “color”
  3 = “averageColor”
  4 = “footprintArea”
  5 = “radius”

developer debug visualization modes. This parameter will only be used when layering two distinct glitter materials.

fallback_glitter_layering_mode

Int enum
  0 = “physical” (default)
  1 = “additive”

layering mode for glitter on top of the under material. physical: conserves energy and glitter attenuates under material, additive: breaks energy conservation but glitter is never darker than the under material (eg. use case: snow). This parameter will only be used when layering two distinct glitter materials.

fallback_glitter_randomness

Float
default: 0.5

randomness of flake orientation. This parameter will only be used when layering two distinct glitter materials.

fallback_glitter_seed

Int
default: 0

The seed for the glitter random number generator. This parameter will only be used when layering two distinct glitter materials.

fallback_glitter_space

Int enum
  4 = “object”
  5 = “reference” (default)

The space to calculate the worley noise in, defaults to reference space. This parameter will only be used when layering two distinct glitter materials.

fallback_glitter_style_A_frequency

Float
default: 1.0

0 implies none of this style, 1 implies all the flakes will get this style. This parameter will only be used when layering two distinct glitter materials.

fallback_glitter_style_B_frequency

Float bindable
default: 1.0

0 implies none of this style, 1 implies all the flakes will get this style. This parameter will only be used when layering two distinct glitter materials.

fallback_glitter_texture_A

String filename
default:

filename that points to a texture .exr or .tx file (must be mip-mapped and tiled with maketx). This parameter will only be used when layering two distinct glitter materials.

fallback_glitter_texture_B

String
default:

filename that points to a texture .exr or .tx file (must be mip-mapped and tiled with maketx). This parameter will only be used when layering two distinct glitter materials.

General attributes

extra_aovs

Map
default: None

Bind this attribute to a 'ListMap' that contains references to ExtraAovMaps that specify additional outputs that can be assigned to a RenderOutput "light aov" result

label

String
default:

label used in material and light aovs

material0

DwaBaseLayerable
default: None

material input

material1

DwaBaseLayerable
default: None

material input

material10

DwaBaseLayerable
default: None

material input

material11

DwaBaseLayerable
default: None

material input

material12

DwaBaseLayerable
default: None

material input

material13

DwaBaseLayerable
default: None

material input

material14

DwaBaseLayerable
default: None

material input

material15

DwaBaseLayerable
default: None

material input

material16

DwaBaseLayerable
default: None

material input

material17

DwaBaseLayerable
default: None

material input

material18

DwaBaseLayerable
default: None

material input

material19

DwaBaseLayerable
default: None

material input

material2

DwaBaseLayerable
default: None

material input

material20

DwaBaseLayerable
default: None

material input

material21

DwaBaseLayerable
default: None

material input

material22

DwaBaseLayerable
default: None

material input

material23

DwaBaseLayerable
default: None

material input

material24

DwaBaseLayerable
default: None

material input

material25

DwaBaseLayerable
default: None

material input

material26

DwaBaseLayerable
default: None

material input

material27

DwaBaseLayerable
default: None

material input

material28

DwaBaseLayerable
default: None

material input

material29

DwaBaseLayerable
default: None

material input

material3

DwaBaseLayerable
default: None

material input

material30

DwaBaseLayerable
default: None

material input

material31

DwaBaseLayerable
default: None

material input

material32

DwaBaseLayerable
default: None

material input

material33

DwaBaseLayerable
default: None

material input

material34

DwaBaseLayerable
default: None

material input

material35

DwaBaseLayerable
default: None

material input

material36

DwaBaseLayerable
default: None

material input

material37

DwaBaseLayerable
default: None

material input

material38

DwaBaseLayerable
default: None

material input

material39

DwaBaseLayerable
default: None

material input

material4

DwaBaseLayerable
default: None

material input

material40

DwaBaseLayerable
default: None

material input

material41

DwaBaseLayerable
default: None

material input

material42

DwaBaseLayerable
default: None

material input

material43

DwaBaseLayerable
default: None

material input

material44

DwaBaseLayerable
default: None

material input

material45

DwaBaseLayerable
default: None

material input

material46

DwaBaseLayerable
default: None

material input

material47

DwaBaseLayerable
default: None

material input

material48

DwaBaseLayerable
default: None

material input

material49

DwaBaseLayerable
default: None

material input

material5

DwaBaseLayerable
default: None

material input

material50

DwaBaseLayerable
default: None

material input

material51

DwaBaseLayerable
default: None

material input

material52

DwaBaseLayerable
default: None

material input

material53

DwaBaseLayerable
default: None

material input

material54

DwaBaseLayerable
default: None

material input

material55

DwaBaseLayerable
default: None

material input

material56

DwaBaseLayerable
default: None

material input

material57

DwaBaseLayerable
default: None

material input

material58

DwaBaseLayerable
default: None

material input

material59

DwaBaseLayerable
default: None

material input

material6

DwaBaseLayerable
default: None

material input

material60

DwaBaseLayerable
default: None

material input

material61

DwaBaseLayerable
default: None

material input

material62

DwaBaseLayerable
default: None

material input

material63

DwaBaseLayerable
default: None

material input

material7

DwaBaseLayerable
default: None

material input

material8

DwaBaseLayerable
default: None

material input

material9

DwaBaseLayerable
default: None

material input

mix

Float bindable
default: 0.0

Which of the 64 inputs (0 to 63) to use. Fractional values will mix the two materials the value lies between

mix_interpolation

Int enum
  0 = “linear” (default)
  1 = “hold”
  2 = “nearest”
  3 = “smooth”

Adjusts rate of transition from one material to the next based on mix value

priority

Int
default: 0

The material's place in an order of precedence for overlapping dielectrics. A value of 0 means the priority should be ignored. Materials with lower numbers (higher priority) "override" materials with higher numbers (lower priority). To enable automatic removal of self-overlapping geometry, a non-zero priority must be set on the geometry's material.

record_reflected_cryptomatte

Bool
default: False

Indicates whether the next reflected surface should appear in the reflected cryptomatte layers

record_refracted_cryptomatte

Bool
default: False

Indicates whether the next refracted surface should appear in the refracted cryptomatte layers

remap_mix_to_inputs

Bool
default: True

When enabled, multiplies mix value by number of inputs used. Inputs should start at 0 with no gaps