IVirtualTexture::ProducePageData

Upload page data to the cache, data must have been previously requested, and reported either 'Available' or 'Pending' The system will attempt to call RequestPageData/ProducePageData only once for a given vLevel/vAddress, with all the requested layers set in LayerMask, this is important for certain types of procedural producers that may generate multiple layers of VT data at the same time It's valid to produce 'Pending' page data, but in this case ProducePageData may block until data is ready Only called from render thread

Windows
MacOS
Linux

References

Module

RenderCore

Header

/Engine/Source/Runtime/RenderCore/Public/VirtualTexturing.h

Include

#include "VirtualTexturing.h"

Syntax

IVirtualTextureFinalizer * ProducePageData
(
    FRHICommandListImmediate & RHICmdList,
    ERHIFeatureLevel::Type FeatureLevel,
    EVTProducePageFlags Flags,
    const FVirtualTextureProducerHandle & ProducerHandle,
    uint8 LayerMask,
    uint8 vLevel,
    uint64 vAddress,
    uint64 RequestHandle,
    const FVTProduceTargetLayer * TargetLayers
)

Remarks

Upload page data to the cache, data must have been previously requested, and reported either 'Available' or 'Pending' The system will attempt to call RequestPageData/ProducePageData only once for a given vLevel/vAddress, with all the requested layers set in LayerMask, this is important for certain types of procedural producers that may generate multiple layers of VT data at the same time It's valid to produce 'Pending' page data, but in this case ProducePageData may block until data is ready Only called from render thread

Returns

a 'IVirtualTextureFinalizer' which must be finalized to complete the operation

Parameters

Parameter

Description

RHICmdList

Used to write any commands required to generate the VT page data

FeatureLevel

The current RHI feature level

ProducerHandle

Handle to this producer

LayerMask

Mask of requested layers; can be used to only produce data for these layers as an optimization, or ignored if all layers are logically produced together

vLevel

The mipmap level of the data

vAddress

Bit-interleaved x,y page indexes

RequestHandle

opaque handle returned from 'RequestPageData'

TargetLayers

Array of 'FVTProduceTargetLayer' structs, gives location where each layer should write data

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