vasilito
cb424d7448
verify-patch-sanity.py validates every active recipe .patch has internally- consistent hunk line counts — catching the 'malformed patch at line N' failure at commit/CI/preflight time instead of hours into a cook. This cycle hit that class three times (qtwaylandscanner, sddm, xwayland), each only discovered when cookbook tried to apply the patch. Running it across the repo found 29 latent malformed patches (validated against GNU patch: e.g. relibc/P3-sysv-ipc reproduces 'malformed patch at line 22'). They were harmless only because they sit in vendored recipes (baked, not re- applied) — but would fail on any version-bump re-derivation. --fix recounts the hunk headers (body untouched) and repaired all 29. Wired into build-preflight.sh (Phase 1.0D) and redbear-ci.yml, with a unit test (test-patch-sanity.sh). Skips archived/legacy trees and unvalidatable formats (empty placeholders, bare-@@ git hunks).
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:
|