mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-23 01:10:04 +00:00
![Laurent Pinchart](/assets/img/avatar_default.png)
The drm_crtc.c file is a mess, making the ABI documentation confusing since all functions are in the same bag. Split the format-related helpers to a new drm_fourcc.c file. Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch> Link: http://patchwork.freedesktop.org/patch/msgid/1465466048-2020-1-git-send-email-laurent.pinchart@ideasonboard.com
320 lines
7.8 KiB
C
320 lines
7.8 KiB
C
/*
|
|
* Copyright (c) 2016 Laurent Pinchart <laurent.pinchart@ideasonboard.com>
|
|
*
|
|
* DRM core format related functions
|
|
*
|
|
* Permission to use, copy, modify, distribute, and sell this software and its
|
|
* documentation for any purpose is hereby granted without fee, provided that
|
|
* the above copyright notice appear in all copies and that both that copyright
|
|
* notice and this permission notice appear in supporting documentation, and
|
|
* that the name of the copyright holders not be used in advertising or
|
|
* publicity pertaining to distribution of the software without specific,
|
|
* written prior permission. The copyright holders make no representations
|
|
* about the suitability of this software for any purpose. It is provided "as
|
|
* is" without express or implied warranty.
|
|
*
|
|
* THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
* INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
|
|
* EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
|
|
* CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
|
|
* DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
|
* TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
|
|
* OF THIS SOFTWARE.
|
|
*/
|
|
|
|
#include <linux/bug.h>
|
|
#include <linux/ctype.h>
|
|
#include <linux/export.h>
|
|
#include <linux/kernel.h>
|
|
|
|
#include <drm/drmP.h>
|
|
#include <drm/drm_fourcc.h>
|
|
|
|
static char printable_char(int c)
|
|
{
|
|
return isascii(c) && isprint(c) ? c : '?';
|
|
}
|
|
|
|
/**
|
|
* drm_get_format_name - return a string for drm fourcc format
|
|
* @format: format to compute name of
|
|
*
|
|
* Note that the buffer used by this function is globally shared and owned by
|
|
* the function itself.
|
|
*
|
|
* FIXME: This isn't really multithreading safe.
|
|
*/
|
|
const char *drm_get_format_name(uint32_t format)
|
|
{
|
|
static char buf[32];
|
|
|
|
snprintf(buf, sizeof(buf),
|
|
"%c%c%c%c %s-endian (0x%08x)",
|
|
printable_char(format & 0xff),
|
|
printable_char((format >> 8) & 0xff),
|
|
printable_char((format >> 16) & 0xff),
|
|
printable_char((format >> 24) & 0x7f),
|
|
format & DRM_FORMAT_BIG_ENDIAN ? "big" : "little",
|
|
format);
|
|
|
|
return buf;
|
|
}
|
|
EXPORT_SYMBOL(drm_get_format_name);
|
|
|
|
/**
|
|
* drm_fb_get_bpp_depth - get the bpp/depth values for format
|
|
* @format: pixel format (DRM_FORMAT_*)
|
|
* @depth: storage for the depth value
|
|
* @bpp: storage for the bpp value
|
|
*
|
|
* This only supports RGB formats here for compat with code that doesn't use
|
|
* pixel formats directly yet.
|
|
*/
|
|
void drm_fb_get_bpp_depth(uint32_t format, unsigned int *depth,
|
|
int *bpp)
|
|
{
|
|
switch (format) {
|
|
case DRM_FORMAT_C8:
|
|
case DRM_FORMAT_RGB332:
|
|
case DRM_FORMAT_BGR233:
|
|
*depth = 8;
|
|
*bpp = 8;
|
|
break;
|
|
case DRM_FORMAT_XRGB1555:
|
|
case DRM_FORMAT_XBGR1555:
|
|
case DRM_FORMAT_RGBX5551:
|
|
case DRM_FORMAT_BGRX5551:
|
|
case DRM_FORMAT_ARGB1555:
|
|
case DRM_FORMAT_ABGR1555:
|
|
case DRM_FORMAT_RGBA5551:
|
|
case DRM_FORMAT_BGRA5551:
|
|
*depth = 15;
|
|
*bpp = 16;
|
|
break;
|
|
case DRM_FORMAT_RGB565:
|
|
case DRM_FORMAT_BGR565:
|
|
*depth = 16;
|
|
*bpp = 16;
|
|
break;
|
|
case DRM_FORMAT_RGB888:
|
|
case DRM_FORMAT_BGR888:
|
|
*depth = 24;
|
|
*bpp = 24;
|
|
break;
|
|
case DRM_FORMAT_XRGB8888:
|
|
case DRM_FORMAT_XBGR8888:
|
|
case DRM_FORMAT_RGBX8888:
|
|
case DRM_FORMAT_BGRX8888:
|
|
*depth = 24;
|
|
*bpp = 32;
|
|
break;
|
|
case DRM_FORMAT_XRGB2101010:
|
|
case DRM_FORMAT_XBGR2101010:
|
|
case DRM_FORMAT_RGBX1010102:
|
|
case DRM_FORMAT_BGRX1010102:
|
|
case DRM_FORMAT_ARGB2101010:
|
|
case DRM_FORMAT_ABGR2101010:
|
|
case DRM_FORMAT_RGBA1010102:
|
|
case DRM_FORMAT_BGRA1010102:
|
|
*depth = 30;
|
|
*bpp = 32;
|
|
break;
|
|
case DRM_FORMAT_ARGB8888:
|
|
case DRM_FORMAT_ABGR8888:
|
|
case DRM_FORMAT_RGBA8888:
|
|
case DRM_FORMAT_BGRA8888:
|
|
*depth = 32;
|
|
*bpp = 32;
|
|
break;
|
|
default:
|
|
DRM_DEBUG_KMS("unsupported pixel format %s\n",
|
|
drm_get_format_name(format));
|
|
*depth = 0;
|
|
*bpp = 0;
|
|
break;
|
|
}
|
|
}
|
|
EXPORT_SYMBOL(drm_fb_get_bpp_depth);
|
|
|
|
/**
|
|
* drm_format_num_planes - get the number of planes for format
|
|
* @format: pixel format (DRM_FORMAT_*)
|
|
*
|
|
* Returns:
|
|
* The number of planes used by the specified pixel format.
|
|
*/
|
|
int drm_format_num_planes(uint32_t format)
|
|
{
|
|
switch (format) {
|
|
case DRM_FORMAT_YUV410:
|
|
case DRM_FORMAT_YVU410:
|
|
case DRM_FORMAT_YUV411:
|
|
case DRM_FORMAT_YVU411:
|
|
case DRM_FORMAT_YUV420:
|
|
case DRM_FORMAT_YVU420:
|
|
case DRM_FORMAT_YUV422:
|
|
case DRM_FORMAT_YVU422:
|
|
case DRM_FORMAT_YUV444:
|
|
case DRM_FORMAT_YVU444:
|
|
return 3;
|
|
case DRM_FORMAT_NV12:
|
|
case DRM_FORMAT_NV21:
|
|
case DRM_FORMAT_NV16:
|
|
case DRM_FORMAT_NV61:
|
|
case DRM_FORMAT_NV24:
|
|
case DRM_FORMAT_NV42:
|
|
return 2;
|
|
default:
|
|
return 1;
|
|
}
|
|
}
|
|
EXPORT_SYMBOL(drm_format_num_planes);
|
|
|
|
/**
|
|
* drm_format_plane_cpp - determine the bytes per pixel value
|
|
* @format: pixel format (DRM_FORMAT_*)
|
|
* @plane: plane index
|
|
*
|
|
* Returns:
|
|
* The bytes per pixel value for the specified plane.
|
|
*/
|
|
int drm_format_plane_cpp(uint32_t format, int plane)
|
|
{
|
|
unsigned int depth;
|
|
int bpp;
|
|
|
|
if (plane >= drm_format_num_planes(format))
|
|
return 0;
|
|
|
|
switch (format) {
|
|
case DRM_FORMAT_YUYV:
|
|
case DRM_FORMAT_YVYU:
|
|
case DRM_FORMAT_UYVY:
|
|
case DRM_FORMAT_VYUY:
|
|
return 2;
|
|
case DRM_FORMAT_NV12:
|
|
case DRM_FORMAT_NV21:
|
|
case DRM_FORMAT_NV16:
|
|
case DRM_FORMAT_NV61:
|
|
case DRM_FORMAT_NV24:
|
|
case DRM_FORMAT_NV42:
|
|
return plane ? 2 : 1;
|
|
case DRM_FORMAT_YUV410:
|
|
case DRM_FORMAT_YVU410:
|
|
case DRM_FORMAT_YUV411:
|
|
case DRM_FORMAT_YVU411:
|
|
case DRM_FORMAT_YUV420:
|
|
case DRM_FORMAT_YVU420:
|
|
case DRM_FORMAT_YUV422:
|
|
case DRM_FORMAT_YVU422:
|
|
case DRM_FORMAT_YUV444:
|
|
case DRM_FORMAT_YVU444:
|
|
return 1;
|
|
default:
|
|
drm_fb_get_bpp_depth(format, &depth, &bpp);
|
|
return bpp >> 3;
|
|
}
|
|
}
|
|
EXPORT_SYMBOL(drm_format_plane_cpp);
|
|
|
|
/**
|
|
* drm_format_horz_chroma_subsampling - get the horizontal chroma subsampling factor
|
|
* @format: pixel format (DRM_FORMAT_*)
|
|
*
|
|
* Returns:
|
|
* The horizontal chroma subsampling factor for the
|
|
* specified pixel format.
|
|
*/
|
|
int drm_format_horz_chroma_subsampling(uint32_t format)
|
|
{
|
|
switch (format) {
|
|
case DRM_FORMAT_YUV411:
|
|
case DRM_FORMAT_YVU411:
|
|
case DRM_FORMAT_YUV410:
|
|
case DRM_FORMAT_YVU410:
|
|
return 4;
|
|
case DRM_FORMAT_YUYV:
|
|
case DRM_FORMAT_YVYU:
|
|
case DRM_FORMAT_UYVY:
|
|
case DRM_FORMAT_VYUY:
|
|
case DRM_FORMAT_NV12:
|
|
case DRM_FORMAT_NV21:
|
|
case DRM_FORMAT_NV16:
|
|
case DRM_FORMAT_NV61:
|
|
case DRM_FORMAT_YUV422:
|
|
case DRM_FORMAT_YVU422:
|
|
case DRM_FORMAT_YUV420:
|
|
case DRM_FORMAT_YVU420:
|
|
return 2;
|
|
default:
|
|
return 1;
|
|
}
|
|
}
|
|
EXPORT_SYMBOL(drm_format_horz_chroma_subsampling);
|
|
|
|
/**
|
|
* drm_format_vert_chroma_subsampling - get the vertical chroma subsampling factor
|
|
* @format: pixel format (DRM_FORMAT_*)
|
|
*
|
|
* Returns:
|
|
* The vertical chroma subsampling factor for the
|
|
* specified pixel format.
|
|
*/
|
|
int drm_format_vert_chroma_subsampling(uint32_t format)
|
|
{
|
|
switch (format) {
|
|
case DRM_FORMAT_YUV410:
|
|
case DRM_FORMAT_YVU410:
|
|
return 4;
|
|
case DRM_FORMAT_YUV420:
|
|
case DRM_FORMAT_YVU420:
|
|
case DRM_FORMAT_NV12:
|
|
case DRM_FORMAT_NV21:
|
|
return 2;
|
|
default:
|
|
return 1;
|
|
}
|
|
}
|
|
EXPORT_SYMBOL(drm_format_vert_chroma_subsampling);
|
|
|
|
/**
|
|
* drm_format_plane_width - width of the plane given the first plane
|
|
* @width: width of the first plane
|
|
* @format: pixel format
|
|
* @plane: plane index
|
|
*
|
|
* Returns:
|
|
* The width of @plane, given that the width of the first plane is @width.
|
|
*/
|
|
int drm_format_plane_width(int width, uint32_t format, int plane)
|
|
{
|
|
if (plane >= drm_format_num_planes(format))
|
|
return 0;
|
|
|
|
if (plane == 0)
|
|
return width;
|
|
|
|
return width / drm_format_horz_chroma_subsampling(format);
|
|
}
|
|
EXPORT_SYMBOL(drm_format_plane_width);
|
|
|
|
/**
|
|
* drm_format_plane_height - height of the plane given the first plane
|
|
* @height: height of the first plane
|
|
* @format: pixel format
|
|
* @plane: plane index
|
|
*
|
|
* Returns:
|
|
* The height of @plane, given that the height of the first plane is @height.
|
|
*/
|
|
int drm_format_plane_height(int height, uint32_t format, int plane)
|
|
{
|
|
if (plane >= drm_format_num_planes(format))
|
|
return 0;
|
|
|
|
if (plane == 0)
|
|
return height;
|
|
|
|
return height / drm_format_vert_chroma_subsampling(format);
|
|
}
|
|
EXPORT_SYMBOL(drm_format_plane_height);
|