Class VkDisplayPlaneCapabilitiesKHR
- All Implemented Interfaces:
AutoCloseable,org.lwjgl.system.NativeResource,org.lwjgl.system.Pointer
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 which 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 which 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.
The value supportedAlpha must contain at least one valid VkDisplayPlaneAlphaFlagBitsKHR bit.
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. Presentation requests specifying unsupported combinations may fail.
See Also
VkDisplayPlaneCapabilities2KHR, VkExtent2D, VkOffset2D, GetDisplayPlaneCapabilitiesKHR
Layout
struct VkDisplayPlaneCapabilitiesKHR {
VkDisplayPlaneAlphaFlagsKHR supportedAlpha();
VkOffset2D minSrcPosition();
VkOffset2D maxSrcPosition();
VkExtent2D minSrcExtent();
VkExtent2D maxSrcExtent();
VkOffset2D minDstPosition();
VkOffset2D maxDstPosition();
VkExtent2D minDstExtent();
VkExtent2D maxDstExtent();
}-
Nested Class Summary
Nested ClassesNested classes/interfaces inherited from class org.lwjgl.system.Struct
org.lwjgl.system.Struct.StructValidationNested classes/interfaces inherited from interface org.lwjgl.system.Pointer
org.lwjgl.system.Pointer.Default -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final intThe struct alignment in bytes.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct member offsets.static final intThe struct size in bytes.static final intThe struct member offsets.Fields inherited from interface org.lwjgl.system.Pointer
BITS32, BITS64, CLONG_SHIFT, CLONG_SIZE, POINTER_SHIFT, POINTER_SIZE -
Constructor Summary
ConstructorsConstructorDescriptionVkDisplayPlaneCapabilitiesKHR(ByteBuffer container) Creates aVkDisplayPlaneCapabilitiesKHRinstance at the current position of the specifiedByteBuffercontainer. -
Method Summary
Modifier and TypeMethodDescriptioncalloc()Returns a newVkDisplayPlaneCapabilitiesKHRinstance allocated withmemCalloc.calloc(int capacity) Returns a newVkDisplayPlaneCapabilitiesKHR.Bufferinstance allocated withmemCalloc.calloc(int capacity, org.lwjgl.system.MemoryStack stack) Returns a newVkDisplayPlaneCapabilitiesKHR.Bufferinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.calloc(org.lwjgl.system.MemoryStack stack) Returns a newVkDisplayPlaneCapabilitiesKHRinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.Deprecated.callocStack(int capacity) Deprecated.callocStack(int capacity, org.lwjgl.system.MemoryStack stack) Deprecated.callocStack(org.lwjgl.system.MemoryStack stack) Deprecated.create()Returns a newVkDisplayPlaneCapabilitiesKHRinstance allocated withBufferUtils.create(int capacity) Returns a newVkDisplayPlaneCapabilitiesKHR.Bufferinstance allocated withBufferUtils.create(long address) Returns a newVkDisplayPlaneCapabilitiesKHRinstance for the specified memory address.create(long address, int capacity) Create aVkDisplayPlaneCapabilitiesKHR.Bufferinstance at the specified memory.static @Nullable VkDisplayPlaneCapabilitiesKHRcreateSafe(long address) static @Nullable VkDisplayPlaneCapabilitiesKHR.BuffercreateSafe(long address, int capacity) malloc()Returns a newVkDisplayPlaneCapabilitiesKHRinstance allocated withmemAlloc.malloc(int capacity) Returns a newVkDisplayPlaneCapabilitiesKHR.Bufferinstance allocated withmemAlloc.malloc(int capacity, org.lwjgl.system.MemoryStack stack) Returns a newVkDisplayPlaneCapabilitiesKHR.Bufferinstance allocated on the specifiedMemoryStack.malloc(org.lwjgl.system.MemoryStack stack) Returns a newVkDisplayPlaneCapabilitiesKHRinstance allocated on the specifiedMemoryStack.Deprecated.mallocStack(int capacity) Deprecated.mallocStack(int capacity, org.lwjgl.system.MemoryStack stack) Deprecated.mallocStack(org.lwjgl.system.MemoryStack stack) Deprecated.seeminDstPositionseeminDstPositionthe maximum source rectangle size supported by this plane using the specified mode.the maximum source rectangle offset supported by this plane using the specified mode.seeminDstPositionminDstPosition,maxDstPosition,minDstExtent,maxDstExtentall have similar semantics to their corresponding*Src*equivalents, but apply to the output region within the mode rather than the input region within the source image.the minimum source rectangle size supported by this plane using the specified mode.the minimum source rectangle offset supported by this plane using the specified mode.static VkExtent2DnmaxDstExtent(long struct) Unsafe version ofmaxDstExtent().static VkOffset2DnmaxDstPosition(long struct) Unsafe version ofmaxDstPosition().static VkExtent2DnmaxSrcExtent(long struct) Unsafe version ofmaxSrcExtent().static VkOffset2DnmaxSrcPosition(long struct) Unsafe version ofmaxSrcPosition().static VkExtent2DnminDstExtent(long struct) Unsafe version ofminDstExtent().static VkOffset2DnminDstPosition(long struct) Unsafe version ofminDstPosition().static VkExtent2DnminSrcExtent(long struct) Unsafe version ofminSrcExtent().static VkOffset2DnminSrcPosition(long struct) Unsafe version ofminSrcPosition().static intnsupportedAlpha(long struct) Unsafe version ofsupportedAlpha().intsizeof()inta bitmask ofVkDisplayPlaneAlphaFlagBitsKHRdescribing the supported alpha blending modes.Methods inherited from class org.lwjgl.system.Struct
clear, free, isNull, validate, validateMethods inherited from class org.lwjgl.system.Pointer.Default
address, equals, hashCode, toStringMethods inherited from interface org.lwjgl.system.NativeResource
close, free
-
Field Details
-
SIZEOF
public static final int SIZEOFThe struct size in bytes. -
ALIGNOF
public static final int ALIGNOFThe struct alignment in bytes. -
SUPPORTEDALPHA
public static final int SUPPORTEDALPHAThe struct member offsets. -
MINSRCPOSITION
public static final int MINSRCPOSITIONThe struct member offsets. -
MAXSRCPOSITION
public static final int MAXSRCPOSITIONThe struct member offsets. -
MINSRCEXTENT
public static final int MINSRCEXTENTThe struct member offsets. -
MAXSRCEXTENT
public static final int MAXSRCEXTENTThe struct member offsets. -
MINDSTPOSITION
public static final int MINDSTPOSITIONThe struct member offsets. -
MAXDSTPOSITION
public static final int MAXDSTPOSITIONThe struct member offsets. -
MINDSTEXTENT
public static final int MINDSTEXTENTThe struct member offsets. -
MAXDSTEXTENT
public static final int MAXDSTEXTENTThe struct member offsets.
-
-
Constructor Details
-
VkDisplayPlaneCapabilitiesKHR
Creates aVkDisplayPlaneCapabilitiesKHRinstance at the current position of the specifiedByteBuffercontainer. 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.
-
-
Method Details
-
sizeof
public int sizeof()- Specified by:
sizeofin classorg.lwjgl.system.Struct<VkDisplayPlaneCapabilitiesKHR>
-
supportedAlpha
public int supportedAlpha()a bitmask ofVkDisplayPlaneAlphaFlagBitsKHRdescribing 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. Thexandycomponents ofmaxSrcPositionmust each be greater than or equal to thexandycomponents ofminSrcPosition, 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. -
minDstPosition
minDstPosition,maxDstPosition,minDstExtent,maxDstExtentall have similar semantics to their corresponding*Src*equivalents, but apply to the output region within the mode rather than the input region within the source image. Unlike the*Src*offsets,minDstPositionandmaxDstPositionmay contain negative values. -
maxDstPosition
seeminDstPosition -
minDstExtent
seeminDstPosition -
maxDstExtent
seeminDstPosition -
malloc
Returns a newVkDisplayPlaneCapabilitiesKHRinstance allocated withmemAlloc. The instance must be explicitly freed. -
calloc
Returns a newVkDisplayPlaneCapabilitiesKHRinstance allocated withmemCalloc. The instance must be explicitly freed. -
create
Returns a newVkDisplayPlaneCapabilitiesKHRinstance allocated withBufferUtils. -
create
Returns a newVkDisplayPlaneCapabilitiesKHRinstance for the specified memory address. -
createSafe
-
malloc
Returns a newVkDisplayPlaneCapabilitiesKHR.Bufferinstance allocated withmemAlloc. The instance must be explicitly freed.- Parameters:
capacity- the buffer capacity
-
calloc
Returns a newVkDisplayPlaneCapabilitiesKHR.Bufferinstance allocated withmemCalloc. The instance must be explicitly freed.- Parameters:
capacity- the buffer capacity
-
create
Returns a newVkDisplayPlaneCapabilitiesKHR.Bufferinstance allocated withBufferUtils.- Parameters:
capacity- the buffer capacity
-
create
Create aVkDisplayPlaneCapabilitiesKHR.Bufferinstance at the specified memory.- Parameters:
address- the memory addresscapacity- the buffer capacity
-
createSafe
-
mallocStack
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(MemoryStack)instead. -
callocStack
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(MemoryStack)instead. -
mallocStack
@Deprecated public static VkDisplayPlaneCapabilitiesKHR mallocStack(org.lwjgl.system.MemoryStack stack) Deprecated.Deprecated for removal in 3.4.0. Usemalloc(MemoryStack)instead. -
callocStack
@Deprecated public static VkDisplayPlaneCapabilitiesKHR callocStack(org.lwjgl.system.MemoryStack stack) Deprecated.Deprecated for removal in 3.4.0. Usecalloc(MemoryStack)instead. -
mallocStack
Deprecated.Deprecated for removal in 3.4.0. Usemalloc(int, MemoryStack)instead. -
callocStack
Deprecated.Deprecated for removal in 3.4.0. Usecalloc(int, MemoryStack)instead. -
mallocStack
@Deprecated public static VkDisplayPlaneCapabilitiesKHR.Buffer mallocStack(int capacity, org.lwjgl.system.MemoryStack stack) Deprecated.Deprecated for removal in 3.4.0. Usemalloc(int, MemoryStack)instead. -
callocStack
@Deprecated public static VkDisplayPlaneCapabilitiesKHR.Buffer callocStack(int capacity, org.lwjgl.system.MemoryStack stack) Deprecated.Deprecated for removal in 3.4.0. Usecalloc(int, MemoryStack)instead. -
malloc
Returns a newVkDisplayPlaneCapabilitiesKHRinstance allocated on the specifiedMemoryStack.- Parameters:
stack- the stack from which to allocate
-
calloc
Returns a newVkDisplayPlaneCapabilitiesKHRinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.- Parameters:
stack- the stack from which to allocate
-
malloc
public static VkDisplayPlaneCapabilitiesKHR.Buffer malloc(int capacity, org.lwjgl.system.MemoryStack stack) Returns a newVkDisplayPlaneCapabilitiesKHR.Bufferinstance allocated on the specifiedMemoryStack.- Parameters:
capacity- the buffer capacitystack- the stack from which to allocate
-
calloc
public static VkDisplayPlaneCapabilitiesKHR.Buffer calloc(int capacity, org.lwjgl.system.MemoryStack stack) Returns a newVkDisplayPlaneCapabilitiesKHR.Bufferinstance allocated on the specifiedMemoryStackand initializes all its bits to zero.- Parameters:
capacity- the buffer capacitystack- the stack from which to allocate
-
nsupportedAlpha
public static int nsupportedAlpha(long struct) Unsafe version ofsupportedAlpha(). -
nminSrcPosition
Unsafe version ofminSrcPosition(). -
nmaxSrcPosition
Unsafe version ofmaxSrcPosition(). -
nminSrcExtent
Unsafe version ofminSrcExtent(). -
nmaxSrcExtent
Unsafe version ofmaxSrcExtent(). -
nminDstPosition
Unsafe version ofminDstPosition(). -
nmaxDstPosition
Unsafe version ofmaxDstPosition(). -
nminDstExtent
Unsafe version ofminDstExtent(). -
nmaxDstExtent
Unsafe version ofmaxDstExtent().
-