include/drm/drm_color_mgmt.h

   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  */
  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