Engine.Material

Extends

MaterialInterface

Modifiers

native ( Material ) hidecategories ( object )

Copyright 1998-2011 Epic Games, Inc. All Rights Reserved.

Core.Object
|   
+-- Engine.Surface
   |   
   +-- Engine.MaterialInterface
      |   
      +-- Engine.Material

Direct Known Subclasses:

DecalMaterial, PreviewMaterial

AnisotropicDirection Source code

Specify a vector to use as anisotropic direction

bIsFallbackMaterial Source code

Indicates that the material will be used as a fallback on sm2 platforms

bIsMasked Source code

TRUE if Material is masked and uses custom opacity

bIsPreviewMaterial Source code

TRUE if Material is the preview material used in the material editor.

bUsedAsSpecialEngineMaterial Source code

This is a special usage flag that allows a material to be assignable to any primitive type. This is useful for materials used by code to implement certain viewmodes, for example the default material or lighting only material. The cost is that nearly 20x more shaders will be compiled for the material than the average material, which will greatly increase shader compile time and memory usage. This flag should only be set when absolutely necessary, and is purposefully not exposed to the UI to prevent abuse.

bUsedWithParticleSystem Source code

bUsesDistortion Source code

TRUE if Material uses distortion

CustomLighting Source code

Use a custom light transfer equation to be factored with light color, attenuation and shadowing. This is currently only used for Movable, Toggleable and Dominant light contribution. LightVector can be used in this material input and will be set to the tangent space light direction of the current light being rendered.

CustomSkylightDiffuse Source code

Use a custom diffuse factor for attenuation with lights that only support a diffuse term. This should only be the diffuse color coefficient, and must not depend on LightVector. This is currently used with skylights, SH lights, materials exported to lightmass and directional lightmap contribution.

DefaultMaterialInstances[3] Source code

DiffuseColor Source code

DiffusePower Source code

Distortion Source code

Allows the material to distort background color by offsetting each background pixel by the amount of the distortion input for that pixel.

EditorComments Source code

Array of comments associated with this material; viewed in the material editor.

EditorCompounds Source code

Array of material expression compounds associated with this material; viewed in the material editor.

EditorParameters Source code

EditorPitch Source code

EditorX Source code

EditorY Source code

EditorYaw Source code

EmissiveColor Source code

Expressions Source code

Array of material expressions, excluding Comments and Compounds. Used by the material editor.

MaterialResources[2] Source code

Normal Source code

Opacity Source code

OpacityMask Source code

PhysicalMaterial Source code

For backwards compatibility only.

ReferencedTextureGuids Source code

ReferencedTextures Source code

Legacy texture references, now handled by FMaterial.

SpecularColor Source code

SpecularPower Source code

SubsurfaceAbsorptionColor Source code

Light from subsurface scattering is attenuated by SubsurfaceAbsorptionColor^Distance.

SubsurfaceInscatteringColor Source code

Modulates the local contribution to the subsurface scattered lighting of the material.

SubsurfaceScatteringRadius Source code

The maximum distance light from subsurface scattering will travel.

TessellationFactors Source code

Multiplies to the tessellation factors applied when a tessellation mode is set. X = Edges, Y = Inside

TwoSidedLightingColor Source code

Modulates the lighting without the Lambertian term in two sided lighting.

TwoSidedLightingMask Source code

Lerps between lighting color (diffuse * attenuation * Lambertian) and lighting without the Lambertian term color (diffuse * attenuation * TwoSidedLightingColor).

WorldDisplacement Source code

Offset in tangent space applied to tessellated vertices. A scalar connected to this input will be treated as the z component (float3(0,0,x)).

WorldPositionOffset Source code

Adds to world position in the vertex shader.

D3D11

bEnableMaskedAntialiasing Source code

Indicates that the material should be rendered with antialiasing. Opacity is evaluated multiple times (for each MSAA sample).

bUseImageBasedReflections Source code

Replaces analytical phong specular highlights on this material with an image based reflection, Specified by the ImageReflection actors placed in the world. Only works in D3D11.

D3D11TessellationMode Source code

The type of tessellation to apply to this object. Note D3D11 required for anything except MTM_NoTessellation.

EnableSeparateTranslucency Source code

Indicates that the material should be rendered in the SeparateTranslucency Pass (does not affect bloom, not affected by DOF).

EnableSubsurfaceScattering Source code

Indicates that the material should be rendered with subsurface scattering.

ImageReflectionNormalDampening Source code

Values larger than 1 dampen the normal used for image reflections, values smaller than 1 exaggerate the normal used for image reflections.

Material

BlendMode Source code

Determines how the material's color is blended with background colors.

LightingModel Source code

Determines how inputs are combined to create the material's final color.

OpacityMaskClipValue Source code

If BlendMode is BLEND_Masked or BLEND_SoftMasked, the surface is not rendered where OpacityMask < OpacityMaskClipValue.

TwoSided Source code

Indicates that the material should be rendered without backface culling and the normal should be flipped for backfaces.

Misc

bAllowLightmapSpecular Source code

Controls whether lightmap specular will be rendered or not. Can be disabled to reduce instruction count.

bPerPixelCameraVector Source code

When enabled, the camera vector will be computed in the pixel shader instead of the vertex shader which may improve the quality of the reflection. Enabling this setting also allows VertexColor expressions to be used alongside Transform expressions.

ShadowDepthBias Source code

Can be used to bias shadows away from the surface.

Wireframe Source code

MutuallyExclusiveUsage

bUsedAsLightFunction Source code

bUsedWithDecals Source code

WARNING: bUsedWithDecals is mutually exclusive with all other mesh type usage flags! A material with bUsedWithDecals=true will not work on any other mesh type.

bUsedWithFogVolumes Source code

Indicates that the material is used on fog volumes. This usage flag is mutually exclusive with all other mesh type usage flags!

PhysicalMaterial

BlackPhysicalMaterial Source code

The physical material to use when a black pixel in the PhysMaterialMask texture is hit.

PhysMaterial Source code

Physical material to use for this graphics material. Used for sounds, effects etc.

PhysMaterialMask Source code

A 1 bit monochrome texture that represents a mask for what physical material should be used if the collided texel is black or white.

PhysMaterialMaskUVChannel Source code

The UV channel to use for the PhysMaterialMask.

WhitePhysicalMaterial Source code

The physical material to use when a white pixel in the PhysMaterialMask texture is hit.

Translucency

bAllowFog Source code

Whether the material should allow fog or be unaffected by fog. This only has meaning for materials with translucent blend modes.

bAllowTranslucencyDoF Source code

Whether the material should allow Depth of Field or be unaffected by DoF. This only has meaning for materials with translucent blend modes.

bCastLitTranslucencyShadowAsMasked Source code

If this is set, lit translucent objects will cast shadow as if they were masked

bDisableDepthTest Source code

Allows the material to disable depth tests, which is only meaningful with translucent blend modes. Disabling depth tests will make rendering significantly slower since no occluded pixels can get zculled.

bTranslucencyInheritDominantShadowsFromOpaque Source code

Whether the material should inherit the dynamic shadows that dominant lights are casting on opaque and masked materials behind this material. This is useful for ground meshes using a translucent blend mode and depth biased alpha to hide seams.

bTranslucencyReceiveDominantShadowsFromStatic Source code

Whether the material should receive dynamic dominant light shadows from static objects when the material is being lit by a light environment. This is useful for character hair.

bUseLitTranslucencyDepthPass Source code

If this is set, a depth-only pass for will be rendered for solid (A=255) areas of dynamic lit translucency primitives. This improves hair sorting at the extra render cost.

bUseLitTranslucencyPostRenderDepthPass Source code

If this is set, a depth-only pass for will be rendered for any visible (A>0) areas of dynamic lit translucency primitives. This is necessary for correct fog and DoF of hair

bUseOneLayerDistortion Source code

Whether the material should use one-layer distortion, which can be cheaper than normal distortion for some primitive types (mainly fluid surfaces). One layer distortion won't handle overlapping one layer distortion primitives correctly. This causes an extra scene color resolve for the first primitive that uses one layer distortion and so should only be used in very specific circumstances.

TwoSidedSeparatePass Source code

Indicates that the material should be rendered in its own pass. Used for hair renderering

Usage

bUsedWithAPEXMeshes Source code

bUsedWithBeamTrails Source code

bUsedWithFluidSurfaces Source code

bUsedWithFracturedMeshes Source code

bUsedWithGammaCorrection Source code

Gamma corrects the output of the base pass using the current render target's gamma value. This must be set on materials used with UIScenes to get correct results.

bUsedWithInstancedMeshes Source code

bUsedWithInstancedMeshParticles Source code

Enables instancing for mesh particles. Use the "Vertex Color" node when enabled, not "MeshEmit VertColor."

bUsedWithLandscape Source code

bUsedWithLensFlare Source code

bUsedWithMaterialEffect Source code

bUsedWithMorphTargets Source code

bUsedWithParticleSprites Source code

bUsedWithParticleSubUV Source code

bUsedWithRadialBlur Source code

bUsedWithScreenDoorFade Source code

Enables support for screen door fading for primitives rendering with this material. This adds an extra texture lookup and a few extra instructions.

bUsedWithSkeletalMesh Source code

Indicates that the material and its instances can be assigned to skeletal meshes. This will result in the shaders required to support skeletal meshes being compiled which will increase shader compile time and memory usage.

bUsedWithSpeedTree Source code

bUsedWithSplineMeshes Source code

bUsedWithStaticLighting Source code

bUsedWithTerrain Source code

ColorMaterialInput Source code

MaterialInput Source code

ScalarMaterialInput Source code

Vector2MaterialInput Source code

VectorMaterialInput Source code

defaultproperties
{
	BlendMode=BLEND_Opaque
	DiffuseColor=(Constant=(R=128,G=128,B=128))
	DiffusePower=(Constant=1.0)
	SpecularColor=(Constant=(R=128,G=128,B=128))
	SpecularPower=(Constant=15.0)
	Distortion=(ConstantX=0,ConstantY=0)
	Opacity=(Constant=1)
	OpacityMask=(Constant=1)
	OpacityMaskClipValue=0.3333
	ShadowDepthBias=0
	TwoSidedLightingColor=(Constant=(R=255,G=255,B=255))
	SubsurfaceInscatteringColor=(Constant=(R=255,G=255,B=255))
	SubsurfaceAbsorptionColor=(Constant=(R=230,G=200,B=200))
	bAllowFog=TRUE
	bUsedWithStaticLighting=FALSE
	bAllowLightmapSpecular=TRUE
	PhysMaterialMaskUVChannel=-1
	D3D11TessellationMode=MTM_NoTessellation
	ImageReflectionNormalDampening=5
}