> tools

Material

tools/material·v1.5.1

IN:1 OUT:1

SUMMARY

Material writes surface properties as point, primitive or vertex attributes so different parts of the geometry render with different materials in the Aura Render Engine: base color, metallic, roughness, specular, anisotropy, clearcoat, transmission with IOR and dispersion, absorption and emission. Group limits the edit, Override if Material Exists decides whether existing material attributes are replaced, and a Geometry operator can also reference a Material for its whole geometry. The Maps page adds base color, metallic, roughness, specular, anisotropy level and angle, clearcoat, transmission, emission and normal maps with Bump Scale; several TOPs per map are picked per instance by a point attribute, and Per POPX Instance Maps gives each POPX instance its own maps.

Volume settings shade fields rendered as volumes, such as POPX Flow smoke, with scattering, absorption, density scale, sharpening, anisotropy and multiple scattering. Fire settings make hot smoke glow through a blackbody or custom ramp, and can let the fire light the surrounding smoke.

PARAMETERS

PAGEMaterial

[+]Attribute Class	Attrclass	Selects which attribute class the material properties are applied to.
Group	Group	If there are input groups, specifying a group name in this field will cause this POP to act only upon the group specified.
Override if Material Exists	Overrideifexists	Override material attributes that already exist.
[+]Base Color	Basecolor	Sets the diffuse albedo color of the surface.
Metallic	Metallic	Sets how metallic the surface appears.
Roughness	Roughness	Sets the roughness of the surface.
Specular Level	Specularlevel	Sets the specular reflection strength of dielectrics.
[+]Specular Tint	Speculartint	Tints the specular reflection with a color.
Anisotropic Level	Anisotropiclevel	Sets how strongly the anisotropic highlights are stretched.
Anisotropic Angle	Anisotropicangle	Sets the rotation angle of the anisotropic highlights.
Clearcoat Level	Clearcoatlevel	Sets the strength of a secondary specular layer, for car paint or lacquered surfaces.
Clearcoat Roughness	Clearcoatroughness	Sets the roughness of the clearcoat layer.
[+]Clearcoat Tint	Clearcoattint	Tints the clearcoat reflection with a color.
Transmission	Transmission	Sets how much light passes through the surface, for glass and transparent materials.
IOR	Ior	Sets the index of refraction of dielectrics.
Thickness	Thickness	Sets the thickness of the surface for thin-walled materials.
Dispersion	Dispersion	Sets the amount of chromatic dispersion of refractive materials.
[+]Absorption Color	Absorptioncolor	Sets the color the volume absorbs as light passes through.
[+]Emission Color	Emissioncolor	Sets the emitted color of self-illuminating surfaces.
Emission Level	Emissionlevel	Sets the emission intensity of self-illuminating surfaces.
Scattering	Scattering	Sets how much light the medium scatters toward the camera.
Absorption	Absorption	How much light the medium absorbs along the ray.
Density Scale	Densityscale	Multiplies the density read from the flow.
Sharpen	Sharpen	Crisps the smoke by pushing fine wisps and edges away from their surroundings at render time. 0 turns it off.
Anisotropy	Anisotropy	How the smoke scatters light: 0 evenly in every direction, above 0 forward (smoke lit from behind glows at its edges), below 0 back toward the light.
Multiple Scattering	Multiplescattering	Adds the light that bounces around inside the smoke: thick smoke gets a soft, bright interior instead of a dark core.
Multiple Scattering Amount	Msamount	Scales the multiple scattering.
Octaves	Msoctaves	The number of light bounces the multiple scattering approximates. More octaves carry light deeper into dense smoke, for a brighter, softer interior.
Octave Depth	Msdepth	How far each bounce reaches into the smoke. Higher is a deeper, milkier glow; lower keeps the bounced light near the lit side.
Fire Intensity	Fireintensity	Sets how brightly hot smoke glows with a blackbody color from its temperature, not shadowed. Set to 0 for no glow.
Temperature Range	Firerange	The temperatures the glow spans: dark red at the first, white hot at the second.
[+]Fire Ramp	Fireramp	Sets the colors of the fire glow, from the coolest glowing temperature on the left to the hottest on the right.
Open Fire Ramp Editor	Openfirerampeditor	Opens the editor of the custom fire ramp.
Reset Fire Ramp	Resetfireramp	Resets the custom fire ramp.
Fire Lights Smoke	Firelight	Makes the fire light the smoke around it, so the soot above and around a flame picks up its glow.
Fire Light	Firelightamount	Sets how brightly the fire lights the smoke.
Fire Light Radius	Firelightradius	Sets how far the fire light reaches, in world units.

PAGEMaps

Substance TOP	Substance	Sets a Substance TOP whose outputs fill the maps left empty on this page: base color, metallic, roughness, specular, anisotropic level and angle, clearcoat, transmission, emission and normal, matched by the output name. A map set on this page always wins.
Base Color Map(s)	Basecolormap	Sets the TOP or TOPs used as the base color map.
Base Color Map Index	Basecolormapindex	Sets the point attribute that picks which of the Base Color Map(s) each instance uses when several TOPs are given.
Metallic Map(s)	Metallicmap	Sets the TOP or TOPs used as the metallic map.
Metallic Map Index	Metallicmapindex	Sets the point attribute that picks which of the Metallic Map(s) each instance uses when several TOPs are given.
Roughness Map(s)	Roughnessmap	Sets the TOP or TOPs used as the roughness map.
Roughness Map Index	Roughnessmapindex	Sets the point attribute that picks which of the Roughness Map(s) each instance uses when several TOPs are given.
Specular Map(s)	Specularmap	Sets the TOP or TOPs used as the specular map.
Specular Map Index	Specularmapindex	Sets the point attribute that picks which of the Specular Map(s) each instance uses when several TOPs are given.
Aniso Level Map(s)	Anisolevelmap	Sets the TOP or TOPs used as the anisotropic level map.
Aniso Level Map Index	Anisolevelmapindex	Sets the point attribute that picks which of the Aniso Level Map(s) each instance uses when several TOPs are given.
Aniso Angle Map(s)	Anisoanglemap	Sets the TOP or TOPs used as the anisotropic angle map.
Aniso Angle Map Index	Anisoanglemapindex	Sets the point attribute that picks which of the Aniso Angle Map(s) each instance uses when several TOPs are given.
Clearcoat Map(s)	Clearcoatmap	Sets the TOP or TOPs used as the clearcoat map.
Clearcoat Map Index	Clearcoatmapindex	Sets the point attribute that picks which of the Clearcoat Map(s) each instance uses when several TOPs are given.
Transmission Map(s)	Transmissionmap	Sets the TOP or TOPs used as the transmission map.
Transmission Map Index	Transmissionmapindex	Sets the point attribute that picks which of the Transmission Map(s) each instance uses when several TOPs are given.
Emission Map(s)	Emissionmap	Sets the TOP or TOPs used as the emission map.
Emission Map Index	Emissionmapindex	Sets the point attribute that picks which of the Emission Map(s) each instance uses when several TOPs are given.
Normal Map(s)	Normalmap	Sets the TOP or TOPs used as the normal map, for surface bump detail.
Normal Map Index	Normalmapindex	Sets the point attribute that picks which of the Normal Map(s) each instance uses when several TOPs are given.
Bump Scale	Bumpscale	Scales the bump intensity of the normal map.
Per POPX Instance Maps	Instancemaps	Enable to give each POPX instance its own maps from the POPX Maps blocks. Off uses the main maps for every instance.
POPX Maps	Maps	Per-instance maps, one block per instance, used when Per-Instance Maps is on. The block count follows the instances of the input.
Substance TOP	Maps0substance	Sets a Substance TOP whose outputs fill the maps left empty in this instance block, matched by the output name. A map set in the block always wins.
Base Color Map	Maps0basecolormap	Sets the base color map of this instance block.
Metallic Map	Maps0metallicmap	Sets the metallic map of this instance block.
Roughness Map	Maps0roughnessmap	Sets the roughness map of this instance block.
Specular Map	Maps0specularmap	Sets the specular map of this instance block.
Aniso Level Map	Maps0anisolevelmap	Sets the anisotropic level map of this instance block.
Aniso Angle Map	Maps0anisoanglemap	Sets the anisotropic angle map of this instance block.
Clearcoat Map	Maps0clearcoatmap	Sets the clearcoat map of this instance block.
Transmission Map	Maps0transmissionmap	Sets the transmission map of this instance block.
Emission Map	Maps0emissionmap	Sets the emission map of this instance block.
Normal Map (Bump)	Maps0normalmap	Sets the normal map of this instance block, for surface bump detail.
Bump Scale	Maps0bumpscale	Scales the bump intensity of the normal map of this instance block.

PAGECommon

Bypass	Bypass	Pass through the first input to the output unchanged.
Free Extra GPU Memory	Freeextragpumem	Free memory that has accumulated when output memory has grown and shrunk.
Render Primitives	Renderprimitives	Whether to render the full POPX geometry. When off, only point instances are drawn.
Convert to Point Primitives	Converttoptprim	Enable converting points to point primitives when Render Primitives is off.
SRT / RST	Srtrst	Sets the transform order, SRT or RST, used when the points are rendered as TouchDesigner instances.

INPUTS

Input 0 POP - POPX/POP Geometry

OUTPUTS

Output 0 POP - POPX/POP Geometry