java.lang.Object
- org.lwjgl.system.Pointer.Default
- - org.lwjgl.system.Struct
  - - org.lwjgl.vulkan.VkSurfaceCapabilitiesKHR

All Implemented Interfaces:

java.lang.AutoCloseable, NativeResource, Pointer
```
public class VkSurfaceCapabilitiesKHR
extends Struct
implements NativeResource
```
Structure describing capabilities of a surface.
Description

Note

Supported usage flags of a presentable image when using PRESENT_MODE_SHARED_DEMAND_REFRESH_KHR or PRESENT_MODE_SHARED_CONTINUOUS_REFRESH_KHR presentation mode are provided by VkSharedPresentSurfaceCapabilitiesKHR::sharedPresentSupportedUsageFlags.

Note

Formulas such as min(N, maxImageCount) are not correct, since maxImageCount may be zero.

See Also

VkExtent2D, VkSurfaceCapabilities2KHR, GetPhysicalDeviceSurfaceCapabilitiesKHR

Member documentation
- minImageCount – the minimum number of images the specified device supports for a swapchain created for the surface, and will be at least one.
- maxImageCount – the maximum number of images the specified device supports for a swapchain created for the surface, and will be either 0, or greater than or equal to minImageCount. A value of 0 means that there is no limit on the number of images, though there may be limits related to the total amount of memory used by presentable images.
- currentExtent – the current width and height of the surface, or the special value (0xFFFFFFFF, 0xFFFFFFFF) indicating that the surface size will be determined by the extent of a swapchain targeting the surface.
- minImageExtent – contains the smallest valid swapchain extent for the surface on the specified device. The width and height of the extent will each be less than or equal to the corresponding width and height of currentExtent, unless currentExtent has the special value described above.
- maxImageExtent – contains the largest valid swapchain extent for the surface on the specified device. The width and height of the extent will each be greater than or equal to the corresponding width and height of minImageExtent. The width and height of the extent will each be greater than or equal to the corresponding width and height of currentExtent, unless currentExtent has the special value described above.
- maxImageArrayLayers – the maximum number of layers presentable images can have for a swapchain created for this device and surface, and will be at least one.
- supportedTransforms – a bitmask of VkSurfaceTransformFlagBitsKHR indicating the presentation transforms supported for the surface on the specified device. At least one bit will be set.
- currentTransform – VkSurfaceTransformFlagBitsKHR value indicating the surface’s current transform relative to the presentation engine’s natural orientation.
- supportedCompositeAlpha – a bitmask of VkCompositeAlphaFlagBitsKHR, representing the alpha compositing modes supported by the presentation engine for the surface on the specified device, and at least one bit will be set. Opaque composition can be achieved in any alpha compositing mode by either using an image format that has no alpha component, or by ensuring that all pixels in the presentable images have an alpha value of 1.0.
- supportedUsageFlags – a bitmask of VkImageUsageFlagBits representing the ways the application can use the presentable images of a swapchain created with VkPresentModeKHR set to PRESENT_MODE_IMMEDIATE_KHR, PRESENT_MODE_MAILBOX_KHR, PRESENT_MODE_FIFO_KHR or PRESENT_MODE_FIFO_RELAXED_KHR for the surface on the specified device. IMAGE_USAGE_COLOR_ATTACHMENT_BIT must be included in the set but implementations may support additional usages.
Layout
```
 struct VkSurfaceCapabilitiesKHR {
     uint32_t minImageCount;
     uint32_t maxImageCount;
     VkExtent2D currentExtent;
     VkExtent2D minImageExtent;
     VkExtent2D maxImageExtent;
     uint32_t maxImageArrayLayers;
     VkSurfaceTransformFlagsKHR supportedTransforms;
     VkSurfaceTransformFlagBitsKHR currentTransform;
     VkCompositeAlphaFlagsKHR supportedCompositeAlpha;
     VkImageUsageFlags supportedUsageFlags;
 }
```

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class VkSurfaceCapabilitiesKHR.Buffer
An array of VkSurfaceCapabilitiesKHR structs.
- Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer
  Pointer.Default

Field Summary

Fields
Modifier and Type	Field	Description
`static int`	`ALIGNOF`	The struct alignment in bytes.
`static int`	`CURRENTEXTENT CURRENTTRANSFORM MAXIMAGEARRAYLAYERS MAXIMAGECOUNT MAXIMAGEEXTENT MINIMAGECOUNT MINIMAGEEXTENT`	The struct member offsets.
`static int`	`SIZEOF`	The struct size in bytes.
`static int`	`SUPPORTEDCOMPOSITEALPHA SUPPORTEDTRANSFORMS SUPPORTEDUSAGEFLAGS`	The struct member offsets.

Fields inherited from interface org.lwjgl.system.Pointer
BITS32, BITS64, POINTER_SHIFT, POINTER_SIZE

Constructor Summary

Constructors
Constructor	Description
`VkSurfaceCapabilitiesKHR(java.nio.ByteBuffer container)`	Creates a `VkSurfaceCapabilitiesKHR` instance at the current position of the specified `ByteBuffer` container.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`static VkSurfaceCapabilitiesKHR`	`calloc()`	Returns a new `VkSurfaceCapabilitiesKHR` instance allocated with `memCalloc`.
`static VkSurfaceCapabilitiesKHR.Buffer`	`calloc(int capacity)`	Returns a new `VkSurfaceCapabilitiesKHR.Buffer` instance allocated with `memCalloc`.
`static VkSurfaceCapabilitiesKHR`	`callocStack()`	Returns a new `VkSurfaceCapabilitiesKHR` instance allocated on the thread-local `MemoryStack` and initializes all its bits to zero.
`static VkSurfaceCapabilitiesKHR.Buffer`	`callocStack(int capacity)`	Returns a new `VkSurfaceCapabilitiesKHR.Buffer` instance allocated on the thread-local `MemoryStack` and initializes all its bits to zero.
`static VkSurfaceCapabilitiesKHR.Buffer`	`callocStack(int capacity, MemoryStack stack)`	Returns a new `VkSurfaceCapabilitiesKHR.Buffer` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static VkSurfaceCapabilitiesKHR`	`callocStack(MemoryStack stack)`	Returns a new `VkSurfaceCapabilitiesKHR` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static VkSurfaceCapabilitiesKHR`	`create()`	Returns a new `VkSurfaceCapabilitiesKHR` instance allocated with `BufferUtils`.
`static VkSurfaceCapabilitiesKHR.Buffer`	`create(int capacity)`	Returns a new `VkSurfaceCapabilitiesKHR.Buffer` instance allocated with `BufferUtils`.
`static VkSurfaceCapabilitiesKHR`	`create(long address)`	Returns a new `VkSurfaceCapabilitiesKHR` instance for the specified memory address.
`static VkSurfaceCapabilitiesKHR.Buffer`	`create(long address, int capacity)`	Create a `VkSurfaceCapabilitiesKHR.Buffer` instance at the specified memory.
`static VkSurfaceCapabilitiesKHR`	`createSafe(long address)`	Like `create`, but returns `null` if `address` is `NULL`.
`static VkSurfaceCapabilitiesKHR.Buffer`	`createSafe(long address, int capacity)`	Like `create`, but returns `null` if `address` is `NULL`.
`VkExtent2D`	`currentExtent()`	Returns a `VkExtent2D` view of the `currentExtent` field.
`VkSurfaceCapabilitiesKHR`	`currentExtent(java.util.function.Consumer<VkExtent2D> consumer)`	Passes the `currentExtent` field to the specified `Consumer`.
`int`	`currentTransform()`	Returns the value of the `currentTransform` field.
`static VkSurfaceCapabilitiesKHR`	`malloc()`	Returns a new `VkSurfaceCapabilitiesKHR` instance allocated with `memAlloc`.
`static VkSurfaceCapabilitiesKHR.Buffer`	`malloc(int capacity)`	Returns a new `VkSurfaceCapabilitiesKHR.Buffer` instance allocated with `memAlloc`.
`static VkSurfaceCapabilitiesKHR`	`mallocStack()`	Returns a new `VkSurfaceCapabilitiesKHR` instance allocated on the thread-local `MemoryStack`.
`static VkSurfaceCapabilitiesKHR.Buffer`	`mallocStack(int capacity)`	Returns a new `VkSurfaceCapabilitiesKHR.Buffer` instance allocated on the thread-local `MemoryStack`.
`static VkSurfaceCapabilitiesKHR.Buffer`	`mallocStack(int capacity, MemoryStack stack)`	Returns a new `VkSurfaceCapabilitiesKHR.Buffer` instance allocated on the specified `MemoryStack`.
`static VkSurfaceCapabilitiesKHR`	`mallocStack(MemoryStack stack)`	Returns a new `VkSurfaceCapabilitiesKHR` instance allocated on the specified `MemoryStack`.
`int`	`maxImageArrayLayers()`	Returns the value of the `maxImageArrayLayers` field.
`int`	`maxImageCount()`	Returns the value of the `maxImageCount` field.
`VkExtent2D`	`maxImageExtent()`	Returns a `VkExtent2D` view of the `maxImageExtent` field.
`VkSurfaceCapabilitiesKHR`	`maxImageExtent(java.util.function.Consumer<VkExtent2D> consumer)`	Passes the `maxImageExtent` field to the specified `Consumer`.
`int`	`minImageCount()`	Returns the value of the `minImageCount` field.
`VkExtent2D`	`minImageExtent()`	Returns a `VkExtent2D` view of the `minImageExtent` field.
`VkSurfaceCapabilitiesKHR`	`minImageExtent(java.util.function.Consumer<VkExtent2D> consumer)`	Passes the `minImageExtent` field to the specified `Consumer`.
`static VkExtent2D`	`ncurrentExtent(long struct)`	Unsafe version of `currentExtent()`.
`static int`	`ncurrentTransform(long struct)`	Unsafe version of `currentTransform()`.
`static int`	`nmaxImageArrayLayers(long struct)`	Unsafe version of `maxImageArrayLayers()`.
`static int`	`nmaxImageCount(long struct)`	Unsafe version of `maxImageCount()`.
`static VkExtent2D`	`nmaxImageExtent(long struct)`	Unsafe version of `maxImageExtent()`.
`static int`	`nminImageCount(long struct)`	Unsafe version of `minImageCount()`.
`static VkExtent2D`	`nminImageExtent(long struct)`	Unsafe version of `minImageExtent()`.
`static int`	`nsupportedCompositeAlpha(long struct)`	Unsafe version of `supportedCompositeAlpha()`.
`static int`	`nsupportedTransforms(long struct)`	Unsafe version of `supportedTransforms()`.
`static int`	`nsupportedUsageFlags(long struct)`	Unsafe version of `supportedUsageFlags()`.
`int`	`sizeof()`	Returns `sizeof(struct)`.
`int`	`supportedCompositeAlpha()`	Returns the value of the `supportedCompositeAlpha` field.
`int`	`supportedTransforms()`	Returns the value of the `supportedTransforms` field.
`int`	`supportedUsageFlags()`	Returns the value of the `supportedUsageFlags` field.

Methods inherited from interface org.lwjgl.system.NativeResource
close, free

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

Methods inherited from class org.lwjgl.system.Pointer.Default
address, equals, hashCode, toString

Methods inherited from class org.lwjgl.system.Struct
clear, free, isNull

- Field Detail
  - SIZEOF
    
    The struct size in bytes.
  - ALIGNOF
    
    The struct alignment in bytes.
  - MINIMAGECOUNT, MAXIMAGECOUNT, CURRENTEXTENT, MINIMAGEEXTENT, MAXIMAGEEXTENT, MAXIMAGEARRAYLAYERS, SUPPORTEDTRANSFORMS, CURRENTTRANSFORM, SUPPORTEDCOMPOSITEALPHA, SUPPORTEDUSAGEFLAGS
    
    The struct member offsets.
- Constructor Detail
  - VkSurfaceCapabilitiesKHR
```
public VkSurfaceCapabilitiesKHR(java.nio.ByteBuffer container)
```
    Creates a VkSurfaceCapabilitiesKHR 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.
- Method Detail
  - sizeof
```
public int sizeof()
```
    Description copied from class: Struct
    
    Returns sizeof(struct).
    
    Specified by:
    
    sizeof in class Struct
  - minImageCount
```
public int minImageCount()
```
    Returns the value of the minImageCount field.
  - maxImageCount
```
public int maxImageCount()
```
    Returns the value of the maxImageCount field.
  - currentExtent
```
public VkExtent2D currentExtent()
```
    Returns a VkExtent2D view of the currentExtent field.
  - currentExtent
```
public VkSurfaceCapabilitiesKHR currentExtent(java.util.function.Consumer<VkExtent2D> consumer)
```
    Passes the currentExtent field to the specified Consumer.
  - minImageExtent
```
public VkExtent2D minImageExtent()
```
    Returns a VkExtent2D view of the minImageExtent field.
  - minImageExtent
```
public VkSurfaceCapabilitiesKHR minImageExtent(java.util.function.Consumer<VkExtent2D> consumer)
```
    Passes the minImageExtent field to the specified Consumer.
  - maxImageExtent
```
public VkExtent2D maxImageExtent()
```
    Returns a VkExtent2D view of the maxImageExtent field.
  - maxImageExtent
```
public VkSurfaceCapabilitiesKHR maxImageExtent(java.util.function.Consumer<VkExtent2D> consumer)
```
    Passes the maxImageExtent field to the specified Consumer.
  - maxImageArrayLayers
```
public int maxImageArrayLayers()
```
    Returns the value of the maxImageArrayLayers field.
  - supportedTransforms
```
public int supportedTransforms()
```
    Returns the value of the supportedTransforms field.
  - currentTransform
```
public int currentTransform()
```
    Returns the value of the currentTransform field.
  - supportedCompositeAlpha
```
public int supportedCompositeAlpha()
```
    Returns the value of the supportedCompositeAlpha field.
  - supportedUsageFlags
```
public int supportedUsageFlags()
```
    Returns the value of the supportedUsageFlags field.
  - malloc
```
public static VkSurfaceCapabilitiesKHR malloc()
```
    Returns a new VkSurfaceCapabilitiesKHR instance allocated with memAlloc. The instance must be explicitly freed.
  - calloc
```
public static VkSurfaceCapabilitiesKHR calloc()
```
    Returns a new VkSurfaceCapabilitiesKHR instance allocated with memCalloc. The instance must be explicitly freed.
  - create
```
public static VkSurfaceCapabilitiesKHR create()
```
    Returns a new VkSurfaceCapabilitiesKHR instance allocated with BufferUtils.
  - create
```
public static VkSurfaceCapabilitiesKHR create(long address)
```
    Returns a new VkSurfaceCapabilitiesKHR instance for the specified memory address.
  - createSafe
```
@Nullable
public static VkSurfaceCapabilitiesKHR createSafe(long address)
```
    Like create, but returns null if address is NULL.
  - malloc
```
public static VkSurfaceCapabilitiesKHR.Buffer malloc(int capacity)
```
    Returns a new VkSurfaceCapabilitiesKHR.Buffer instance allocated with memAlloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - calloc
```
public static VkSurfaceCapabilitiesKHR.Buffer calloc(int capacity)
```
    Returns a new VkSurfaceCapabilitiesKHR.Buffer instance allocated with memCalloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static VkSurfaceCapabilitiesKHR.Buffer create(int capacity)
```
    Returns a new VkSurfaceCapabilitiesKHR.Buffer instance allocated with BufferUtils.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static VkSurfaceCapabilitiesKHR.Buffer create(long address,
                                                     int capacity)
```
    Create a VkSurfaceCapabilitiesKHR.Buffer instance at the specified memory.
    
    Parameters:
    
    address - the memory address
    
    capacity - the buffer capacity
  - createSafe
```
@Nullable
public static VkSurfaceCapabilitiesKHR.Buffer createSafe(long address,
                                                         int capacity)
```
    Like create, but returns null if address is NULL.
  - mallocStack
```
public static VkSurfaceCapabilitiesKHR mallocStack()
```
    Returns a new VkSurfaceCapabilitiesKHR instance allocated on the thread-local MemoryStack.
  - callocStack
```
public static VkSurfaceCapabilitiesKHR callocStack()
```
    Returns a new VkSurfaceCapabilitiesKHR instance allocated on the thread-local MemoryStack and initializes all its bits to zero.
  - mallocStack
```
public static VkSurfaceCapabilitiesKHR mallocStack(MemoryStack stack)
```
    Returns a new VkSurfaceCapabilitiesKHR instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
  - callocStack
```
public static VkSurfaceCapabilitiesKHR callocStack(MemoryStack stack)
```
    Returns a new VkSurfaceCapabilitiesKHR instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
  - mallocStack
```
public static VkSurfaceCapabilitiesKHR.Buffer mallocStack(int capacity)
```
    Returns a new VkSurfaceCapabilitiesKHR.Buffer instance allocated on the thread-local MemoryStack.
    
    Parameters:
    
    capacity - the buffer capacity
  - callocStack
```
public static VkSurfaceCapabilitiesKHR.Buffer callocStack(int capacity)
```
    Returns a new VkSurfaceCapabilitiesKHR.Buffer instance allocated on the thread-local MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    capacity - the buffer capacity
  - mallocStack
```
public static VkSurfaceCapabilitiesKHR.Buffer mallocStack(int capacity,
                                                          MemoryStack stack)
```
    Returns a new VkSurfaceCapabilitiesKHR.Buffer instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - callocStack
```
public static VkSurfaceCapabilitiesKHR.Buffer callocStack(int capacity,
                                                          MemoryStack stack)
```
    Returns a new VkSurfaceCapabilitiesKHR.Buffer instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - nminImageCount
```
public static int nminImageCount(long struct)
```
    Unsafe version of minImageCount().
  - nmaxImageCount
```
public static int nmaxImageCount(long struct)
```
    Unsafe version of maxImageCount().
  - ncurrentExtent
```
public static VkExtent2D ncurrentExtent(long struct)
```
    Unsafe version of currentExtent().
  - nminImageExtent
```
public static VkExtent2D nminImageExtent(long struct)
```
    Unsafe version of minImageExtent().
  - nmaxImageExtent
```
public static VkExtent2D nmaxImageExtent(long struct)
```
    Unsafe version of maxImageExtent().
  - nmaxImageArrayLayers
```
public static int nmaxImageArrayLayers(long struct)
```
    Unsafe version of maxImageArrayLayers().
  - nsupportedTransforms
```
public static int nsupportedTransforms(long struct)
```
    Unsafe version of supportedTransforms().
  - ncurrentTransform
```
public static int ncurrentTransform(long struct)
```
    Unsafe version of currentTransform().
  - nsupportedCompositeAlpha
```
public static int nsupportedCompositeAlpha(long struct)
```
    Unsafe version of supportedCompositeAlpha().
  - nsupportedUsageFlags
```
public static int nsupportedUsageFlags(long struct)
```
    Unsafe version of supportedUsageFlags().

Class VkSurfaceCapabilitiesKHR

Description

Note

Note

See Also

Member documentation

Layout

Nested Class Summary

Nested classes/interfaces inherited from interface org.lwjgl.system.Pointer

Field Summary

Fields inherited from interface org.lwjgl.system.Pointer

Constructor Summary

Method Summary

Methods inherited from interface org.lwjgl.system.NativeResource

Methods inherited from class java.lang.Object

Methods inherited from class org.lwjgl.system.Pointer.Default

Methods inherited from class org.lwjgl.system.Struct

Field Detail

SIZEOF

ALIGNOF

MINIMAGECOUNT, MAXIMAGECOUNT, CURRENTEXTENT, MINIMAGEEXTENT, MAXIMAGEEXTENT, MAXIMAGEARRAYLAYERS, SUPPORTEDTRANSFORMS, CURRENTTRANSFORM, SUPPORTEDCOMPOSITEALPHA, SUPPORTEDUSAGEFLAGS

Constructor Detail

VkSurfaceCapabilitiesKHR

Method Detail

sizeof

minImageCount

maxImageCount

currentExtent

currentExtent

minImageExtent

minImageExtent

maxImageExtent

maxImageExtent

maxImageArrayLayers

supportedTransforms

currentTransform

supportedCompositeAlpha

supportedUsageFlags

malloc

calloc

create

create

createSafe

malloc

calloc

create

create

createSafe

mallocStack

callocStack

mallocStack

callocStack

mallocStack

callocStack

mallocStack

callocStack

nminImageCount

nmaxImageCount

ncurrentExtent

nminImageExtent

nmaxImageExtent

nmaxImageArrayLayers

nsupportedTransforms

ncurrentTransform

nsupportedCompositeAlpha

nsupportedUsageFlags