1 /*
2  * Copyright (c) 2016 Intel Corporation
3  *
4  * Permission to use, copy, modify, distribute, and sell this software and its
5  * documentation for any purpose is hereby granted without fee, provided that
6  * the above copyright notice appear in all copies and that both that copyright
7  * notice and this permission notice appear in supporting documentation, and
8  * that the name of the copyright holders not be used in advertising or
9  * publicity pertaining to distribution of the software without specific,
10  * written prior permission.  The copyright holders make no representations
11  * about the suitability of this software for any purpose.  It is provided "as
12  * is" without express or implied warranty.
13  *
14  * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
15  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
16  * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
17  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
18  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
19  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
20  * OF THIS SOFTWARE.
21  */
22 
23 #ifndef __DRM_COLOR_MGMT_H__
24 #define __DRM_COLOR_MGMT_H__
25 
26 #include <linux/ctype.h>
27 
28 struct drm_crtc;
29 struct drm_plane;
30 
31 uint32_t drm_color_lut_extract(uint32_t user_input, uint32_t bit_precision);
32 
33 void drm_crtc_enable_color_mgmt(struct drm_crtc *crtc,
34 				uint degamma_lut_size,
35 				bool has_ctm,
36 				uint gamma_lut_size);
37 
38 int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc,
39 				 int gamma_size);
40 
41 /**
42  * drm_color_lut_size - calculate the number of entries in the LUT
43  * @blob: blob containing the LUT
44  *
45  * Returns:
46  * The number of entries in the color LUT stored in @blob.
47  */
drm_color_lut_size(const struct drm_property_blob * blob)48 static inline int drm_color_lut_size(const struct drm_property_blob *blob)
49 {
50 	return blob->length / sizeof(struct drm_color_lut);
51 }
52 
53 enum drm_color_encoding {
54 	DRM_COLOR_YCBCR_BT601,
55 	DRM_COLOR_YCBCR_BT709,
56 	DRM_COLOR_YCBCR_BT2020,
57 	DRM_COLOR_ENCODING_MAX,
58 };
59 
60 enum drm_color_range {
61 	DRM_COLOR_YCBCR_LIMITED_RANGE,
62 	DRM_COLOR_YCBCR_FULL_RANGE,
63 	DRM_COLOR_RANGE_MAX,
64 };
65 
66 int drm_plane_create_color_properties(struct drm_plane *plane,
67 				      u32 supported_encodings,
68 				      u32 supported_ranges,
69 				      enum drm_color_encoding default_encoding,
70 				      enum drm_color_range default_range);
71 #endif
72