drm_fourcc.c 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407
  1. /*
  2. * Copyright (c) 2016 Laurent Pinchart <laurent.pinchart@ideasonboard.com>
  3. *
  4. * DRM core format related functions
  5. *
  6. * Permission to use, copy, modify, distribute, and sell this software and its
  7. * documentation for any purpose is hereby granted without fee, provided that
  8. * the above copyright notice appear in all copies and that both that copyright
  9. * notice and this permission notice appear in supporting documentation, and
  10. * that the name of the copyright holders not be used in advertising or
  11. * publicity pertaining to distribution of the software without specific,
  12. * written prior permission. The copyright holders make no representations
  13. * about the suitability of this software for any purpose. It is provided "as
  14. * is" without express or implied warranty.
  15. *
  16. * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  17. * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
  18. * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  19. * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
  20. * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  21. * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  22. * OF THIS SOFTWARE.
  23. */
  24. #include <linux/bug.h>
  25. #include <linux/ctype.h>
  26. #include <linux/export.h>
  27. #include <linux/kernel.h>
  28. #include <drm/drm_device.h>
  29. #include <drm/drm_fourcc.h>
  30. static char printable_char(int c)
  31. {
  32. return isascii(c) && isprint(c) ? c : '?';
  33. }
  34. /**
  35. * drm_mode_legacy_fb_format - compute drm fourcc code from legacy description
  36. * @bpp: bits per pixels
  37. * @depth: bit depth per pixel
  38. *
  39. * Computes a drm fourcc pixel format code for the given @bpp/@depth values.
  40. * Useful in fbdev emulation code, since that deals in those values.
  41. */
  42. uint32_t drm_mode_legacy_fb_format(uint32_t bpp, uint32_t depth)
  43. {
  44. uint32_t fmt = DRM_FORMAT_INVALID;
  45. switch (bpp) {
  46. case 8:
  47. if (depth == 8)
  48. fmt = DRM_FORMAT_C8;
  49. break;
  50. case 16:
  51. switch (depth) {
  52. case 15:
  53. fmt = DRM_FORMAT_XRGB1555;
  54. break;
  55. case 16:
  56. fmt = DRM_FORMAT_RGB565;
  57. break;
  58. default:
  59. break;
  60. }
  61. break;
  62. case 24:
  63. if (depth == 24)
  64. fmt = DRM_FORMAT_RGB888;
  65. break;
  66. case 32:
  67. switch (depth) {
  68. case 24:
  69. fmt = DRM_FORMAT_XRGB8888;
  70. break;
  71. case 30:
  72. fmt = DRM_FORMAT_XRGB2101010;
  73. break;
  74. case 32:
  75. fmt = DRM_FORMAT_ARGB8888;
  76. break;
  77. default:
  78. break;
  79. }
  80. break;
  81. default:
  82. break;
  83. }
  84. return fmt;
  85. }
  86. EXPORT_SYMBOL(drm_mode_legacy_fb_format);
  87. /**
  88. * drm_driver_legacy_fb_format - compute drm fourcc code from legacy description
  89. * @dev: DRM device
  90. * @bpp: bits per pixels
  91. * @depth: bit depth per pixel
  92. *
  93. * Computes a drm fourcc pixel format code for the given @bpp/@depth values.
  94. * Unlike drm_mode_legacy_fb_format() this looks at the drivers mode_config,
  95. * and depending on the &drm_mode_config.quirk_addfb_prefer_host_byte_order flag
  96. * it returns little endian byte order or host byte order framebuffer formats.
  97. */
  98. uint32_t drm_driver_legacy_fb_format(struct drm_device *dev,
  99. uint32_t bpp, uint32_t depth)
  100. {
  101. uint32_t fmt = drm_mode_legacy_fb_format(bpp, depth);
  102. if (dev->mode_config.quirk_addfb_prefer_host_byte_order) {
  103. if (fmt == DRM_FORMAT_XRGB8888)
  104. fmt = DRM_FORMAT_HOST_XRGB8888;
  105. if (fmt == DRM_FORMAT_ARGB8888)
  106. fmt = DRM_FORMAT_HOST_ARGB8888;
  107. if (fmt == DRM_FORMAT_RGB565)
  108. fmt = DRM_FORMAT_HOST_RGB565;
  109. if (fmt == DRM_FORMAT_XRGB1555)
  110. fmt = DRM_FORMAT_HOST_XRGB1555;
  111. }
  112. if (dev->mode_config.quirk_addfb_prefer_xbgr_30bpp &&
  113. fmt == DRM_FORMAT_XRGB2101010)
  114. fmt = DRM_FORMAT_XBGR2101010;
  115. return fmt;
  116. }
  117. EXPORT_SYMBOL(drm_driver_legacy_fb_format);
  118. /**
  119. * drm_get_format_name - fill a string with a drm fourcc format's name
  120. * @format: format to compute name of
  121. * @buf: caller-supplied buffer
  122. */
  123. const char *drm_get_format_name(uint32_t format, struct drm_format_name_buf *buf)
  124. {
  125. snprintf(buf->str, sizeof(buf->str),
  126. "%c%c%c%c %s-endian (0x%08x)",
  127. printable_char(format & 0xff),
  128. printable_char((format >> 8) & 0xff),
  129. printable_char((format >> 16) & 0xff),
  130. printable_char((format >> 24) & 0x7f),
  131. format & DRM_FORMAT_BIG_ENDIAN ? "big" : "little",
  132. format);
  133. return buf->str;
  134. }
  135. EXPORT_SYMBOL(drm_get_format_name);
  136. /*
  137. * Internal function to query information for a given format. See
  138. * drm_format_info() for the public API.
  139. */
  140. const struct drm_format_info *__drm_format_info(u32 format)
  141. {
  142. static const struct drm_format_info formats[] = {
  143. { .format = DRM_FORMAT_C8, .depth = 8, .num_planes = 1, .cpp = { 1, 0, 0 }, .hsub = 1, .vsub = 1 },
  144. { .format = DRM_FORMAT_RGB332, .depth = 8, .num_planes = 1, .cpp = { 1, 0, 0 }, .hsub = 1, .vsub = 1 },
  145. { .format = DRM_FORMAT_BGR233, .depth = 8, .num_planes = 1, .cpp = { 1, 0, 0 }, .hsub = 1, .vsub = 1 },
  146. { .format = DRM_FORMAT_XRGB4444, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1 },
  147. { .format = DRM_FORMAT_XBGR4444, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1 },
  148. { .format = DRM_FORMAT_RGBX4444, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1 },
  149. { .format = DRM_FORMAT_BGRX4444, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1 },
  150. { .format = DRM_FORMAT_ARGB4444, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  151. { .format = DRM_FORMAT_ABGR4444, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  152. { .format = DRM_FORMAT_RGBA4444, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  153. { .format = DRM_FORMAT_BGRA4444, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  154. { .format = DRM_FORMAT_XRGB1555, .depth = 15, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1 },
  155. { .format = DRM_FORMAT_XBGR1555, .depth = 15, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1 },
  156. { .format = DRM_FORMAT_RGBX5551, .depth = 15, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1 },
  157. { .format = DRM_FORMAT_BGRX5551, .depth = 15, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1 },
  158. { .format = DRM_FORMAT_ARGB1555, .depth = 15, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  159. { .format = DRM_FORMAT_ABGR1555, .depth = 15, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  160. { .format = DRM_FORMAT_RGBA5551, .depth = 15, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  161. { .format = DRM_FORMAT_BGRA5551, .depth = 15, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  162. { .format = DRM_FORMAT_RGB565, .depth = 16, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1 },
  163. { .format = DRM_FORMAT_BGR565, .depth = 16, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 1, .vsub = 1 },
  164. { .format = DRM_FORMAT_RGB888, .depth = 24, .num_planes = 1, .cpp = { 3, 0, 0 }, .hsub = 1, .vsub = 1 },
  165. { .format = DRM_FORMAT_BGR888, .depth = 24, .num_planes = 1, .cpp = { 3, 0, 0 }, .hsub = 1, .vsub = 1 },
  166. { .format = DRM_FORMAT_XRGB8888, .depth = 24, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1 },
  167. { .format = DRM_FORMAT_XBGR8888, .depth = 24, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1 },
  168. { .format = DRM_FORMAT_RGBX8888, .depth = 24, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1 },
  169. { .format = DRM_FORMAT_BGRX8888, .depth = 24, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1 },
  170. { .format = DRM_FORMAT_RGB565_A8, .depth = 24, .num_planes = 2, .cpp = { 2, 1, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  171. { .format = DRM_FORMAT_BGR565_A8, .depth = 24, .num_planes = 2, .cpp = { 2, 1, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  172. { .format = DRM_FORMAT_XRGB2101010, .depth = 30, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1 },
  173. { .format = DRM_FORMAT_XBGR2101010, .depth = 30, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1 },
  174. { .format = DRM_FORMAT_RGBX1010102, .depth = 30, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1 },
  175. { .format = DRM_FORMAT_BGRX1010102, .depth = 30, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1 },
  176. { .format = DRM_FORMAT_ARGB2101010, .depth = 30, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  177. { .format = DRM_FORMAT_ABGR2101010, .depth = 30, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  178. { .format = DRM_FORMAT_RGBA1010102, .depth = 30, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  179. { .format = DRM_FORMAT_BGRA1010102, .depth = 30, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  180. { .format = DRM_FORMAT_ARGB8888, .depth = 32, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  181. { .format = DRM_FORMAT_ABGR8888, .depth = 32, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  182. { .format = DRM_FORMAT_RGBA8888, .depth = 32, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  183. { .format = DRM_FORMAT_BGRA8888, .depth = 32, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  184. { .format = DRM_FORMAT_XRGB16161616F, .depth = 0, .num_planes = 1, .cpp = { 8, 0, 0 }, .hsub = 1, .vsub = 1 },
  185. { .format = DRM_FORMAT_XBGR16161616F, .depth = 0, .num_planes = 1, .cpp = { 8, 0, 0 }, .hsub = 1, .vsub = 1 },
  186. { .format = DRM_FORMAT_ARGB16161616F, .depth = 0, .num_planes = 1, .cpp = { 8, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  187. { .format = DRM_FORMAT_ABGR16161616F, .depth = 0, .num_planes = 1, .cpp = { 8, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  188. { .format = DRM_FORMAT_RGB888_A8, .depth = 32, .num_planes = 2, .cpp = { 3, 1, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  189. { .format = DRM_FORMAT_BGR888_A8, .depth = 32, .num_planes = 2, .cpp = { 3, 1, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  190. { .format = DRM_FORMAT_XRGB8888_A8, .depth = 32, .num_planes = 2, .cpp = { 4, 1, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  191. { .format = DRM_FORMAT_XBGR8888_A8, .depth = 32, .num_planes = 2, .cpp = { 4, 1, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  192. { .format = DRM_FORMAT_RGBX8888_A8, .depth = 32, .num_planes = 2, .cpp = { 4, 1, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  193. { .format = DRM_FORMAT_BGRX8888_A8, .depth = 32, .num_planes = 2, .cpp = { 4, 1, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true },
  194. { .format = DRM_FORMAT_YUV410, .depth = 0, .num_planes = 3, .cpp = { 1, 1, 1 }, .hsub = 4, .vsub = 4, .is_yuv = true },
  195. { .format = DRM_FORMAT_YVU410, .depth = 0, .num_planes = 3, .cpp = { 1, 1, 1 }, .hsub = 4, .vsub = 4, .is_yuv = true },
  196. { .format = DRM_FORMAT_YUV411, .depth = 0, .num_planes = 3, .cpp = { 1, 1, 1 }, .hsub = 4, .vsub = 1, .is_yuv = true },
  197. { .format = DRM_FORMAT_YVU411, .depth = 0, .num_planes = 3, .cpp = { 1, 1, 1 }, .hsub = 4, .vsub = 1, .is_yuv = true },
  198. { .format = DRM_FORMAT_YUV420, .depth = 0, .num_planes = 3, .cpp = { 1, 1, 1 }, .hsub = 2, .vsub = 2, .is_yuv = true },
  199. { .format = DRM_FORMAT_YVU420, .depth = 0, .num_planes = 3, .cpp = { 1, 1, 1 }, .hsub = 2, .vsub = 2, .is_yuv = true },
  200. { .format = DRM_FORMAT_YUV422, .depth = 0, .num_planes = 3, .cpp = { 1, 1, 1 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  201. { .format = DRM_FORMAT_YVU422, .depth = 0, .num_planes = 3, .cpp = { 1, 1, 1 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  202. { .format = DRM_FORMAT_YUV444, .depth = 0, .num_planes = 3, .cpp = { 1, 1, 1 }, .hsub = 1, .vsub = 1, .is_yuv = true },
  203. { .format = DRM_FORMAT_YVU444, .depth = 0, .num_planes = 3, .cpp = { 1, 1, 1 }, .hsub = 1, .vsub = 1, .is_yuv = true },
  204. { .format = DRM_FORMAT_NV12, .depth = 0, .num_planes = 2, .cpp = { 1, 2, 0 }, .hsub = 2, .vsub = 2, .is_yuv = true },
  205. { .format = DRM_FORMAT_NV21, .depth = 0, .num_planes = 2, .cpp = { 1, 2, 0 }, .hsub = 2, .vsub = 2, .is_yuv = true },
  206. { .format = DRM_FORMAT_NV16, .depth = 0, .num_planes = 2, .cpp = { 1, 2, 0 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  207. { .format = DRM_FORMAT_NV61, .depth = 0, .num_planes = 2, .cpp = { 1, 2, 0 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  208. { .format = DRM_FORMAT_NV24, .depth = 0, .num_planes = 2, .cpp = { 1, 2, 0 }, .hsub = 1, .vsub = 1, .is_yuv = true },
  209. { .format = DRM_FORMAT_NV42, .depth = 0, .num_planes = 2, .cpp = { 1, 2, 0 }, .hsub = 1, .vsub = 1, .is_yuv = true },
  210. { .format = DRM_FORMAT_YUYV, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  211. { .format = DRM_FORMAT_YVYU, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  212. { .format = DRM_FORMAT_UYVY, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  213. { .format = DRM_FORMAT_VYUY, .depth = 0, .num_planes = 1, .cpp = { 2, 0, 0 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  214. { .format = DRM_FORMAT_XYUV8888, .depth = 0, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .is_yuv = true },
  215. { .format = DRM_FORMAT_VUY888, .depth = 0, .num_planes = 1, .cpp = { 3, 0, 0 }, .hsub = 1, .vsub = 1, .is_yuv = true },
  216. { .format = DRM_FORMAT_AYUV, .depth = 0, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true, .is_yuv = true },
  217. { .format = DRM_FORMAT_Y210, .depth = 0, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  218. { .format = DRM_FORMAT_Y212, .depth = 0, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  219. { .format = DRM_FORMAT_Y216, .depth = 0, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 2, .vsub = 1, .is_yuv = true },
  220. { .format = DRM_FORMAT_Y410, .depth = 0, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true, .is_yuv = true },
  221. { .format = DRM_FORMAT_Y412, .depth = 0, .num_planes = 1, .cpp = { 8, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true, .is_yuv = true },
  222. { .format = DRM_FORMAT_Y416, .depth = 0, .num_planes = 1, .cpp = { 8, 0, 0 }, .hsub = 1, .vsub = 1, .has_alpha = true, .is_yuv = true },
  223. { .format = DRM_FORMAT_XVYU2101010, .depth = 0, .num_planes = 1, .cpp = { 4, 0, 0 }, .hsub = 1, .vsub = 1, .is_yuv = true },
  224. { .format = DRM_FORMAT_XVYU12_16161616, .depth = 0, .num_planes = 1, .cpp = { 8, 0, 0 }, .hsub = 1, .vsub = 1, .is_yuv = true },
  225. { .format = DRM_FORMAT_XVYU16161616, .depth = 0, .num_planes = 1, .cpp = { 8, 0, 0 }, .hsub = 1, .vsub = 1, .is_yuv = true },
  226. { .format = DRM_FORMAT_Y0L0, .depth = 0, .num_planes = 1,
  227. .char_per_block = { 8, 0, 0 }, .block_w = { 2, 0, 0 }, .block_h = { 2, 0, 0 },
  228. .hsub = 2, .vsub = 2, .has_alpha = true, .is_yuv = true },
  229. { .format = DRM_FORMAT_X0L0, .depth = 0, .num_planes = 1,
  230. .char_per_block = { 8, 0, 0 }, .block_w = { 2, 0, 0 }, .block_h = { 2, 0, 0 },
  231. .hsub = 2, .vsub = 2, .is_yuv = true },
  232. { .format = DRM_FORMAT_Y0L2, .depth = 0, .num_planes = 1,
  233. .char_per_block = { 8, 0, 0 }, .block_w = { 2, 0, 0 }, .block_h = { 2, 0, 0 },
  234. .hsub = 2, .vsub = 2, .has_alpha = true, .is_yuv = true },
  235. { .format = DRM_FORMAT_X0L2, .depth = 0, .num_planes = 1,
  236. .char_per_block = { 8, 0, 0 }, .block_w = { 2, 0, 0 }, .block_h = { 2, 0, 0 },
  237. .hsub = 2, .vsub = 2, .is_yuv = true },
  238. { .format = DRM_FORMAT_P010, .depth = 0, .num_planes = 2,
  239. .char_per_block = { 2, 4, 0 }, .block_w = { 1, 1, 0 }, .block_h = { 1, 1, 0 },
  240. .hsub = 2, .vsub = 2, .is_yuv = true},
  241. { .format = DRM_FORMAT_P012, .depth = 0, .num_planes = 2,
  242. .char_per_block = { 2, 4, 0 }, .block_w = { 1, 1, 0 }, .block_h = { 1, 1, 0 },
  243. .hsub = 2, .vsub = 2, .is_yuv = true},
  244. { .format = DRM_FORMAT_P016, .depth = 0, .num_planes = 2,
  245. .char_per_block = { 2, 4, 0 }, .block_w = { 1, 1, 0 }, .block_h = { 1, 1, 0 },
  246. .hsub = 2, .vsub = 2, .is_yuv = true},
  247. { .format = DRM_FORMAT_P210, .depth = 0,
  248. .num_planes = 2, .char_per_block = { 2, 4, 0 },
  249. .block_w = { 1, 1, 0 }, .block_h = { 1, 1, 0 }, .hsub = 2,
  250. .vsub = 1, .is_yuv = true },
  251. { .format = DRM_FORMAT_VUY101010, .depth = 0,
  252. .num_planes = 1, .cpp = { 0, 0, 0 }, .hsub = 1, .vsub = 1,
  253. .is_yuv = true },
  254. { .format = DRM_FORMAT_YUV420_8BIT, .depth = 0,
  255. .num_planes = 1, .cpp = { 0, 0, 0 }, .hsub = 2, .vsub = 2,
  256. .is_yuv = true },
  257. { .format = DRM_FORMAT_YUV420_10BIT, .depth = 0,
  258. .num_planes = 1, .cpp = { 0, 0, 0 }, .hsub = 2, .vsub = 2,
  259. .is_yuv = true },
  260. { .format = DRM_FORMAT_NV15, .depth = 0,
  261. .num_planes = 2, .char_per_block = { 5, 5, 0 },
  262. .block_w = { 4, 2, 0 }, .block_h = { 1, 1, 0 }, .hsub = 2,
  263. .vsub = 2, .is_yuv = true },
  264. { .format = DRM_FORMAT_Q410, .depth = 0,
  265. .num_planes = 3, .char_per_block = { 2, 2, 2 },
  266. .block_w = { 1, 1, 1 }, .block_h = { 1, 1, 1 }, .hsub = 0,
  267. .vsub = 0, .is_yuv = true },
  268. { .format = DRM_FORMAT_Q401, .depth = 0,
  269. .num_planes = 3, .char_per_block = { 2, 2, 2 },
  270. .block_w = { 1, 1, 1 }, .block_h = { 1, 1, 1 }, .hsub = 0,
  271. .vsub = 0, .is_yuv = true },
  272. };
  273. unsigned int i;
  274. for (i = 0; i < ARRAY_SIZE(formats); ++i) {
  275. if (formats[i].format == format)
  276. return &formats[i];
  277. }
  278. return NULL;
  279. }
  280. /**
  281. * drm_format_info - query information for a given format
  282. * @format: pixel format (DRM_FORMAT_*)
  283. *
  284. * The caller should only pass a supported pixel format to this function.
  285. * Unsupported pixel formats will generate a warning in the kernel log.
  286. *
  287. * Returns:
  288. * The instance of struct drm_format_info that describes the pixel format, or
  289. * NULL if the format is unsupported.
  290. */
  291. const struct drm_format_info *drm_format_info(u32 format)
  292. {
  293. const struct drm_format_info *info;
  294. info = __drm_format_info(format);
  295. WARN_ON(!info);
  296. return info;
  297. }
  298. EXPORT_SYMBOL(drm_format_info);
  299. /**
  300. * drm_get_format_info - query information for a given framebuffer configuration
  301. * @dev: DRM device
  302. * @mode_cmd: metadata from the userspace fb creation request
  303. *
  304. * Returns:
  305. * The instance of struct drm_format_info that describes the pixel format, or
  306. * NULL if the format is unsupported.
  307. */
  308. const struct drm_format_info *
  309. drm_get_format_info(struct drm_device *dev,
  310. const struct drm_mode_fb_cmd2 *mode_cmd)
  311. {
  312. const struct drm_format_info *info = NULL;
  313. if (dev->mode_config.funcs->get_format_info)
  314. info = dev->mode_config.funcs->get_format_info(mode_cmd);
  315. if (!info)
  316. info = drm_format_info(mode_cmd->pixel_format);
  317. return info;
  318. }
  319. EXPORT_SYMBOL(drm_get_format_info);
  320. /**
  321. * drm_format_info_block_width - width in pixels of block.
  322. * @info: pixel format info
  323. * @plane: plane index
  324. *
  325. * Returns:
  326. * The width in pixels of a block, depending on the plane index.
  327. */
  328. unsigned int drm_format_info_block_width(const struct drm_format_info *info,
  329. int plane)
  330. {
  331. if (!info || plane < 0 || plane >= info->num_planes)
  332. return 0;
  333. if (!info->block_w[plane])
  334. return 1;
  335. return info->block_w[plane];
  336. }
  337. EXPORT_SYMBOL(drm_format_info_block_width);
  338. /**
  339. * drm_format_info_block_height - height in pixels of a block
  340. * @info: pixel format info
  341. * @plane: plane index
  342. *
  343. * Returns:
  344. * The height in pixels of a block, depending on the plane index.
  345. */
  346. unsigned int drm_format_info_block_height(const struct drm_format_info *info,
  347. int plane)
  348. {
  349. if (!info || plane < 0 || plane >= info->num_planes)
  350. return 0;
  351. if (!info->block_h[plane])
  352. return 1;
  353. return info->block_h[plane];
  354. }
  355. EXPORT_SYMBOL(drm_format_info_block_height);
  356. /**
  357. * drm_format_info_min_pitch - computes the minimum required pitch in bytes
  358. * @info: pixel format info
  359. * @plane: plane index
  360. * @buffer_width: buffer width in pixels
  361. *
  362. * Returns:
  363. * The minimum required pitch in bytes for a buffer by taking into consideration
  364. * the pixel format information and the buffer width.
  365. */
  366. uint64_t drm_format_info_min_pitch(const struct drm_format_info *info,
  367. int plane, unsigned int buffer_width)
  368. {
  369. if (!info || plane < 0 || plane >= info->num_planes)
  370. return 0;
  371. return DIV_ROUND_UP_ULL((u64)buffer_width * info->char_per_block[plane],
  372. drm_format_info_block_width(info, plane) *
  373. drm_format_info_block_height(info, plane));
  374. }
  375. EXPORT_SYMBOL(drm_format_info_min_pitch);