Class VkDisplayPlaneCapabilitiesKHR

  • All Implemented Interfaces:
    java.lang.AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer

    public class VkDisplayPlaneCapabilitiesKHR
    extends org.lwjgl.system.Struct
    implements org.lwjgl.system.NativeResource
    Structure describing capabilities of a mode and plane combination.
    Description

    The minimum and maximum position and extent fields describe the implementation limits, if any, as they apply to the specified display mode and plane. Vendors may support displaying a subset of a swapchain's presentable images on the specified display plane. This is expressed by returning minSrcPosition, maxSrcPosition, minSrcExtent, and maxSrcExtent values that indicate a range of possible positions and sizes may be used to specify the region within the presentable images that source pixels will be read from when creating a swapchain on the specified display mode and plane.

    Vendors may also support mapping the presentable images`' content to a subset or superset of the visible region in the specified display mode. This is expressed by returning minDstPosition, maxDstPosition, minDstExtent and maxDstExtent values that indicate a range of possible positions and sizes may be used to describe the region within the display mode that the source pixels will be mapped to.

    Other vendors may support only a 1-1 mapping between pixels in the presentable images and the display mode. This may be indicated by returning (0,0) for minSrcPosition, maxSrcPosition, minDstPosition, and maxDstPosition, and (display mode width, display mode height) for minSrcExtent, maxSrcExtent, minDstExtent, and maxDstExtent.

    These values indicate the limits of the implementation's individual fields. Not all combinations of values within the offset and extent ranges returned in VkDisplayPlaneCapabilitiesKHR are guaranteed to be supported. Vendors may still fail presentation requests that specify unsupported combinations.

    See Also

    VkDisplayPlaneCapabilities2KHR, VkExtent2D, VkOffset2D, GetDisplayPlaneCapabilitiesKHR

    Member documentation

    • supportedAlpha – a bitmask of VkDisplayPlaneAlphaFlagBitsKHR describing the supported alpha blending modes.
    • minSrcPosition – the minimum source rectangle offset supported by this plane using the specified mode.
    • maxSrcPosition – the maximum source rectangle offset supported by this plane using the specified mode. The x and y components of maxSrcPosition must each be greater than or equal to the x and y components of minSrcPosition, respectively.
    • minSrcExtent – the minimum source rectangle size supported by this plane using the specified mode.
    • maxSrcExtent – the maximum source rectangle size supported by this plane using the specified mode.
    • minDstPositionminDstPosition, maxDstPosition, minDstExtent, maxDstExtent all have similar semantics to their corresponding ptext:Src equivalents, but apply to the output region within the mode rather than the input region within the source image. Unlike the ptext:Src offsets, minDstPosition and maxDstPosition may contain negative values.
    • maxDstPosition – see minDstPosition
    • minDstExtent – see minDstPosition
    • maxDstExtent – see minDstPosition

    Layout

    
     struct VkDisplayPlaneCapabilitiesKHR {
         VkDisplayPlaneAlphaFlagsKHR supportedAlpha;
         VkOffset2D minSrcPosition;
         VkOffset2D maxSrcPosition;
         VkExtent2D minSrcExtent;
         VkExtent2D maxSrcExtent;
         VkOffset2D minDstPosition;
         VkOffset2D maxDstPosition;
         VkExtent2D minDstExtent;
         VkExtent2D maxDstExtent;
     }
    • Field Detail

      • SIZEOF

        The struct size in bytes.
      • ALIGNOF

        The struct alignment in bytes.
      • SUPPORTEDALPHA, MINSRCPOSITION, MAXSRCPOSITION, MINSRCEXTENT, MAXSRCEXTENT, MINDSTPOSITION, MAXDSTPOSITION, MINDSTEXTENT, MAXDSTEXTENT

        The struct member offsets.
    • Constructor Detail

      • VkDisplayPlaneCapabilitiesKHR

        public VkDisplayPlaneCapabilitiesKHR​(java.nio.ByteBuffer container)
        Creates a VkDisplayPlaneCapabilitiesKHR 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.