Package org.lwjgl.vulkan

Class VkDeviceGroupRenderPassBeginInfo

  • All Implemented Interfaces:
    java.lang.AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
    Direct Known Subclasses:
    VkDeviceGroupRenderPassBeginInfoKHR
    public class VkDeviceGroupRenderPassBeginInfo
extends org.lwjgl.system.Struct
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 attachment load, store, and 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
    Valid Usage (Implicit)
    See Also

    VkRect2D

    Layout

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