From: Jason Ekstrand <jason.ekstrand@intel.com>
Date: Sat, 23 Jan 2016 03:14:41 +0000 (-0800)
Subject: anv/format: Add a helpful comment about format names
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=2bfb9f29b828ebc6bba4807043cd2214078fe2c5;p=mesa.git

anv/format: Add a helpful comment about format names
---

diff --git a/src/vulkan/anv_formats.c b/src/vulkan/anv_formats.c
index 3f3eace3c2f..642bc7d3cb1 100644
--- a/src/vulkan/anv_formats.c
+++ b/src/vulkan/anv_formats.c
@@ -35,6 +35,11 @@
       __VA_ARGS__ \
    }
 
+/* HINT: For array formats, the ISL name should match the VK name.  For
+ * packed formats, they should have the channels in reverse order from each
+ * other.  The reason for this is that, for packed formats, the ISL (and
+ * bspec) names are in LSB -> MSB order while VK formats are MSB -> LSB.
+ */
 static const struct anv_format anv_formats[] = {
    fmt(VK_FORMAT_UNDEFINED,               ISL_FORMAT_RAW),
    fmt(VK_FORMAT_R4G4_UNORM_PACK8,        ISL_FORMAT_UNSUPPORTED),