mirror of
				https://github.com/torvalds/linux.git
				synced 2025-11-04 02:30:34 +02:00 
			
		
		
		
	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);
 |