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

#include <TextureResource.h>

+ Inheritance diagram for FTextureRenderTargetCubeResource:

Public Member Functions

 FTextureRenderTargetCubeResource (const class UTextureRenderTargetCube *InOwner)
 
virtual class FTextureRenderTargetCubeResourceGetTextureRenderTargetCubeResource ()
 
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
 
FUnorderedAccessViewRHIRef GetUnorderedAccessViewRHI ()
 
float GetDisplayGamma () const override
 
ENGINE_API bool ReadPixels (TArray< FColor > &OutImageData, FReadSurfaceDataFlags InFlags, FIntRect InRect=FIntRect(0, 0, 0, 0))
 
ENGINE_API bool ReadPixels (TArray< FFloat16Color > &OutImageData, FReadSurfaceDataFlags InFlags, FIntRect InRect=FIntRect(0, 0, 0, 0))
 
- Public Member Functions inherited from FTextureRenderTargetResource
 FTextureRenderTargetResource ()
 
virtual const FTextureRHIRefGetShaderResourceTexture () const override
 
virtual class FTextureRenderTarget2DResourceGetTextureRenderTarget2DResource ()
 
virtual class FTextureRenderTarget2DArrayResourceGetTextureRenderTarget2DArrayResource ()
 
virtual class FTextureRenderTargetVolumeResourceGetTextureRenderTargetVolumeResource ()
 
virtual void ClampSize (int32 SizeX, int32 SizeY)
 
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 ()
 
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
 
- 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 UTextureRenderTargetCube
 

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 cube render target textures.

Constructor & Destructor Documentation

◆ FTextureRenderTargetCubeResource()

FTextureRenderTargetCubeResource::FTextureRenderTargetCubeResource ( const class UTextureRenderTargetCube InOwner)
inline

Constructor

Parameters
InOwner- cube texture object to create a resource for

Member Function Documentation

◆ GetDisplayGamma()

float FTextureRenderTargetCubeResource::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.

◆ GetSizeX()

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

Implements FTextureRenderTargetResource.

◆ GetSizeXY()

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

Implements FRenderTarget.

◆ GetSizeY()

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

Implements FTextureRenderTargetResource.

◆ GetTextureRenderTargetCubeResource()

virtual class FTextureRenderTargetCubeResource * FTextureRenderTargetCubeResource::GetTextureRenderTargetCubeResource ( )
inlinevirtual

Cube texture RT resource interface

Reimplemented from FTextureRenderTargetResource.

◆ GetUnorderedAccessViewRHI()

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

◆ InitRHI()

void FTextureRenderTargetCubeResource::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.

◆ ReadPixels() [1/2]

PRAGMA_DISABLE_DEPRECATION_WARNINGS bool FTextureRenderTargetCubeResource::ReadPixels ( TArray< FColor > &  OutImageData,
FReadSurfaceDataFlags  InFlags,
FIntRect  InRect = FIntRect(0, 0, 0, 0) 
)
virtual

Copy the texels of a single face of the cube into an array.

Parameters
OutImageData- float16 values will be stored in this array.
InFlags- read flags. ensure cubeface member has been set.
InRect- Rectangle of texels to copy.
Returns
true if the read succeeded.

Copy the texels of a single face of a cube texture into an array.

Parameters
OutImageData- RGBA8 values will be stored in this array.
InFlags- read flags. ensure cubeface member has been set.
InRect- Rectangle of texels to copy. Empty InRect (0,0,0,0) defaults to the whole surface size.
Returns
True if the read succeeded.

Reimplemented from FRenderTarget.

◆ ReadPixels() [2/2]

bool FTextureRenderTargetCubeResource::ReadPixels ( TArray< FFloat16Color > &  OutImageData,
FReadSurfaceDataFlags  InFlags,
FIntRect  InRect = FIntRect(0, 0, 0, 0) 
)

Copy the texels of a single face of the cube into an array.

Parameters
OutImageData- float16 values will be stored in this array.
InFlags- read flags. ensure cubeface member has been set.
InRect- Rectangle of texels to copy.
Returns
true if the read succeeded.

Copy the texels of a single face of a cube texture into an array.

Parameters
OutImageData- float16 values will be stored in this array.
InFlags- read flags. ensure cubeface member has been set.
InRect- Rectangle of texels to copy. Empty InRect (0,0,0,0) defaults to the whole surface size.
Returns
True if the read succeeded.

◆ ReleaseRHI()

void FTextureRenderTargetCubeResource::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.

◆ UpdateDeferredResource()

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

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

Implements FDeferredUpdateResource.

Friends And Related Symbol Documentation

◆ UTextureRenderTargetCube

Updates (resolves) the render target texture. Optionally clears each face 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: