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  * Extract a degamma/gamma LUT value provided by user and round it to the
  38  * precision supported by the hardware.
  39  */
  40 static inline uint32_t drm_color_lut_extract(uint32_t user_input,
  41                                              uint32_t bit_precision)
  42 {
  43         uint32_t val = user_input;
  44         uint32_t max = 0xffff >> (16 - bit_precision);
  45
  46         /* Round only if we're not using full precision. */
  47         if (bit_precision < 16) {
  48                 val += 1UL << (16 - bit_precision - 1);
  49                 val >>= 16 - bit_precision;
  50         }
  51
  52         return clamp_val(val, 0, max);
  53 }
  54
  55
  56 #endif