UDocumentation UE5.7 10.02.2026 (Source)
API documentation for Unreal Engine 5.7
FTextureRenderTarget2DResource Class Reference

#include <TextureResource.h>

+ Inheritance diagram for FTextureRenderTarget2DResource:

Public Member Functions

 FTextureRenderTarget2DResource (const class UTextureRenderTarget2D *InOwner)
 
virtual ~FTextureRenderTarget2DResource ()
 
FLinearColor GetClearColor ()
 
EPixelFormat GetFormat () const
 
ETextureCreateFlags GetCreateFlags ()
 
virtual class FTextureRenderTarget2DResourceGetTextureRenderTarget2DResource () override
 
virtual void ClampSize (int32 SizeX, int32 SizeY) override
 
virtual void InitRHI (FRHICommandListBase &RHICmdList) override
 
virtual void ReleaseRHI () override
 
virtual uint32 GetSizeX () const override
 
virtual uint32 GetSizeY () const override
 
virtual FIntPoint GetSizeXY () const override
 
virtual float GetDisplayGamma () const override
 
FUnorderedAccessViewRHIRef GetUnorderedAccessViewRHI ()
 
- Public Member Functions inherited from FTextureRenderTargetResource
 FTextureRenderTargetResource ()
 
virtual const FTextureRHIRefGetShaderResourceTexture () const override
 
virtual class FTextureRenderTarget2DArrayResourceGetTextureRenderTarget2DArrayResource ()
 
virtual class FTextureRenderTargetVolumeResourceGetTextureRenderTargetVolumeResource ()
 
virtual class FTextureRenderTargetCubeResourceGetTextureRenderTargetCubeResource ()
 
virtual FRHIGPUMask GetGPUMask (FRHICommandListImmediate &RHICmdList) const final override
 
void SetActiveGPUMask (FRHIGPUMask InGPUMask)
 
- Public Member Functions inherited from FTextureResource
 FTextureResource ()
 
virtual ~FTextureResource ()
 
virtual bool IsProxy () const
 
virtual FTexture2DResourceGetTexture2DResource ()
 
virtual FTexture3DResourceGetTexture3DResource ()
 
virtual FTexture2DArrayResourceGetTexture2DArrayResource ()
 
virtual FStreamableTextureResourceGetStreamableTextureResource ()
 
virtual FVirtualTexture2DResourceGetVirtualTexture2DResource ()
 
virtual const FTexture2DResourceGetTexture2DResource () const
 
virtual const FTexture3DResourceGetTexture3DResource () const
 
virtual const FTexture2DArrayResourceGetTexture2DArrayResource () const
 
virtual const FStreamableTextureResourceGetStreamableTextureResource () const
 
virtual const FVirtualTexture2DResourceGetVirtualTexture2DResource () const
 
int32 GetCurrentMipCount () const
 
bool IsTextureRHIPartiallyResident () const
 
FRHITextureGetTexture2DRHI () const
 
FRHITextureGetTexture3DRHI () const
 
FRHITextureGetTexture2DArrayRHI () const
 
void SetTextureReference (FRHITextureReference *TextureReference)
 
FRHITextureReferenceGetTextureReference () const
 
- Public Member Functions inherited from FTexture
RENDERCORE_API FTexture ()
 
virtual RENDERCORE_API ~FTexture ()
 
RENDERCORE_API FTexture (const FTexture &)
 
RENDERCORE_API FTexture (FTexture &&)
 
RENDERCORE_API FTextureoperator= (const FTexture &Other)
 
RENDERCORE_API FTextureoperator= (FTexture &&Other)
 
const FTextureRHIRefGetTextureRHI ()
 
virtual RENDERCORE_API uint32 GetSizeZ () const
 
virtual RENDERCORE_API FString GetFriendlyName () const override
 
- Public Member Functions inherited from FRenderResource
RENDERCORE_API FRenderResource ()
 
RENDERCORE_API FRenderResource (ERHIFeatureLevel::Type InFeatureLevel)
 
RENDERCORE_API FRenderResource (const FRenderResource &)
 
RENDERCORE_API FRenderResource (FRenderResource &&)
 
RENDERCORE_API FRenderResourceoperator= (const FRenderResource &Other)
 
RENDERCORE_API FRenderResourceoperator= (FRenderResource &&Other)
 
virtual RENDERCORE_API ~FRenderResource ()
 
virtual RENDERCORE_API void InitResource (FRHICommandListBase &RHICmdList)
 
virtual RENDERCORE_API void ReleaseResource ()
 
RENDERCORE_API void UpdateRHI (FRHICommandListBase &RHICmdList)
 
bool IsInitialized () const
 
int32 GetListIndex () const
 
EInitPhase GetInitPhase () const
 
void SetOwnerName (FName InOwnerName)
 
FName GetOwnerName () const
 
void SetResourceName (FName InResourceName)
 
FName GetResourceName () const
 
- Public Member Functions inherited from FRenderTarget
ENGINE_API FRenderTarget ()
 
virtual ENGINE_API ~FRenderTarget ()
 
virtual ENGINE_API const FTextureRHIRefGetRenderTargetTexture () const
 
virtual ENGINE_API FUnorderedAccessViewRHIRef GetRenderTargetUAV () const
 
virtual ENGINE_API FRDGTextureRef GetRenderTargetTexture (FRDGBuilder &GraphBuilder) const
 
virtual EDisplayColorGamut GetDisplayColorGamut () const
 
virtual EDisplayOutputFormat GetDisplayOutputFormat () const
 
virtual bool GetSceneHDREnabled () const
 
virtual void ProcessToggleFreezeCommand ()
 
virtual bool HasToggleFreezeCommand ()
 
virtual ENGINE_API bool ReadPixels (TArray< FColor > &OutImageData, FReadSurfaceDataFlags InFlags=FReadSurfaceDataFlags(RCM_UNorm, CubeFace_MAX), FIntRect InSrcRect=FIntRect(0, 0, 0, 0))
 
ENGINE_API bool ReadPixelsPtr (FColor *OutImageBytes, FReadSurfaceDataFlags InFlags=FReadSurfaceDataFlags(RCM_UNorm, CubeFace_MAX), FIntRect InSrcRect=FIntRect(0, 0, 0, 0))
 
ENGINE_API bool ReadFloat16Pixels (TArray< FFloat16Color > &OutImageData, ECubeFace CubeFace)
 
virtual ENGINE_API bool ReadFloat16Pixels (TArray< FFloat16Color > &OutImageData, FReadSurfaceDataFlags InFlags=FReadSurfaceDataFlags(RCM_UNorm, CubeFace_MAX), FIntRect InSrcRect=FIntRect(0, 0, 0, 0))
 
virtual ENGINE_API bool ReadLinearColorPixels (TArray< FLinearColor > &OutImageData, FReadSurfaceDataFlags InFlags=FReadSurfaceDataFlags(RCM_MinMax, CubeFace_MAX), FIntRect InSrcRect=FIntRect(0, 0, 0, 0))
 
ENGINE_API bool ReadLinearColorPixelsPtr (FLinearColor *OutImageBytes, FReadSurfaceDataFlags InFlags=FReadSurfaceDataFlags(RCM_MinMax, CubeFace_MAX), FIntRect InSrcRect=FIntRect(0, 0, 0, 0))
 
- Public Member Functions inherited from FDeferredUpdateResource
 FDeferredUpdateResource ()
 
ENGINE_API void FlushDeferredResourceUpdate (FRHICommandListImmediate &RHICmdList)
 
ENGINE_API void ResetSceneTextureExtentsHistory ()
 

Protected Member Functions

virtual void UpdateDeferredResource (FRHICommandListImmediate &RHICmdList, bool bClearRenderTarget=true) override
 
void Resize (int32 NewSizeX, int32 NewSizeY, int32 NewNumMips)
 
void Resize (FRHICommandListBase &RHICmdList, int32 NewSizeX, int32 NewSizeY, bool bAutoGenerateMips)
 
- Protected Member Functions inherited from FTextureRenderTargetResource
void SetGPUMask (FRHIGPUMask InGPUMask)
 
- Protected Member Functions inherited from FRenderResource
void SetFeatureLevel (const FStaticFeatureLevel InFeatureLevel)
 
const FStaticFeatureLevel GetFeatureLevel () const
 
bool HasValidFeatureLevel () const
 
template<typename T >
FBufferRHIRef CreateRHIBuffer (FRHICommandListBase &RHICmdList, T &InOutResourceObject, uint32 ResourceCount, EBufferUsageFlags InBufferUsageFlags, const TCHAR *InDebugName)
 
void SetInitPhase (EInitPhase InInitPhase)
 
- Protected Member Functions inherited from FDeferredUpdateResource
ENGINE_API void AddToDeferredUpdateList (bool OnlyUpdateOnce)
 
ENGINE_API void RemoveFromDeferredUpdateList ()
 

Friends

class UTextureRenderTarget2D
 
class FScene
 
class FSceneCapturePass
 

Additional Inherited Members

- Public Types inherited from FRenderResource
enum class  EInitPhase : uint8 { Pre , Default , MAX }
 
- Static Public Member Functions inherited from FTextureRenderTargetResource
static ENGINE_API bool IsSupportedFormat (EPixelFormat Format)
 
- Static Public Member Functions inherited from FRenderResource
static RENDERCORE_API void ReleaseRHIForAllResources ()
 
static RENDERCORE_API void InitPreRHIResources ()
 
static RENDERCORE_API void ChangeFeatureLevel (ERHIFeatureLevel::Type NewFeatureLevel)
 
static RENDERCORE_API FName SetScopeName (FName Name)
 
- Static Public Member Functions inherited from FRenderTarget
static float GetEngineDisplayGamma ()
 
- Static Public Member Functions inherited from FDeferredUpdateResource
static ENGINE_API void UpdateResources (FRHICommandListImmediate &RHICmdList)
 
static void ResetNeedsUpdate ()
 
static bool IsUpdateNeeded ()
 
- Public Attributes inherited from FTexture
FTextureRHIRef TextureRHI
 
FSamplerStateRHIRef SamplerStateRHI
 
FSamplerStateRHIRef DeferredPassSamplerStateRHI
 
double LastRenderTime = -FLT_MAX
 
FMipBiasFade MipBiasFade
 
bool bGreyScaleFormat = false
 
bool bIgnoreGammaConversions = false
 
bool bSRGB = false
 
- Public Attributes inherited from FRenderResource
ERenderResourceState ResourceState = ERenderResourceState::Default
 
- Static Protected Member Functions inherited from FTexture
static RENDERCORE_API FRHISamplerStateGetOrCreateSamplerState (const FSamplerStateInitializerRHI &Initializer)
 
- Static Protected Member Functions inherited from FRenderResource
static RENDERCORE_API FRHICommandListBaseGetImmediateCommandList ()
 
- Protected Attributes inherited from FTextureResource
FTextureReferenceRHIRef TextureReferenceRHI
 
- Protected Attributes inherited from FRenderTarget
FTextureRHIRef RenderTargetTextureRHI
 

Detailed Description

FTextureResource type for 2D render target textures.

Constructor & Destructor Documentation

◆ FTextureRenderTarget2DResource()

PRAGMA_ENABLE_DEPRECATION_WARNINGS FTextureRenderTarget2DResource::FTextureRenderTarget2DResource ( const class UTextureRenderTarget2D InOwner)

Constructor

Parameters
InOwner- 2d texture object to create a resource for

◆ ~FTextureRenderTarget2DResource()

PRAGMA_DISABLE_DEPRECATION_WARNINGS FTextureRenderTarget2DResource::~FTextureRenderTarget2DResource ( )
virtualdefault

Member Function Documentation

◆ ClampSize()

PRAGMA_ENABLE_DEPRECATION_WARNINGS void FTextureRenderTarget2DResource::ClampSize ( int32  MaxSizeX,
int32  MaxSizeY 
)
overridevirtual

Clamp size of the render target resource to max values

Parameters
MaxSizeXmax allowed width
MaxSizeYmax allowed height

Reimplemented from FTextureRenderTargetResource.

◆ GetClearColor()

FLinearColor FTextureRenderTarget2DResource::GetClearColor ( )
inline

◆ GetCreateFlags()

ETextureCreateFlags FTextureRenderTarget2DResource::GetCreateFlags ( )

◆ GetDisplayGamma()

float FTextureRenderTarget2DResource::GetDisplayGamma ( ) const
overridevirtual

Render target resource should be sampled in linear color space

Returns
display gamma expected for rendering to this render target

Reimplemented from FTextureRenderTargetResource.

◆ GetFormat()

EPixelFormat FTextureRenderTarget2DResource::GetFormat ( ) const
inline

◆ GetSizeX()

uint32 FTextureRenderTarget2DResource::GetSizeX ( ) const
overridevirtual
Returns
width of the target
width of target

Implements FTextureRenderTargetResource.

◆ GetSizeXY()

FIntPoint FTextureRenderTarget2DResource::GetSizeXY ( ) const
overridevirtual
Returns
dimensions of the target
dimensions of target surface

Implements FRenderTarget.

◆ GetSizeY()

uint32 FTextureRenderTarget2DResource::GetSizeY ( ) const
overridevirtual
Returns
height of the target
height of target

Implements FTextureRenderTargetResource.

◆ GetTextureRenderTarget2DResource()

virtual class FTextureRenderTarget2DResource * FTextureRenderTarget2DResource::GetTextureRenderTarget2DResource ( )
inlineoverridevirtual

2D texture RT resource interface

Reimplemented from FTextureRenderTargetResource.

◆ GetUnorderedAccessViewRHI()

FUnorderedAccessViewRHIRef FTextureRenderTarget2DResource::GetUnorderedAccessViewRHI ( )
inline
Returns
UnorderedAccessView for rendering

◆ InitRHI()

void FTextureRenderTarget2DResource::InitRHI ( FRHICommandListBase RHICmdList)
overridevirtual

Initializes the dynamic RHI resource and/or RHI render target used by this resource. Called when the resource is initialized, or when reseting all RHI resources. Resources that need to initialize after a D3D device reset must implement this function. This is only called by the rendering thread.

Initializes the RHI render target resources used by this resource. Called when the resource is initialized, or when reseting all RHI resources. This is only called by the rendering thread.

Reimplemented from FRenderResource.

◆ ReleaseRHI()

void FTextureRenderTarget2DResource::ReleaseRHI ( )
overridevirtual

Releases the dynamic RHI resource and/or RHI render target resources used by this resource. Called when the resource is released, or when reseting all RHI resources. Resources that need to release before a D3D device reset must implement this function. This is only called by the rendering thread.

Release the RHI render target resources used by this resource. Called when the resource is released, or when reseting all RHI resources. This is only called by the rendering thread.

Reimplemented from FTexture.

◆ Resize() [1/2]

void FTextureRenderTarget2DResource::Resize ( FRHICommandListBase RHICmdList,
int32  NewSizeX,
int32  NewSizeY,
bool  bAutoGenerateMips 
)
inlineprotected

◆ Resize() [2/2]

void FTextureRenderTarget2DResource::Resize ( int32  NewSizeX,
int32  NewSizeY,
int32  NewNumMips 
)
protected

◆ UpdateDeferredResource()

void FTextureRenderTarget2DResource::UpdateDeferredResource ( FRHICommandListImmediate RHICmdList,
bool  bClearRenderTarget = true 
)
overrideprotectedvirtual

Updates (resolves) the render target texture. Optionally clears the contents of the render target to the clear color. This is only called by the rendering thread.

Convert the input values from the editor to a compatible format for FSamplerStateInitializerRHI. Ensure default sampler is Bilinear clamp

Implements FDeferredUpdateResource.

Friends And Related Symbol Documentation

◆ FScene

friend class FScene
friend

Utility function used for resizing of scene texture sized scene capture render targets in the render thread

◆ FSceneCapturePass

friend class FSceneCapturePass
friend

◆ UTextureRenderTarget2D

Updates (resolves) the render target texture. Optionally clears the contents of the render target to green. This is only called by the rendering thread.


The documentation for this class was generated from the following files: