From: Chad Versace <chad.versace@intel.com>
Date: Thu, 31 Dec 2015 19:55:48 +0000 (-0800)
Subject: isl: Document the 3D block extent of isl_format
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=373fd89e4bc7c36c5df2dda16f148ccf55197635;p=mesa.git

isl: Document the 3D block extent of isl_format
---

diff --git a/src/isl/isl.h b/src/isl/isl.h
index 22fc7540ac7..2f5a6ffe1c4 100644
--- a/src/isl/isl.h
+++ b/src/isl/isl.h
@@ -571,6 +571,13 @@ struct isl_channel_layout {
    uint8_t bits; /**< Size in bits */
 };
 
+/**
+ *   Each format has 3D block extent (width, height, depth). The block extent
+ *   of compressed formats is that of the format's compression block. For
+ *   example, the block extent of ISL_FORMAT_ETC2_RGB8 is (w=4, h=4, d=1).
+ *   The block extent of uncompressed pixel formats, such as
+ *   ISL_FORMAT_R8G8B8A8_UNORM, is is (w=1, h=1, d=1).
+ */
 struct isl_format_layout {
    enum isl_format format;