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

All Implemented Interfaces:

java.lang.AutoCloseable, org.lwjgl.system.NativeResource, org.lwjgl.system.Pointer
```
public class VkImageCreateInfo
extends org.lwjgl.system.Struct
implements org.lwjgl.system.NativeResource
```
Structure specifying the parameters of a newly created image object.
Description

Images created with tiling equal to IMAGE_TILING_LINEAR have further restrictions on their limits and capabilities compared to images created with tiling equal to IMAGE_TILING_OPTIMAL. Creation of images with tiling IMAGE_TILING_LINEAR may not be supported unless other parameters meet all of the constraints:
- imageType is IMAGE_TYPE_2D
- format is not a depth/stencil format
- mipLevels is 1
- arrayLayers is 1
- samples is SAMPLE_COUNT_1_BIT
- usage only includes IMAGE_USAGE_TRANSFER_SRC_BIT and/or IMAGE_USAGE_TRANSFER_DST_BIT
Images created with one of the formats that require a sampler Y’C_BC_R conversion, have further restrictions on their limits and capabilities compared to images created with other formats. Creation of images with a format requiring Y′C_BC_R conversion may not be supported unless other parameters meet all of the constraints:
- imageType is IMAGE_TYPE_2D
- mipLevels is 1
- arrayLayers is 1
- samples is SAMPLE_COUNT_1_BIT
Implementations may support additional limits and capabilities beyond those listed above.

To determine the set of valid usage bits for a given format, call GetPhysicalDeviceFormatProperties.

If the size of the resultant image would exceed maxResourceSize, then CreateImage must fail and return ERROR_OUT_OF_DEVICE_MEMORY. This failure may occur even when all image creation parameters satisfy their valid usage requirements.

Note

For images created without IMAGE_CREATE_EXTENDED_USAGE_BIT a usage bit is valid if it is supported for the format the image is created with.

For images created with IMAGE_CREATE_EXTENDED_USAGE_BIT a usage bit is valid if it is supported for at least one of the formats a VkImageView created from the image can have (see Image Views for more detail).

Image Creation Limits

Valid values for some image creation parameters are limited by a numerical upper bound or by inclusion in a bitset. For example, VkImageCreateInfo::arrayLayers is limited by imageCreateMaxArrayLayers, defined below; and VkImageCreateInfo::samples is limited by imageCreateSampleCounts, also defined below.

Several limiting values are defined below, as well as assisting values from which the limiting values are derived. The limiting values are referenced by the relevant valid usage statements of VkImageCreateInfo.
- Let uint64_t imageCreateDrmFormatModifiers[] be the set of Linux DRM format modifiers that the resultant image may have.
  - If tiling is not IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then imageCreateDrmFormatModifiers is empty.
  - If VkImageCreateInfo::pNext contains VkImageDrmFormatModifierExplicitCreateInfoEXT, then imageCreateDrmFormatModifiers contains exactly one modifier, VkImageDrmFormatModifierExplicitCreateInfoEXT::drmFormatModifier.
  - If VkImageCreateInfo::pNext contains VkImageDrmFormatModifierListCreateInfoEXT, then imageCreateDrmFormatModifiers contains the entire array VkImageDrmFormatModifierListCreateInfoEXT::pDrmFormatModifiers.
- Let VkBool32 imageCreateMaybeLinear indicate if the resultant image may be linear.
  - If tiling is IMAGE_TILING_LINEAR, then imageCreateMaybeLinear is TRUE.
  - If tiling is IMAGE_TILING_OPTIMAL, then imageCreateMaybeLinear is FALSE.
  - If tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then imageCreateMaybeLinear is TRUE if and only if imageCreateDrmFormatModifiers contains DRM_FORMAT_MOD_LINEAR.
- Let VkFormatFeatureFlags imageCreateFormatFeatures be the set of valid format features available during image creation.
  - If tiling is IMAGE_TILING_LINEAR, then imageCreateFormatFeatures is the value of VkFormatProperties::linearTilingFeatures found by calling GetPhysicalDeviceFormatProperties with parameter format equal to VkImageCreateInfo::format.
  - If tiling is IMAGE_TILING_OPTIMAL, then imageCreateFormatFeatures is the value of VkFormatProperties::optimalTilingFeatures found by calling GetPhysicalDeviceFormatProperties with parameter format equal to VkImageCreateInfo::format.
  - If tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then the value of imageCreateFormatFeatures is found by calling GetPhysicalDeviceFormatProperties2 with VkImageFormatProperties::format equal to VkImageCreateInfo::format and with VkDrmFormatModifierPropertiesListEXT chained into VkFormatProperties2; by collecting all members of the returned array VkDrmFormatModifierPropertiesListEXT::pDrmFormatModifierProperties whose drmFormatModifier belongs to imageCreateDrmFormatModifiers; and by taking the bitwise intersection, over the collected array members, of drmFormatModifierTilingFeatures. (The resultant imageCreateFormatFeatures may be empty).
- Let VkImageFormatProperties2 imageCreateImageFormatPropertiesList[] be the list of structures obtained by calling GetPhysicalDeviceImageFormatProperties2, possibly multiple times, as follows:
  - The parameters VkPhysicalDeviceImageFormatInfo2::format, imageType, tiling, usage, and flags must be equal to those in VkImageCreateInfo.
  - If VkImageCreateInfo::pNext contains a VkExternalMemoryImageCreateInfo structure whose handleTypes is not 0, then VkPhysicalDeviceImageFormatInfo2::pNext must contain a VkPhysicalDeviceExternalImageFormatInfo structure whose handleType is not 0; and GetPhysicalDeviceImageFormatProperties2 must be called for each handle type in VkExternalMemoryImageCreateInfo::handleTypes, successively setting VkPhysicalDeviceExternalImageFormatInfo::handleType on each call.
  - If VkImageCreateInfo::pNext contains no VkExternalMemoryImageCreateInfo structure, or contains a structure whose handleTypes is 0, then VkPhysicalDeviceImageFormatInfo2::pNext must either contain no VkPhysicalDeviceExternalImageFormatInfo structure, or contain a structure whose handleType is 0.
  - If tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then VkPhysicalDeviceImageFormatInfo2::pNext must contain a VkPhysicalDeviceImageDrmFormatModifierInfoEXT structure where sharingMode is equal to VkImageCreateInfo::sharingMode; and, if sharingMode is SHARING_MODE_CONCURRENT, then queueFamilyIndexCount and pQueueFamilyIndices must be equal to those in VkImageCreateInfo; and, if flags contains IMAGE_CREATE_MUTABLE_FORMAT_BIT, then the VkImageFormatListCreateInfo structure included in the pNext chain of VkPhysicalDeviceImageFormatInfo2 must be equivalent to the one included in the pNext chain of VkImageCreateInfo; and GetPhysicalDeviceImageFormatProperties2 must be called for each modifier in imageCreateDrmFormatModifiers, successively setting VkPhysicalDeviceImageDrmFormatModifierInfoEXT::drmFormatModifier on each call.
  - If tiling is not IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then VkPhysicalDeviceImageFormatInfo2::pNext must contain no VkPhysicalDeviceImageDrmFormatModifierInfoEXT structure.
  - If any call to GetPhysicalDeviceImageFormatProperties2 returns an error, then imageCreateImageFormatPropertiesList is defined to be the empty list.
- Let uint32_t imageCreateMaxMipLevels be the minimum value of VkImageFormatProperties::maxMipLevels in imageCreateImageFormatPropertiesList. The value is undefined if imageCreateImageFormatPropertiesList is empty.
- Let uint32_t imageCreateMaxArrayLayers be the minimum value of VkImageFormatProperties::maxArrayLayers in imageCreateImageFormatPropertiesList. The value is undefined if imageCreateImageFormatPropertiesList is empty.
- Let VkExtent3D imageCreateMaxExtent be the component-wise minimum over all VkImageFormatProperties::maxExtent values in imageCreateImageFormatPropertiesList. The value is undefined if imageCreateImageFormatPropertiesList is empty.
- Let VkSampleCountFlags imageCreateSampleCounts be the intersection of each VkImageFormatProperties::sampleCounts in imageCreateImageFormatPropertiesList. The value is undefined if imageCreateImageFormatPropertiesList is empty.
Valid Usage
- Each of the following values (as described in Image Creation Limits) must not be undefined : imageCreateMaxMipLevels, imageCreateMaxArrayLayers, imageCreateMaxExtent, and imageCreateSampleCounts
- If sharingMode is SHARING_MODE_CONCURRENT, pQueueFamilyIndices must be a valid pointer to an array of queueFamilyIndexCount uint32_t values
- If sharingMode is SHARING_MODE_CONCURRENT, queueFamilyIndexCount must be greater than 1
- If sharingMode is SHARING_MODE_CONCURRENT, each element of pQueueFamilyIndices must be unique and must be less than pQueueFamilyPropertyCount returned by either GetPhysicalDeviceQueueFamilyProperties or GetPhysicalDeviceQueueFamilyProperties2 for the physicalDevice that was used to create device
- format must not be FORMAT_UNDEFINED
- extent.width must be greater than 0
- extent.height must be greater than 0
- extent.depth must be greater than 0
- mipLevels must be greater than 0
- arrayLayers must be greater than 0
- If flags contains IMAGE_CREATE_CUBE_COMPATIBLE_BIT, imageType must be IMAGE_TYPE_2D
- If flags contains IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT, imageType must be IMAGE_TYPE_2D
- If flags contains IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT, imageType must be IMAGE_TYPE_3D
- extent.width must be less than or equal to imageCreateMaxExtent.width (as defined in Image Creation Limits)
- extent.height must be less than or equal to imageCreateMaxExtent.height (as defined in Image Creation Limits)
- extent.depth must be less than or equal to imageCreateMaxExtent.depth (as defined in Image Creation Limits)
- If imageType is IMAGE_TYPE_2D and flags contains IMAGE_CREATE_CUBE_COMPATIBLE_BIT, extent.width and extent.height must be equal and arrayLayers must be greater than or equal to 6
- If imageType is IMAGE_TYPE_1D, both extent.height and extent.depth must be 1
- If imageType is IMAGE_TYPE_2D, extent.depth must be 1
- mipLevels must be less than or equal to the number of levels in the complete mipmap chain based on extent.width, extent.height, and extent.depth
- mipLevels must be less than or equal to imageCreateMaxMipLevels (as defined in Image Creation Limits)
- arrayLayers must be less than or equal to imageCreateMaxArrayLayers (as defined in Image Creation Limits)
- If imageType is IMAGE_TYPE_3D, arrayLayers must be 1
- If samples is not SAMPLE_COUNT_1_BIT, then imageType must be IMAGE_TYPE_2D, flags must not contain IMAGE_CREATE_CUBE_COMPATIBLE_BIT, mipLevels must be equal to 1, and imageCreateMaybeLinear (as defined in Image Creation Limits) must be FALSE,
- If samples is not SAMPLE_COUNT_1_BIT, usage must not contain IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT
- If usage includes IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, then bits other than IMAGE_USAGE_COLOR_ATTACHMENT_BIT, IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, and IMAGE_USAGE_INPUT_ATTACHMENT_BIT must not be set
- If usage includes IMAGE_USAGE_COLOR_ATTACHMENT_BIT, IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, or IMAGE_USAGE_INPUT_ATTACHMENT_BIT, extent.width must be less than or equal to VkPhysicalDeviceLimits::maxFramebufferWidth
- If usage includes IMAGE_USAGE_COLOR_ATTACHMENT_BIT, IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, or IMAGE_USAGE_INPUT_ATTACHMENT_BIT, extent.height must be less than or equal to VkPhysicalDeviceLimits::maxFramebufferHeight
- If fragmentDensityMapOffset is not enabled and usage includes IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT, extent.width must be less than or equal to ceil(maxFramebufferWidth / minFragmentDensityTexelSize_width)
- If fragmentDensityMapOffset is not enabled and usage includes IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT, extent.height must be less than or equal to ceil(maxFramebufferHeight / minFragmentDensityTexelSize_height)
- If usage includes IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, usage must also contain at least one of IMAGE_USAGE_COLOR_ATTACHMENT_BIT, IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, or IMAGE_USAGE_INPUT_ATTACHMENT_BIT
- samples must be a bit value that is set in imageCreateSampleCounts (as defined in Image Creation Limits)
- If the multisampled storage images feature is not enabled, and usage contains IMAGE_USAGE_STORAGE_BIT, samples must be SAMPLE_COUNT_1_BIT
- If the sparse bindings feature is not enabled, flags must not contain IMAGE_CREATE_SPARSE_BINDING_BIT
- If the sparse aliased residency feature is not enabled, flags must not contain IMAGE_CREATE_SPARSE_ALIASED_BIT
- If tiling is IMAGE_TILING_LINEAR, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
- If imageType is IMAGE_TYPE_1D, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
- If the sparse residency for 2D images feature is not enabled, and imageType is IMAGE_TYPE_2D, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
- If the sparse residency for 3D images feature is not enabled, and imageType is IMAGE_TYPE_3D, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
- If the sparse residency for images with 2 samples feature is not enabled, imageType is IMAGE_TYPE_2D, and samples is SAMPLE_COUNT_2_BIT, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
- If the sparse residency for images with 4 samples feature is not enabled, imageType is IMAGE_TYPE_2D, and samples is SAMPLE_COUNT_4_BIT, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
- If the sparse residency for images with 8 samples feature is not enabled, imageType is IMAGE_TYPE_2D, and samples is SAMPLE_COUNT_8_BIT, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
- If the sparse residency for images with 16 samples feature is not enabled, imageType is IMAGE_TYPE_2D, and samples is SAMPLE_COUNT_16_BIT, flags must not contain IMAGE_CREATE_SPARSE_RESIDENCY_BIT
- If flags contains IMAGE_CREATE_SPARSE_RESIDENCY_BIT or IMAGE_CREATE_SPARSE_ALIASED_BIT, it must also contain IMAGE_CREATE_SPARSE_BINDING_BIT
- If any of the bits IMAGE_CREATE_SPARSE_BINDING_BIT, IMAGE_CREATE_SPARSE_RESIDENCY_BIT, or IMAGE_CREATE_SPARSE_ALIASED_BIT are set, IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT must not also be set
- If the protected memory feature is not enabled, flags must not contain IMAGE_CREATE_PROTECTED_BIT
- If any of the bits IMAGE_CREATE_SPARSE_BINDING_BIT, IMAGE_CREATE_SPARSE_RESIDENCY_BIT, or IMAGE_CREATE_SPARSE_ALIASED_BIT are set, IMAGE_CREATE_PROTECTED_BIT must not also be set
- If the pNext chain includes a VkExternalMemoryImageCreateInfoNV structure, it must not contain a VkExternalMemoryImageCreateInfo structure
- If the pNext chain includes a VkExternalMemoryImageCreateInfo structure, its handleTypes member must only contain bits that are also in VkExternalImageFormatProperties::externalMemoryProperties.compatibleHandleTypes, as returned by GetPhysicalDeviceImageFormatProperties2 with format, imageType, tiling, usage, and flags equal to those in this structure, and with a VkPhysicalDeviceExternalImageFormatInfo structure included in the pNext chain, with a handleType equal to any one of the handle types specified in VkExternalMemoryImageCreateInfo::handleTypes
- If the pNext chain includes a VkExternalMemoryImageCreateInfoNV structure, its handleTypes member must only contain bits that are also in VkExternalImageFormatPropertiesNV::externalMemoryProperties.compatibleHandleTypes, as returned by GetPhysicalDeviceExternalImageFormatPropertiesNV with format, imageType, tiling, usage, and flags equal to those in this structure, and with externalHandleType equal to any one of the handle types specified in VkExternalMemoryImageCreateInfoNV::handleTypes
- If the logical device was created with VkDeviceGroupDeviceCreateInfo::physicalDeviceCount equal to 1, flags must not contain IMAGE_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT
- If flags contains IMAGE_CREATE_SPLIT_INSTANCE_BIND_REGIONS_BIT, then mipLevels must be one, arrayLayers must be one, imageType must be IMAGE_TYPE_2D. and imageCreateMaybeLinear (as defined in Image Creation Limits) must be FALSE
- If flags contains IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT, then format must be a compressed image format
- If flags contains IMAGE_CREATE_BLOCK_TEXEL_VIEW_COMPATIBLE_BIT, then flags must also contain IMAGE_CREATE_MUTABLE_FORMAT_BIT
- initialLayout must be IMAGE_LAYOUT_UNDEFINED or IMAGE_LAYOUT_PREINITIALIZED
- If the pNext chain includes a VkExternalMemoryImageCreateInfo or VkExternalMemoryImageCreateInfoNV structure whose handleTypes member is not 0, initialLayout must be IMAGE_LAYOUT_UNDEFINED
- If the image format is one of the formats that require a sampler Y’C_BC_R conversion, mipLevels must be 1
- If the image format is one of the formats that require a sampler Y’C_BC_R conversion, samples must be SAMPLE_COUNT_1_BIT
- If the image format is one of the formats that require a sampler Y’C_BC_R conversion, imageType must be IMAGE_TYPE_2D
- If the image format is one of the formats that require a sampler Y’C_BC_R conversion, and the ycbcrImageArrays feature is not enabled, arrayLayers must be 1
- If format is a multi-planar format, and if imageCreateFormatFeatures (as defined in Image Creation Limits) does not contain FORMAT_FEATURE_DISJOINT_BIT, then flags must not contain IMAGE_CREATE_DISJOINT_BIT
- If format is not a multi-planar format, and flags does not include IMAGE_CREATE_ALIAS_BIT, flags must not contain IMAGE_CREATE_DISJOINT_BIT
- If format has a _422 or _420 suffix, width must be a multiple of 2
- If format has a _420 suffix, height must be a multiple of 2
- If tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT, then the pNext chain must include exactly one of VkImageDrmFormatModifierListCreateInfoEXT or VkImageDrmFormatModifierExplicitCreateInfoEXT structures
- If the pNext chain includes a VkImageDrmFormatModifierListCreateInfoEXT or VkImageDrmFormatModifierExplicitCreateInfoEXT structure, then tiling must be IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT
- If tiling is IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT and flags contains IMAGE_CREATE_MUTABLE_FORMAT_BIT, then the pNext chain must include a VkImageFormatListCreateInfo structure with non-zero viewFormatCount
- If flags contains IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT format must be a depth or depth/stencil format
- If format is a depth-stencil format, usage includes IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, and the pNext chain includes a VkImageStencilUsageCreateInfo structure, then its VkImageStencilUsageCreateInfo::stencilUsage member must also include IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
- If format is a depth-stencil format, usage does not include IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT, and the pNext chain includes a VkImageStencilUsageCreateInfo structure, then its VkImageStencilUsageCreateInfo::stencilUsage member must also not include IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT
- If format is a depth-stencil format, usage includes IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, and the pNext chain includes a VkImageStencilUsageCreateInfo structure, then its VkImageStencilUsageCreateInfo::stencilUsage member must also include IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT
- If format is a depth-stencil format, usage does not include IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT, and the pNext chain includes a VkImageStencilUsageCreateInfo structure, then its VkImageStencilUsageCreateInfo::stencilUsage member must also not include IMAGE_USAGE_TRANSIENT_ATTACHMENT_BIT
- If Format is a depth-stencil format and the pNext chain includes a VkImageStencilUsageCreateInfo structure with its stencilUsage member including IMAGE_USAGE_INPUT_ATTACHMENT_BIT, extent.width must be less than or equal to VkPhysicalDeviceLimits::maxFramebufferWidth
- If format is a depth-stencil format and the pNext chain includes a VkImageStencilUsageCreateInfo structure with its stencilUsage member including IMAGE_USAGE_INPUT_ATTACHMENT_BIT, extent.height must be less than or equal to VkPhysicalDeviceLimits::maxFramebufferHeight
- If the multisampled storage images feature is not enabled, format is a depth-stencil format and the pNext chain includes a VkImageStencilUsageCreateInfo structure with its stencilUsage including IMAGE_USAGE_STORAGE_BIT, samples must be SAMPLE_COUNT_1_BIT
- If flags contains IMAGE_CREATE_CORNER_SAMPLED_BIT_NV, imageType must be IMAGE_TYPE_2D or IMAGE_TYPE_3D
- If flags contains IMAGE_CREATE_CORNER_SAMPLED_BIT_NV, it must not contain IMAGE_CREATE_CUBE_COMPATIBLE_BIT and the format must not be a depth/stencil format
- If flags contains IMAGE_CREATE_CORNER_SAMPLED_BIT_NV and imageType is IMAGE_TYPE_2D, extent.width and extent.height must be greater than 1
- If flags contains IMAGE_CREATE_CORNER_SAMPLED_BIT_NV and imageType is IMAGE_TYPE_3D, extent.width, extent.height, and extent.depth must be greater than 1
- If usage includes IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR, imageType must be IMAGE_TYPE_2D
- If usage includes IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR, samples must be SAMPLE_COUNT_1_BIT
- If usage includes IMAGE_USAGE_SHADING_RATE_IMAGE_BIT_NV, tiling must be IMAGE_TILING_OPTIMAL
- If flags contains IMAGE_CREATE_SUBSAMPLED_BIT_EXT, tiling must be IMAGE_TILING_OPTIMAL
- If flags contains IMAGE_CREATE_SUBSAMPLED_BIT_EXT, imageType must be IMAGE_TYPE_2D
- If flags contains IMAGE_CREATE_SUBSAMPLED_BIT_EXT, flags must not contain IMAGE_CREATE_CUBE_COMPATIBLE_BIT
- If flags contains IMAGE_CREATE_SUBSAMPLED_BIT_EXT, mipLevels must be 1
- If usage includes IMAGE_USAGE_INVOCATION_MASK_BIT_HUAWEI, tiling must be IMAGE_TILING_LINEAR
- If the VK_KHR_portability_subset extension is enabled, and VkPhysicalDevicePortabilitySubsetFeaturesKHR::imageView2DOn3DImage is FALSE, flags must not contain IMAGE_CREATE_2D_ARRAY_COMPATIBLE_BIT
- If the VK_KHR_portability_subset extension is enabled, and VkPhysicalDevicePortabilitySubsetFeaturesKHR::multisampleArrayImage is FALSE, and samples is not SAMPLE_COUNT_1_BIT, then arrayLayers must be 1
- If a VkImageFormatListCreateInfo structure was included in the pNext chain and VkImageFormatListCreateInfo::viewFormatCount is not zero, then all of the formats in VkImageFormatListCreateInfo::pViewFormats must be compatible with the format as described in the compatibility table
- If flags does not contain IMAGE_CREATE_MUTABLE_FORMAT_BIT and the pNext chain includes a VkImageFormatListCreateInfo structure, then VkImageFormatListCreateInfo::viewFormatCount must be 0 or 1
- If usage includes IMAGE_USAGE_VIDEO_DECODE_DST_BIT_KHR, IMAGE_USAGE_VIDEO_DECODE_DPB_BIT_KHR, then the pNext chain must include a valid VkVideoProfilesKHR structure which includes at least one VkVideoProfileKHR with a decode codec-operation
- If usage includes IMAGE_USAGE_VIDEO_ENCODE_DST_BIT_KHR, IMAGE_USAGE_VIDEO_ENCODE_SRC_BIT_KHR, IMAGE_USAGE_VIDEO_ENCODE_DPB_BIT_KHR, then the pNext chain must include a valid VkVideoProfilesKHR structure which includes at least one VkVideoProfileKHR with a encode codec-operation
Valid Usage (Implicit)
- sType must be STRUCTURE_TYPE_IMAGE_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 VkDedicatedAllocationImageCreateInfoNV, VkExternalMemoryImageCreateInfo, VkExternalMemoryImageCreateInfoNV, VkImageDrmFormatModifierExplicitCreateInfoEXT, VkImageDrmFormatModifierListCreateInfoEXT, VkImageFormatListCreateInfo, VkImageStencilUsageCreateInfo, VkImageSwapchainCreateInfoKHR, VkVideoDecodeH264ProfileEXT, VkVideoDecodeH265ProfileEXT, VkVideoEncodeH264ProfileEXT, VkVideoEncodeH265ProfileEXT, VkVideoProfileKHR, or VkVideoProfilesKHR
- The sType value of each struct in the pNext chain must be unique
- flags must be a valid combination of VkImageCreateFlagBits values
- imageType must be a valid VkImageType value
- format must be a valid VkFormat value
- samples must be a valid VkSampleCountFlagBits value
- tiling must be a valid VkImageTiling value
- usage must be a valid combination of VkImageUsageFlagBits values
- usage must not be 0
- sharingMode must be a valid VkSharingMode value
- initialLayout must be a valid VkImageLayout value
See Also

VkDeviceImageMemoryRequirements, VkExtent3D, CreateImage

Layout
```
 struct VkImageCreateInfo {
     VkStructureType sType();
     void const * pNext();
     VkImageCreateFlags flags();
     VkImageType imageType();
     VkFormat format();
     VkExtent3D extent();
     uint32_t mipLevels();
     uint32_t arrayLayers();
     VkSampleCountFlagBits samples();
     VkImageTiling tiling();
     VkImageUsageFlags usage();
     VkSharingMode sharingMode();
     uint32_t queueFamilyIndexCount();
     uint32_t const * pQueueFamilyIndices();
     VkImageLayout initialLayout();
 }
```

Nested Class Summary

Nested Classes
Modifier and Type Class Description

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

Field Summary

Fields
Modifier and Type	Field	Description
`static int`	`ALIGNOF`	The struct alignment in bytes.
`static int`	`ARRAYLAYERS EXTENT FLAGS FORMAT IMAGETYPE INITIALLAYOUT MIPLEVELS PNEXT PQUEUEFAMILYINDICES QUEUEFAMILYINDEXCOUNT SAMPLES SHARINGMODE`	The struct member offsets.
`static int`	`SIZEOF`	The struct size in bytes.
`static int`	`STYPE TILING USAGE`	The struct member offsets.

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

Constructor Summary

Constructors
Constructor Description

VkImageCreateInfo(java.nio.ByteBuffer container)
Creates a VkImageCreateInfo instance at the current position of the specified ByteBuffer container.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`int`	`arrayLayers()`	the number of layers in the image.
`VkImageCreateInfo`	`arrayLayers(int value)`	Sets the specified value to the `arrayLayers()` field.
`static VkImageCreateInfo`	`calloc()`	Returns a new `VkImageCreateInfo` instance allocated with `memCalloc`.
`static VkImageCreateInfo.Buffer`	`calloc(int capacity)`	Returns a new `VkImageCreateInfo.Buffer` instance allocated with `memCalloc`.
`static VkImageCreateInfo.Buffer`	`calloc(int capacity, org.lwjgl.system.MemoryStack stack)`	Returns a new `VkImageCreateInfo.Buffer` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static VkImageCreateInfo`	`calloc(org.lwjgl.system.MemoryStack stack)`	Returns a new `VkImageCreateInfo` instance allocated on the specified `MemoryStack` and initializes all its bits to zero.
`static VkImageCreateInfo`	`callocStack()`	Deprecated.
`static VkImageCreateInfo.Buffer`	`callocStack(int capacity)`	Deprecated.
`static VkImageCreateInfo.Buffer`	`callocStack(int capacity, org.lwjgl.system.MemoryStack stack)`	Deprecated.
`static VkImageCreateInfo`	`callocStack(org.lwjgl.system.MemoryStack stack)`	Deprecated.
`static VkImageCreateInfo`	`create()`	Returns a new `VkImageCreateInfo` instance allocated with `BufferUtils`.
`static VkImageCreateInfo.Buffer`	`create(int capacity)`	Returns a new `VkImageCreateInfo.Buffer` instance allocated with `BufferUtils`.
`static VkImageCreateInfo`	`create(long address)`	Returns a new `VkImageCreateInfo` instance for the specified memory address.
`static VkImageCreateInfo.Buffer`	`create(long address, int capacity)`	Create a `VkImageCreateInfo.Buffer` instance at the specified memory.
`static VkImageCreateInfo`	`createSafe(long address)`	Like `create`, but returns `null` if `address` is `NULL`.
`static VkImageCreateInfo.Buffer`	`createSafe(long address, int capacity)`	Like `create`, but returns `null` if `address` is `NULL`.
`VkExtent3D`	`extent()`	a `VkExtent3D` describing the number of data elements in each dimension of the base level.
`VkImageCreateInfo`	`extent(java.util.function.Consumer<VkExtent3D> consumer)`	Passes the `extent()` field to the specified `Consumer`.
`VkImageCreateInfo`	`extent(VkExtent3D value)`	Copies the specified `VkExtent3D` to the `extent()` field.
`int`	`flags()`	a bitmask of `VkImageCreateFlagBits` describing additional parameters of the image.
`VkImageCreateInfo`	`flags(int value)`	Sets the specified value to the `flags()` field.
`int`	`format()`	a `VkFormat` describing the format and type of the texel blocks that will be contained in the image.
`VkImageCreateInfo`	`format(int value)`	Sets the specified value to the `format()` field.
`int`	`imageType()`	a `VkImageType` value specifying the basic dimensionality of the image.
`VkImageCreateInfo`	`imageType(int value)`	Sets the specified value to the `imageType()` field.
`int`	`initialLayout()`	a `VkImageLayout` value specifying the initial `VkImageLayout` of all image subresources of the image.
`VkImageCreateInfo`	`initialLayout(int value)`	Sets the specified value to the `initialLayout()` field.
`static VkImageCreateInfo`	`malloc()`	Returns a new `VkImageCreateInfo` instance allocated with `memAlloc`.
`static VkImageCreateInfo.Buffer`	`malloc(int capacity)`	Returns a new `VkImageCreateInfo.Buffer` instance allocated with `memAlloc`.
`static VkImageCreateInfo.Buffer`	`malloc(int capacity, org.lwjgl.system.MemoryStack stack)`	Returns a new `VkImageCreateInfo.Buffer` instance allocated on the specified `MemoryStack`.
`static VkImageCreateInfo`	`malloc(org.lwjgl.system.MemoryStack stack)`	Returns a new `VkImageCreateInfo` instance allocated on the specified `MemoryStack`.
`static VkImageCreateInfo`	`mallocStack()`	Deprecated.
`static VkImageCreateInfo.Buffer`	`mallocStack(int capacity)`	Deprecated.
`static VkImageCreateInfo.Buffer`	`mallocStack(int capacity, org.lwjgl.system.MemoryStack stack)`	Deprecated.
`static VkImageCreateInfo`	`mallocStack(org.lwjgl.system.MemoryStack stack)`	Deprecated.
`int`	`mipLevels()`	describes the number of levels of detail available for minified sampling of the image.
`VkImageCreateInfo`	`mipLevels(int value)`	Sets the specified value to the `mipLevels()` field.
`static int`	`narrayLayers(long struct)`	Unsafe version of `arrayLayers()`.
`static void`	`narrayLayers(long struct, int value)`	Unsafe version of `arrayLayers`.
`static VkExtent3D`	`nextent(long struct)`	Unsafe version of `extent()`.
`static void`	`nextent(long struct, VkExtent3D value)`	Unsafe version of `extent`.
`static int`	`nflags(long struct)`	Unsafe version of `flags()`.
`static void`	`nflags(long struct, int value)`	Unsafe version of `flags`.
`static int`	`nformat(long struct)`	Unsafe version of `format()`.
`static void`	`nformat(long struct, int value)`	Unsafe version of `format`.
`static int`	`nimageType(long struct)`	Unsafe version of `imageType()`.
`static void`	`nimageType(long struct, int value)`	Unsafe version of `imageType`.
`static int`	`ninitialLayout(long struct)`	Unsafe version of `initialLayout()`.
`static void`	`ninitialLayout(long struct, int value)`	Unsafe version of `initialLayout`.
`static int`	`nmipLevels(long struct)`	Unsafe version of `mipLevels()`.
`static void`	`nmipLevels(long struct, int value)`	Unsafe version of `mipLevels`.
`static long`	`npNext(long struct)`	Unsafe version of `pNext()`.
`static void`	`npNext(long struct, long value)`	Unsafe version of `pNext`.
`static java.nio.IntBuffer`	`npQueueFamilyIndices(long struct)`	Unsafe version of `pQueueFamilyIndices`.
`static void`	`npQueueFamilyIndices(long struct, java.nio.IntBuffer value)`	Unsafe version of `pQueueFamilyIndices`.
`static int`	`nqueueFamilyIndexCount(long struct)`	Unsafe version of `queueFamilyIndexCount()`.
`static void`	`nqueueFamilyIndexCount(long struct, int value)`	Sets the specified value to the `queueFamilyIndexCount` field of the specified `struct`.
`static int`	`nsamples(long struct)`	Unsafe version of `samples()`.
`static void`	`nsamples(long struct, int value)`	Unsafe version of `samples`.
`static int`	`nsharingMode(long struct)`	Unsafe version of `sharingMode()`.
`static void`	`nsharingMode(long struct, int value)`	Unsafe version of `sharingMode`.
`static int`	`nsType(long struct)`	Unsafe version of `sType()`.
`static void`	`nsType(long struct, int value)`	Unsafe version of `sType`.
`static int`	`ntiling(long struct)`	Unsafe version of `tiling()`.
`static void`	`ntiling(long struct, int value)`	Unsafe version of `tiling`.
`static int`	`nusage(long struct)`	Unsafe version of `usage()`.
`static void`	`nusage(long struct, int value)`	Unsafe version of `usage`.
`long`	`pNext()`	`NULL` or a pointer to a structure extending this structure.
`VkImageCreateInfo`	`pNext(long value)`	Sets the specified value to the `pNext()` field.
`VkImageCreateInfo`	`pNext(VkDedicatedAllocationImageCreateInfoNV value)`	Prepends the specified `VkDedicatedAllocationImageCreateInfoNV` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkExternalMemoryImageCreateInfo value)`	Prepends the specified `VkExternalMemoryImageCreateInfo` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkExternalMemoryImageCreateInfoKHR value)`	Prepends the specified `VkExternalMemoryImageCreateInfoKHR` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkExternalMemoryImageCreateInfoNV value)`	Prepends the specified `VkExternalMemoryImageCreateInfoNV` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkImageDrmFormatModifierExplicitCreateInfoEXT value)`	Prepends the specified `VkImageDrmFormatModifierExplicitCreateInfoEXT` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkImageDrmFormatModifierListCreateInfoEXT value)`	Prepends the specified `VkImageDrmFormatModifierListCreateInfoEXT` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkImageFormatListCreateInfo value)`	Prepends the specified `VkImageFormatListCreateInfo` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkImageFormatListCreateInfoKHR value)`	Prepends the specified `VkImageFormatListCreateInfoKHR` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkImageStencilUsageCreateInfo value)`	Prepends the specified `VkImageStencilUsageCreateInfo` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkImageStencilUsageCreateInfoEXT value)`	Prepends the specified `VkImageStencilUsageCreateInfoEXT` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkImageSwapchainCreateInfoKHR value)`	Prepends the specified `VkImageSwapchainCreateInfoKHR` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkVideoDecodeH264ProfileEXT value)`	Prepends the specified `VkVideoDecodeH264ProfileEXT` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkVideoDecodeH265ProfileEXT value)`	Prepends the specified `VkVideoDecodeH265ProfileEXT` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkVideoEncodeH264ProfileEXT value)`	Prepends the specified `VkVideoEncodeH264ProfileEXT` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkVideoEncodeH265ProfileEXT value)`	Prepends the specified `VkVideoEncodeH265ProfileEXT` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkVideoProfileKHR value)`	Prepends the specified `VkVideoProfileKHR` value to the `pNext` chain.
`VkImageCreateInfo`	`pNext(VkVideoProfilesKHR value)`	Prepends the specified `VkVideoProfilesKHR` value to the `pNext` chain.
`java.nio.IntBuffer`	`pQueueFamilyIndices()`	a pointer to an array of queue families that will access this image.
`VkImageCreateInfo`	`pQueueFamilyIndices(java.nio.IntBuffer value)`	Sets the address of the specified `IntBuffer` to the `pQueueFamilyIndices()` field.
`int`	`queueFamilyIndexCount()`	the number of entries in the `pQueueFamilyIndices` array.
`VkImageCreateInfo`	`queueFamilyIndexCount(int value)`	Sets the specified value to the `queueFamilyIndexCount()` field.
`int`	`samples()`	a `VkSampleCountFlagBits` value specifying the number of samples per texel.
`VkImageCreateInfo`	`samples(int value)`	Sets the specified value to the `samples()` field.
`VkImageCreateInfo`	`set(int sType, long pNext, int flags, int imageType, int format, VkExtent3D extent, int mipLevels, int arrayLayers, int samples, int tiling, int usage, int sharingMode, int queueFamilyIndexCount, java.nio.IntBuffer pQueueFamilyIndices, int initialLayout)`	Initializes this struct with the specified values.
`VkImageCreateInfo`	`set(VkImageCreateInfo src)`	Copies the specified struct data to this struct.
`int`	`sharingMode()`	a `VkSharingMode` value specifying the sharing mode of the image when it will be accessed by multiple queue families.
`VkImageCreateInfo`	`sharingMode(int value)`	Sets the specified value to the `sharingMode()` field.
`int`	`sizeof()`
`int`	`sType()`	the type of this structure.
`VkImageCreateInfo`	`sType(int value)`	Sets the specified value to the `sType()` field.
`VkImageCreateInfo`	`sType$Default()`	Sets the `STRUCTURE_TYPE_IMAGE_CREATE_INFO` value to the `sType()` field.
`int`	`tiling()`	a `VkImageTiling` value specifying the tiling arrangement of the texel blocks in memory.
`VkImageCreateInfo`	`tiling(int value)`	Sets the specified value to the `tiling()` field.
`int`	`usage()`	a bitmask of `VkImageUsageFlagBits` describing the intended usage of the image.
`VkImageCreateInfo`	`usage(int value)`	Sets the specified value to the `usage()` 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, validate

- Field Detail
  - SIZEOF
    
    The struct size in bytes.
  - ALIGNOF
    
    The struct alignment in bytes.
  - STYPE, PNEXT, FLAGS, IMAGETYPE, FORMAT, EXTENT, MIPLEVELS, ARRAYLAYERS, SAMPLES, TILING, USAGE, SHARINGMODE, QUEUEFAMILYINDEXCOUNT, PQUEUEFAMILYINDICES, INITIALLAYOUT
    
    The struct member offsets.
- Constructor Detail
  - VkImageCreateInfo
```
public VkImageCreateInfo(java.nio.ByteBuffer container)
```
    Creates a VkImageCreateInfo 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()
```
    Specified by:
    
    sizeof in class org.lwjgl.system.Struct
  - sType
```
public int sType()
```
    the type of this structure.
  - pNext
```
public long pNext()
```
    NULL or a pointer to a structure extending this structure.
  - flags
```
public int flags()
```
    a bitmask of VkImageCreateFlagBits describing additional parameters of the image.
  - imageType
```
public int imageType()
```
    a VkImageType value specifying the basic dimensionality of the image. Layers in array textures do not count as a dimension for the purposes of the image type.
  - format
```
public int format()
```
    a VkFormat describing the format and type of the texel blocks that will be contained in the image.
  - extent
```
public VkExtent3D extent()
```
    a VkExtent3D describing the number of data elements in each dimension of the base level.
  - mipLevels
```
public int mipLevels()
```
    describes the number of levels of detail available for minified sampling of the image.
  - arrayLayers
```
public int arrayLayers()
```
    the number of layers in the image.
  - samples
```
public int samples()
```
    a VkSampleCountFlagBits value specifying the number of samples per texel.
  - tiling
```
public int tiling()
```
    a VkImageTiling value specifying the tiling arrangement of the texel blocks in memory.
  - usage
```
public int usage()
```
    a bitmask of VkImageUsageFlagBits describing the intended usage of the image.
  - sharingMode
```
public int sharingMode()
```
    a VkSharingMode value specifying the sharing mode of the image when it will be accessed by multiple queue families.
  - queueFamilyIndexCount
```
public int queueFamilyIndexCount()
```
    the number of entries in the pQueueFamilyIndices array.
  - pQueueFamilyIndices
```
@Nullable
public java.nio.IntBuffer pQueueFamilyIndices()
```
    a pointer to an array of queue families that will access this image. It is ignored if sharingMode is not SHARING_MODE_CONCURRENT.
  - initialLayout
```
public int initialLayout()
```
    a VkImageLayout value specifying the initial VkImageLayout of all image subresources of the image. See Image Layouts.
  - sType
```
public VkImageCreateInfo sType(int value)
```
    Sets the specified value to the sType() field.
  - sType$Default
```
public VkImageCreateInfo sType$Default()
```
    Sets the STRUCTURE_TYPE_IMAGE_CREATE_INFO value to the sType() field.
  - pNext
```
public VkImageCreateInfo pNext(long value)
```
    Sets the specified value to the pNext() field.
  - pNext
```
public VkImageCreateInfo pNext(VkDedicatedAllocationImageCreateInfoNV value)
```
    Prepends the specified VkDedicatedAllocationImageCreateInfoNV value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkExternalMemoryImageCreateInfo value)
```
    Prepends the specified VkExternalMemoryImageCreateInfo value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkExternalMemoryImageCreateInfoKHR value)
```
    Prepends the specified VkExternalMemoryImageCreateInfoKHR value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkExternalMemoryImageCreateInfoNV value)
```
    Prepends the specified VkExternalMemoryImageCreateInfoNV value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkImageDrmFormatModifierExplicitCreateInfoEXT value)
```
    Prepends the specified VkImageDrmFormatModifierExplicitCreateInfoEXT value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkImageDrmFormatModifierListCreateInfoEXT value)
```
    Prepends the specified VkImageDrmFormatModifierListCreateInfoEXT value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkImageFormatListCreateInfo value)
```
    Prepends the specified VkImageFormatListCreateInfo value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkImageFormatListCreateInfoKHR value)
```
    Prepends the specified VkImageFormatListCreateInfoKHR value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkImageStencilUsageCreateInfo value)
```
    Prepends the specified VkImageStencilUsageCreateInfo value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkImageStencilUsageCreateInfoEXT value)
```
    Prepends the specified VkImageStencilUsageCreateInfoEXT value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkImageSwapchainCreateInfoKHR value)
```
    Prepends the specified VkImageSwapchainCreateInfoKHR value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkVideoDecodeH264ProfileEXT value)
```
    Prepends the specified VkVideoDecodeH264ProfileEXT value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkVideoDecodeH265ProfileEXT value)
```
    Prepends the specified VkVideoDecodeH265ProfileEXT value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkVideoEncodeH264ProfileEXT value)
```
    Prepends the specified VkVideoEncodeH264ProfileEXT value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkVideoEncodeH265ProfileEXT value)
```
    Prepends the specified VkVideoEncodeH265ProfileEXT value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkVideoProfileKHR value)
```
    Prepends the specified VkVideoProfileKHR value to the pNext chain.
  - pNext
```
public VkImageCreateInfo pNext(VkVideoProfilesKHR value)
```
    Prepends the specified VkVideoProfilesKHR value to the pNext chain.
  - flags
```
public VkImageCreateInfo flags(int value)
```
    Sets the specified value to the flags() field.
  - imageType
```
public VkImageCreateInfo imageType(int value)
```
    Sets the specified value to the imageType() field.
  - format
```
public VkImageCreateInfo format(int value)
```
    Sets the specified value to the format() field.
  - extent
```
public VkImageCreateInfo extent(VkExtent3D value)
```
    Copies the specified VkExtent3D to the extent() field.
  - extent
```
public VkImageCreateInfo extent(java.util.function.Consumer<VkExtent3D> consumer)
```
    Passes the extent() field to the specified Consumer.
  - mipLevels
```
public VkImageCreateInfo mipLevels(int value)
```
    Sets the specified value to the mipLevels() field.
  - arrayLayers
```
public VkImageCreateInfo arrayLayers(int value)
```
    Sets the specified value to the arrayLayers() field.
  - samples
```
public VkImageCreateInfo samples(int value)
```
    Sets the specified value to the samples() field.
  - tiling
```
public VkImageCreateInfo tiling(int value)
```
    Sets the specified value to the tiling() field.
  - usage
```
public VkImageCreateInfo usage(int value)
```
    Sets the specified value to the usage() field.
  - sharingMode
```
public VkImageCreateInfo sharingMode(int value)
```
    Sets the specified value to the sharingMode() field.
  - queueFamilyIndexCount
```
public VkImageCreateInfo queueFamilyIndexCount(int value)
```
    Sets the specified value to the queueFamilyIndexCount() field.
  - pQueueFamilyIndices
```
public VkImageCreateInfo pQueueFamilyIndices(@Nullable
                                             java.nio.IntBuffer value)
```
    Sets the address of the specified IntBuffer to the pQueueFamilyIndices() field.
  - initialLayout
```
public VkImageCreateInfo initialLayout(int value)
```
    Sets the specified value to the initialLayout() field.
  - set
```
public VkImageCreateInfo set(int sType,
                             long pNext,
                             int flags,
                             int imageType,
                             int format,
                             VkExtent3D extent,
                             int mipLevels,
                             int arrayLayers,
                             int samples,
                             int tiling,
                             int usage,
                             int sharingMode,
                             int queueFamilyIndexCount,
                             @Nullable
                             java.nio.IntBuffer pQueueFamilyIndices,
                             int initialLayout)
```
    Initializes this struct with the specified values.
  - set
```
public VkImageCreateInfo set(VkImageCreateInfo src)
```
    Copies the specified struct data to this struct.
    
    Parameters:
    
    src - the source struct
    
    Returns:
    
    this struct
  - malloc
```
public static VkImageCreateInfo malloc()
```
    Returns a new VkImageCreateInfo instance allocated with memAlloc. The instance must be explicitly freed.
  - calloc
```
public static VkImageCreateInfo calloc()
```
    Returns a new VkImageCreateInfo instance allocated with memCalloc. The instance must be explicitly freed.
  - create
```
public static VkImageCreateInfo create()
```
    Returns a new VkImageCreateInfo instance allocated with BufferUtils.
  - create
```
public static VkImageCreateInfo create(long address)
```
    Returns a new VkImageCreateInfo instance for the specified memory address.
  - createSafe
```
@Nullable
public static VkImageCreateInfo createSafe(long address)
```
    Like create, but returns null if address is NULL.
  - malloc
```
public static VkImageCreateInfo.Buffer malloc(int capacity)
```
    Returns a new VkImageCreateInfo.Buffer instance allocated with memAlloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - calloc
```
public static VkImageCreateInfo.Buffer calloc(int capacity)
```
    Returns a new VkImageCreateInfo.Buffer instance allocated with memCalloc. The instance must be explicitly freed.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static VkImageCreateInfo.Buffer create(int capacity)
```
    Returns a new VkImageCreateInfo.Buffer instance allocated with BufferUtils.
    
    Parameters:
    
    capacity - the buffer capacity
  - create
```
public static VkImageCreateInfo.Buffer create(long address,
                                              int capacity)
```
    Create a VkImageCreateInfo.Buffer instance at the specified memory.
    
    Parameters:
    
    address - the memory address
    
    capacity - the buffer capacity
  - createSafe
```
@Nullable
public static VkImageCreateInfo.Buffer createSafe(long address,
                                                  int capacity)
```
    Like create, but returns null if address is NULL.
  - mallocStack
```
@Deprecated
public static VkImageCreateInfo mallocStack()
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use malloc(MemoryStack) instead.
  - callocStack
```
@Deprecated
public static VkImageCreateInfo callocStack()
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use calloc(MemoryStack) instead.
  - mallocStack
```
@Deprecated
public static VkImageCreateInfo mallocStack(org.lwjgl.system.MemoryStack stack)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use malloc(MemoryStack) instead.
  - callocStack
```
@Deprecated
public static VkImageCreateInfo callocStack(org.lwjgl.system.MemoryStack stack)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use calloc(MemoryStack) instead.
  - mallocStack
```
@Deprecated
public static VkImageCreateInfo.Buffer mallocStack(int capacity)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use malloc(int, MemoryStack) instead.
  - callocStack
```
@Deprecated
public static VkImageCreateInfo.Buffer callocStack(int capacity)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use calloc(int, MemoryStack) instead.
  - mallocStack
```
@Deprecated
public static VkImageCreateInfo.Buffer mallocStack(int capacity,
                                                   org.lwjgl.system.MemoryStack stack)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use malloc(int, MemoryStack) instead.
  - callocStack
```
@Deprecated
public static VkImageCreateInfo.Buffer callocStack(int capacity,
                                                   org.lwjgl.system.MemoryStack stack)
```
    Deprecated.
    
    Deprecated for removal in 3.4.0. Use calloc(int, MemoryStack) instead.
  - malloc
```
public static VkImageCreateInfo malloc(org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkImageCreateInfo instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
  - calloc
```
public static VkImageCreateInfo calloc(org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkImageCreateInfo instance allocated on the specified MemoryStack and initializes all its bits to zero.
    
    Parameters:
    
    stack - the stack from which to allocate
  - malloc
```
public static VkImageCreateInfo.Buffer malloc(int capacity,
                                              org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkImageCreateInfo.Buffer instance allocated on the specified MemoryStack.
    
    Parameters:
    
    stack - the stack from which to allocate
    
    capacity - the buffer capacity
  - calloc
```
public static VkImageCreateInfo.Buffer calloc(int capacity,
                                              org.lwjgl.system.MemoryStack stack)
```
    Returns a new VkImageCreateInfo.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
  - nsType
```
public static int nsType(long struct)
```
    Unsafe version of sType().
  - npNext
```
public static long npNext(long struct)
```
    Unsafe version of pNext().
  - nflags
```
public static int nflags(long struct)
```
    Unsafe version of flags().
  - nimageType
```
public static int nimageType(long struct)
```
    Unsafe version of imageType().
  - nformat
```
public static int nformat(long struct)
```
    Unsafe version of format().
  - nextent
```
public static VkExtent3D nextent(long struct)
```
    Unsafe version of extent().
  - nmipLevels
```
public static int nmipLevels(long struct)
```
    Unsafe version of mipLevels().
  - narrayLayers
```
public static int narrayLayers(long struct)
```
    Unsafe version of arrayLayers().
  - nsamples
```
public static int nsamples(long struct)
```
    Unsafe version of samples().
  - ntiling
```
public static int ntiling(long struct)
```
    Unsafe version of tiling().
  - nusage
```
public static int nusage(long struct)
```
    Unsafe version of usage().
  - nsharingMode
```
public static int nsharingMode(long struct)
```
    Unsafe version of sharingMode().
  - nqueueFamilyIndexCount
```
public static int nqueueFamilyIndexCount(long struct)
```
    Unsafe version of queueFamilyIndexCount().
  - npQueueFamilyIndices
```
@Nullable
public static java.nio.IntBuffer npQueueFamilyIndices(long struct)
```
    Unsafe version of pQueueFamilyIndices.
  - ninitialLayout
```
public static int ninitialLayout(long struct)
```
    Unsafe version of initialLayout().
  - nsType
```
public static void nsType(long struct,
                          int value)
```
    Unsafe version of sType.
  - npNext
```
public static void npNext(long struct,
                          long value)
```
    Unsafe version of pNext.
  - nflags
```
public static void nflags(long struct,
                          int value)
```
    Unsafe version of flags.
  - nimageType
```
public static void nimageType(long struct,
                              int value)
```
    Unsafe version of imageType.
  - nformat
```
public static void nformat(long struct,
                           int value)
```
    Unsafe version of format.
  - nextent
```
public static void nextent(long struct,
                           VkExtent3D value)
```
    Unsafe version of extent.
  - nmipLevels
```
public static void nmipLevels(long struct,
                              int value)
```
    Unsafe version of mipLevels.
  - narrayLayers
```
public static void narrayLayers(long struct,
                                int value)
```
    Unsafe version of arrayLayers.
  - nsamples
```
public static void nsamples(long struct,
                            int value)
```
    Unsafe version of samples.
  - ntiling
```
public static void ntiling(long struct,
                           int value)
```
    Unsafe version of tiling.
  - nusage
```
public static void nusage(long struct,
                          int value)
```
    Unsafe version of usage.
  - nsharingMode
```
public static void nsharingMode(long struct,
                                int value)
```
    Unsafe version of sharingMode.
  - nqueueFamilyIndexCount
```
public static void nqueueFamilyIndexCount(long struct,
                                          int value)
```
    Sets the specified value to the queueFamilyIndexCount field of the specified struct.
  - npQueueFamilyIndices
```
public static void npQueueFamilyIndices(long struct,
                                        @Nullable
                                        java.nio.IntBuffer value)
```
    Unsafe version of pQueueFamilyIndices.
  - ninitialLayout
```
public static void ninitialLayout(long struct,
                                  int value)
```
    Unsafe version of initialLayout.

Class VkImageCreateInfo

Description

Note

Image Creation Limits

Valid Usage

Valid Usage (Implicit)

See Also

Layout

Nested Class Summary

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

Nested classes/interfaces inherited from class org.lwjgl.system.Struct

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

STYPE, PNEXT, FLAGS, IMAGETYPE, FORMAT, EXTENT, MIPLEVELS, ARRAYLAYERS, SAMPLES, TILING, USAGE, SHARINGMODE, QUEUEFAMILYINDEXCOUNT, PQUEUEFAMILYINDICES, INITIALLAYOUT

Constructor Detail

VkImageCreateInfo

Method Detail

sizeof

sType

pNext

flags

imageType

format

extent

mipLevels

arrayLayers

samples

tiling

usage

sharingMode

queueFamilyIndexCount

pQueueFamilyIndices

initialLayout

sType

sType$Default

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

pNext

flags

imageType

format

extent

extent

mipLevels

arrayLayers

samples

tiling

usage

sharingMode

queueFamilyIndexCount

pQueueFamilyIndices

initialLayout

set

set

malloc

calloc