OpenHarmony/third_party_mesa3d
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: use ext-role for GL / VK extensions

Browse Source 
This makes sure that we generate proper links to all of these
extensions.

Reviewed-by: Eric Engestrom <eric@igalia.com>
Reviewed-by: Adam Jackson <ajax@redhat.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19594>
This commit is contained in:
Erik Faye-Lund
2022-11-08 12:05:36 +01:00
committed by Marge Bot
parent f69560bdcb
commit ba78af66c6
20 changed files with 171 additions and 187 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
docs/drivers/anv.rst
View File

@@ -14,7 +14,7 @@ specific to ANV:
:envvar:`ANV_DISABLE_SECONDARY_CMD_BUFFER_CALLS`
If defined to ``1`` or ``true``, this will prevent usage of self
modifying command buffers to implement ``vkCmdExecuteCommands``. As
a result of this, it will also disable ``VK_KHR_performance_query``.
a result of this, it will also disable :ext:`VK_KHR_performance_query`.
:envvar:`ANV_ALWAYS_BINDLESS`
If defined to ``1`` or ``true``, this forces all descriptor sets to
use the internal `Bindless model`_.
@@ -28,7 +28,7 @@ specific to ANV:
Haswell, Cherryview).
:envvar:`ANV_PRIMITIVE_REPLICATION_MAX_VIEWS`
Specifies up to how many view shaders can be lowered to handle
VK_KHR_multiview. Beyond this number, multiview is implemented
:ext:`VK_KHR_multiview`. Beyond this number, multiview is implemented
using instanced rendering. If unspecified, the value default to
``2``.
@@ -38,7 +38,7 @@ Experimental features
:envvar:`ANV_EXPERIMENTAL_NV_MESH_SHADER`
If defined to ``1`` or ``true``, this advertise support for
VK_NV_mesh_shader extension for platforms that have hardware
:ext:`VK_NV_mesh_shader` extension for platforms that have hardware
support for it.

6
docs/drivers/lima.rst
View File

@@ -131,9 +131,9 @@ Here are some known caveats in OpenGL support:
that may affect the quality of the texture lookup.
- Lima supports FP16 textures in OpenGL ES (through
``GL_OES_texture_half_float``), but not in OpenGL.
This is because it would require ``ARB_texture_float`` which would also
require 32-bit float textures, that the Mali-4xx does not support.
:ext:`GL_OES_texture_half_float<GL_OES_texture_float>`), but not in OpenGL.
This is because it would require :ext:`GL_ARB_texture_float` which would
also require 32-bit float textures, that the Mali-4xx does not support.
- Rendering to FP16 is possible, but the result is clamped to the
[0.0,1.0] range.

12
docs/drivers/svga3d.rst
View File

@@ -23,12 +23,12 @@ With the Fall 2018 Workstation 15 / Fusion 11 releases, additional
features are supported in the driver:
- Multisample antialiasing (2x, 4x)
- GL_ARB/AMD_draw_buffers_blend
- GL_ARB_sample_shading
- GL_ARB_texture_cube_map_array
- GL_ARB_texture_gather
- GL_ARB_texture_query_lod
- GL_EXT/OES_draw_buffers_indexed
- :ext:`GL_ARB_draw_buffers_blend` / :ext:`GL_AMD_draw_buffers_blend`
- :ext:`GL_ARB_sample_shading`
- :ext:`GL_ARB_texture_cube_map_array`
- :ext:`GL_ARB_texture_gather`
- :ext:`GL_ARB_texture_query_lod`
- :ext:`GL_EXT_draw_buffers_indexed` / :ext:`GL_OES_draw_buffers_indexed`
This requires version 2.15.0 or later of the vmwgfx kernel module and
the VM must be configured for hardware version 16 or later.

10
docs/drivers/venus.rst
View File

@@ -16,9 +16,9 @@ Requirements
The Venus renderer requires
- Vulkan 1.1
- ``VK_EXT_external_memory_dma_buf``
- ``VK_EXT_image_drm_format_modifier``
- ``VK_EXT_queue_family_foreign``
- :ext:`VK_EXT_external_memory_dma_buf`
- :ext:`VK_EXT_image_drm_format_modifier`
- :ext:`VK_EXT_queue_family_foreign`
from the host driver. However, it violates the spec in some places currently
and also relies on implementation-defined behaviors in others. It is not
@@ -161,8 +161,8 @@ driver supports the formats, especially multi-planar ones, and the DRM format
modifiers of the GBM BOs.
In the future, if virglrenderer's ``virgl_renderer_export_fence`` is
supported, the Venus renderer will require ``VK_KHR_external_fence_fd`` with
``VK_EXTERNAL_FENCE_HANDLE_TYPE_SYNC_FD_BIT`` from the host driver.
supported, the Venus renderer will require :ext:`VK_KHR_external_fence_fd`
with ``VK_EXTERNAL_FENCE_HANDLE_TYPE_SYNC_FD_BIT`` from the host driver.
VK_MEMORY_PROPERTY_HOST_VISIBLE_BIT
-----------------------------------

63
docs/drivers/zink.rst
View File

@@ -44,13 +44,13 @@ Here's a list of those requirements:
* Device extensions:
* `VK_KHR_maintenance1`_
* `VK_KHR_create_renderpass2`_
* `VK_KHR_imageless_framebuffer`_
* `VK_KHR_timeline_semaphore`_
* `VK_EXT_custom_border_color`_ with ``customBorderColorWithoutFormat``
* `VK_EXT_provoking_vertex`_
* `VK_EXT_line_rasterization`_, with the following ``VkPhysicalDeviceLineRasterizationFeaturesEXT``:
* :ext:`VK_KHR_maintenance1`
* :ext:`VK_KHR_create_renderpass2`
* :ext:`VK_KHR_imageless_framebuffer`
* :ext:`VK_KHR_timeline_semaphore`
* :ext:`VK_EXT_custom_border_color` with ``customBorderColorWithoutFormat``
* :ext:`VK_EXT_provoking_vertex`
* :ext:`VK_EXT_line_rasterization`, with the following ``VkPhysicalDeviceLineRasterizationFeaturesEXT``:
* ``rectangularLines``
* ``bresenhamLines``
@@ -59,14 +59,14 @@ Here's a list of those requirements:
* ``stippledBresenhamLines``
* ``stippledSmoothLines``
* `VK_KHR_swapchain_mutable_format`_
* `VK_EXT_border_color_swizzle`_
* `VK_KHR_descriptor_update_template`_
* :ext:`VK_KHR_swapchain_mutable_format`
* :ext:`VK_EXT_border_color_swizzle`
* :ext:`VK_KHR_descriptor_update_template`
In addition to this, `VK_KHR_external_memory`_ is required to support the
In addition to this, :ext:`VK_KHR_external_memory` is required to support the
DRI code-path.
We also require either the `VK_EXT_scalar_block_layout`_ extension or
We also require either the :ext:`VK_EXT_scalar_block_layout` extension or
Vulkan 1.2, with the ``scalarBlockLayout`` feature.
OpenGL 3.0
@@ -82,8 +82,8 @@ supported:
* Device extensions:
* `VK_EXT_transform_feedback`_
* `VK_EXT_conditional_rendering`_
* :ext:`VK_EXT_transform_feedback`
* :ext:`VK_EXT_conditional_rendering`
OpenGL 3.1
^^^^^^^^^^
@@ -107,7 +107,7 @@ supported, although some of these might not actually get verified:
* Device extensions:
* `VK_EXT_depth_clip_enable`_
* :ext:`VK_EXT_depth_clip_enable`
OpenGL 3.3
^^^^^^^^^^
@@ -121,7 +121,7 @@ supported, although some of these might not actually get verified:
* Device extensions:
* `VK_EXT_vertex_attribute_divisor`_
* :ext:`VK_EXT_vertex_attribute_divisor`
OpenGL 4.0
^^^^^^^^^^
@@ -137,7 +137,7 @@ supported:
* Device extensions:
* `VK_KHR_maintenance2`_
* :ext:`VK_KHR_maintenance2`
* Formats requiring ``VK_FORMAT_FEATURE_UNIFORM_TEXEL_BUFFER_BIT``:
@@ -167,7 +167,7 @@ For OpenGL 4.2 support, the following additional requirements must be
supported:
* Device extensions:
* `VK_EXT_image_2d_view_of_3d`_
* :ext:`VK_EXT_image_2d_view_of_3d`
* ``VkPhysicalDeviceLimits``:
@@ -187,7 +187,7 @@ supported:
* Device extensions:
* `VK_KHR_shader_draw_parameters`_
* :ext:`VK_KHR_shader_draw_parameters`
OpenGL 4.3
^^^^^^^^^^
@@ -221,7 +221,7 @@ supported:
* Device extensions:
* `VK_KHR_sampler_mirror_clamp_to_edge`_
* :ext:`VK_KHR_sampler_mirror_clamp_to_edge`
OpenGL 4.5
^^^^^^^^^^
@@ -245,7 +245,7 @@ are required to be supported
* Device extensions:
* `VK_KHR_draw_indirect_count`_
* :ext:`VK_KHR_draw_indirect_count`
Performance
-----------
@@ -308,24 +308,3 @@ questions, don't hesitate to visit `#zink on OFTC
.. _downloaded from GPUinfo.org: https://www.saschawillems.de/blog/2022/03/12/vulkan-profiles-support-for-the-vulkan-hardware-capability-viewer-and-database/>
.. _VK_KHR_maintenance1: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_KHR_maintenance1.html
.. _VK_KHR_create_renderpass2: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_KHR_create_renderpass2.html
.. _VK_KHR_imageless_framebuffer: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_KHR_imageless_framebuffer.html
.. _VK_KHR_timeline_semaphore: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_KHR_timeline_semaphore.html
.. _VK_KHR_external_memory: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_KHR_external_memory.html
.. _VK_EXT_scalar_block_layout: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_EXT_scalar_block_layout.html
.. _VK_EXT_transform_feedback: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_EXT_transform_feedback.html
.. _VK_EXT_conditional_rendering: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_EXT_conditional_rendering.html
.. _VK_EXT_vertex_attribute_divisor: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_EXT_vertex_attribute_divisor.html
.. _VK_EXT_image_2d_view_of_3d: https://www.khronos.org/registry/vulkan/specs/1.3-extensions/man/html/VK_EXT_image_2d_view_of_3d.html
.. _VK_KHR_maintenance2: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_KHR_maintenance2.html
.. _VK_KHR_shader_draw_parameters: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_KHR_shader_draw_parameters.html
.. _VK_KHR_draw_indirect_count: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_KHR_draw_indirect_count.html
.. _VK_KHR_sampler_mirror_clamp_to_edge: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_KHR_sampler_mirror_clamp_to_edge.html
.. _VK_EXT_custom_border_color: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_EXT_custom_border_color.html
.. _VK_EXT_provoking_vertex: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_EXT_provoking_vertex.html
.. _VK_EXT_line_rasterization: https://www.khronos.org/registry/vulkan/specs/1.2-extensions/man/html/VK_EXT_line_rasterization.html
.. _VK_KHR_swapchain_mutable_format: https://registry.khronos.org/vulkan/specs/1.3-extensions/man/html/VK_KHR_swapchain_mutable_format.html
.. _VK_EXT_border_color_swizzle: https://registry.khronos.org/vulkan/specs/1.3-extensions/man/html/VK_EXT_border_color_swizzle.html
.. _VK_EXT_depth_clip_enable: https://www.khronos.org/registry/vulkan/specs/1.3-extensions/man/html/VK_EXT_depth_clip_enable.html
.. _VK_KHR_descriptor_update_template: https://www.khronos.org/registry/vulkan/specs/1.3-extensions/man/html/VK_KHR_descriptor_update_template.html