derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
84 lines
2.9 KiB
ReStructuredText
84 lines
2.9 KiB
ReStructuredText
NIR Texture Instructions
|
|
========================
|
|
|
|
Even though texture instructions *could* be supported as intrinsics, the vast
|
|
number of combinations mean that doing so is practically impossible. Instead,
|
|
NIR has a dedicated texture instruction. There are several texture operations:
|
|
|
|
.. c:autoenum:: nir_texop
|
|
:file: src/compiler/nir/nir.h
|
|
:members:
|
|
|
|
As with other instruction types, there is still an array of sources, except
|
|
that each source also has a *type* associated with it. There are various
|
|
source types, each corresponding to a piece of information that the different
|
|
texture operations require.
|
|
|
|
.. c:autoenum:: nir_tex_src_type
|
|
:members:
|
|
|
|
Of particular interest are the texture/sampler deref/index/handle source types.
|
|
First, note that textures and samplers are specified separately in NIR. While
|
|
not required for OpenGL, this is required for Vulkan and OpenCL. Some
|
|
OpenGL [ES] drivers have to deal with hardware that does not have separate
|
|
samplers and textures. While not recommended, an OpenGL-only driver may assume
|
|
that the texture and sampler derefs will always point to the same resource, if
|
|
needed. Note that this pretty well paints your compiler into a corner and
|
|
makes any future port to Vulkan or OpenCL harder, so such assumptions should
|
|
really only be made if targeting OpenGL ES 2.0 era hardware.
|
|
|
|
Also, like a lot of other resources, there are multiple ways to represent a
|
|
texture in NIR. It can be referenced by a variable dereference, an index, or a
|
|
bindless handle. When using an index or a bindless handle, the texture type
|
|
information is generally not available. To handle this, various information
|
|
from the type is redundantly stored in the :c:struct:`nir_tex_instr` itself.
|
|
|
|
.. c:autostruct:: nir_tex_instr
|
|
:members:
|
|
|
|
.. c:autostruct:: nir_tex_src
|
|
:members:
|
|
|
|
Texture instruction helpers
|
|
---------------------------
|
|
|
|
There are a number of helper functions for working with NIR texture
|
|
instructions. They are documented here in no particular order.
|
|
|
|
.. c:autofunction:: nir_tex_instr_create
|
|
|
|
.. c:autofunction:: nir_tex_instr_need_sampler
|
|
|
|
.. c:autofunction:: nir_tex_instr_result_size
|
|
|
|
.. c:autofunction:: nir_tex_instr_dest_size
|
|
|
|
.. c:autofunction:: nir_tex_instr_is_query
|
|
|
|
.. c:autofunction:: nir_tex_instr_has_implicit_derivative
|
|
|
|
.. c:autofunction:: nir_tex_instr_src_type
|
|
|
|
.. c:autofunction:: nir_tex_instr_src_size
|
|
|
|
.. c:autofunction:: nir_tex_instr_src_index
|
|
|
|
.. c:autofunction:: nir_tex_instr_add_src
|
|
|
|
.. c:autofunction:: nir_tex_instr_remove_src
|
|
|
|
Texture instruction lowering
|
|
----------------------------
|
|
|
|
Because most hardware only supports some subset of all possible GLSL/SPIR-V
|
|
texture operations, NIR provides a quite powerful lowering pass which is able
|
|
to implement more complex texture operations in terms of simpler ones.
|
|
|
|
.. c:autofunction:: nir_lower_tex
|
|
|
|
.. c:autostruct:: nir_lower_tex_options
|
|
:members:
|
|
|
|
.. c:autoenum:: nir_lower_tex_packing
|
|
:members:
|