Structure specifying parameters of a newly created pipeline viewport state.

Valid Usage

• If the multiViewport feature is not enabled, viewportCount must not be greater than 1
• If the multiViewport feature is not enabled, scissorCount must not be greater than 1
• viewportCount must be less than or equal to VkPhysicalDeviceLimits::maxViewports
• scissorCount must be less than or equal to VkPhysicalDeviceLimits::maxViewports
• The x and y members of offset member of any element of pScissors must be greater than or equal to 0
• Evaluation of (offset.x + extent.width) must not cause a signed integer addition overflow for any element of pScissors
• Evaluation of (offset.y + extent.height) must not cause a signed integer addition overflow for any element of pScissors
• If scissorCount and viewportCount are both not dynamic, then scissorCount and viewportCount must be identical
• If the graphics pipeline is being created with DYNAMIC_STATE_VIEWPORT_WITH_COUNT set then viewportCount must be 0, otherwise it must be greater than 0
• If the graphics pipeline is being created with DYNAMIC_STATE_SCISSOR_WITH_COUNT set then scissorCount must be 0, otherwise it must be greater than 0
• If the viewportWScalingEnable member of a VkPipelineViewportWScalingStateCreateInfoNV structure included in the pNext chain is TRUE, the viewportCount member of the VkPipelineViewportWScalingStateCreateInfoNV structure must be greater than or equal to VkPipelineViewportStateCreateInfo::viewportCount

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_PIPELINE_VIEWPORT_STATE_CREATE_INFO
• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of VkPipelineViewportCoarseSampleOrderStateCreateInfoNV, VkPipelineViewportDepthClipControlCreateInfoEXT, VkPipelineViewportExclusiveScissorStateCreateInfoNV, VkPipelineViewportShadingRateImageStateCreateInfoNV, VkPipelineViewportSwizzleStateCreateInfoNV, or VkPipelineViewportWScalingStateCreateInfoNV
• The sType value of each struct in the pNext chain must be unique
• flags must be 0

See Also

VkGraphicsPipelineCreateInfo, VkRect2D, VkViewport

Layout

struct VkPipelineViewportStateCreateInfo {
    VkStructureType sType;
    void const * pNext;
    VkPipelineViewportStateCreateFlags flags;
    uint32_t viewportCount;
    VkViewport const * pViewports;
    uint32_t scissorCount;
    VkRect2D const * pScissors;
}