vkGetRenderingAreaGranularity

To query the render area granularity for a render pass instance, call:

void vkGetRenderingAreaGranularity(
    VkDevice device,
    const VkRenderingAreaInfo* pRenderingAreaInfo,
    VkExtent2D* pGranularity);

pub fn get_rendering_area_granularity(
    device: vk::Device,
    p_rendering_area_info: *const vk::RenderingAreaInfo,
    p_granularity: *mut vk::Extent2D,
);

void vkGetRenderingAreaGranularityKHR(
    VkDevice device,
    const VkRenderingAreaInfo* pRenderingAreaInfo,
    VkExtent2D* pGranularity);

pub fn get_rendering_area_granularity_khr(
    device: vk::Device,
    p_rendering_area_info: *const vk::RenderingAreaInfo,
    p_granularity: *mut vk::Extent2D,
);

• device is the logical device that owns the render pass instance.
• pRenderingAreaInfo is a pointer to a VkRenderingAreaInfo structure specifying details of the render pass instance to query the render area granularity for.
• pGranularity is a pointer to a VkExtent2D structure in which the granularity is returned.

The conditions leading to an optimal renderArea are:

• the offset.x member in renderArea is a multiple of the width member of the returned VkExtent2D (the horizontal granularity).
• the offset.y member in renderArea is a multiple of the height member of the returned VkExtent2D (the vertical granularity).
• either the extent.width member in renderArea is a multiple of the horizontal granularity or offset.x+extent.width is equal to the width of each attachment used in the render pass instance.
• either the extent.height member in renderArea is a multiple of the vertical granularity or offset.y+extent.height is equal to the height of each attachment used in the render pass instance.