Package org.lwjgl.vulkan

Class VkDeviceGroupRenderPassBeginInfo

java.lang.Object
org.lwjgl.system.Pointer.Default
org.lwjgl.system.Struct<VkDeviceGroupRenderPassBeginInfo>
org.lwjgl.vulkan.VkDeviceGroupRenderPassBeginInfo
All Implemented Interfaces:
AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
Direct Known Subclasses:
VkDeviceGroupRenderPassBeginInfoKHR
public class VkDeviceGroupRenderPassBeginInfo extends org.lwjgl.system.Struct<VkDeviceGroupRenderPassBeginInfo> implements org.lwjgl.system.NativeResource
Set the initial device mask and render areas for a render pass instance.
Description

The deviceMask serves several purposes. It is an upper bound on the set of physical devices that can be used during the render pass instance, and the initial device mask when the render pass instance begins. In addition, commands transitioning to the next subpass in a render pass instance and commands ending the render pass instance, and, accordingly render pass load, store, and multisample resolve operations and subpass dependencies corresponding to the render pass instance, are executed on the physical devices included in the device mask provided here.

If deviceRenderAreaCount is not zero, then the elements of pDeviceRenderAreas override the value of VkRenderPassBeginInfo::renderArea, and provide a render area specific to each physical device. These render areas serve the same purpose as VkRenderPassBeginInfo::renderArea, including controlling the region of attachments that are cleared by ATTACHMENT_LOAD_OP_CLEAR and that are resolved into resolve attachments.

If this structure is not present, the render pass instance’s device mask is the value of VkDeviceGroupCommandBufferBeginInfo::deviceMask. If this structure is not present or if deviceRenderAreaCount is zero, VkRenderPassBeginInfo::renderArea is used for all physical devices.

Valid Usage
  • deviceMask must be a valid device mask value
  • deviceMask must not be zero
  • deviceMask must be a subset of the command buffer’s initial device mask
  • deviceRenderAreaCount must either be zero or equal to the number of physical devices in the logical device
  • The offset.x member of any element of pDeviceRenderAreas must be greater than or equal to 0
  • The offset.y member of any element of pDeviceRenderAreas must be greater than or equal to 0
  • The sum of the offset.x and extent.width members of any element of pDeviceRenderAreas must be less than or equal to maxFramebufferWidth
  • The sum of the offset.y and extent.height members of any element of pDeviceRenderAreas must be less than or equal to maxFramebufferHeight
  • The extent.width member of any element of pDeviceRenderAreas must be greater than 0
  • The extent.height member of any element of pDeviceRenderAreas must be greater than 0
Valid Usage (Implicit)
See Also

VkRect2D

Layout


 struct VkDeviceGroupRenderPassBeginInfo {
     VkStructureType sType();
     void const * pNext();
     uint32_t deviceMask();
     uint32_t deviceRenderAreaCount();
     VkRect2D const * pDeviceRenderAreas();
 }