38  * fourcc code, a Format Modifier may optionally be provided, in order to
45  * unique fourcc:modifier pair. This format:modifier pair must fully define the
49  * Having multiple fourcc:modifier pairs which describe the same layout should
57  * modifier is specific to the modifer being used. For example, some modifiers
62  * match only a single modifier. A modifier must not be a subset of layouts of
63  * another modifier. For instance, it's incorrect to encode pitch alignment in
64  * a modifier: a buffer may match a 64-pixel aligned modifier and a 32-pixel
65  * aligned modifier. That said, modifiers can have implicit minimal
68  * For modifiers where the combination of fourcc code and modifier can alias,
74  * There are two kinds of modifier users:
82  *   These users musn't need to know to reason about the modifier value
83  *   (i.e. they are not expected to extract information out of the modifier).
85  * Vendors should document their modifier usage in as much detail as
89  * The authoritative list of format modifier codes is found in
236 …10	fourcc_code('V', 'U', '3', '0') /* Y followed by U then V, 10:10:10. Non-linear modifier only */
276  * These formats can only be used with a non-Linear modifier.
394  * The upper 8 bits of the format modifier are a vendor-id as assigned
415 #define fourcc_mod_get_vendor(modifier) \  argument
416 	(((modifier) >> 56) & 0xff)
418 #define fourcc_mod_is_vendor(modifier, vendor) \  argument
419 	(fourcc_mod_get_vendor(modifier) == DRM_FORMAT_MOD_VENDOR_## vendor)
425  * Format Modifier tokens:
431  * Generic modifier names:
444  * vendor-specific modifier, a new 'GENERIC' vendor or modifier using vendor
452  * modifier(s), reflecting the vendor of the standard.
458  * Invalid Modifier
460  * This modifier can be used as a sentinel to terminate the format modifiers
461  * list, or to initialize a variable with an invalid modifier. It might also be
470  * modifier (e.g. not setting DRM_MODE_FB_MODIFIERS in the DRM_ADDFB2 ioctl),
479  * The "none" format modifier doesn't actually mean that the modifier is
643  * for the I915_FORMAT_MOD_Y_TILED_GEN12_RC_CCS_CC modifier, see its description
800  *             implied by the format modifier, format, or memory buffer, page
801  *             kind would not need to be included in the modifier itself, but
802  *             since the modifier should define the layout of the associated
854 drm_fourcc_canonicalize_nvidia_format_mod(__u64 modifier)  in drm_fourcc_canonicalize_nvidia_format_mod()  argument
856 	if (!(modifier & 0x10) || (modifier & (0xff << 12)))  in drm_fourcc_canonicalize_nvidia_format_mod()
857 		return modifier;  in drm_fourcc_canonicalize_nvidia_format_mod()
859 		return modifier | (0xfe << 12);  in drm_fourcc_canonicalize_nvidia_format_mod()
901  * vertical lines in the image. Reserve the lower 32 bits for modifier
950  * of column width in the modifier (we can't use the stride value due
954  * Note that the column height for this format modifier is the same
960  * The DRM_FORMAT_MOD_BROADCOM_SAND128_COL_HEIGHT modifier is also
998  * all blocks using the format.  This tiling modifier will use XOR as
1000  * the assumption is that a no-XOR tiling modifier will be created.
1012  * represented using bits in the modifier. Not all combinations are valid,
1204  * AFRC coding unit size modifier.
1242  * Arm 16x16 Block U-Interleaved modifier
1252  * Allwinner tiled modifier
1306  * This layout is transferrable between Amlogic SoCs supporting this modifier.
1319  * Amlogic SoCs supporting this modifier.