UMaterialInstance

Choose your operating system:

Windows

macOS

Linux

Inheritance Hierarchy

UObjectBase

UObjectBaseUtility

UObject

UMaterialInterface

UMaterialInstance

UMaterialInstanceConstant

ULandscapeMaterialInstanceConstant

UMaterialInstanceDynamic

References

Module	Engine
Header	/Engine/Source/Runtime/Engine/Classes/Materials/MaterialInstance.h
Include	#include "Materials/MaterialInstance.h"

Syntax

class UMaterialInstance : public UMaterialInterface

Variables

	Name	Description
FMaterialInstan...	BasePropertyOverrides
uint8: 1	bCastDynamicShadowAsMasked
uint8: 1	bHasStaticPermutationResource	Indicates whether the instance has static permutation resources (which are required when static parameters are present) Read directly from the rendering thread, can only be modified with the use of a FMaterialUpdateContext.
uint8: 1	bIsShadingModelFromMaterialExpression
TEnumAsByte< EB...	BlendMode
bool	bLoadedCachedData
uint8: 1	bOutputTranslucentVelocity
uint8: 1	bOverrideSubsurfaceProfile	Defines if SubsurfaceProfile from this instance is used or it uses the parent one.
TUniquePtr< FMa...	CachedData
uint8: 1	DitheredLODTransition
TArray< struct ...	DoubleVectorParameterValues	DoubleVector parameters.
TArray< struct ...	FontParameterValues	Font parameters.
float	OpacityMaskClipValue	Cached copies of the base property overrides or the value from the parent to avoid traversing the parent chain for each access.
TObjectPtr< cla...	Parent	Parent material.
TObjectPtr< cla...	PhysicalMaterialMap	Physical material map used with physical material mask, when it exists.
TObjectPtr< cla...	PhysMaterial	Physical material to use for this graphics material. Used for sounds, effects etc.
bool[2]	ReentrantFlag	Flag to detect cycles in the material instance graph, this is only used at content creation time where the hierarchy can be changed.
FMaterialInstan...	Resource	FMaterialRenderProxy derivative that represent this material instance to the renderer, when the renderer needs to fetch parameter values.
TArray< struct ...	RuntimeVirtualTextureParameterValues	RuntimeVirtualTexture parameters.
TArray< struct ...	ScalarParameterValues	Scalar parameters.
FMaterialShadin...	ShadingModels
TArray< struct ...	TextureParameterValues	Texture parameters.
uint8: 1	TwoSided
TArray< struct ...	VectorParameterValues	Vector parameters.

Constructors

	Name	Description
	UMaterialInstance ( const FObjectInitializer& ObjectIn... )

Destructors

	Name	Description
	~UMaterialInstance()

Functions

	Name	Description
void	AddParameterValueInternal ( const FMaterialParameterInfo& Para..., const FMaterialParameterMetadata& ..., EMaterialSetParameterValueFlags Fla... )
void	AddReferencedObjects ( UObject* InThis, FReferenceCollector& Collector )
void	AllMaterialsCacheResourceShadersForRendering ( bool bUpdateProgressDialog )	For all materials instances, UMaterialInstance::CacheResourceShadersForRendering.
FMaterialRes...	AllocatePermutationResource()
void	BeginAllowCachingStaticParameterValues()
void	CacheResourceShadersForCooking ( EShaderPlatform ShaderPlatform, TArray< FMaterialResource* >&..., EMaterialShaderPrecompileMode Preco..., const ITargetPlatform* TargetP... )	Cache resource shaders for rendering on the given shader platform.
void	CacheResourceShadersForRendering ( EMaterialShaderPrecompileMode Preco..., FMaterialResourceDeferredDeletionAr... )	Cache resource shaders for rendering on the given shader platform.
void	CacheResourceShadersForRendering ( EMaterialShaderPrecompileMode Preco... )	Cache resource shaders for rendering on the given shader platform.
void	CacheShadersForResources ( EShaderPlatform ShaderPlatform, const TArray< FMaterialResource..., EMaterialShaderPrecompileMode Preco..., const ITargetPlatform* TargetP... )	Caches shader maps for an array of material resources.
void	ClearParameterValuesInternal ( EMaterialInstanceClearParameterFlag... )
void	CopyMaterialInstanceParameters ( UMaterialInterface* Source )	Copies over material instance parameters from the base material given a material interface.
void	CopyMaterialUniformParametersInternal ( UMaterialInterface* Source )	Copies the uniform parameters (scalar, vector and texture) from a material or instance hierarchy.
void	DumpDebugInfo()
void	EndAllowCachingStaticParameterValues()
bool	Equivalent ( const UMaterialInstance* Compa... )
void	GetAllShaderMaps ( TArray< FMaterialShaderMap* > ... )	Gathers actively used shader maps from all material resources used by this material instance
void	GetBasePropertyOverridesHash ( FSHAHash& OutHash )	Properties of the base material. Can now be overridden by instances.
const FMater...	GetCachedInstanceData()
bool	GetParameterOverrideValue ( EMaterialParameterType Type, const FMemoryImageMaterialParameter..., FMaterialParameterMetadata& OutVal... )
bool	GetReentrantFlag ( bool bIsInGameThread )
const FStati...	GetStaticParameters()	Gets static parameter set for this material.
void	GetStaticParameterValues ( FStaticParameterSet& OutStaticPara... )	Builds a composited set of static parameters, including inherited and overridden values
void	GetTextureExpressionValues ( const FMaterialResource* Mater..., TArray< UTexture* >& OutTextu..., TArray< TArray< int32 > >* Out... )
bool	HasOverridenBaseProperties()
void	InitResources()	Initialize the material instance's resources.
void	InitStaticPermutation ( EMaterialShaderPrecompileMode Preco... )	Recompiles static permutations if necessary.
bool	IsChildOf ( const UMaterialInterface* Mate... )	Determine whether this Material Instance is a child of another Material
void	PropagateDataToMaterialProxy()	To share code between PostLoad() and PostEditChangeProperty()
void	RemoveLayerParameterIndex ( int32 Index )
void	ReserveParameterValuesInternal ( EMaterialParameterType Type, int32 Capacity )	Internal interface for setting / updating values for material instances.
void	SaveShaderStableKeys ( const ITargetPlatform* TP )
void	SetDoubleVectorParameterValueInternal ( const FMaterialParameterInfo& Para..., FVector4d Value )
void	SetFontParameterValueInternal ( const FMaterialParameterInfo& Para..., UFont* FontValue, int32 FontPage )
bool	SetMaterialLayers ( const FMaterialLayersFunctions& La... )
void	SetParameterValueInternal ( const FMaterialParameterInfo& Para..., const FMaterialParameterMetadata& ..., EMaterialSetParameterValueFlags Fla... )
bool	SetParentInternal ( UMaterialInterface* NewParent, bool RecacheShaders )
void	SetReentrantFlag ( const bool bValue, bool bIsInGameThread )
void	SetRuntimeVirtualTextureParameterValueInternal ( const FMaterialParameterInfo& Para..., URuntimeVirtualTexture* Value )
void	SetScalarParameterAtlasInternal ( const FMaterialParameterInfo& Para..., FScalarParameterAtlasInstanceData A... )
bool	SetScalarParameterByIndexInternal ( int32 ParameterIndex, float Value )
void	SetScalarParameterValueInternal ( const FMaterialParameterInfo& Para..., float Value, bool bUseAtlas, FScalarParameterAtlasInstanceData A... )
void	SetStaticSwitchParameterValueEditorOnly ( const FMaterialParameterInfo& Para..., bool Value )
void	SetTextureParameterValueInternal ( const FMaterialParameterInfo& Para..., UTexture* Value )
bool	SetVectorParameterByIndexInternal ( int32 ParameterIndex, FLinearColor Value )
void	SetVectorParameterValueInternal ( const FMaterialParameterInfo& Para..., FLinearColor Value )
void	SwapLayerParameterIndices ( int32 OriginalIndex, int32 NewIndex )
void	UpdateCachedData()
void	UpdateOverridableBaseProperties()
void	UpdateParameterNames()	Refresh parameter names using the stored reference to the expression object for the parameter.
bool	UpdateParameters()	Updates parameter names on the material instance, returns true if parameters have changed.
void	UpdateStaticPermutation ( const FStaticParameterSet& NewPara..., FMaterialUpdateContext* Materi... )	Sets new static parameter overrides on the instance and recompiles the static permutation resources if needed.
void	UpdateStaticPermutation ( FMaterialUpdateContext* Materi... )	Ensure's static permutations for current parameters and overrides are upto date.
void	UpdateStaticPermutation ( const FStaticParameterSet& NewPara..., FMaterialInstanceBasePropertyOverri..., const bool bForceStaticPermutationU..., FMaterialUpdateContext* Materi... )	Sets new static parameter overrides on the instance and recompiles the static permutation resources if needed (can be forced with bForceRecompile).
void	ValidateTextureOverrides ( ERHIFeatureLevel::Type InFeatureLev... )

Overridden from UMaterialInterface

	Name	Description
bool	CastsRayTracedShadows()
bool	CheckMaterialUsage ( const EMaterialUsage Usage )	Checks if the material can be used with the given usage flag.
bool	CheckMaterialUsage_Concurrent ( const EMaterialUsage Usage )	Same as above but is valid to call from any thread.
int32	CompilePropertyEx ( FMaterialCompiler* Compiler, const FGuid& AttributeID )	Allows material properties to be compiled with the option of being overridden by the material attributes input.
void	ForceRecompileForRendering()	Clears the shader cache and recompiles the shader for rendering.
void	GetAllParametersOfType ( EMaterialParameterType Type, TMap< FMaterialParameterInfo, FMate... )
EBlendMode	GetBlendMode()
const FMater...	GetCachedExpressionData ( TMicRecursionGuard RecursionGuard )
bool	GetCastShadowAsMasked()
void	GetDependencies ( TSet< UMaterialInterface* >& ... )	Get this material dependencies.
void	GetDependentFunctions ( TArray< class UMaterialFunctionInte... )
float	GetDiffuseBoost()
float	GetEmissiveBoost()
float	GetExportResolutionScale()
bool	GetGroupSortPriority ( const FString& InGroupName, int32& OutSortPriority )	Get the sort priority index of the given parameter group
void	GetLightingGuidChain ( bool bIncludeTextures, TArray< FGuid >& OutGuids )	Returns all the Guids related to this material.
UMaterial &#...	GetMaterial()	Get the material which we are instancing.
const UMater...	GetMaterial()	Get the material which we are instancing.
const UMater...	GetMaterial_Concurrent ( TMicRecursionGuard RecursionGuard )	Same as above, but can be called concurrently
void	GetMaterialInheritanceChain ( FMaterialInheritanceChain& OutChai... )
bool	GetMaterialLayers ( FMaterialLayersFunctions& OutLayer..., TMicRecursionGuard RecursionGuard )	Get the material layers stack
FMaterialRes...	GetMaterialResource ( ERHIFeatureLevel::Type InFeatureLev..., EMaterialQualityLevel::Type Quality... )	Get the static permutation resource if the instance has one
const FMater...	GetMaterialResource ( ERHIFeatureLevel::Type InFeatureLev..., EMaterialQualityLevel::Type Quality... )	Get the static permutation resource if the instance has one
float	GetOpacityMaskClipValue()	Access to overridable properties of the base material.
bool	GetParameterValue ( EMaterialParameterType Type, const FMemoryImageMaterialParameter..., FMaterialParameterMetadata& OutVal..., EMaterialGetParameterValueFlags Fla... )
UPhysicalMat...	GetPhysicalMaterial()	Return a pointer to the physical material used by this material instance.
UPhysicalMat...	GetPhysicalMaterialFromMap ( int32 Index )	Return a pointer to the physical material from mask map at given index.
UPhysicalMat...	GetPhysicalMaterialMask()	Return a pointer to the physical material mask used by this material instance.
void	GetReferencedTexturesAndOverrides ( TSet< const UTexture* >& InOu... )	Add to the set any texture referenced by expressions, including nested functions, as well as any overrides from parameters.
bool	GetRefractionSettings ( float& OutBiasValue )
FMaterialRen...	GetRenderProxy()	Return a pointer to the FMaterialRenderProxy used for rendering.
void	GetShaderTypes ( EShaderPlatform Platform, const ITargetPlatform* TargetP..., TArray< FDebugShaderTypeInfo >& Ou... )	Gathers a list of shader types sorted by vertex factory types that should be cached for this material.
FMaterialSha...	GetShadingModels()
USubsurfaceP...	GetSubsurfaceProfile_Internal()
float	GetTextureDensity ( FName TextureName, const FMeshUVChannelInfo& UVChanne... )	Returns the density of a texture in (LocalSpace Unit / Texture).
bool	GetTexturesInPropertyChain ( EMaterialProperty InProperty, TArray< UTexture* >& OutTextu..., TArray< FName >* OutTexturePar..., FStaticParameterSet* InStaticP..., ERHIFeatureLevel::Type InFeatureLev..., EMaterialQualityLevel::Type InQuali... )	Get all of the textures in the expression chain for the given property (ie fill in the given array with all textures in the chain).
void	GetUsedTextures ( TArray< UTexture* >& OutTextu..., EMaterialQualityLevel::Type Quality..., bool bAllQualityLevels, ERHIFeatureLevel::Type FeatureLevel, bool bAllFeatureLevels )	Return the textures used to render this material.
void	GetUsedTexturesAndIndices ( TArray< UTexture* >& OutTextu..., TArray< TArray< int32 > >& OutIndi..., EMaterialQualityLevel::Type Quality..., ERHIFeatureLevel::Type FeatureLevel )	Return the textures used to render this material and the material indices bound to each.
bool	IsDependent ( UMaterialInterface* TestDepend... )	Test this material for dependency on a given material.
bool	IsDependent_Concurrent ( UMaterialInterface* TestDepend..., TMicRecursionGuard RecursionGuard )	Same as above, but can be called concurrently
bool	IsDitheredLODTransition()
bool	IsMasked()
bool	IsPropertyActive ( EMaterialProperty InProperty )	Checks to see if an input property should be active, based on the state of the material
bool	IsShadingModelFromMaterialExpression()
bool	IsTranslucencyWritingVelocity()
bool	IsTwoSided()
bool	IterateDependentFunctions ( TFunctionRef< bool... )
void	LogMaterialsAndTextures ( FOutputDevice& Ar, int32 Indent )	Output to the log which materials and textures are used by this material.
void	OverrideNumericParameterDefault ( EMaterialParameterType Type, const FHashedMaterialParameterInfo ..., const UE::Shader::FValue& Value, bool bOverride, ERHIFeatureLevel::Type FeatureLevel )	Overrides the default value of the given parameter (transient).
void	OverrideTexture ( const UTexture* InTextureToOve..., UTexture* OverrideTexture, ERHIFeatureLevel::Type InFeatureLev... )	Override a specific texture (transient)
void	RecacheUniformExpressions ( bool bRecreateUniformBuffer )	Re-caches uniform expressions for this material interface Set bRecreateUniformBuffer to true if uniform buffer layout will change (e.g. FMaterial is being recompiled).
void	SaveShaderStableKeysInner ( const ITargetPlatform* TP, const FStableShaderKeyAndValue& Sa... )
bool	UpdateLightmassTextureTracking()	Check if the textures have changed since the last time the material was serialized for Lightmass...

Overridden from UObject

	Name	Description
void	BeginCacheForCookedPlatformData ( const ITargetPlatform* TargetP... )	Starts caching of platform specific data for the target platform Called when cooking before serialization so that object can prepare platform specific data Not called during normal loading of objects
void	BeginDestroy()	Called before destroying the object.
void	ClearAllCachedCookedPlatformData()	Clear all cached cooked platform data
void	ClearCachedCookedPlatformData ( const ITargetPlatform* TargetP... )	Clears cached cooked platform data for specific platform
void	FinishDestroy()	Called to finish destroying the object.
void	GetResourceSizeEx ( FResourceSizeEx& CumulativeResourc... )	Get the size of the object/resource for use in memory tools or to display to artists/LDs in the Editor This is the extended version which separates up the used memory into different memory regions (the actual definition of which may be platform specific).
bool	IsCachedCookedPlatformDataLoaded ( const ITargetPlatform* TargetP... )	Have we finished loading all the cooked platform data for the target platforms requested in BeginCacheForCookedPlatformData
bool	IsReadyForFinishDestroy()	Called to check if the object is ready for FinishDestroy.
void	PostEditChangeProperty ( FPropertyChangedEvent& PropertyCha... )	Called when a property on this object has been modified externally
void	PostInitProperties()	Called after the C++ constructor and after the properties have been initialized, including those loaded from config.
void	PostLoad()	Do any object-specific cleanup required immediately after loading an object.
void	PreSave ( FObjectPreSaveContext SaveContext )	Presave function.
void	Serialize ( FArchive& Ar )	Handles reading, writing, and reference collecting using FArchive.

Typedefs

Name	Description
FCustomParameterSetUpdaterDelegate	Delegate for custom static parameters updater.
FCustomStaticParametersGetterDelegate	Delegate for custom static parameters getter.

Constants

Name	Description
CustomParameterSetUpdaters	An array of custom parameter set updaters.
CustomStaticParametersGetters	Custom static parameters getter delegate.

Deprecated Variables

		Name	Description
	bool	bOverrideBaseProperties_DEPRECATED

Deprecated Functions

	Name	Description
void	GetAllParameterInfo ( TArray< FMaterialParameterInfo >& ..., TArray< FGuid >& OutParameterIds )	Use GetAllParameterInfoOfType or GetAllParametersOfType
void	PreSave ( const ITargetPlatform* TargetP... )	Use version that takes FObjectPreSaveContext instead.
void	UpdatePermutationAllocations ( FMaterialResourceDeferredDeletionAr... )	Calling UpdatePermutationAllocations is no longer necessary