Vulkan.Extensions.VK_EXT_transform_feedback

Name

VK_EXT_transform_feedback - device extension

VK_EXT_transform_feedback

Name String

VK_EXT_transform_feedback

Extension Type

Device extension

Registered Extension Number

29

Revision

1

Extension and Version Dependencies

• Requires support for Vulkan 1.0
• Requires VK_KHR_get_physical_device_properties2 to be enabled for any device-level functionality

Special Uses

• OpenGL / ES support
• D3D support
• Developer tools

Contact

• Piers Daniell @pdaniell-nv%0A*Here describe the issue or question you have about the VK_EXT_transform_feedback extension*

Other Extension Metadata

Last Modified Date

2018-10-09

Contributors

• Baldur Karlsson, Valve
• Boris Zanin, Mobica
• Daniel Rakos, AMD
• Donald Scorgie, Imagination
• Henri Verbeet, CodeWeavers
• Jan-Harald Fredriksen, Arm
• Jason Ekstrand, Intel
• Jeff Bolz, NVIDIA
• Jesse Barker, Unity
• Jesse Hall, Google
• Pierre-Loup Griffais, Valve
• Philip Rebohle, DXVK
• Ruihao Zhang, Qualcomm
• Samuel Pitoiset, Valve
• Slawomir Grajewski, Intel
• Stu Smith, Imagination Technologies

Description

This extension adds transform feedback to the Vulkan API by exposing the SPIR-V TransformFeedback and GeometryStreams capabilities to capture vertex, tessellation or geometry shader outputs to one or more buffers. It adds API functionality to bind transform feedback buffers to capture the primitives emitted by the graphics pipeline from SPIR-V outputs decorated for transform feedback. The transform feedback capture can be paused and resumed by way of storing and retrieving a byte counter. The captured data can be drawn again where the vertex count is derived from the byte counter without CPU intervention. If the implementation is capable, a vertex stream other than zero can be rasterized.

All these features are designed to match the full capabilities of OpenGL core transform feedback functionality and beyond. Many of the features are optional to allow base OpenGL ES GPUs to also implement this extension.

The primary purpose of the functionality exposed by this extension is to support translation layers from other 3D APIs. This functionality is not considered forward looking, and is not expected to be promoted to a KHR extension or to core Vulkan. Unless this is needed for translation, it is recommended that developers use alternative techniques of using the GPU to process and capture vertex data.

New Commands

• cmdBeginQueryIndexedEXT

• cmdBeginTransformFeedbackEXT
• cmdBindTransformFeedbackBuffersEXT
• cmdDrawIndirectByteCountEXT
• cmdEndQueryIndexedEXT
• cmdEndTransformFeedbackEXT

New Structures

• Extending PhysicalDeviceFeatures2, DeviceCreateInfo:

  • PhysicalDeviceTransformFeedbackFeaturesEXT

• Extending PhysicalDeviceProperties2:

  • PhysicalDeviceTransformFeedbackPropertiesEXT

• Extending PipelineRasterizationStateCreateInfo:

  • PipelineRasterizationStateStreamCreateInfoEXT

New Bitmasks

• PipelineRasterizationStateStreamCreateFlagsEXT

New Enum Constants

• EXT_TRANSFORM_FEEDBACK_EXTENSION_NAME

• EXT_TRANSFORM_FEEDBACK_SPEC_VERSION

• Extending AccessFlagBits:

  • ACCESS_TRANSFORM_FEEDBACK_COUNTER_READ_BIT_EXT
  • ACCESS_TRANSFORM_FEEDBACK_COUNTER_WRITE_BIT_EXT
  • ACCESS_TRANSFORM_FEEDBACK_WRITE_BIT_EXT

• Extending BufferUsageFlagBits:

  • BUFFER_USAGE_TRANSFORM_FEEDBACK_BUFFER_BIT_EXT
  • BUFFER_USAGE_TRANSFORM_FEEDBACK_COUNTER_BUFFER_BIT_EXT

• Extending PipelineStageFlagBits:

  • PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT

• Extending QueryType:

  • QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT

• Extending StructureType:

  • STRUCTURE_TYPE_PHYSICAL_DEVICE_TRANSFORM_FEEDBACK_FEATURES_EXT
  • STRUCTURE_TYPE_PHYSICAL_DEVICE_TRANSFORM_FEEDBACK_PROPERTIES_EXT
  • STRUCTURE_TYPE_PIPELINE_RASTERIZATION_STATE_STREAM_CREATE_INFO_EXT

Issues

1) Should we include pause/resume functionality?

RESOLVED: Yes, this is needed to ease layering other APIs which have this functionality. To pause use cmdEndTransformFeedbackEXT and provide valid buffer handles in the pCounterBuffers array and offsets in the pCounterBufferOffsets array for the implementation to save the resume points. Then to resume use cmdBeginTransformFeedbackEXT with the previous pCounterBuffers and pCounterBufferOffsets values. Between the pause and resume there needs to be a memory barrier for the counter buffers with a source access of ACCESS_TRANSFORM_FEEDBACK_COUNTER_WRITE_BIT_EXT at pipeline stage PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT to a destination access of ACCESS_TRANSFORM_FEEDBACK_COUNTER_READ_BIT_EXT at pipeline stage PIPELINE_STAGE_TRANSFORM_FEEDBACK_BIT_EXT.

2) How does this interact with multiview?

RESOLVED: Transform feedback cannot be made active in a render pass with multiview enabled.

3) How should queries be done?

RESOLVED: There is a new query type QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT. A query pool created with this type will capture 2 integers - numPrimitivesWritten and numPrimitivesNeeded - for the specified vertex stream output from the last pre-rasterization shader stage. The vertex stream output queried is zero by default, but can be specified with the new cmdBeginQueryIndexedEXT and cmdEndQueryIndexedEXT commands.

Version History

• Revision 1, 2018-10-09 (Piers Daniell)

  • Internal revisions

See Also

PhysicalDeviceTransformFeedbackFeaturesEXT, PhysicalDeviceTransformFeedbackPropertiesEXT, PipelineRasterizationStateStreamCreateFlagsEXT, PipelineRasterizationStateStreamCreateInfoEXT, cmdBeginQueryIndexedEXT, cmdBeginTransformFeedbackEXT, cmdBindTransformFeedbackBuffersEXT, cmdDrawIndirectByteCountEXT, cmdEndQueryIndexedEXT, cmdEndTransformFeedbackEXT

Document Notes

For more information, see the Vulkan Specification

This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.

Documentation

cmdBindTransformFeedbackBuffersEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

commandBuffer is the command buffer into which the command is recorded.

-> ("firstBinding" ::: Word32)

firstBinding is the index of the first transform feedback binding whose state is updated by the command.

-> ("buffers" ::: Vector Buffer)

pBuffers is a pointer to an array of buffer handles.

-> ("offsets" ::: Vector DeviceSize)

pOffsets is a pointer to an array of buffer offsets.

-> ("sizes" ::: Vector DeviceSize)

pSizes is NULL or a pointer to an array of DeviceSize buffer sizes, specifying the maximum number of bytes to capture to the corresponding transform feedback buffer. If pSizes is NULL, or the value of the pSizes array element is WHOLE_SIZE, then the maximum number of bytes captured will be the size of the corresponding buffer minus the buffer offset.

-> io ()

vkCmdBindTransformFeedbackBuffersEXT - Bind transform feedback buffers to a command buffer

Description

The values taken from elements i of pBuffers, pOffsets and pSizes replace the current state for the transform feedback binding firstBinding + i, for i in [0, bindingCount). The transform feedback binding is updated to start at the offset indicated by pOffsets[i] from the start of the buffer pBuffers[i].

Valid Usage

• PhysicalDeviceTransformFeedbackFeaturesEXT::transformFeedback must be enabled

• firstBinding must be less than PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackBuffers
• The sum of firstBinding and bindingCount must be less than or equal to PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackBuffers
• All elements of pOffsets must be less than the size of the corresponding element in pBuffers
• All elements of pOffsets must be a multiple of 4
• All elements of pBuffers must have been created with the BUFFER_USAGE_TRANSFORM_FEEDBACK_BUFFER_BIT_EXT flag
• If the optional pSize array is specified, each element of pSizes must either be WHOLE_SIZE, or be less than or equal to PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackBufferSize
• All elements of pSizes must be either WHOLE_SIZE, or less than or equal to the size of the corresponding buffer in pBuffers
• All elements of pOffsets plus pSizes, where the pSizes, element is not WHOLE_SIZE, must be less than or equal to the size of the corresponding buffer in pBuffers
• Each element of pBuffers that is non-sparse must be bound completely and contiguously to a single DeviceMemory object
• Transform feedback must not be active when the cmdBindTransformFeedbackBuffersEXT command is recorded

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• pBuffers must be a valid pointer to an array of bindingCount valid Buffer handles
• pOffsets must be a valid pointer to an array of bindingCount DeviceSize values
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics operations
• This command must only be called outside of a video coding scope
• bindingCount must be greater than 0
• Both of commandBuffer, and the elements of pBuffers must have been created, allocated, or retrieved from the same Device

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Command Buffer Levels	Render Pass Scope	Video Coding Scope	Supported Queue Types	Command Type
Primary Secondary	Both	Outside	Graphics	State

See Also

VK_EXT_transform_feedback, Buffer, CommandBuffer, DeviceSize

cmdBeginTransformFeedbackEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

commandBuffer is the command buffer into which the command is recorded.

-> ("firstCounterBuffer" ::: Word32)

firstCounterBuffer is the index of the first transform feedback buffer corresponding to pCounterBuffers[0] and pCounterBufferOffsets[0].

-> ("counterBuffers" ::: Vector Buffer)

pCounterBuffers is NULL or a pointer to an array of Buffer handles to counter buffers. Each buffer contains a 4 byte integer value representing the byte offset from the start of the corresponding transform feedback buffer from where to start capturing vertex data. If the byte offset stored to the counter buffer location was done using cmdEndTransformFeedbackEXT it can be used to resume transform feedback from the previous location. If pCounterBuffers is NULL, then transform feedback will start capturing vertex data to byte offset zero in all bound transform feedback buffers. For each element of pCounterBuffers that is NULL_HANDLE, transform feedback will start capturing vertex data to byte zero in the corresponding bound transform feedback buffer.

-> ("counterBufferOffsets" ::: Vector DeviceSize)

pCounterBufferOffsets is NULL or a pointer to an array of DeviceSize values specifying offsets within each of the pCounterBuffers where the counter values were previously written. The location in each counter buffer at these offsets must be large enough to contain 4 bytes of data. This data is the number of bytes captured by the previous transform feedback to this buffer. If pCounterBufferOffsets is NULL, then it is assumed the offsets are zero.

-> io ()

vkCmdBeginTransformFeedbackEXT - Make transform feedback active in the command buffer

Description

The active transform feedback buffers will capture primitives emitted from the corresponding XfbBuffer in the bound graphics pipeline. Any XfbBuffer emitted that does not output to an active transform feedback buffer will not be captured.

Valid Usage

• PhysicalDeviceTransformFeedbackFeaturesEXT::transformFeedback must be enabled

• Transform feedback must not be active
• firstCounterBuffer must be less than PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackBuffers
• The sum of firstCounterBuffer and counterBufferCount must be less than or equal to PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackBuffers
• If counterBufferCount is not 0, and pCounterBuffers is not NULL, pCounterBuffers must be a valid pointer to an array of counterBufferCount Buffer handles that are either valid or NULL_HANDLE
• For each buffer handle in the array, if it is not NULL_HANDLE it must reference a buffer large enough to hold 4 bytes at the corresponding offset from the pCounterBufferOffsets array
• If pCounterBuffer is NULL, then pCounterBufferOffsets must also be NULL
• For each buffer handle in the pCounterBuffers array that is not NULL_HANDLE it must have been created with a usage value containing BUFFER_USAGE_TRANSFORM_FEEDBACK_COUNTER_BUFFER_BIT_EXT
• A valid graphics pipeline must be bound to PIPELINE_BIND_POINT_GRAPHICS
• The last pre-rasterization shader stage of the bound graphics pipeline must have been declared with the Xfb execution mode
• Transform feedback must not be made active in a render pass instance with multiview enabled

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• If counterBufferCount is not 0, and pCounterBufferOffsets is not NULL, pCounterBufferOffsets must be a valid pointer to an array of counterBufferCount DeviceSize values
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics operations
• This command must only be called inside of a render pass instance
• This command must only be called outside of a video coding scope
• Both of commandBuffer, and the elements of pCounterBuffers that are valid handles of non-ignored parameters must have been created, allocated, or retrieved from the same Device

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Command Buffer Levels	Render Pass Scope	Video Coding Scope	Supported Queue Types	Command Type
Primary Secondary	Inside	Outside	Graphics	State

See Also

VK_EXT_transform_feedback, Buffer, CommandBuffer, DeviceSize

cmdUseTransformFeedbackEXT :: forall io r. MonadIO io => CommandBuffer -> Word32 -> Vector Buffer -> Vector DeviceSize -> io r -> io r

This function will call the supplied action between calls to cmdBeginTransformFeedbackEXT and cmdEndTransformFeedbackEXT

Note that cmdEndTransformFeedbackEXT is *not* called if an exception is thrown by the inner action.

cmdEndTransformFeedbackEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

commandBuffer is the command buffer into which the command is recorded.

-> ("firstCounterBuffer" ::: Word32)

firstCounterBuffer is the index of the first transform feedback buffer corresponding to pCounterBuffers[0] and pCounterBufferOffsets[0].

-> ("counterBuffers" ::: Vector Buffer)

pCounterBuffers is NULL or a pointer to an array of Buffer handles to counter buffers. The counter buffers are used to record the current byte positions of each transform feedback buffer where the next vertex output data would be captured. This can be used by a subsequent cmdBeginTransformFeedbackEXT call to resume transform feedback capture from this position. It can also be used by cmdDrawIndirectByteCountEXT to determine the vertex count of the draw call.

-> ("counterBufferOffsets" ::: Vector DeviceSize)

pCounterBufferOffsets is NULL or a pointer to an array of DeviceSize values specifying offsets within each of the pCounterBuffers where the counter values can be written. The location in each counter buffer at these offsets must be large enough to contain 4 bytes of data. The data stored at this location is the byte offset from the start of the transform feedback buffer binding where the next vertex data would be written. If pCounterBufferOffsets is NULL, then it is assumed the offsets are zero.

-> io ()

vkCmdEndTransformFeedbackEXT - Make transform feedback inactive in the command buffer

Valid Usage

• PhysicalDeviceTransformFeedbackFeaturesEXT::transformFeedback must be enabled

• Transform feedback must be active
• firstCounterBuffer must be less than PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackBuffers
• The sum of firstCounterBuffer and counterBufferCount must be less than or equal to PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackBuffers
• If counterBufferCount is not 0, and pCounterBuffers is not NULL, pCounterBuffers must be a valid pointer to an array of counterBufferCount Buffer handles that are either valid or NULL_HANDLE
• For each buffer handle in the array, if it is not NULL_HANDLE it must reference a buffer large enough to hold 4 bytes at the corresponding offset from the pCounterBufferOffsets array
• If pCounterBuffer is NULL, then pCounterBufferOffsets must also be NULL
• For each buffer handle in the pCounterBuffers array that is not NULL_HANDLE it must have been created with a usage value containing BUFFER_USAGE_TRANSFORM_FEEDBACK_COUNTER_BUFFER_BIT_EXT

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• If counterBufferCount is not 0, and pCounterBufferOffsets is not NULL, pCounterBufferOffsets must be a valid pointer to an array of counterBufferCount DeviceSize values
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics operations
• This command must only be called inside of a render pass instance
• This command must only be called outside of a video coding scope
• Both of commandBuffer, and the elements of pCounterBuffers that are valid handles of non-ignored parameters must have been created, allocated, or retrieved from the same Device

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Command Buffer Levels	Render Pass Scope	Video Coding Scope	Supported Queue Types	Command Type
Primary Secondary	Inside	Outside	Graphics	State

See Also

VK_EXT_transform_feedback, Buffer, CommandBuffer, DeviceSize

cmdBeginQueryIndexedEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

commandBuffer is the command buffer into which this command will be recorded.

-> QueryPool

queryPool is the query pool that will manage the results of the query.

-> ("query" ::: Word32)

query is the query index within the query pool that will contain the results.

-> QueryControlFlags

flags is a bitmask of QueryControlFlagBits specifying constraints on the types of queries that can be performed.

-> ("index" ::: Word32)

index is the query type specific index. When the query type is QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT or QUERY_TYPE_PRIMITIVES_GENERATED_EXT, the index represents the vertex stream.

-> io ()

vkCmdBeginQueryIndexedEXT - Begin an indexed query

Description

The cmdBeginQueryIndexedEXT command operates the same as the cmdBeginQuery command, except that it also accepts a query type specific index parameter.

This command defines an execution dependency between other query commands that reference the same query index.

The first synchronization scope includes all commands which reference the queries in queryPool indicated by query and index that occur earlier in submission order.

The second synchronization scope includes all commands which reference the queries in queryPool indicated by query and index that occur later in submission order.

The operation of this command happens after the first scope and happens before the second scope.

Valid Usage

• All queries used by the command must be unavailable

• The queryType used to create queryPool must not be QUERY_TYPE_TIMESTAMP
• The queryType used to create queryPool must not be QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_KHR or QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_SIZE_KHR
• The queryType used to create queryPool must not be QUERY_TYPE_ACCELERATION_STRUCTURE_SIZE_KHR or QUERY_TYPE_ACCELERATION_STRUCTURE_SERIALIZATION_BOTTOM_LEVEL_POINTERS_KHR
• The queryType used to create queryPool must not be QUERY_TYPE_ACCELERATION_STRUCTURE_COMPACTED_SIZE_NV
• If the occlusionQueryPrecise feature is not enabled, or the queryType used to create queryPool was not QUERY_TYPE_OCCLUSION, flags must not contain QUERY_CONTROL_PRECISE_BIT
• query must be less than the number of queries in queryPool
• If the queryType used to create queryPool was QUERY_TYPE_OCCLUSION, the CommandPool that commandBuffer was allocated from must support graphics operations
• If the queryType used to create queryPool was QUERY_TYPE_PIPELINE_STATISTICS and any of the pipelineStatistics indicate graphics operations, the CommandPool that commandBuffer was allocated from must support graphics operations
• If the queryType used to create queryPool was QUERY_TYPE_PIPELINE_STATISTICS and any of the pipelineStatistics indicate compute operations, the CommandPool that commandBuffer was allocated from must support compute operations
• commandBuffer must not be a protected command buffer
• If called within a render pass instance, the sum of query and the number of bits set in the current subpass’s view mask must be less than or equal to the number of queries in queryPool
• If the queryType used to create queryPool was VK_QUERY_TYPE_VIDEO_ENCODE_BITSTREAM_BUFFER_RANGE_KHR the CommandPool that commandBuffer was allocated from must support video encode operations
• If the queryPool was created with the same queryType as that of another active query within commandBuffer, then index must not match the index used for the active query
• If the queryType used to create queryPool was QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT the CommandPool that commandBuffer was allocated from must support graphics operations
• If the queryType used to create queryPool was QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT the index parameter must be less than PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackStreams
• If the queryType used to create queryPool was QUERY_TYPE_PRIMITIVES_GENERATED_EXT the CommandPool that commandBuffer was allocated from must support graphics operations
• If the queryType used to create queryPool was QUERY_TYPE_PRIMITIVES_GENERATED_EXT the index parameter must be less than PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackStreams
• If the queryType used to create queryPool was QUERY_TYPE_PRIMITIVES_GENERATED_EXT and the primitivesGeneratedQueryWithNonZeroStreams feature is not enabled, the index parameter must be zero.
• If the queryType used to create queryPool was not QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT and not QUERY_TYPE_PRIMITIVES_GENERATED_EXT, the index must be zero
• If the queryType used to create queryPool was QUERY_TYPE_PRIMITIVES_GENERATED_EXT then primitivesGeneratedQuery must be enabled
• If the queryType used to create queryPool was QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT then PhysicalDeviceTransformFeedbackPropertiesEXT::transformFeedbackQueries must be supported
• The queryType used to create queryPool must not be QUERY_TYPE_MESH_PRIMITIVES_GENERATED_EXT
• If queryPool was created with a queryType of QUERY_TYPE_PERFORMANCE_QUERY_KHR, then the QueryPoolPerformanceCreateInfoKHR::queueFamilyIndex queryPool was created with must equal the queue family index of the CommandPool that commandBuffer was allocated from
• If queryPool was created with a queryType of QUERY_TYPE_PERFORMANCE_QUERY_KHR, the profiling lock must have been held before beginCommandBuffer was called on commandBuffer
• If queryPool was created with a queryType of QUERY_TYPE_PERFORMANCE_QUERY_KHR and one of the counters used to create queryPool was PERFORMANCE_COUNTER_SCOPE_COMMAND_BUFFER_KHR, the query begin must be the first recorded command in commandBuffer
• If queryPool was created with a queryType of QUERY_TYPE_PERFORMANCE_QUERY_KHR and one of the counters used to create queryPool was PERFORMANCE_COUNTER_SCOPE_RENDER_PASS_KHR, the begin command must not be recorded within a render pass instance
• If queryPool was created with a queryType of QUERY_TYPE_PERFORMANCE_QUERY_KHR and another query pool with a queryType QUERY_TYPE_PERFORMANCE_QUERY_KHR has been used within commandBuffer, its parent primary command buffer or secondary command buffer recorded within the same parent primary command buffer as commandBuffer, the performanceCounterMultipleQueryPools feature must be enabled
• If queryPool was created with a queryType of QUERY_TYPE_PERFORMANCE_QUERY_KHR, this command must not be recorded in a command buffer that, either directly or through secondary command buffers, also contains a cmdResetQueryPool command affecting the same query

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• queryPool must be a valid QueryPool handle
• flags must be a valid combination of QueryControlFlagBits values
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics, compute, decode, or encode operations
• This command must only be called outside of a video coding scope
• Both of commandBuffer, and queryPool must have been created, allocated, or retrieved from the same Device

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Command Buffer Levels	Render Pass Scope	Video Coding Scope	Supported Queue Types	Command Type
Primary Secondary	Both	Outside	Graphics Compute Decode Encode	Action State

See Also

VK_EXT_transform_feedback, CommandBuffer, QueryControlFlags, QueryPool, cmdBeginQuery, cmdEndQuery, cmdEndQueryIndexedEXT

cmdUseQueryIndexedEXT :: forall io r. MonadIO io => CommandBuffer -> QueryPool -> Word32 -> QueryControlFlags -> Word32 -> io r -> io r

This function will call the supplied action between calls to cmdBeginQueryIndexedEXT and cmdEndQueryIndexedEXT

Note that cmdEndQueryIndexedEXT is *not* called if an exception is thrown by the inner action.

cmdEndQueryIndexedEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

commandBuffer is the command buffer into which this command will be recorded.

-> QueryPool

queryPool is the query pool that is managing the results of the query.

-> ("query" ::: Word32)

query is the query index within the query pool where the result is stored.

-> ("index" ::: Word32)

index is the query type specific index.

-> io ()

vkCmdEndQueryIndexedEXT - Ends a query

Description

The command completes the query in queryPool identified by query and index, and marks it as available.

The cmdEndQueryIndexedEXT command operates the same as the cmdEndQuery command, except that it also accepts a query type specific index parameter.

This command defines an execution dependency between other query commands that reference the same query index.

The first synchronization scope includes all commands which reference the queries in queryPool indicated by query that occur earlier in submission order.

The second synchronization scope includes only the operation of this command.

Valid Usage

• All queries used by the command must be active

• query must be less than the number of queries in queryPool
• commandBuffer must not be a protected command buffer
• If cmdEndQueryIndexedEXT is called within a render pass instance, the sum of query and the number of bits set in the current subpass’s view mask must be less than or equal to the number of queries in queryPool
• If the queryType used to create queryPool was QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT or QUERY_TYPE_PRIMITIVES_GENERATED_EXT, the index parameter must be less than PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackStreams
• If the queryType used to create queryPool was not QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT and not QUERY_TYPE_PRIMITIVES_GENERATED_EXT, the index must be zero
• If the queryType used to create queryPool was QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT or QUERY_TYPE_PRIMITIVES_GENERATED_EXT, index must equal the index used to begin the query
• [[VUID-{refpage}-None-07007]] If called within a subpass of a render pass instance, the corresponding cmdBeginQuery* command must have been called previously within the same subpass
• [[VUID-{refpage}-None-07008]] If called outside of a render pass instance, the corresponding cmdBeginQuery* command must have been called outside of a render pass instance

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• queryPool must be a valid QueryPool handle
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics, compute, decode, or encode operations
• This command must only be called outside of a video coding scope
• Both of commandBuffer, and queryPool must have been created, allocated, or retrieved from the same Device

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Command Buffer Levels	Render Pass Scope	Video Coding Scope	Supported Queue Types	Command Type
Primary Secondary	Both	Outside	Graphics Compute Decode Encode	Action State

See Also

VK_EXT_transform_feedback, CommandBuffer, QueryPool, cmdBeginQuery, cmdBeginQueryIndexedEXT, cmdEndQuery

cmdDrawIndirectByteCountEXT

Arguments

:: forall io. MonadIO io

=> CommandBuffer

commandBuffer is the command buffer into which the command is recorded.

-> ("instanceCount" ::: Word32)

instanceCount is the number of instances to draw.

-> ("firstInstance" ::: Word32)

firstInstance is the instance ID of the first instance to draw.

-> ("counterBuffer" ::: Buffer)

counterBuffer is the buffer handle from where the byte count is read.

-> ("counterBufferOffset" ::: DeviceSize)

counterBufferOffset is the offset into the buffer used to read the byte count, which is used to calculate the vertex count for this draw call.

-> ("counterOffset" ::: Word32)

counterOffset is subtracted from the byte count read from the counterBuffer at the counterBufferOffset

-> ("vertexStride" ::: Word32)

vertexStride is the stride in bytes between each element of the vertex data that is used to calculate the vertex count from the counter value. This value is typically the same value that was used in the graphics pipeline state when the transform feedback was captured as the XfbStride.

-> io ()

vkCmdDrawIndirectByteCountEXT - Draw primitives with indirect parameters where the vertex count is derived from the counter byte value in the counter buffer

Description

When the command is executed, primitives are assembled in the same way as done with cmdDraw except the vertexCount is calculated based on the byte count read from counterBuffer at offset counterBufferOffset. The assembled primitives execute the bound graphics pipeline.

The effective vertexCount is calculated as follows:

const uint32_t * counterBufferPtr = (const uint8_t *)counterBuffer.address + counterBufferOffset;
vertexCount = floor(max(0, (*counterBufferPtr - counterOffset)) / vertexStride);

The effective firstVertex is zero.

Valid Usage

• If a Sampler created with magFilter or minFilter equal to FILTER_LINEAR and compareEnable equal to FALSE is used to sample a ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT

• If a Sampler created with mipmapMode equal to SAMPLER_MIPMAP_MODE_LINEAR and compareEnable equal to FALSE is used to sample a ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_LINEAR_BIT
• If a ImageView is sampled with depth comparison, the image view’s format features must contain FORMAT_FEATURE_2_SAMPLED_IMAGE_DEPTH_COMPARISON_BIT
• If a ImageView is accessed using atomic operations as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_STORAGE_IMAGE_ATOMIC_BIT
• If a ImageView is sampled with FILTER_CUBIC_EXT as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_SAMPLED_IMAGE_FILTER_CUBIC_BIT_EXT
• Any ImageView being sampled with FILTER_CUBIC_EXT as a result of this command must have a ImageViewType and format that supports cubic filtering, as specified by FilterCubicImageViewImageFormatPropertiesEXT::filterCubic returned by getPhysicalDeviceImageFormatProperties2
• Any ImageView being sampled with FILTER_CUBIC_EXT with a reduction mode of either SAMPLER_REDUCTION_MODE_MIN or SAMPLER_REDUCTION_MODE_MAX as a result of this command must have a ImageViewType and format that supports cubic filtering together with minmax filtering, as specified by FilterCubicImageViewImageFormatPropertiesEXT::filterCubicMinmax returned by getPhysicalDeviceImageFormatProperties2
• Any Image created with a ImageCreateInfo::flags containing IMAGE_CREATE_CORNER_SAMPLED_BIT_NV sampled as a result of this command must only be sampled using a SamplerAddressMode of SAMPLER_ADDRESS_MODE_CLAMP_TO_EDGE
• For any ImageView being written as a storage image where the image format field of the OpTypeImage is Unknown, the view’s format features must contain FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT
• For any ImageView being read as a storage image where the image format field of the OpTypeImage is Unknown, the view’s format features must contain FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT
• For any BufferView being written as a storage texel buffer where the image format field of the OpTypeImage is Unknown, the view’s buffer features must contain FORMAT_FEATURE_2_STORAGE_WRITE_WITHOUT_FORMAT_BIT
• Any BufferView being read as a storage texel buffer where the image format field of the OpTypeImage is Unknown then the view’s buffer features must contain FORMAT_FEATURE_2_STORAGE_READ_WITHOUT_FORMAT_BIT
• For each set n that is statically used by the Pipeline bound to the pipeline bind point used by this command, a descriptor set must have been bound to n at the same pipeline bind point, with a PipelineLayout that is compatible for set n, with the PipelineLayout used to create the current Pipeline, as described in ???
• If the maintenance4 feature is not enabled, then for each push constant that is statically used by the Pipeline bound to the pipeline bind point used by this command, a push constant value must have been set for the same pipeline bind point, with a PipelineLayout that is compatible for push constants, with the PipelineLayout used to create the current Pipeline, as described in ???
• Descriptors in each bound descriptor set, specified via cmdBindDescriptorSets, must be valid if they are statically used by the Pipeline bound to the pipeline bind point used by this command
• A valid pipeline must be bound to the pipeline bind point used by this command
• If the Pipeline object bound to the pipeline bind point used by this command requires any dynamic state, that state must have been set or inherited (if the VK_NV_inherited_viewport_scissor extension is enabled) for commandBuffer, and done so after any previously bound pipeline with the corresponding state not specified as dynamic
• There must not have been any calls to dynamic state setting commands for any state not specified as dynamic in the Pipeline object bound to the pipeline bind point used by this command, since that pipeline was bound
• If the Pipeline object bound to the pipeline bind point used by this command accesses a Sampler object that uses unnormalized coordinates, that sampler must not be used to sample from any Image with a ImageView of the type IMAGE_VIEW_TYPE_3D, IMAGE_VIEW_TYPE_CUBE, IMAGE_VIEW_TYPE_1D_ARRAY, IMAGE_VIEW_TYPE_2D_ARRAY or IMAGE_VIEW_TYPE_CUBE_ARRAY, in any shader stage
• If the Pipeline object bound to the pipeline bind point used by this command accesses a Sampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-V OpImageSample* or OpImageSparseSample* instructions with ImplicitLod, Dref or Proj in their name, in any shader stage
• If the Pipeline object bound to the pipeline bind point used by this command accesses a Sampler object that uses unnormalized coordinates, that sampler must not be used with any of the SPIR-V OpImageSample* or OpImageSparseSample* instructions that includes a LOD bias or any offset values, in any shader stage
• If any stage of the Pipeline object bound to the pipeline bind point used by this command accesses a uniform buffer, and that stage was created without enabling either PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT or PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT for uniformBuffers, and the robustBufferAccess feature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point
• If any stage of the Pipeline object bound to the pipeline bind point used by this command accesses a storage buffer, and that stage was created without enabling either PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_EXT or PIPELINE_ROBUSTNESS_BUFFER_BEHAVIOR_ROBUST_BUFFER_ACCESS_2_EXT for storageBuffers, and the robustBufferAccess feature is not enabled, that stage must not access values outside of the range of the buffer as specified in the descriptor set bound to the same pipeline bind point
• If commandBuffer is an unprotected command buffer and protectedNoFault is not supported, any resource accessed by the Pipeline object bound to the pipeline bind point used by this command must not be a protected resource
• If the Pipeline object bound to the pipeline bind point used by this command accesses a Sampler or ImageView object that enables sampler Y′CBCR conversion, that object must only be used with OpImageSample* or OpImageSparseSample* instructions
• If the Pipeline object bound to the pipeline bind point used by this command accesses a Sampler or ImageView object that enables sampler Y′CBCR conversion, that object must not use the ConstOffset and Offset operands
• If a ImageView is accessed using OpImageWrite as a result of this command, then the Type of the Texel operand of that instruction must have at least as many components as the image view’s format
• If a BufferView is accessed using OpImageWrite as a result of this command, then the Type of the Texel operand of that instruction must have at least as many components as the buffer view’s format
• If a ImageView with a Format that has a 64-bit component width is accessed as a result of this command, the SampledType of the OpTypeImage operand of that instruction must have a Width of 64
• If a ImageView with a Format that has a component width less than 64-bit is accessed as a result of this command, the SampledType of the OpTypeImage operand of that instruction must have a Width of 32
• If a BufferView with a Format that has a 64-bit component width is accessed as a result of this command, the SampledType of the OpTypeImage operand of that instruction must have a Width of 64
• If a BufferView with a Format that has a component width less than 64-bit is accessed as a result of this command, the SampledType of the OpTypeImage operand of that instruction must have a Width of 32
• If the sparseImageInt64Atomics feature is not enabled, Image objects created with the IMAGE_CREATE_SPARSE_RESIDENCY_BIT flag must not be accessed by atomic instructions through an OpTypeImage with a SampledType with a Width of 64 by this command
• If the sparseImageInt64Atomics feature is not enabled, Buffer objects created with the BUFFER_CREATE_SPARSE_RESIDENCY_BIT flag must not be accessed by atomic instructions through an OpTypeImage with a SampledType with a Width of 64 by this command
• If OpImageWeightedSampleQCOM is used to sample a ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_2_WEIGHT_SAMPLED_IMAGE_BIT_QCOM
• If OpImageWeightedSampleQCOM uses a ImageView as a sample weight image as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_2_WEIGHT_IMAGE_BIT_QCOM
• If OpImageBoxFilterQCOM is used to sample a ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_2_BOX_FILTER_SAMPLED_BIT_QCOM
• If OpImageBlockMatchSSDQCOM is used to read from an ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
• If OpImageBlockMatchSADQCOM is used to read from an ImageView as a result of this command, then the image view’s format features must contain FORMAT_FEATURE_2_BLOCK_MATCHING_BIT_QCOM
• If OpImageBlockMatchSADQCOM or OpImageBlockMatchSSDQCOM is used to read from a reference image as result of this command, then the specified reference coordinates must not fail integer texel coordinate validation.
• If OpImageWeightedSampleQCOM, OpImageBoxFilterQCOM, OpImageBlockMatchSSDQCOM, or OpImageBlockMatchSADQCOM uses a Sampler as a result of this command, then the sampler must have been created with SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM.
• If any command other than OpImageWeightedSampleQCOM, OpImageBoxFilterQCOM, OpImageBlockMatchSSDQCOM, or OpImageBlockMatchSADQCOM uses a Sampler as a result of this command, then the sampler must not have been created with SAMPLER_CREATE_IMAGE_PROCESSING_BIT_QCOM.
• Any shader invocation executed by this command must terminate
• The current render pass must be compatible with the renderPass member of the GraphicsPipelineCreateInfo structure specified when creating the Pipeline bound to PIPELINE_BIND_POINT_GRAPHICS
• The subpass index of the current render pass must be equal to the subpass member of the GraphicsPipelineCreateInfo structure specified when creating the Pipeline bound to PIPELINE_BIND_POINT_GRAPHICS
• Every input attachment used by the current subpass must be bound to the pipeline via a descriptor set
• If any shader executed by this pipeline accesses an OpTypeImage variable with a Dim operand of SubpassData, it must be decorated with an InputAttachmentIndex that corresponds to a valid input attachment in the current subpass
• Input attachment views accessed in a subpass must be created with the same Format as the corresponding subpass definition be created with a ImageView that is an attachment in the currently bound Framebuffer at an index that corresponds to a valid input attachment in the current subpass
• Memory backing image subresources used as attachments in the current render pass must not be written in any way other than as an attachment by this command
• If any recorded command in the current subpass will write to an image subresource as an attachment, this command must not read from the memory backing that image subresource in any other way than as an attachment
• If any recorded command in the current subpass will read from an image subresource used as an attachment in any way other than as an attachment, this command must not write to that image subresource as an attachment
• If the current render pass instance uses a depth/stencil attachment with a read-only layout for the depth aspect, depth writes must be disabled
• If the current render pass instance uses a depth/stencil attachment with a read-only layout for the stencil aspect and stencil test is enabled, all stencil ops must be STENCIL_OP_KEEP
• If the draw is recorded in a render pass instance with multiview enabled, the maximum instance index must be less than or equal to PhysicalDeviceMultiviewProperties::maxMultiviewInstanceIndex
• If the bound graphics pipeline was created with PipelineSampleLocationsStateCreateInfoEXT::sampleLocationsEnable set to TRUE and the current subpass has a depth/stencil attachment, then that attachment must have been created with the IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT bit set
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT dynamic state enabled then cmdSetSampleLocationsEXT must have been called in the current command buffer prior to this drawing command
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_VIEWPORT_WITH_COUNT dynamic state enabled, but not the DYNAMIC_STATE_SCISSOR_WITH_COUNT dynamic state enabled, then cmdSetViewportWithCount must have been called in the current command buffer prior to this drawing command, and the viewportCount parameter of cmdSetViewportWithCount must match the PipelineViewportStateCreateInfo::scissorCount of the pipeline
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_SCISSOR_WITH_COUNT dynamic state enabled, but not the DYNAMIC_STATE_VIEWPORT_WITH_COUNT dynamic state enabled, then cmdSetScissorWithCount must have been called in the current command buffer prior to this drawing command, and the scissorCount parameter of cmdSetScissorWithCount must match the PipelineViewportStateCreateInfo::viewportCount of the pipeline
• If the bound graphics pipeline state was created with both the DYNAMIC_STATE_SCISSOR_WITH_COUNT and DYNAMIC_STATE_VIEWPORT_WITH_COUNT dynamic states enabled then both cmdSetViewportWithCount and cmdSetScissorWithCount must have been called in the current command buffer prior to this drawing command, and the viewportCount parameter of cmdSetViewportWithCount must match the scissorCount parameter of cmdSetScissorWithCount
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_VIEWPORT_WITH_COUNT dynamic state enabled, but not the DYNAMIC_STATE_VIEWPORT_W_SCALING_NV dynamic state enabled, then the bound graphics pipeline must have been created with PipelineViewportWScalingStateCreateInfoNV::viewportCount greater or equal to the viewportCount parameter in the last call to cmdSetViewportWithCount
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_VIEWPORT_WITH_COUNT and DYNAMIC_STATE_VIEWPORT_W_SCALING_NV dynamic states enabled then the viewportCount parameter in the last call to cmdSetViewportWScalingNV must be greater than or equal to the viewportCount parameter in the last call to cmdSetViewportWithCount
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_VIEWPORT_WITH_COUNT dynamic state enabled, but not the DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV dynamic state enabled, then the bound graphics pipeline must have been created with PipelineViewportShadingRateImageStateCreateInfoNV::viewportCount greater or equal to the viewportCount parameter in the last call to cmdSetViewportWithCount
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_VIEWPORT_WITH_COUNT and DYNAMIC_STATE_VIEWPORT_SHADING_RATE_PALETTE_NV dynamic states enabled then the viewportCount parameter in the last call to cmdSetViewportShadingRatePaletteNV must be greater than or equal to the viewportCount parameter in the last call to cmdSetViewportWithCount
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_VIEWPORT_WITH_COUNT dynamic state enabled and a PipelineViewportSwizzleStateCreateInfoNV structure chained from PipelineViewportStateCreateInfo, then the bound graphics pipeline must have been created with PipelineViewportSwizzleStateCreateInfoNV::viewportCount greater or equal to the viewportCount parameter in the last call to cmdSetViewportWithCount
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_VIEWPORT_WITH_COUNT dynamic state enabled and a PipelineViewportExclusiveScissorStateCreateInfoNV structure chained from PipelineViewportStateCreateInfo, then the bound graphics pipeline must have been created with PipelineViewportExclusiveScissorStateCreateInfoNV::exclusiveScissorCount greater or equal to the viewportCount parameter in the last call to cmdSetViewportWithCount
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_RASTERIZER_DISCARD_ENABLE dynamic state enabled then cmdSetRasterizerDiscardEnable must have been called in the current command buffer prior to this drawing command
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_DEPTH_BIAS_ENABLE dynamic state enabled then cmdSetDepthBiasEnable must have been called in the current command buffer prior to this drawing command
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_LOGIC_OP_EXT dynamic state enabled then cmdSetLogicOpEXT must have been called in the current command buffer prior to this drawing command and the logicOp must be a valid LogicOp value
• If the primitiveFragmentShadingRateWithMultipleViewports limit is not supported, the bound graphics pipeline was created with the DYNAMIC_STATE_VIEWPORT_WITH_COUNT dynamic state enabled, and any of the shader stages of the bound graphics pipeline write to the PrimitiveShadingRateKHR built-in, then cmdSetViewportWithCount must have been called in the current command buffer prior to this drawing command, and the viewportCount parameter of cmdSetViewportWithCount must be 1
• If rasterization is not disabled in the bound graphics pipeline, then for each color attachment in the subpass, if the corresponding image view’s format features do not contain FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT, then the blendEnable member of the corresponding element of the pAttachments member of pColorBlendState must be FALSE
• If rasterization is not disabled in the bound graphics pipeline, and none of the VK_AMD_mixed_attachment_samples extension, the VK_NV_framebuffer_mixed_samples extension, or the multisampledRenderToSingleSampled feature are enabled, then PipelineMultisampleStateCreateInfo::rasterizationSamples must be the same as the current subpass color and/or depth/stencil attachments
• If the current render pass instance was begun with cmdBeginRendering, the imageView member of pDepthAttachment is not NULL_HANDLE, and the layout member of pDepthAttachment is IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL, this command must not write any values to the depth attachment
• If the current render pass instance was begun with cmdBeginRendering, the imageView member of pStencilAttachment is not NULL_HANDLE, and the layout member of pStencilAttachment is IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL, this command must not write any values to the stencil attachment
• If the current render pass instance was begun with cmdBeginRendering, the imageView member of pDepthAttachment is not NULL_HANDLE, and the layout member of pDepthAttachment is IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL, this command must not write any values to the depth attachment
• If the current render pass instance was begun with cmdBeginRendering, the imageView member of pStencilAttachment is not NULL_HANDLE, and the layout member of pStencilAttachment is IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL, this command must not write any values to the stencil attachment
• If the current render pass instance was begun with cmdBeginRendering, the imageView member of pDepthAttachment is not NULL_HANDLE, and the layout member of pDepthAttachment is IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL, this command must not write any values to the depth attachment
• If the current render pass instance was begun with cmdBeginRendering, the imageView member of pStencilAttachment is not NULL_HANDLE, and the layout member of pStencilAttachment is IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL, this command must not write any values to the stencil attachment
• If the current render pass instance was begun with cmdBeginRendering, the currently bound graphics pipeline must have been created with a PipelineRenderingCreateInfo::viewMask equal to RenderingInfo::viewMask
• If the current render pass instance was begun with cmdBeginRendering, the currently bound graphics pipeline must have been created with a PipelineRenderingCreateInfo::colorAttachmentCount equal to RenderingInfo::colorAttachmentCount
• If the current render pass instance was begun with cmdBeginRendering and RenderingInfo::colorAttachmentCount greater than 0, then each element of the RenderingInfo::pColorAttachments array with a imageView not equal to NULL_HANDLE must have been created with a Format equal to the corresponding element of PipelineRenderingCreateInfo::pColorAttachmentFormats used to create the currently bound graphics pipeline
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT dynamic state enabled then cmdSetColorWriteEnableEXT must have been called in the current command buffer prior to this drawing command, and the attachmentCount parameter of cmdSetColorWriteEnableEXT must be greater than or equal to the PipelineColorBlendStateCreateInfo::attachmentCount of the currently bound graphics pipeline
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_COLOR_WRITE_ENABLE_EXT dynamic state enabled then cmdSetColorWriteEnableEXT must have been called in the current command buffer prior to this drawing command, and the attachmentCount parameter of cmdSetColorWriteEnableEXT must be less than or equal to the maxColorAttachments member of PhysicalDeviceLimits
• If the current render pass instance was begun with cmdBeginRendering and RenderingInfo::pDepthAttachment->imageView was not NULL_HANDLE, the value of PipelineRenderingCreateInfo::depthAttachmentFormat used to create the currently bound graphics pipeline must be equal to the Format used to create RenderingInfo::pDepthAttachment->imageView
• If the current render pass instance was begun with cmdBeginRendering and RenderingInfo::pStencilAttachment->imageView was not NULL_HANDLE, the value of PipelineRenderingCreateInfo::stencilAttachmentFormat used to create the currently bound graphics pipeline must be equal to the Format used to create RenderingInfo::pStencilAttachment->imageView
• If the current render pass instance was begun with cmdBeginRendering and RenderingFragmentShadingRateAttachmentInfoKHR::imageView was not NULL_HANDLE, the currently bound graphics pipeline must have been created with PIPELINE_CREATE_RENDERING_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR
• If the current render pass instance was begun with cmdBeginRendering and RenderingFragmentDensityMapAttachmentInfoEXT::imageView was not NULL_HANDLE, the currently bound graphics pipeline must have been created with PIPELINE_CREATE_RENDERING_FRAGMENT_DENSITY_MAP_ATTACHMENT_BIT_EXT
• If the currently bound pipeline was created with a AttachmentSampleCountInfoAMD or AttachmentSampleCountInfoNV structure, and the current render pass instance was begun with cmdBeginRendering with a RenderingInfo::colorAttachmentCount parameter greater than 0, then each element of the RenderingInfo::pColorAttachments array with a imageView not equal to NULL_HANDLE must have been created with a sample count equal to the corresponding element of the pColorAttachmentSamples member of AttachmentSampleCountInfoAMD or AttachmentSampleCountInfoNV used to create the currently bound graphics pipeline
• If the current render pass instance was begun with cmdBeginRendering, the currently bound pipeline was created with a AttachmentSampleCountInfoAMD or AttachmentSampleCountInfoNV structure, and RenderingInfo::pDepthAttachment->imageView was not NULL_HANDLE, the value of the depthStencilAttachmentSamples member of AttachmentSampleCountInfoAMD or AttachmentSampleCountInfoNV used to create the currently bound graphics pipeline must be equal to the sample count used to create RenderingInfo::pDepthAttachment->imageView
• If the current render pass instance was begun with cmdBeginRendering, the currently bound pipeline was created with a AttachmentSampleCountInfoAMD or AttachmentSampleCountInfoNV structure, and RenderingInfo::pStencilAttachment->imageView was not NULL_HANDLE, the value of the depthStencilAttachmentSamples member of AttachmentSampleCountInfoAMD or AttachmentSampleCountInfoNV used to create the currently bound graphics pipeline must be equal to the sample count used to create RenderingInfo::pStencilAttachment->imageView
• If the currently bound pipeline was created without a AttachmentSampleCountInfoAMD or AttachmentSampleCountInfoNV structure, and the multisampledRenderToSingleSampled feature is not enabled, and the current render pass instance was begun with cmdBeginRendering with a RenderingInfo::colorAttachmentCount parameter greater than 0, then each element of the RenderingInfo::pColorAttachments array with a imageView not equal to NULL_HANDLE must have been created with a sample count equal to the value of PipelineMultisampleStateCreateInfo::rasterizationSamples used to create the currently bound graphics pipeline
• If the current render pass instance was begun with cmdBeginRendering, the currently bound pipeline was created without a AttachmentSampleCountInfoAMD or AttachmentSampleCountInfoNV structure, and the multisampledRenderToSingleSampled feature is not enabled, and RenderingInfo::pDepthAttachment->imageView was not NULL_HANDLE, the value of PipelineMultisampleStateCreateInfo::rasterizationSamples used to create the currently bound graphics pipeline must be equal to the sample count used to create RenderingInfo::pDepthAttachment->imageView
• If the current render pass instance was begun with cmdBeginRendering, the currently bound pipeline was created without a AttachmentSampleCountInfoAMD or AttachmentSampleCountInfoNV structure, and the multisampledRenderToSingleSampled feature is not enabled, and RenderingInfo::pStencilAttachment->imageView was not NULL_HANDLE, the value of PipelineMultisampleStateCreateInfo::rasterizationSamples used to create the currently bound graphics pipeline must be equal to the sample count used to create RenderingInfo::pStencilAttachment->imageView
• If the current render pass instance was begun with cmdBeginRendering, the currently bound pipeline must have been created with a GraphicsPipelineCreateInfo::renderPass equal to NULL_HANDLE
• If the primitivesGeneratedQueryWithRasterizerDiscard feature is not enabled and the QUERY_TYPE_PRIMITIVES_GENERATED_EXT query is active, rasterization discard must not be enabled.
• If the primitivesGeneratedQueryWithNonZeroStreams feature is not enabled and the QUERY_TYPE_PRIMITIVES_GENERATED_EXT query is active, the bound graphics pipeline must not have been created with a non-zero value in PipelineRasterizationStateStreamCreateInfoEXT::rasterizationStream.
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT state enabled and the last call to cmdSetColorBlendEnableEXT set pColorBlendEnables for any attachment to TRUE, then for those attachments in the subpass the corresponding image view’s format features must contain FORMAT_FEATURE_COLOR_ATTACHMENT_BLEND_BIT
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT state enabled, and the current subpass does not use any color and/or depth/stencil attachments, then the rasterizationSamples in the last call to cmdSetRasterizationSamplesEXT must follow the rules for a zero-attachment subpass
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_SAMPLE_MASK_EXT state enabled and the DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT state disabled, then the samples parameter in the last call to cmdSetSampleMaskEXT must be greater or equal to the PipelineMultisampleStateCreateInfo::rasterizationSamples parameter used to create the bound graphics pipeline
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_SAMPLE_MASK_EXT state and DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT states enabled, then the samples parameter in the last call to cmdSetSampleMaskEXT must be greater or equal to the rasterizationSamples parameter in the last call to cmdSetRasterizationSamplesEXT
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT state enabled, and none of the VK_AMD_mixed_attachment_samples extension, VK_NV_framebuffer_mixed_samples extension, or the multisampledRenderToSingleSampled feature is enabled, then the rasterizationSamples in the last call to cmdSetRasterizationSamplesEXT must be the same as the current subpass color and/or depth/stencil attachments
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT dynamic state enabled then cmdSetColorBlendEnableEXT must have been called in the current command buffer prior to this drawing command, and the attachments specified by the firstAttachment and attachmentCount parameters of cmdSetColorBlendEnableEXT calls must specify an enable for all active color attachments in the current subpass
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_COLOR_BLEND_EQUATION_EXT dynamic state enabled then cmdSetColorBlendEquationEXT must have been called in the current command buffer prior to this drawing command, and the attachments specified by the firstAttachment and attachmentCount parameters of cmdSetColorBlendEquationEXT calls must specify the blend equations for all active color attachments in the current subpass where blending is enabled
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_COLOR_WRITE_MASK_EXT dynamic state enabled then cmdSetColorWriteMaskEXT must have been called in the current command buffer prior to this drawing command, and the attachments specified by the firstAttachment and attachmentCount parameters of cmdSetColorWriteMaskEXT calls must specify the color write mask for all active color attachments in the current subpass
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT dynamic state enabled then cmdSetColorBlendAdvancedEXT must have been called in the current command buffer prior to this drawing command, and the attachments specified by the firstAttachment and attachmentCount parameters of cmdSetColorBlendAdvancedEXT calls must specify the advanced blend equations for all active color attachments in the current subpass where blending is enabled
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_COLOR_BLEND_ADVANCED_EXT and DYNAMIC_STATE_COLOR_BLEND_ENABLE_EXT dynamic states enabled and the last calls to cmdSetColorBlendEnableEXT and cmdSetColorBlendAdvancedEXT have enabled advanced blending, then the number of active color attachments in the current subpass must not exceed advancedBlendMaxColorAttachments
• If the primitivesGeneratedQueryWithNonZeroStreams feature is not enabled and the QUERY_TYPE_PRIMITIVES_GENERATED_EXT query is active, and the bound graphics pipeline was created with DYNAMIC_STATE_RASTERIZATION_STREAM_EXT state enabled, the last call to cmdSetRasterizationStreamEXT must have set the rasterizationStream to zero
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT state enabled and the DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT state disabled, then the sampleLocationsPerPixel member of pSampleLocationsInfo in the last call to cmdSetSampleLocationsEXT must equal the rasterizationSamples member of the PipelineMultisampleStateCreateInfo structure the bound graphics pipeline has been created with
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT state enabled and the DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT state enabled, then the sampleLocationsPerPixel member of pSampleLocationsInfo in the last call to cmdSetSampleLocationsEXT must equal the rasterizationSamples parameter of the last call to cmdSetRasterizationSamplesEXT
• If the bound graphics pipeline was created with the DYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT state enabled, and sampleLocationsEnable was TRUE in the last call to cmdSetSampleLocationsEnableEXT, and the current subpass has a depth/stencil attachment, then that attachment must have been created with the IMAGE_CREATE_SAMPLE_LOCATIONS_COMPATIBLE_DEPTH_BIT_EXT bit set
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT state enabled and the DYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT state enabled, and if sampleLocationsEnable was TRUE in the last call to cmdSetSampleLocationsEnableEXT, then the sampleLocationsInfo.sampleLocationGridSize.width in the last call to cmdSetSampleLocationsEXT must evenly divide MultisamplePropertiesEXT::sampleLocationGridSize.width as returned by getPhysicalDeviceMultisamplePropertiesEXT with a samples parameter equaling rasterizationSamples
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_SAMPLE_LOCATIONS_EXT state enabled and the DYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT state enabled, and if sampleLocationsEnable was TRUE in the last call to cmdSetSampleLocationsEnableEXT, then the sampleLocationsInfo.sampleLocationGridSize.height in the last call to cmdSetSampleLocationsEXT must evenly divide MultisamplePropertiesEXT::sampleLocationGridSize.height as returned by getPhysicalDeviceMultisamplePropertiesEXT with a samples parameter equaling rasterizationSamples
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_SAMPLE_LOCATIONS_ENABLE_EXT state enabled, and if sampleLocationsEnable was TRUE in the last call to cmdSetSampleLocationsEnableEXT, the fragment shader code must not statically use the extended instruction InterpolateAtSample
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_COVERAGE_MODULATION_TABLE_ENABLE_NV state enabled and the last call to cmdSetCoverageModulationTableEnableNV set coverageModulationTableEnable to TRUE, then the coverageModulationTableCount parameter in the last call to cmdSetCoverageModulationTableNV must equal the current rasterizationSamples divided by the number of color samples in the current subpass
• If the VK_NV_framebuffer_mixed_samples extension is enabled, and if current subpass has a depth/stencil attachment and depth test, stencil test, or depth bounds test are enabled in the currently bound pipeline state, then the current rasterizationSamples must be the same as the sample count of the depth/stencil attachment
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV state enabled and the last call to cmdSetCoverageToColorEnableNV set the coverageToColorEnable to TRUE, then the current subpass must have a color attachment at the location selected by the last call to cmdSetCoverageToColorLocationNV coverageToColorLocation, with a Format of FORMAT_R8_UINT, FORMAT_R8_SINT, FORMAT_R16_UINT, FORMAT_R16_SINT, FORMAT_R32_UINT, or FORMAT_R32_SINT
• If this VK_NV_coverage_reduction_mode extension is enabled, the bound graphics pipeline state was created with the DYNAMIC_STATE_COVERAGE_TO_COLOR_ENABLE_NV and DYNAMIC_STATE_RASTERIZATION_SAMPLES_EXT states enabled, the current coverage reduction mode coverageReductionMode, then the current rasterizationSamples, and the sample counts for the color and depth/stencil attachments (if the subpass has them) must be a valid combination returned by getPhysicalDeviceSupportedFramebufferMixedSamplesCombinationsNV
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_VIEWPORT_WITH_COUNT dynamic state enabled, but not the DYNAMIC_STATE_VIEWPORT_SWIZZLE_NV dynamic state enabled, then the bound graphics pipeline must have been created with PipelineViewportSwizzleStateCreateInfoNV::viewportCount greater or equal to the viewportCount parameter in the last call to cmdSetViewportWithCount
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_VIEWPORT_WITH_COUNT and DYNAMIC_STATE_VIEWPORT_SWIZZLE_NV dynamic states enabled then the viewportCount parameter in the last call to cmdSetViewportSwizzleNV must be greater than or equal to the viewportCount parameter in the last call to cmdSetViewportWithCount
• If the VK_NV_framebuffer_mixed_samples extension is enabled, and if the current subpass has any color attachments and rasterizationSamples of the last call to cmdSetRasterizationSamplesEXT is greater than the number of color samples, then the pipeline sampleShadingEnable must be FALSE
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT or DYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT dynamic states enabled, and if the current stippledLineEnable state is TRUE and the current lineRasterizationMode state is LINE_RASTERIZATION_MODE_RECTANGULAR_EXT, then the stippledRectangularLines feature must be enabled
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT or DYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT dynamic states enabled, and if the current stippledLineEnable state is TRUE and the current lineRasterizationMode state is LINE_RASTERIZATION_MODE_BRESENHAM_EXT, then the stippledBresenhamLines feature must be enabled
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT or DYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT dynamic states enabled, and if the current stippledLineEnable state is TRUE and the current lineRasterizationMode state is LINE_RASTERIZATION_MODE_RECTANGULAR_SMOOTH_EXT, then the stippledSmoothLines feature must be enabled
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_LINE_STIPPLE_ENABLE_EXT or DYNAMIC_STATE_LINE_RASTERIZATION_MODE_EXT dynamic states enabled, and if the current stippledLineEnable state is TRUE and the current lineRasterizationMode state is LINE_RASTERIZATION_MODE_DEFAULT_EXT, then the stippledRectangularLines feature must be enabled and PhysicalDeviceLimits::strictLines must be VK_TRUE
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_CONSERVATIVE_RASTERIZATION_MODE_EXT dynamic state enabled, conservativePointAndLineRasterization is not supported, and the effective primitive topology output by the last pre-rasterization shader stage is a line or point, then the conservativeRasterizationMode set by the last call to cmdSetConservativeRasterizationModeEXT must be CONSERVATIVE_RASTERIZATION_MODE_DISABLED_EXT
• If the currently bound pipeline was created with the PipelineShaderStageCreateInfo::stage member of an element of GraphicsPipelineCreateInfo::pStages set to SHADER_STAGE_VERTEX_BIT, SHADER_STAGE_TESSELLATION_CONTROL_BIT, SHADER_STAGE_TESSELLATION_EVALUATION_BIT or SHADER_STAGE_GEOMETRY_BIT, then Mesh Shader Queries must not be active
• All vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface must have either valid or NULL_HANDLE buffers bound
• If the nullDescriptor feature is not enabled, all vertex input bindings accessed via vertex input variables declared in the vertex shader entry point’s interface must not be NULL_HANDLE
• For a given vertex buffer binding, any attribute data fetched must be entirely contained within the corresponding vertex buffer binding, as described in ???
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_PRIMITIVE_TOPOLOGY_EXT dynamic state enabled and the dynamicPrimitiveTopologyUnrestricted is FALSE, then the primitiveTopology parameter in the last call to cmdSetPrimitiveTopologyEXT must be of the same topology class as the pipeline PipelineInputAssemblyStateCreateInfo::topology state
• If the bound graphics pipeline was created with both the DYNAMIC_STATE_VERTEX_INPUT_EXT and DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT dynamic states enabled, then cmdSetVertexInputEXT must have been called in the current command buffer prior to this draw command
• If the bound graphics pipeline was created with the DYNAMIC_STATE_VERTEX_INPUT_BINDING_STRIDE_EXT dynamic state enabled, but not the DYNAMIC_STATE_VERTEX_INPUT_EXT dynamic state enabled, then cmdBindVertexBuffers2EXT must have been called in the current command buffer prior to this draw command, and the pStrides parameter of cmdBindVertexBuffers2EXT must not be NULL
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_VERTEX_INPUT_EXT dynamic state enabled, then cmdSetVertexInputEXT must have been called in the current command buffer prior to this draw command
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_PATCH_CONTROL_POINTS_EXT dynamic state enabled then cmdSetPatchControlPointsEXT must have been called in the current command buffer prior to this drawing command
• If the bound graphics pipeline state was created with the DYNAMIC_STATE_PRIMITIVE_RESTART_ENABLE_EXT dynamic state enabled then cmdSetPrimitiveRestartEnableEXT must have been called in the current command buffer prior to this drawing command
• The bound graphics pipeline must not have been created with the PipelineShaderStageCreateInfo::stage member of an element of GraphicsPipelineCreateInfo::pStages set to SHADER_STAGE_TASK_BIT_EXT or SHADER_STAGE_MESH_BIT_EXT
• PhysicalDeviceTransformFeedbackFeaturesEXT::transformFeedback must be enabled
• The implementation must support PhysicalDeviceTransformFeedbackPropertiesEXT::transformFeedbackDraw
• vertexStride must be greater than 0 and less than or equal to PhysicalDeviceLimits::maxTransformFeedbackBufferDataStride
• If counterBuffer is non-sparse then it must be bound completely and contiguously to a single DeviceMemory object
• counterBuffer must have been created with the BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set
• counterBufferOffset must be a multiple of 4
• commandBuffer must not be a protected command buffer

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• counterBuffer must be a valid Buffer handle
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support graphics operations
• This command must only be called inside of a render pass instance
• This command must only be called outside of a video coding scope
• Both of commandBuffer, and counterBuffer must have been created, allocated, or retrieved from the same Device

Host Synchronization

• Host access to commandBuffer must be externally synchronized

• Host access to the CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Command Buffer Levels	Render Pass Scope	Video Coding Scope	Supported Queue Types	Command Type
Primary Secondary	Inside	Outside	Graphics	Action

See Also

VK_EXT_transform_feedback, Buffer, CommandBuffer, DeviceSize

data PhysicalDeviceTransformFeedbackFeaturesEXT

VkPhysicalDeviceTransformFeedbackFeaturesEXT - Structure describing transform feedback features that can be supported by an implementation

Members

This structure describes the following features:

Description

If the PhysicalDeviceTransformFeedbackFeaturesEXT structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. PhysicalDeviceTransformFeedbackFeaturesEXT can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

See Also

VK_EXT_transform_feedback, Bool32, StructureType

Constructors

PhysicalDeviceTransformFeedbackFeaturesEXT

Fields

• transformFeedback :: Bool

  transformFeedback indicates whether the implementation supports transform feedback and shader modules can declare the TransformFeedback capability.

• geometryStreams :: Bool

  geometryStreams indicates whether the implementation supports the GeometryStreams SPIR-V capability.

Instances

Storable PhysicalDeviceTransformFeedbackFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

sizeOf :: PhysicalDeviceTransformFeedbackFeaturesEXT -> Int

alignment :: PhysicalDeviceTransformFeedbackFeaturesEXT -> Int

peekElemOff :: Ptr PhysicalDeviceTransformFeedbackFeaturesEXT -> Int -> IO PhysicalDeviceTransformFeedbackFeaturesEXT

pokeElemOff :: Ptr PhysicalDeviceTransformFeedbackFeaturesEXT -> Int -> PhysicalDeviceTransformFeedbackFeaturesEXT -> IO ()

peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceTransformFeedbackFeaturesEXT

pokeByteOff :: Ptr b -> Int -> PhysicalDeviceTransformFeedbackFeaturesEXT -> IO ()

peek :: Ptr PhysicalDeviceTransformFeedbackFeaturesEXT -> IO PhysicalDeviceTransformFeedbackFeaturesEXT

poke :: Ptr PhysicalDeviceTransformFeedbackFeaturesEXT -> PhysicalDeviceTransformFeedbackFeaturesEXT -> IO ()

Show PhysicalDeviceTransformFeedbackFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

showsPrec :: Int -> PhysicalDeviceTransformFeedbackFeaturesEXT -> ShowS

show :: PhysicalDeviceTransformFeedbackFeaturesEXT -> String

showList :: [PhysicalDeviceTransformFeedbackFeaturesEXT] -> ShowS

Eq PhysicalDeviceTransformFeedbackFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

(==) :: PhysicalDeviceTransformFeedbackFeaturesEXT -> PhysicalDeviceTransformFeedbackFeaturesEXT -> Bool

(/=) :: PhysicalDeviceTransformFeedbackFeaturesEXT -> PhysicalDeviceTransformFeedbackFeaturesEXT -> Bool

FromCStruct PhysicalDeviceTransformFeedbackFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

peekCStruct :: Ptr PhysicalDeviceTransformFeedbackFeaturesEXT -> IO PhysicalDeviceTransformFeedbackFeaturesEXT

ToCStruct PhysicalDeviceTransformFeedbackFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

withCStruct :: PhysicalDeviceTransformFeedbackFeaturesEXT -> (Ptr PhysicalDeviceTransformFeedbackFeaturesEXT -> IO b) -> IO b

pokeCStruct :: Ptr PhysicalDeviceTransformFeedbackFeaturesEXT -> PhysicalDeviceTransformFeedbackFeaturesEXT -> IO b -> IO b

withZeroCStruct :: (Ptr PhysicalDeviceTransformFeedbackFeaturesEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr PhysicalDeviceTransformFeedbackFeaturesEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceTransformFeedbackFeaturesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

zero :: PhysicalDeviceTransformFeedbackFeaturesEXT

data PhysicalDeviceTransformFeedbackPropertiesEXT

VkPhysicalDeviceTransformFeedbackPropertiesEXT - Structure describing transform feedback properties that can be supported by an implementation

Description

If the PhysicalDeviceTransformFeedbackPropertiesEXT structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Valid Usage (Implicit)

See Also

VK_EXT_transform_feedback, Bool32, DeviceSize, StructureType

Constructors

PhysicalDeviceTransformFeedbackPropertiesEXT

Fields

• maxTransformFeedbackStreams :: Word32

  maxTransformFeedbackStreams is the maximum number of vertex streams that can be output from geometry shaders declared with the GeometryStreams capability. If the implementation does not support PhysicalDeviceTransformFeedbackFeaturesEXT::geometryStreams then maxTransformFeedbackStreams must be set to 1.

• maxTransformFeedbackBuffers :: Word32

  maxTransformFeedbackBuffers is the maximum number of transform feedback buffers that can be bound for capturing shader outputs from the last pre-rasterization shader stage.

• maxTransformFeedbackBufferSize :: DeviceSize

  maxTransformFeedbackBufferSize is the maximum size that can be specified when binding a buffer for transform feedback in cmdBindTransformFeedbackBuffersEXT.

• maxTransformFeedbackStreamDataSize :: Word32

  maxTransformFeedbackStreamDataSize is the maximum amount of data in bytes for each vertex that captured to one or more transform feedback buffers associated with a specific vertex stream.

• maxTransformFeedbackBufferDataSize :: Word32

  maxTransformFeedbackBufferDataSize is the maximum amount of data in bytes for each vertex that can be captured to a specific transform feedback buffer.

• maxTransformFeedbackBufferDataStride :: Word32

  maxTransformFeedbackBufferDataStride is the maximum stride between each capture of vertex data to the buffer.

• transformFeedbackQueries :: Bool

  transformFeedbackQueries is TRUE if the implementation supports the QUERY_TYPE_TRANSFORM_FEEDBACK_STREAM_EXT query type. transformFeedbackQueries is FALSE if queries of this type cannot be created.

• transformFeedbackStreamsLinesTriangles :: Bool

  transformFeedbackStreamsLinesTriangles is TRUE if the implementation supports the geometry shader OpExecutionMode of OutputLineStrip and OutputTriangleStrip in addition to OutputPoints when more than one vertex stream is output. If transformFeedbackStreamsLinesTriangles is FALSE the implementation only supports an OpExecutionMode of OutputPoints when more than one vertex stream is output from the geometry shader.

• transformFeedbackRasterizationStreamSelect :: Bool

  transformFeedbackRasterizationStreamSelect is TRUE if the implementation supports the GeometryStreams SPIR-V capability and the application can use PipelineRasterizationStateStreamCreateInfoEXT to modify which vertex stream output is used for rasterization. Otherwise vertex stream 0 must always be used for rasterization.

• transformFeedbackDraw :: Bool

  transformFeedbackDraw is TRUE if the implementation supports the cmdDrawIndirectByteCountEXT function otherwise the function must not be called.

Instances

Storable PhysicalDeviceTransformFeedbackPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

sizeOf :: PhysicalDeviceTransformFeedbackPropertiesEXT -> Int

alignment :: PhysicalDeviceTransformFeedbackPropertiesEXT -> Int

peekElemOff :: Ptr PhysicalDeviceTransformFeedbackPropertiesEXT -> Int -> IO PhysicalDeviceTransformFeedbackPropertiesEXT

pokeElemOff :: Ptr PhysicalDeviceTransformFeedbackPropertiesEXT -> Int -> PhysicalDeviceTransformFeedbackPropertiesEXT -> IO ()

peekByteOff :: Ptr b -> Int -> IO PhysicalDeviceTransformFeedbackPropertiesEXT

pokeByteOff :: Ptr b -> Int -> PhysicalDeviceTransformFeedbackPropertiesEXT -> IO ()

peek :: Ptr PhysicalDeviceTransformFeedbackPropertiesEXT -> IO PhysicalDeviceTransformFeedbackPropertiesEXT

poke :: Ptr PhysicalDeviceTransformFeedbackPropertiesEXT -> PhysicalDeviceTransformFeedbackPropertiesEXT -> IO ()

Show PhysicalDeviceTransformFeedbackPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

showsPrec :: Int -> PhysicalDeviceTransformFeedbackPropertiesEXT -> ShowS

show :: PhysicalDeviceTransformFeedbackPropertiesEXT -> String

showList :: [PhysicalDeviceTransformFeedbackPropertiesEXT] -> ShowS

Eq PhysicalDeviceTransformFeedbackPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

(==) :: PhysicalDeviceTransformFeedbackPropertiesEXT -> PhysicalDeviceTransformFeedbackPropertiesEXT -> Bool

(/=) :: PhysicalDeviceTransformFeedbackPropertiesEXT -> PhysicalDeviceTransformFeedbackPropertiesEXT -> Bool

FromCStruct PhysicalDeviceTransformFeedbackPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

peekCStruct :: Ptr PhysicalDeviceTransformFeedbackPropertiesEXT -> IO PhysicalDeviceTransformFeedbackPropertiesEXT

ToCStruct PhysicalDeviceTransformFeedbackPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

withCStruct :: PhysicalDeviceTransformFeedbackPropertiesEXT -> (Ptr PhysicalDeviceTransformFeedbackPropertiesEXT -> IO b) -> IO b

pokeCStruct :: Ptr PhysicalDeviceTransformFeedbackPropertiesEXT -> PhysicalDeviceTransformFeedbackPropertiesEXT -> IO b -> IO b

withZeroCStruct :: (Ptr PhysicalDeviceTransformFeedbackPropertiesEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr PhysicalDeviceTransformFeedbackPropertiesEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PhysicalDeviceTransformFeedbackPropertiesEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

zero :: PhysicalDeviceTransformFeedbackPropertiesEXT

data PipelineRasterizationStateStreamCreateInfoEXT

VkPipelineRasterizationStateStreamCreateInfoEXT - Structure defining the geometry stream used for rasterization

Description

If this structure is not present, rasterizationStream is assumed to be zero.

Valid Usage (Implicit)

See Also

VK_EXT_transform_feedback, PipelineRasterizationStateStreamCreateFlagsEXT, StructureType

Constructors

PipelineRasterizationStateStreamCreateInfoEXT

Fields

• flags :: PipelineRasterizationStateStreamCreateFlagsEXT

  flags is reserved for future use.

  flags must be 0

• rasterizationStream :: Word32

  rasterizationStream is the vertex stream selected for rasterization.

  rasterizationStream must be less than PhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackStreams

  rasterizationStream must be zero if PhysicalDeviceTransformFeedbackPropertiesEXT::transformFeedbackRasterizationStreamSelect is FALSE

Instances

Storable PipelineRasterizationStateStreamCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

sizeOf :: PipelineRasterizationStateStreamCreateInfoEXT -> Int

alignment :: PipelineRasterizationStateStreamCreateInfoEXT -> Int

peekElemOff :: Ptr PipelineRasterizationStateStreamCreateInfoEXT -> Int -> IO PipelineRasterizationStateStreamCreateInfoEXT

pokeElemOff :: Ptr PipelineRasterizationStateStreamCreateInfoEXT -> Int -> PipelineRasterizationStateStreamCreateInfoEXT -> IO ()

peekByteOff :: Ptr b -> Int -> IO PipelineRasterizationStateStreamCreateInfoEXT

pokeByteOff :: Ptr b -> Int -> PipelineRasterizationStateStreamCreateInfoEXT -> IO ()

peek :: Ptr PipelineRasterizationStateStreamCreateInfoEXT -> IO PipelineRasterizationStateStreamCreateInfoEXT

poke :: Ptr PipelineRasterizationStateStreamCreateInfoEXT -> PipelineRasterizationStateStreamCreateInfoEXT -> IO ()

Show PipelineRasterizationStateStreamCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

showsPrec :: Int -> PipelineRasterizationStateStreamCreateInfoEXT -> ShowS

show :: PipelineRasterizationStateStreamCreateInfoEXT -> String

showList :: [PipelineRasterizationStateStreamCreateInfoEXT] -> ShowS

Eq PipelineRasterizationStateStreamCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

(==) :: PipelineRasterizationStateStreamCreateInfoEXT -> PipelineRasterizationStateStreamCreateInfoEXT -> Bool

(/=) :: PipelineRasterizationStateStreamCreateInfoEXT -> PipelineRasterizationStateStreamCreateInfoEXT -> Bool

FromCStruct PipelineRasterizationStateStreamCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

peekCStruct :: Ptr PipelineRasterizationStateStreamCreateInfoEXT -> IO PipelineRasterizationStateStreamCreateInfoEXT

ToCStruct PipelineRasterizationStateStreamCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

withCStruct :: PipelineRasterizationStateStreamCreateInfoEXT -> (Ptr PipelineRasterizationStateStreamCreateInfoEXT -> IO b) -> IO b

pokeCStruct :: Ptr PipelineRasterizationStateStreamCreateInfoEXT -> PipelineRasterizationStateStreamCreateInfoEXT -> IO b -> IO b

withZeroCStruct :: (Ptr PipelineRasterizationStateStreamCreateInfoEXT -> IO b) -> IO b

pokeZeroCStruct :: Ptr PipelineRasterizationStateStreamCreateInfoEXT -> IO b -> IO b

cStructSize :: Int

cStructAlignment :: Int

Zero PipelineRasterizationStateStreamCreateInfoEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

zero :: PipelineRasterizationStateStreamCreateInfoEXT

newtype PipelineRasterizationStateStreamCreateFlagsEXT

VkPipelineRasterizationStateStreamCreateFlagsEXT - Reserved for future use

Description

PipelineRasterizationStateStreamCreateFlagsEXT is a bitmask type for setting a mask, but is currently reserved for future use.

See Also

VK_EXT_transform_feedback, PipelineRasterizationStateStreamCreateInfoEXT

Constructors

PipelineRasterizationStateStreamCreateFlagsEXT Flags

Instances

Bits PipelineRasterizationStateStreamCreateFlagsEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

(.&.) :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT

(.|.) :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT

xor :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT

complement :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT

shift :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

rotate :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

zeroBits :: PipelineRasterizationStateStreamCreateFlagsEXT

bit :: Int -> PipelineRasterizationStateStreamCreateFlagsEXT

setBit :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

clearBit :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

complementBit :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

testBit :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> Bool

bitSizeMaybe :: PipelineRasterizationStateStreamCreateFlagsEXT -> Maybe Int

bitSize :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int

isSigned :: PipelineRasterizationStateStreamCreateFlagsEXT -> Bool

shiftL :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

unsafeShiftL :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

shiftR :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

unsafeShiftR :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

rotateL :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

rotateR :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT

popCount :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int

FiniteBits PipelineRasterizationStateStreamCreateFlagsEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

finiteBitSize :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int

countLeadingZeros :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int

countTrailingZeros :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int

Storable PipelineRasterizationStateStreamCreateFlagsEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

sizeOf :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int

alignment :: PipelineRasterizationStateStreamCreateFlagsEXT -> Int

peekElemOff :: Ptr PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> IO PipelineRasterizationStateStreamCreateFlagsEXT

pokeElemOff :: Ptr PipelineRasterizationStateStreamCreateFlagsEXT -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT -> IO ()

peekByteOff :: Ptr b -> Int -> IO PipelineRasterizationStateStreamCreateFlagsEXT

pokeByteOff :: Ptr b -> Int -> PipelineRasterizationStateStreamCreateFlagsEXT -> IO ()

peek :: Ptr PipelineRasterizationStateStreamCreateFlagsEXT -> IO PipelineRasterizationStateStreamCreateFlagsEXT

poke :: Ptr PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> IO ()

Read PipelineRasterizationStateStreamCreateFlagsEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

readsPrec :: Int -> ReadS PipelineRasterizationStateStreamCreateFlagsEXT

readList :: ReadS [PipelineRasterizationStateStreamCreateFlagsEXT]

readPrec :: ReadPrec PipelineRasterizationStateStreamCreateFlagsEXT

readListPrec :: ReadPrec [PipelineRasterizationStateStreamCreateFlagsEXT]

Show PipelineRasterizationStateStreamCreateFlagsEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

showsPrec :: Int -> PipelineRasterizationStateStreamCreateFlagsEXT -> ShowS

show :: PipelineRasterizationStateStreamCreateFlagsEXT -> String

showList :: [PipelineRasterizationStateStreamCreateFlagsEXT] -> ShowS

Eq PipelineRasterizationStateStreamCreateFlagsEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

(==) :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> Bool

(/=) :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> Bool

Ord PipelineRasterizationStateStreamCreateFlagsEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

compare :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> Ordering

(<) :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> Bool

(<=) :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> Bool

(>) :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> Bool

(>=) :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> Bool

max :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT

min :: PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT -> PipelineRasterizationStateStreamCreateFlagsEXT

Zero PipelineRasterizationStateStreamCreateFlagsEXT

Defined in Vulkan.Extensions.VK_EXT_transform_feedback

Methods

zero :: PipelineRasterizationStateStreamCreateFlagsEXT

type EXT_TRANSFORM_FEEDBACK_SPEC_VERSION = 1

pattern EXT_TRANSFORM_FEEDBACK_SPEC_VERSION :: forall a. Integral a => a

type EXT_TRANSFORM_FEEDBACK_EXTENSION_NAME = "VK_EXT_transform_feedback"

pattern EXT_TRANSFORM_FEEDBACK_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a