Package org.lwjgl.vulkan
Class EXTPipelineCreationFeedback
- java.lang.Object
-
- org.lwjgl.vulkan.EXTPipelineCreationFeedback
-
public final class EXTPipelineCreationFeedback extends java.lang.Object
This extension adds a mechanism to provide feedback to an application about pipeline creation, with the specific goal of allowing a feedback loop between build systems and in-the-field application executions to ensure effective pipeline caches are shipped to customers.Examples
None.
- Name String
VK_EXT_pipeline_creation_feedback
- Extension Type
- Device extension
- Registered Extension Number
- 193
- Revision
- 1
- Extension and Version Dependencies
- Requires Vulkan 1.0
- Contact
- Jean-Francois Roy jfroy
- Last Modified Date
- 2019-03-12
- IP Status
- No known IP claims.
- Contributors
- Jean-Francois Roy, Google
- Hai Nguyen, Google
- Andrew Ellem, Google
- Bob Fraser, Google
- Sujeevan Rajayogam, Google
- Jan-Harald Fredriksen, ARM
- Jeff Leger, Qualcomm Technologies, Inc.
- Jeff Bolz, NVIDIA
- Daniel Koch, NVIDIA
- Neil Henning, AMD
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
VK_EXT_PIPELINE_CREATION_FEEDBACK_EXTENSION_NAME
The extension name.static int
VK_EXT_PIPELINE_CREATION_FEEDBACK_SPEC_VERSION
The extension specification version.static int
VK_PIPELINE_CREATION_FEEDBACK_APPLICATION_PIPELINE_CACHE_HIT_BIT_EXT
VK_PIPELINE_CREATION_FEEDBACK_BASE_PIPELINE_ACCELERATION_BIT_EXT
VK_PIPELINE_CREATION_FEEDBACK_VALID_BIT_EXTVkPipelineCreationFeedbackFlagBitsEXT - Bitmask specifying pipeline or pipeline stage creation feedbackstatic int
VK_STRUCTURE_TYPE_PIPELINE_CREATION_FEEDBACK_CREATE_INFO_EXT
ExtendsVkStructureType
.
-
-
-
Field Detail
-
VK_EXT_PIPELINE_CREATION_FEEDBACK_SPEC_VERSION
The extension specification version.
-
VK_EXT_PIPELINE_CREATION_FEEDBACK_EXTENSION_NAME
The extension name.
-
VK_STRUCTURE_TYPE_PIPELINE_CREATION_FEEDBACK_CREATE_INFO_EXT
ExtendsVkStructureType
.
-
VK_PIPELINE_CREATION_FEEDBACK_VALID_BIT_EXT, VK_PIPELINE_CREATION_FEEDBACK_APPLICATION_PIPELINE_CACHE_HIT_BIT_EXT, VK_PIPELINE_CREATION_FEEDBACK_BASE_PIPELINE_ACCELERATION_BIT_EXT
VkPipelineCreationFeedbackFlagBitsEXT - Bitmask specifying pipeline or pipeline stage creation feedbackDescription
PIPELINE_CREATION_FEEDBACK_VALID_BIT_EXT
indicates that the feedback information is valid.PIPELINE_CREATION_FEEDBACK_APPLICATION_PIPELINE_CACHE_HIT_BIT_EXT
indicates that a readily usable pipeline or pipeline stage was found in thepipelineCache
specified by the application in the pipeline creation command. An implementation should set thePIPELINE_CREATION_FEEDBACK_APPLICATION_PIPELINE_CACHE_HIT_BIT_EXT
bit if it was able to avoid the large majority of pipeline or pipeline stage creation work by using thepipelineCache
parameter ofCreateGraphicsPipelines
,CreateRayTracingPipelinesNV
, orCreateComputePipelines
. When an implementation sets this bit for the entire pipeline, it may leave it unset for any stage.Note
Implementations are encouraged to provide a meaningful signal to applications using this bit. The intention is to communicate to the application that the pipeline or pipeline stage was created "as fast as it gets" using the pipeline cache provided by the application. If an implementation uses an internal cache, it is discouraged from setting this bit as the feedback would be unactionable.
PIPELINE_CREATION_FEEDBACK_BASE_PIPELINE_ACCELERATION_BIT_EXT
indicates that the base pipeline specified by thebasePipelineHandle
orbasePipelineIndex
member of the stext:Vk*PipelineCreateInfo structure was used to accelerate the creation of the pipeline. An implementation should set thePIPELINE_CREATION_FEEDBACK_BASE_PIPELINE_ACCELERATION_BIT_EXT
bit if it was able to avoid a significant amount of work by using the base pipeline.Note
While "significant amount of work" is subjective, implementations are encouraged to provide a meaningful signal to applications using this bit. For example, a 1% reduction in duration may not warrant setting this bit, while a 50% reduction would.
See Also
VkPipelineCreationFeedbackCreateInfoEXT
,VkPipelineCreationFeedbackEXT
,VkPipelineCreationFeedbackFlagsEXT
-
-