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 and 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 VkPipelineCreationFeedbackFlagBitsEXT - Bitmask specifying pipeline or pipeline stage creation feedback
static int	VK_PIPELINE_CREATION_FEEDBACK_BASE_PIPELINE_ACCELERATION_BIT_EXT VkPipelineCreationFeedbackFlagBitsEXT - Bitmask specifying pipeline or pipeline stage creation feedback
static int	VK_PIPELINE_CREATION_FEEDBACK_VALID_BIT_EXT VkPipelineCreationFeedbackFlagBitsEXT - Bitmask specifying pipeline or pipeline stage creation feedback
static int	VK_STRUCTURE_TYPE_PIPELINE_CREATION_FEEDBACK_CREATE_INFO_EXT Extends VkStructureType.

Method Summary

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

VK_EXT_PIPELINE_CREATION_FEEDBACK_SPEC_VERSION

public static final int VK_EXT_PIPELINE_CREATION_FEEDBACK_SPEC_VERSION

The extension specification version.

See Also:

Constant Field Values

VK_EXT_PIPELINE_CREATION_FEEDBACK_EXTENSION_NAME

public static final java.lang.String VK_EXT_PIPELINE_CREATION_FEEDBACK_EXTENSION_NAME

The extension name.

See Also:

Constant Field Values

VK_STRUCTURE_TYPE_PIPELINE_CREATION_FEEDBACK_CREATE_INFO_EXT

public static final int VK_STRUCTURE_TYPE_PIPELINE_CREATION_FEEDBACK_CREATE_INFO_EXT

Extends VkStructureType.

See Also:

Constant Field Values

VK_PIPELINE_CREATION_FEEDBACK_VALID_BIT_EXT

public static final int VK_PIPELINE_CREATION_FEEDBACK_VALID_BIT_EXT

VkPipelineCreationFeedbackFlagBitsEXT - Bitmask specifying pipeline or pipeline stage creation feedback

Description

• 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 the pipelineCache specified by the application in the pipeline creation command. An implementation should set the PIPELINE_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 the pipelineCache parameter of CreateGraphicsPipelines, CreateRayTracingPipelinesNV, or CreateComputePipelines. 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 the basePipelineHandle or basePipelineIndex member of the stext:Vk*PipelineCreateInfo structure was used to accelerate the creation of the pipeline. An implementation should set the PIPELINE_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

See Also:

Constant Field Values

VK_PIPELINE_CREATION_FEEDBACK_APPLICATION_PIPELINE_CACHE_HIT_BIT_EXT

public static final int VK_PIPELINE_CREATION_FEEDBACK_APPLICATION_PIPELINE_CACHE_HIT_BIT_EXT

VkPipelineCreationFeedbackFlagBitsEXT - Bitmask specifying pipeline or pipeline stage creation feedback

Description

• 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 the pipelineCache specified by the application in the pipeline creation command. An implementation should set the PIPELINE_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 the pipelineCache parameter of CreateGraphicsPipelines, CreateRayTracingPipelinesNV, or CreateComputePipelines. 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 the basePipelineHandle or basePipelineIndex member of the stext:Vk*PipelineCreateInfo structure was used to accelerate the creation of the pipeline. An implementation should set the PIPELINE_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

See Also:

Constant Field Values

VK_PIPELINE_CREATION_FEEDBACK_BASE_PIPELINE_ACCELERATION_BIT_EXT

public static final int VK_PIPELINE_CREATION_FEEDBACK_BASE_PIPELINE_ACCELERATION_BIT_EXT

VkPipelineCreationFeedbackFlagBitsEXT - Bitmask specifying pipeline or pipeline stage creation feedback

Description

• 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 the pipelineCache specified by the application in the pipeline creation command. An implementation should set the PIPELINE_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 the pipelineCache parameter of CreateGraphicsPipelines, CreateRayTracingPipelinesNV, or CreateComputePipelines. 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 the basePipelineHandle or basePipelineIndex member of the stext:Vk*PipelineCreateInfo structure was used to accelerate the creation of the pipeline. An implementation should set the PIPELINE_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

See Also:

Constant Field Values