Class VkCopyImageToImageInfo

java.lang.Object
org.lwjgl.system.Pointer.Default
org.lwjgl.system.Struct<VkCopyImageToImageInfo>
org.lwjgl.vulkan.VkCopyImageToImageInfo
All Implemented Interfaces:
AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
Direct Known Subclasses:
VkCopyImageToImageInfoEXT

public class VkCopyImageToImageInfo extends org.lwjgl.system.Struct<VkCopyImageToImageInfo> implements org.lwjgl.system.NativeResource
Structure specifying parameters of an image to image host copy command.
Description

vkCopyImageToImage does not check whether the device memory associated with srcImage or dstImage is currently in use before performing the copy. The application must guarantee that any previously submitted command that writes to the copy regions has completed before the host performs the copy.

Valid Usage
  • srcImage and dstImage must have been created with identical image creation parameters
  • If srcImage is non-sparse then the image or the specified disjoint plane must be bound completely and contiguously to a single VkDeviceMemory object
  • The srcSubresource.mipLevel member of each element of pRegions must be less than the mipLevels specified in VkImageCreateInfo when srcImage was created
  • If srcSubresource.layerCount is not REMAINING_ARRAY_LAYERS, srcSubresource.baseArrayLayer + srcSubresource.layerCount of each element of pRegions must be less than or equal to the arrayLayers specified in VkImageCreateInfo when srcImage was created
  • srcImage must not have been created with flags containing IMAGE_CREATE_SUBSAMPLED_BIT_EXT
  • The image region specified by each element of pRegions must be contained within the specified srcSubresource of srcImage
  • For each element of pRegions, srcOffset.x and (extent.width + srcOffset.x) must both be greater than or equal to 0 and less than or equal to the width of the specified srcSubresource of srcImage
  • For each element of pRegions, srcOffset.y and (extent.height + srcOffset.y) must both be greater than or equal to 0 and less than or equal to the height of the specified srcSubresource of srcImage
  • If dstImage is non-sparse then the image or the specified disjoint plane must be bound completely and contiguously to a single VkDeviceMemory object
  • The dstSubresource.mipLevel member of each element of pRegions must be less than the mipLevels specified in VkImageCreateInfo when dstImage was created
  • If dstSubresource.layerCount is not REMAINING_ARRAY_LAYERS, dstSubresource.baseArrayLayer + dstSubresource.layerCount of each element of pRegions must be less than or equal to the arrayLayers specified in VkImageCreateInfo when dstImage was created
  • dstImage must not have been created with flags containing IMAGE_CREATE_SUBSAMPLED_BIT_EXT
  • The image region specified by each element of pRegions must be contained within the specified dstSubresource of dstImage
  • For each element of pRegions, dstOffset.x and (extent.width + dstOffset.x) must both be greater than or equal to 0 and less than or equal to the width of the specified dstSubresource of dstImage
  • For each element of pRegions, dstOffset.y and (extent.height + dstOffset.y) must both be greater than or equal to 0 and less than or equal to the height of the specified dstSubresource of dstImage
Valid Usage (Implicit)
  • sType must be STRUCTURE_TYPE_COPY_IMAGE_TO_IMAGE_INFO
  • pNext must be NULL
  • flags must be a valid combination of VkHostImageCopyFlagBits values
  • srcImage must be a valid VkImage handle
  • srcImageLayout must be a valid VkImageLayout value
  • dstImage must be a valid VkImage handle
  • dstImageLayout must be a valid VkImageLayout value
  • pRegions must be a valid pointer to an array of regionCount valid VkImageCopy2 structures
  • regionCount must be greater than 0
  • Both of dstImage, and srcImage must have been created, allocated, or retrieved from the same VkDevice
See Also

VkImageCopy2, CopyImageToImage, CopyImageToImageEXT

Layout


 struct VkCopyImageToImageInfo {
     VkStructureType sType();
     void const * pNext();
     VkHostImageCopyFlags flags();
     VkImage srcImage();
     VkImageLayout srcImageLayout();
     VkImage dstImage();
     VkImageLayout dstImageLayout();
     uint32_t regionCount();
     VkImageCopy2 const * pRegions();
 }
  • Field Details

    • SIZEOF

      public static final int SIZEOF
      The struct size in bytes.
    • ALIGNOF

      public static final int ALIGNOF
      The struct alignment in bytes.
    • STYPE

      public static final int STYPE
      The struct member offsets.
    • PNEXT

      public static final int PNEXT
      The struct member offsets.
    • FLAGS

      public static final int FLAGS
      The struct member offsets.
    • SRCIMAGE

      public static final int SRCIMAGE
      The struct member offsets.
    • SRCIMAGELAYOUT

      public static final int SRCIMAGELAYOUT
      The struct member offsets.
    • DSTIMAGE

      public static final int DSTIMAGE
      The struct member offsets.
    • DSTIMAGELAYOUT

      public static final int DSTIMAGELAYOUT
      The struct member offsets.
    • REGIONCOUNT

      public static final int REGIONCOUNT
      The struct member offsets.
    • PREGIONS

      public static final int PREGIONS
      The struct member offsets.
  • Constructor Details

    • VkCopyImageToImageInfo

      public VkCopyImageToImageInfo(ByteBuffer container)
      Creates a VkCopyImageToImageInfo instance at the current position of the specified ByteBuffer container. Changes to the buffer's content will be visible to the struct instance and vice versa.

      The created instance holds a strong reference to the container object.

  • Method Details

    • sizeof

      public int sizeof()
      Specified by:
      sizeof in class org.lwjgl.system.Struct<VkCopyImageToImageInfo>
    • sType

      public int sType()
      a VkStructureType value identifying this structure.
    • pNext

      public long pNext()
      NULL or a pointer to a structure extending this structure.
    • flags

      public int flags()
      a bitmask of VkHostImageCopyFlagBits values describing additional copy parameters.
    • srcImage

      public long srcImage()
      the source image.
    • srcImageLayout

      public int srcImageLayout()
      the layout of the source image subresources for the copy.
    • dstImage

      public long dstImage()
      the destination image.
    • dstImageLayout

      public int dstImageLayout()
      the layout of the destination image subresources for the copy.
    • regionCount

      public int regionCount()
      the number of regions to copy.
    • pRegions

      public VkImageCopy2.Buffer pRegions()
      a pointer to an array of VkImageCopy2 structures specifying the regions to copy.
    • sType

      public VkCopyImageToImageInfo sType(int value)
      Sets the specified value to the sType() field.
    • sType$Default

      public VkCopyImageToImageInfo sType$Default()
    • pNext

      public VkCopyImageToImageInfo pNext(long value)
      Sets the specified value to the pNext() field.
    • flags

      public VkCopyImageToImageInfo flags(int value)
      Sets the specified value to the flags() field.
    • srcImage

      public VkCopyImageToImageInfo srcImage(long value)
      Sets the specified value to the srcImage() field.
    • srcImageLayout

      public VkCopyImageToImageInfo srcImageLayout(int value)
      Sets the specified value to the srcImageLayout() field.
    • dstImage

      public VkCopyImageToImageInfo dstImage(long value)
      Sets the specified value to the dstImage() field.
    • dstImageLayout

      public VkCopyImageToImageInfo dstImageLayout(int value)
      Sets the specified value to the dstImageLayout() field.
    • pRegions

      Sets the address of the specified VkImageCopy2.Buffer to the pRegions() field.
    • set

      public VkCopyImageToImageInfo set(int sType, long pNext, int flags, long srcImage, int srcImageLayout, long dstImage, int dstImageLayout, VkImageCopy2.Buffer pRegions)
      Initializes this struct with the specified values.
    • set

      Copies the specified struct data to this struct.
      Parameters:
      src - the source struct
      Returns:
      this struct
    • malloc

      public static VkCopyImageToImageInfo malloc()
      Returns a new VkCopyImageToImageInfo instance allocated with memAlloc. The instance must be explicitly freed.
    • calloc

      public static VkCopyImageToImageInfo calloc()
      Returns a new VkCopyImageToImageInfo instance allocated with memCalloc. The instance must be explicitly freed.
    • create

      public static VkCopyImageToImageInfo create()
      Returns a new VkCopyImageToImageInfo instance allocated with BufferUtils.
    • create

      public static VkCopyImageToImageInfo create(long address)
      Returns a new VkCopyImageToImageInfo instance for the specified memory address.
    • createSafe

      public static @Nullable VkCopyImageToImageInfo createSafe(long address)
      Like create, but returns null if address is NULL.
    • malloc

      public static VkCopyImageToImageInfo.Buffer malloc(int capacity)
      Returns a new VkCopyImageToImageInfo.Buffer instance allocated with memAlloc. The instance must be explicitly freed.
      Parameters:
      capacity - the buffer capacity
    • calloc

      public static VkCopyImageToImageInfo.Buffer calloc(int capacity)
      Returns a new VkCopyImageToImageInfo.Buffer instance allocated with memCalloc. The instance must be explicitly freed.
      Parameters:
      capacity - the buffer capacity
    • create

      public static VkCopyImageToImageInfo.Buffer create(int capacity)
      Returns a new VkCopyImageToImageInfo.Buffer instance allocated with BufferUtils.
      Parameters:
      capacity - the buffer capacity
    • create

      public static VkCopyImageToImageInfo.Buffer create(long address, int capacity)
      Create a VkCopyImageToImageInfo.Buffer instance at the specified memory.
      Parameters:
      address - the memory address
      capacity - the buffer capacity
    • createSafe

      public static @Nullable VkCopyImageToImageInfo.Buffer createSafe(long address, int capacity)
      Like create, but returns null if address is NULL.
    • malloc

      public static VkCopyImageToImageInfo malloc(org.lwjgl.system.MemoryStack stack)
      Returns a new VkCopyImageToImageInfo instance allocated on the specified MemoryStack.
      Parameters:
      stack - the stack from which to allocate
    • calloc

      public static VkCopyImageToImageInfo calloc(org.lwjgl.system.MemoryStack stack)
      Returns a new VkCopyImageToImageInfo instance allocated on the specified MemoryStack and initializes all its bits to zero.
      Parameters:
      stack - the stack from which to allocate
    • malloc

      public static VkCopyImageToImageInfo.Buffer malloc(int capacity, org.lwjgl.system.MemoryStack stack)
      Returns a new VkCopyImageToImageInfo.Buffer instance allocated on the specified MemoryStack.
      Parameters:
      capacity - the buffer capacity
      stack - the stack from which to allocate
    • calloc

      public static VkCopyImageToImageInfo.Buffer calloc(int capacity, org.lwjgl.system.MemoryStack stack)
      Returns a new VkCopyImageToImageInfo.Buffer instance allocated on the specified MemoryStack and initializes all its bits to zero.
      Parameters:
      capacity - the buffer capacity
      stack - the stack from which to allocate
    • nsType

      public static int nsType(long struct)
      Unsafe version of sType().
    • npNext

      public static long npNext(long struct)
      Unsafe version of pNext().
    • nflags

      public static int nflags(long struct)
      Unsafe version of flags().
    • nsrcImage

      public static long nsrcImage(long struct)
      Unsafe version of srcImage().
    • nsrcImageLayout

      public static int nsrcImageLayout(long struct)
      Unsafe version of srcImageLayout().
    • ndstImage

      public static long ndstImage(long struct)
      Unsafe version of dstImage().
    • ndstImageLayout

      public static int ndstImageLayout(long struct)
      Unsafe version of dstImageLayout().
    • nregionCount

      public static int nregionCount(long struct)
      Unsafe version of regionCount().
    • npRegions

      public static VkImageCopy2.Buffer npRegions(long struct)
      Unsafe version of pRegions().
    • nsType

      public static void nsType(long struct, int value)
      Unsafe version of sType.
    • npNext

      public static void npNext(long struct, long value)
      Unsafe version of pNext.
    • nflags

      public static void nflags(long struct, int value)
      Unsafe version of flags.
    • nsrcImage

      public static void nsrcImage(long struct, long value)
      Unsafe version of srcImage.
    • nsrcImageLayout

      public static void nsrcImageLayout(long struct, int value)
      Unsafe version of srcImageLayout.
    • ndstImage

      public static void ndstImage(long struct, long value)
      Unsafe version of dstImage.
    • ndstImageLayout

      public static void ndstImageLayout(long struct, int value)
      Unsafe version of dstImageLayout.
    • nregionCount

      public static void nregionCount(long struct, int value)
      Sets the specified value to the regionCount field of the specified struct.
    • npRegions

      public static void npRegions(long struct, VkImageCopy2.Buffer value)
      Unsafe version of pRegions.
    • validate

      public static void validate(long struct)
      Validates pointer members that should not be NULL.
      Parameters:
      struct - the struct to validate