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> 27b88ac005SDaniel Vetter #include <drm/drm_property.h> 28f1e2f66cSDaniel Vetter 29d1841d32SJyri Sarha struct drm_crtc; 3080f690e9SJyri Sarha struct drm_plane; 31d1841d32SJyri Sarha 328f2e045eSJani Nikula uint32_t drm_color_lut_extract(uint32_t user_input, uint32_t bit_precision); 338f2e045eSJani Nikula 34f1e2f66cSDaniel Vetter void drm_crtc_enable_color_mgmt(struct drm_crtc *crtc, 35f1e2f66cSDaniel Vetter uint degamma_lut_size, 36f1e2f66cSDaniel Vetter bool has_ctm, 37f1e2f66cSDaniel Vetter uint gamma_lut_size); 38f1e2f66cSDaniel Vetter 39f1e2f66cSDaniel Vetter int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc, 40f1e2f66cSDaniel Vetter int gamma_size); 41f1e2f66cSDaniel Vetter 4241204dfeSVille Syrjälä /** 4341204dfeSVille Syrjälä * drm_color_lut_size - calculate the number of entries in the LUT 4441204dfeSVille Syrjälä * @blob: blob containing the LUT 4541204dfeSVille Syrjälä * 4641204dfeSVille Syrjälä * Returns: 4741204dfeSVille Syrjälä * The number of entries in the color LUT stored in @blob. 4841204dfeSVille Syrjälä */ 4941204dfeSVille Syrjälä static inline int drm_color_lut_size(const struct drm_property_blob *blob) 5041204dfeSVille Syrjälä { 5141204dfeSVille Syrjälä return blob->length / sizeof(struct drm_color_lut); 5241204dfeSVille Syrjälä } 5341204dfeSVille Syrjälä 5480f690e9SJyri Sarha enum drm_color_encoding { 5580f690e9SJyri Sarha DRM_COLOR_YCBCR_BT601, 5680f690e9SJyri Sarha DRM_COLOR_YCBCR_BT709, 5780f690e9SJyri Sarha DRM_COLOR_YCBCR_BT2020, 5880f690e9SJyri Sarha DRM_COLOR_ENCODING_MAX, 5980f690e9SJyri Sarha }; 6080f690e9SJyri Sarha 6180f690e9SJyri Sarha enum drm_color_range { 6280f690e9SJyri Sarha DRM_COLOR_YCBCR_LIMITED_RANGE, 6380f690e9SJyri Sarha DRM_COLOR_YCBCR_FULL_RANGE, 6480f690e9SJyri Sarha DRM_COLOR_RANGE_MAX, 6580f690e9SJyri Sarha }; 6680f690e9SJyri Sarha 6780f690e9SJyri Sarha int drm_plane_create_color_properties(struct drm_plane *plane, 6880f690e9SJyri Sarha u32 supported_encodings, 6980f690e9SJyri Sarha u32 supported_ranges, 7080f690e9SJyri Sarha enum drm_color_encoding default_encoding, 7180f690e9SJyri Sarha enum drm_color_range default_range); 723c8861d8SMatt Roper 733c8861d8SMatt Roper /** 743c8861d8SMatt Roper * enum drm_color_lut_tests - hw-specific LUT tests to perform 753c8861d8SMatt Roper * 763c8861d8SMatt Roper * The drm_color_lut_check() function takes a bitmask of the values here to 773c8861d8SMatt Roper * determine which tests to apply to a userspace-provided LUT. 783c8861d8SMatt Roper */ 793c8861d8SMatt Roper enum drm_color_lut_tests { 803c8861d8SMatt Roper /** 813c8861d8SMatt Roper * @DRM_COLOR_LUT_EQUAL_CHANNELS: 823c8861d8SMatt Roper * 833c8861d8SMatt Roper * Checks whether the entries of a LUT all have equal values for the 843c8861d8SMatt Roper * red, green, and blue channels. Intended for hardware that only 853c8861d8SMatt Roper * accepts a single value per LUT entry and assumes that value applies 863c8861d8SMatt Roper * to all three color components. 873c8861d8SMatt Roper */ 883c8861d8SMatt Roper DRM_COLOR_LUT_EQUAL_CHANNELS = BIT(0), 893c8861d8SMatt Roper 903c8861d8SMatt Roper /** 913c8861d8SMatt Roper * @DRM_COLOR_LUT_NON_DECREASING: 923c8861d8SMatt Roper * 933c8861d8SMatt Roper * Checks whether the entries of a LUT are always flat or increasing 943c8861d8SMatt Roper * (never decreasing). 953c8861d8SMatt Roper */ 963c8861d8SMatt Roper DRM_COLOR_LUT_NON_DECREASING = BIT(1), 973c8861d8SMatt Roper }; 983c8861d8SMatt Roper 993c8861d8SMatt Roper int drm_color_lut_check(struct drm_property_blob *lut, 1003c8861d8SMatt Roper uint32_t tests); 101f1e2f66cSDaniel Vetter #endif 102