Vulkan-Docs/doc/specs/vulkan/man/vkCmdCopyBuffer.txt

60 lines
1.6 KiB
Plaintext

vkCmdCopyBuffer(3)
===================
Name
----
vkCmdCopyBuffer - Copy data between buffer regions.
C Specification
---------------
include::../protos/vkCmdCopyBuffer.txt[]
Parameters
----------
pname:commandBuffer::
The command buffer into which the copy command is to be placed.
pname:srcBuffer::
The buffer containing the data to be copied.
pname:dstBuffer::
The buffer into which data will be copied.
pname:regionCount::
The number of regions of data to copy.
pname:pRegions::
An array of pname:regionCount regions of data to be copied.
Description
-----------
fname:vkCmdCopyBuffer copies regions of data from a source buffer to a destination
buffer. pname:regionCount regions are copied from pname:srcBuffer to pname:dstBuffer. Each
region is represented by a member of the pname:pRegions array, which is an array of
the slink:VkBufferCopy structure, whose definition is:
include::../structs/VkBufferCopy.txt[]
If any two or more regions within pname:pRegions overlap, the resulting data will be
undefined. It is recomended, but not required, that the regions given in pname:pRegions
start on multiples of four bytes and have a length which is a multiple of four bytes.
include::../validity/protos/vkCmdCopyBuffer.txt[]
Notes
-----
Although fname:vkCmdCopyBuffer does not generate errors or return a value, enabled
validation layers may detect possible error conditions or potentially undefined
behavior and report this via some other means.
See Also
--------
flink:vkCmdCopyImage, flink:vkCmdCopyBufferToImage, flink:vkCmdCopyImageToBuffer
include::footer.txt[]