vulkan-3.26.1: Bindings to the Vulkan graphics API.
Safe HaskellSafe-Inferred
LanguageHaskell2010

Vulkan.Extensions.VK_NV_representative_fragment_test

Description

Name

VK_NV_representative_fragment_test - device extension

VK_NV_representative_fragment_test

Name String
VK_NV_representative_fragment_test
Extension Type
Device extension
Registered Extension Number
167
Revision
2
Ratification Status
Not ratified
Extension and Version Dependencies
VK_KHR_get_physical_device_properties2
Contact

Other Extension Metadata

Last Modified Date
2018-09-13
Contributors
  • Kedarnath Thangudu, NVIDIA
  • Christoph Kubisch, NVIDIA
  • Pierre Boudier, NVIDIA
  • Pat Brown, NVIDIA
  • Jeff Bolz, NVIDIA
  • Eric Werness, NVIDIA

Description

This extension provides a new representative fragment test that allows implementations to reduce the amount of rasterization and fragment processing work performed for each point, line, or triangle primitive. For any primitive that produces one or more fragments that pass all other early fragment tests, the implementation is permitted to choose one or more “representative” fragments for processing and discard all other fragments. For draw calls rendering multiple points, lines, or triangles arranged in lists, strips, or fans, the representative fragment test is performed independently for each of those primitives.

This extension is useful for applications that use an early render pass to determine the full set of primitives that would be visible in the final scene. In this render pass, such applications would set up a fragment shader that enables early fragment tests and writes to an image or shader storage buffer to record the ID of the primitive that generated the fragment. Without this extension, the shader would record the ID separately for each visible fragment of each primitive. With this extension, fewer stores will be performed, particularly for large primitives.

The representative fragment test has no effect if early fragment tests are not enabled via the fragment shader. The set of fragments discarded by the representative fragment test is implementation-dependent and may vary from frame to frame. In some cases, the representative fragment test may not discard any fragments for a given primitive.

New Structures

New Enum Constants

Issues

  1. Is the representative fragment test guaranteed to have any effect?

RESOLVED: No. As specified, we only guarantee that each primitive with at least one fragment that passes prior tests will have one fragment passing the representative fragment tests. We do not guarantee that any particular fragment will fail the test.

In the initial implementation of this extension, the representative fragment test is treated as an optimization that may be completely disabled for some pipeline states. This feature was designed for a use case where the fragment shader records information on individual primitives using shader storage buffers or storage images, with no writes to color or depth buffers.

  1. Will the set of fragments that pass the representative fragment test be repeatable if you draw the same scene over and over again?

RESOLVED: No. The set of fragments that pass the representative fragment test is implementation-dependent and may vary due to the timing of operations performed by the GPU.

  1. What happens if you enable the representative fragment test with writes to color and/or depth render targets enabled?

RESOLVED: If writes to the color or depth buffer are enabled, they will be performed for any fragments that survive the relevant tests. Any fragments that fail the representative fragment test will not update color buffers. For the use cases intended for this feature, we do not expect color or depth writes to be enabled.

  1. How do derivatives and automatic texture LOD computations work with the representative fragment test enabled?

RESOLVED: If a fragment shader uses derivative functions or texture lookups using automatic LOD computation, derivatives will be computed identically whether or not the representative fragment test is enabled. For the use cases intended for this feature, we do not expect the use of derivatives in the fragment shader.

Version History

  • Revision 2, 2018-09-13 (pbrown)

    • Add issues.
  • Revision 1, 2018-08-22 (Kedarnath Thangudu)

    • Internal Revisions

See Also

PhysicalDeviceRepresentativeFragmentTestFeaturesNV, PipelineRepresentativeFragmentTestStateCreateInfoNV

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.

Synopsis

Documentation

data PhysicalDeviceRepresentativeFragmentTestFeaturesNV Source #

VkPhysicalDeviceRepresentativeFragmentTestFeaturesNV - Structure describing the representative fragment test features that can be supported by an implementation

Members

This structure describes the following feature:

Description

If the PhysicalDeviceRepresentativeFragmentTestFeaturesNV 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. PhysicalDeviceRepresentativeFragmentTestFeaturesNV can also be used in the pNext chain of DeviceCreateInfo to selectively enable these features.

Valid Usage (Implicit)

See Also

VK_NV_representative_fragment_test, Bool32, StructureType

Constructors

PhysicalDeviceRepresentativeFragmentTestFeaturesNV 

Fields

Instances

Instances details
Storable PhysicalDeviceRepresentativeFragmentTestFeaturesNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

Show PhysicalDeviceRepresentativeFragmentTestFeaturesNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

Eq PhysicalDeviceRepresentativeFragmentTestFeaturesNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

FromCStruct PhysicalDeviceRepresentativeFragmentTestFeaturesNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

ToCStruct PhysicalDeviceRepresentativeFragmentTestFeaturesNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

Zero PhysicalDeviceRepresentativeFragmentTestFeaturesNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

data PipelineRepresentativeFragmentTestStateCreateInfoNV Source #

VkPipelineRepresentativeFragmentTestStateCreateInfoNV - Structure specifying representative fragment test

Description

If this structure is not included in the pNext chain, representativeFragmentTestEnable is considered to be FALSE, and the representative fragment test is disabled.

If the active fragment shader does not specify the EarlyFragmentTests execution mode, the representative fragment shader test has no effect, even if enabled.

Valid Usage (Implicit)

See Also

VK_NV_representative_fragment_test, Bool32, StructureType

Constructors

PipelineRepresentativeFragmentTestStateCreateInfoNV 

Fields

Instances

Instances details
Storable PipelineRepresentativeFragmentTestStateCreateInfoNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

Show PipelineRepresentativeFragmentTestStateCreateInfoNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

Eq PipelineRepresentativeFragmentTestStateCreateInfoNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

FromCStruct PipelineRepresentativeFragmentTestStateCreateInfoNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

ToCStruct PipelineRepresentativeFragmentTestStateCreateInfoNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

Zero PipelineRepresentativeFragmentTestStateCreateInfoNV Source # 
Instance details

Defined in Vulkan.Extensions.VK_NV_representative_fragment_test

type NV_REPRESENTATIVE_FRAGMENT_TEST_EXTENSION_NAME = "VK_NV_representative_fragment_test" Source #