xref: /openbmc/linux/include/drm/drm_color_mgmt.h (revision 41204dfe)
1f1e2f66cSDaniel Vetter /*
2f1e2f66cSDaniel Vetter  * Copyright (c) 2016 Intel Corporation
3f1e2f66cSDaniel Vetter  *
4f1e2f66cSDaniel Vetter  * Permission to use, copy, modify, distribute, and sell this software and its
5f1e2f66cSDaniel Vetter  * documentation for any purpose is hereby granted without fee, provided that
6f1e2f66cSDaniel Vetter  * the above copyright notice appear in all copies and that both that copyright
7f1e2f66cSDaniel Vetter  * notice and this permission notice appear in supporting documentation, and
8f1e2f66cSDaniel Vetter  * that the name of the copyright holders not be used in advertising or
9f1e2f66cSDaniel Vetter  * publicity pertaining to distribution of the software without specific,
10f1e2f66cSDaniel Vetter  * written prior permission.  The copyright holders make no representations
11f1e2f66cSDaniel Vetter  * about the suitability of this software for any purpose.  It is provided "as
12f1e2f66cSDaniel Vetter  * is" without express or implied warranty.
13f1e2f66cSDaniel Vetter  *
14f1e2f66cSDaniel Vetter  * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
15f1e2f66cSDaniel Vetter  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
16f1e2f66cSDaniel Vetter  * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
17f1e2f66cSDaniel Vetter  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
18f1e2f66cSDaniel Vetter  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
19f1e2f66cSDaniel Vetter  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
20f1e2f66cSDaniel Vetter  * OF THIS SOFTWARE.
21f1e2f66cSDaniel Vetter  */
22f1e2f66cSDaniel Vetter 
23f1e2f66cSDaniel Vetter #ifndef __DRM_COLOR_MGMT_H__
24f1e2f66cSDaniel Vetter #define __DRM_COLOR_MGMT_H__
25f1e2f66cSDaniel Vetter 
26f1e2f66cSDaniel Vetter #include <linux/ctype.h>
27f1e2f66cSDaniel Vetter 
28d1841d32SJyri Sarha struct drm_crtc;
2980f690e9SJyri Sarha struct drm_plane;
30d1841d32SJyri Sarha 
318f2e045eSJani Nikula uint32_t drm_color_lut_extract(uint32_t user_input, uint32_t bit_precision);
328f2e045eSJani Nikula 
33f1e2f66cSDaniel Vetter void drm_crtc_enable_color_mgmt(struct drm_crtc *crtc,
34f1e2f66cSDaniel Vetter 				uint degamma_lut_size,
35f1e2f66cSDaniel Vetter 				bool has_ctm,
36f1e2f66cSDaniel Vetter 				uint gamma_lut_size);
37f1e2f66cSDaniel Vetter 
38f1e2f66cSDaniel Vetter int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc,
39f1e2f66cSDaniel Vetter 				 int gamma_size);
40f1e2f66cSDaniel Vetter 
4141204dfeSVille Syrjälä /**
4241204dfeSVille Syrjälä  * drm_color_lut_size - calculate the number of entries in the LUT
4341204dfeSVille Syrjälä  * @blob: blob containing the LUT
4441204dfeSVille Syrjälä  *
4541204dfeSVille Syrjälä  * Returns:
4641204dfeSVille Syrjälä  * The number of entries in the color LUT stored in @blob.
4741204dfeSVille Syrjälä  */
4841204dfeSVille Syrjälä static inline int drm_color_lut_size(const struct drm_property_blob *blob)
4941204dfeSVille Syrjälä {
5041204dfeSVille Syrjälä 	return blob->length / sizeof(struct drm_color_lut);
5141204dfeSVille Syrjälä }
5241204dfeSVille Syrjälä 
5380f690e9SJyri Sarha enum drm_color_encoding {
5480f690e9SJyri Sarha 	DRM_COLOR_YCBCR_BT601,
5580f690e9SJyri Sarha 	DRM_COLOR_YCBCR_BT709,
5680f690e9SJyri Sarha 	DRM_COLOR_YCBCR_BT2020,
5780f690e9SJyri Sarha 	DRM_COLOR_ENCODING_MAX,
5880f690e9SJyri Sarha };
5980f690e9SJyri Sarha 
6080f690e9SJyri Sarha enum drm_color_range {
6180f690e9SJyri Sarha 	DRM_COLOR_YCBCR_LIMITED_RANGE,
6280f690e9SJyri Sarha 	DRM_COLOR_YCBCR_FULL_RANGE,
6380f690e9SJyri Sarha 	DRM_COLOR_RANGE_MAX,
6480f690e9SJyri Sarha };
6580f690e9SJyri Sarha 
6680f690e9SJyri Sarha int drm_plane_create_color_properties(struct drm_plane *plane,
6780f690e9SJyri Sarha 				      u32 supported_encodings,
6880f690e9SJyri Sarha 				      u32 supported_ranges,
6980f690e9SJyri Sarha 				      enum drm_color_encoding default_encoding,
7080f690e9SJyri Sarha 				      enum drm_color_range default_range);
71f1e2f66cSDaniel Vetter #endif
72