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 void drm_crtc_enable_color_mgmt(struct drm_crtc *crtc,
  29                                 uint degamma_lut_size,
  30                                 bool has_ctm,
  31                                 uint gamma_lut_size);
  32
  33 int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc,
  34                                  int gamma_size);
  35
  36 /**
  37  * drm_color_lut_extract - clamp&round LUT entries
  38  * @user_input: input value
  39  * @bit_precision: number of bits the hw LUT supports
  40  *
  41  * Extract a degamma/gamma LUT value provided by user (in the form of
  42  * &drm_color_lut entries) and round it to the precision supported by the
  43  * hardware.
  44  */
  45 static inline uint32_t drm_color_lut_extract(uint32_t user_input,
  46                                              uint32_t bit_precision)
  47 {
  48         uint32_t val = user_input;
  49         uint32_t max = 0xffff >> (16 - bit_precision);
  50
  51         /* Round only if we're not using full precision. */
  52         if (bit_precision < 16) {
  53                 val += 1UL << (16 - bit_precision - 1);
  54                 val >>= 16 - bit_precision;
  55         }
  56
  57         return clamp_val(val, 0, max);
  58 }
  59
  60
  61 #endif