LiteFX::Rendering::ICommandBuffer::transfer

Performs a buffer-to-buffer transfer from a temporary buffer into target.

Synopsis

Declared in <litefx/rendering_api.hpp>

[[dllimport, dllexport]] void transfer(
    void const const* data,
    size_t size,
    IImage const& target,
    UInt32 subresource = 0) const;

Description

This method creates a temporary buffer and maps data into it, before transferring it into target. A reference of the temporary buffer is stored until the parent command queue finished using the command buffer. At this point, the command queue calls releaseSharedState to release all shared references. Note that this is a relaxed constraint. It is only guaranteed, that the queue calls this method at some point after the command buffer has been executed.

Parameters

Name	Description
data	The address that marks the beginning of the data to map.
size	The number of bytes to map.
target	The target buffer to transfer data to.
subresource	The index of the sub-resource of the target image to receive data.