Unreal Engine 4.26 Documentation

Unreal Engine 4.27 Documentation

Unreal Engine 5.0 Documentation

Unreal Engine 5.1 Documentation

Unreal Engine 5.2 Documentation

Unreal Engine 5.3 Documentation

> Unreal Engine API Reference > Runtime > Engine > Materials > FMaterialRenderProxy

Light Theme

Dark Theme

FMaterialRenderProxy

A material render proxy used by the renderer.

Inheritance Hierarchy

FRenderResource

FNoncopyable

FColoredMaterialRenderProxy

	FColoredTexturedMaterialRenderProxy
	FDynamicColoredMaterialRenderProxy
	FLightingDensityMaterialRenderProxy

FLandscapeDebugMaterialRenderProxy

FLandscapeLayerUsageRenderProxy

FLandscapeMaskMaterialRenderProxy

FLandscapeSelectMaterialRenderProxy

FOverrideSelectionColorMaterialRenderProxy

References

Module	Engine
Header	/Engine/Source/Runtime/Engine/Public/Materials/MaterialRenderProxy.h
Include	#include "Materials/MaterialRenderProxy.h"

Syntax

class FMaterialRenderProxy :
public FRenderResource,
public FNoncopyable

Remarks

A material render proxy used by the renderer.

Variables

		Name	Description
	FImmutableSampl...	ImmutableSamplerState	Cached external texture immutable samplers
	FUniformExpress...	UniformExpressionCache	Cached uniform expressions.

Constructors

	Name	Description
	FMaterialRenderProxy ( FString InMaterialName )	Default constructor.

Destructors

	Name	Description
	~FMaterialRenderProxy()	Destructor.

Functions

	Name	Description
void	CacheUniformExpressions ( bool bRecreateUniformBuffer )	Caches uniform expressions for efficient runtime evaluation.
void	CacheUniformExpressions_GameThread ( bool bRecreateUniformBuffer )	Enqueues a rendering command to cache uniform expressions for efficient runtime evaluation.
void	CancelCacheUniformExpressions()	Cancels an in-flight cache operation.
void	EvaluateUniformExpressions ( FUniformExpressionCache& OutUnifor..., const FMaterialRenderContext& Cont..., FUniformExpressionCacheAsyncUpdater... )	Evaluates uniform expressions and stores them in OutUniformExpressionCache.
int32	GetExpressionCacheSerialNumber()
const FMater...	GetFallback ( ERHIFeatureLevel::Type InFeatureLev... )
const FMater...	GetIncompleteMaterialWithFallback ( ERHIFeatureLevel::Type InFeatureLev... )	Finds the FMaterial to use for rendering this FMaterialRenderProxy.
UMaterialInt...	GetMaterialInterface()
const FStrin...	GetMaterialName()
const FMater...	GetMaterialNoFallback ( ERHIFeatureLevel::Type InFeatureLev... )	Returns the FMaterial, without using a fallback if the FMaterial doesn't have a valid shader map.
const TSet< ...	GetMaterialRenderProxyMap()
FCriticalSec...	GetMaterialRenderProxyMapLock()
const FMater...	GetMaterialWithFallback ( ERHIFeatureLevel::Type InFeatureLev..., const FMaterialRenderProxy*& O... )	Finds the FMaterial to use for rendering this FMaterialRenderProxy.
bool	GetParameterValue ( EMaterialParameterType Type, const FHashedMaterialParameterInfo ..., FMaterialParameterValue& OutValue, const FMaterialRenderContext& Cont... )
bool	GetScalarValue ( const FHashedMaterialParameterInfo ..., float* OutValue, const FMaterialRenderContext& Cont... )
const USubsu...	GetSubsurfaceProfileRT()
bool	GetTextureValue ( const FHashedMaterialParameterInfo ..., const URuntimeVirtualTexture*&..., const FMaterialRenderContext& Cont... )
bool	GetTextureValue ( const FHashedMaterialParameterInfo ..., const UTexture** OutValue, const FMaterialRenderContext& Cont... )
bool	GetTextureValue ( const FHashedMaterialParameterInfo ..., const USparseVolumeTexture*..., const FMaterialRenderContext& Cont... )
bool	GetVectorValue ( const FHashedMaterialParameterInfo ..., FLinearColor* OutValue, const FMaterialRenderContext& Cont... )
bool	HasDeferredUniformExpressionCacheRequests()
void	InvalidateUniformExpressionCache ( bool bRecreateUniformBuffer )	Invalidates the uniform expression cache.
bool	IsDeleted()
bool	IsMarkedForGarbageCollection()
void	MarkForGarbageCollection()
void	SetSubsurfaceProfileRT ( const USubsurfaceProfile* Ptr )
void	UpdateDeferredCachedUniformExpressions()
void	UpdateUniformExpressionCacheIfNeeded ( ERHIFeatureLevel::Type InFeatureLev... )

Overridden from FRenderResource

	Name	Description
void	InitDynamicRHI()	Initializes the dynamic RHI resource and/or RHI render target used by this resource.
void	ReleaseDynamicRHI()	Releases the dynamic RHI resource and/or RHI render target resources used by this resource.
void	ReleaseResource()	Prepares the resource for deletion. This is only called by the rendering thread.

Constants

Name	Description
DeferredUniformExpressionCacheRequests
MaterialRenderProxyMap	Tracks all material render proxies in all scenes.
MaterialRenderProxyMapLock	Lock that guards the access to the render proxy map

Deprecated Functions

		Name	Description
	void	EvaluateUniformExpressions ( FUniformExpressionCache& OutUnifor..., const FMaterialRenderContext& Cont..., FRHIComputeCommandList* )	EvaluateUniformExpressions with a command list is deprecated.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.

Take our survey

Cancel