avutil/pixfmt: Improve ascii art showing the meaning of the AVChromaLocation values

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
10 years ago · 710abaf2c5
parent 7786a91b47
commit 710abaf2c5
1 changed files with 7 additions and 3 deletions
--- a/libavutil/pixfmt.h
+++ b/libavutil/pixfmt.h
@ -530,9 +530,13 @@ enum AVColorRange {
 /**
 * Location of chroma samples.
 *
- *  X   X      3 4 X      X are luma samples,
- *             1 2        1-6 are possible chroma positions
- *  X   X      5 6 X      0 is undefined/unknown position
+ * Illustration showing the location, the left shows only luma, the right
+ * shows the location of the chroma samples, the 2 could be imagined to overlay
+ * each other but are drawn seperately due to limitations of ASCII
+ *  ______        ______
+ * |X   X ...    |3 4 X ...     X are luma samples,
+ * |             |1 2           1-6 are possible chroma positions
+ * |X   X ...    |5 6 X ...     0 is undefined/unknown position
 */
 enum AVChromaLocation {
    AVCHROMA_LOC_UNSPECIFIED = 0,