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 modifier 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 mustn'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
248 …10	fourcc_code('V', 'U', '3', '0') /* Y followed by U then V, 10:10:10. Non-linear modifier only */
288  * These formats can only be used with a non-Linear modifier.
408  * The upper 8 bits of the format modifier are a vendor-id as assigned
430 #define fourcc_mod_get_vendor(modifier) \  argument
431 	(((modifier) >> 56) & 0xff)
433 #define fourcc_mod_is_vendor(modifier, vendor) \  argument
434 	(fourcc_mod_get_vendor(modifier) == DRM_FORMAT_MOD_VENDOR_## vendor)
440  * Format Modifier tokens:
446  * Generic modifier names:
459  * vendor-specific modifier, a new 'GENERIC' vendor or modifier using vendor
467  * modifier(s), reflecting the vendor of the standard.
473  * Invalid Modifier
475  * This modifier can be used as a sentinel to terminate the format modifiers
476  * list, or to initialize a variable with an invalid modifier. It might also be
485  * modifier (e.g. not setting DRM_MODE_FB_MODIFIERS in the DRM_ADDFB2 ioctl),
494  * The "none" format modifier doesn't actually mean that the modifier is
658  * for the I915_FORMAT_MOD_Y_TILED_GEN12_RC_CCS_CC modifier, see its description
837  * We reserve the top 8 bits of the Vivante modifier space for tile status
848  * Vivante compression modifiers. Those depend on a TS modifier being present
855 /* Masking out the extension bits will yield the base modifier. */
912  *             implied by the format modifier, format, or memory buffer, page
913  *             kind would not need to be included in the modifier itself, but
914  *             since the modifier should define the layout of the associated
966 drm_fourcc_canonicalize_nvidia_format_mod(__u64 modifier)  in drm_fourcc_canonicalize_nvidia_format_mod()  argument
968 	if (!(modifier & 0x10) || (modifier & (0xff << 12)))  in drm_fourcc_canonicalize_nvidia_format_mod()
969 		return modifier;  in drm_fourcc_canonicalize_nvidia_format_mod()
971 		return modifier | (0xfe << 12);  in drm_fourcc_canonicalize_nvidia_format_mod()
1013  * vertical lines in the image. Reserve the lower 32 bits for modifier
1062  * of column width in the modifier (we can't use the stride value due
1066  * Note that the column height for this format modifier is the same
1072  * The DRM_FORMAT_MOD_BROADCOM_SAND128_COL_HEIGHT modifier is also
1110  * all blocks using the format.  This tiling modifier will use XOR as
1112  * the assumption is that a no-XOR tiling modifier will be created.
1124  * represented using bits in the modifier. Not all combinations are valid,
1316  * AFRC coding unit size modifier.
1354  * Arm 16x16 Block U-Interleaved modifier
1364  * Allwinner tiled modifier
1418  * This layout is transferrable between Amlogic SoCs supporting this modifier.
1431  * Amlogic SoCs supporting this modifier.
1469  * MediaTek Tiled Modifier
1470  * The lowest 8 bits of the modifier is used to specify the tiling