From 508a3bdd275a52d2d2cd15427937da6c3681a11a Mon Sep 17 00:00:00 2001 From: Daniel Stone Date: Fri, 14 Jun 2024 12:18:24 +0100 Subject: [PATCH] u_format: Reword introduction Signed-off-by: Daniel Stone Part-of: --- src/util/format/u_format.yaml | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/src/util/format/u_format.yaml b/src/util/format/u_format.yaml index f14d6190e2f..1343daffc96 100644 --- a/src/util/format/u_format.yaml +++ b/src/util/format/u_format.yaml @@ -4,6 +4,13 @@ # When adding new format entries, enum pipe_format in # src/util/format/u_formats.h must be updated along with it. # +# These formats are the main descriptions used for drivers, and should uniquely +# describe a format without the need for any annotation. The only difference +# is DRM format modifiers, which are used to describe differences in the +# storage (e.g. tiled and/or compressed). +# +# These do not correspond one-to-one to GL formats or internalformats. +# # Each format entry contains: # - name, per enum pipe_format # - layout, per enum util_format_layout, in shortened lower caps @@ -27,16 +34,6 @@ # # The channel encoding and swizzle may be defined separately for little-endian # and big-endian hosts when using a packed (non-array/bitmask) format. -# -# See also: -# - http://msdn.microsoft.com/en-us/library/bb172558.aspx (D3D9) -# - http://msdn.microsoft.com/en-us/library/bb205073.aspx#mapping_texture_formats (D3D9 -> D3D10) -# - http://msdn.microsoft.com/en-us/library/bb173059.aspx (D3D10) -# -# Note that GL doesn't really specify the layout of internal formats. See -# OpenGL 2.1 specification, Table 3.16, on the "Correspondence of sized -# internal formats to base in- ternal formats, and desired component -# resolutions for each sized internal format." # None # Described as regular uint_8 bytes, i.e. PIPE_FORMAT_R8_USCALED