ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / src / kernels / 5.14.0-611.49.2.el9_7.x86_64 / include / drm

/*
 * Copyright (c) 2016 Intel Corporation
 *
 * Permission to use, copy, modify, distribute, and sell this software and its
 * documentation for any purpose is hereby granted without fee, provided that
 * the above copyright notice appear in all copies and that both that copyright
 * notice and this permission notice appear in supporting documentation, and
 * that the name of the copyright holders not be used in advertising or
 * publicity pertaining to distribution of the software without specific,
 * written prior permission.  The copyright holders make no representations
 * about the suitability of this software for any purpose.  It is provided "as
 * is" without express or implied warranty.
 *
 * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
 * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
 * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
 * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
 * OF THIS SOFTWARE.
 */

#ifndef __DRM_COLOR_MGMT_H__
#define __DRM_COLOR_MGMT_H__

#include <linux/ctype.h>
#include <linux/math64.h>
#include <drm/drm_property.h>

struct drm_crtc;
struct drm_plane;

/**
 * drm_color_lut_extract - clamp and round LUT entries
 * @user_input: input value
 * @bit_precision: number of bits the hw LUT supports
 *
 * Extract a degamma/gamma LUT value provided by user (in the form of
 * &drm_color_lut entries) and round it to the precision supported by the
 * hardware, following OpenGL int<->float conversion rules
 * (see eg. OpenGL 4.6 specification - 2.3.5 Fixed-Point Data Conversions).
 */
static inline u32 drm_color_lut_extract(u32 user_input, int bit_precision)
{
	if (bit_precision > 16)
		return DIV_ROUND_CLOSEST_ULL(mul_u32_u32(user_input, (1 << bit_precision) - 1),
					     (1 << 16) - 1);
	else
		return DIV_ROUND_CLOSEST(user_input * ((1 << bit_precision) - 1),
					 (1 << 16) - 1);
}

u64 drm_color_ctm_s31_32_to_qm_n(u64 user_input, u32 m, u32 n);

void drm_crtc_enable_color_mgmt(struct drm_crtc *crtc,
				uint degamma_lut_size,
				bool has_ctm,
				uint gamma_lut_size);

int drm_mode_crtc_set_gamma_size(struct drm_crtc *crtc,
				 int gamma_size);

/**
 * drm_color_lut_size - calculate the number of entries in the LUT
 * @blob: blob containing the LUT
 *
 * Returns:
 * The number of entries in the color LUT stored in @blob.
 */
static inline int drm_color_lut_size(const struct drm_property_blob *blob)
{
	return blob->length / sizeof(struct drm_color_lut);
}

enum drm_color_encoding {
	DRM_COLOR_YCBCR_BT601,
	DRM_COLOR_YCBCR_BT709,
	DRM_COLOR_YCBCR_BT2020,
	DRM_COLOR_ENCODING_MAX,
};

enum drm_color_range {
	DRM_COLOR_YCBCR_LIMITED_RANGE,
	DRM_COLOR_YCBCR_FULL_RANGE,
	DRM_COLOR_RANGE_MAX,
};

int drm_plane_create_color_properties(struct drm_plane *plane,
				      u32 supported_encodings,
				      u32 supported_ranges,
				      enum drm_color_encoding default_encoding,
				      enum drm_color_range default_range);

/**
 * enum drm_color_lut_tests - hw-specific LUT tests to perform
 *
 * The drm_color_lut_check() function takes a bitmask of the values here to
 * determine which tests to apply to a userspace-provided LUT.
 */
enum drm_color_lut_tests {
	/**
	 * @DRM_COLOR_LUT_EQUAL_CHANNELS:
	 *
	 * Checks whether the entries of a LUT all have equal values for the
	 * red, green, and blue channels.  Intended for hardware that only
	 * accepts a single value per LUT entry and assumes that value applies
	 * to all three color components.
	 */
	DRM_COLOR_LUT_EQUAL_CHANNELS = BIT(0),

/**
	 * @DRM_COLOR_LUT_NON_DECREASING:
	 *
	 * Checks whether the entries of a LUT are always flat or increasing
	 * (never decreasing).
	 */
	DRM_COLOR_LUT_NON_DECREASING = BIT(1),
};

int drm_color_lut_check(const struct drm_property_blob *lut, u32 tests);
#endif

[-] drm_eld.h [edit]
[-] drm_bridge.h [edit]
[-] spsc_queue.h [edit]
[-] drm_gem_dma_helper.h [edit]
[-] drm_property.h [edit]
[-] drm_auth.h [edit]
[-] drm_mipi_dbi.h [edit]
[-] drm_mode_object.h [edit]
[-] drm_pciids.h [edit]
[+] ttm
[-] drm_privacy_screen_machine.h [edit]
[-] drm_fixed.h [edit]
[-] drm_fb_helper.h [edit]
[-] drm_gem_ttm_helper.h [edit]
[-] drm_pagemap.h [edit]
[-] drm_atomic_uapi.h [edit]
[-] drm_module.h [edit]
[+] display
[-] drm_encoder.h [edit]
[-] drm_file.h [edit]
[-] drm_connector.h [edit]
[-] drm_utils.h [edit]
[-] drm_suballoc.h [edit]
[+] intel
[-] drm_audio_component.h [edit]
[-] drm_prime.h [edit]
[-] drm_atomic_helper.h [edit]
[-] i915_pciids.h [edit]
[-] drm_mipi_dsi.h [edit]
[-] drm_writeback.h [edit]
[-] drm_gem_framebuffer_helper.h [edit]
[-] drm_lease.h [edit]
[-] drm_crtc_helper.h [edit]
[-] drm_client.h [edit]
[-] Makefile [edit]
[-] drm_vblank.h [edit]
[-] drm_format_helper.h [edit]
[-] drm_fb_dma_helper.h [edit]
[-] drm_mode_config.h [edit]
[-] drm_debugfs.h [edit]
[-] drm_print.h [edit]
[-] drm_client_event.h [edit]
[-] drm_panel.h [edit]
[-] drm_gem_shmem_helper.h [edit]
[-] drm_debugfs_crc.h [edit]
[-] drm_cache.h [edit]
[-] drm_sysfs.h [edit]
[+] clients
[-] drm_edid.h [edit]
[-] drm_modeset_helper.h [edit]
[-] drm_atomic_state_helper.h [edit]
[-] drm_ioctl.h [edit]
[-] drm_blend.h [edit]
[-] drm_gem_vram_helper.h [edit]
[-] drm_panic.h [edit]
[-] drm_plane_helper.h [edit]
[-] drm_fbdev_dma.h [edit]
[-] drm_bridge_connector.h [edit]
[-] drm_probe_helper.h [edit]
[-] drm_modeset_helper_vtables.h [edit]
[-] drm_device.h [edit]
[-] drm_exec.h [edit]
[-] drm_atomic.h [edit]
[-] gud.h [edit]
[-] drm_gem.h [edit]
[-] drm_gpuvm.h [edit]
[-] drm_mm.h [edit]
[-] drm_plane.h [edit]
[-] drm_gpusvm.h [edit]
[-] drm_simple_kms_helper.h [edit]
[-] drm_syncobj.h [edit]
[-] drm_gem_atomic_helper.h [edit]
[-] drm_fbdev_shmem.h [edit]
[-] drm_framebuffer.h [edit]
[-] drm_accel.h [edit]
[-] drm_self_refresh_helper.h [edit]
[-] amd_asic_type.h [edit]
[-] drm_privacy_screen_consumer.h [edit]
[-] gpu_scheduler.h [edit]
[-] drm_fbdev_ttm.h [edit]
[-] drm_managed.h [edit]
[-] task_barrier.h [edit]
[-] drm_fourcc.h [edit]
[-] drm_vblank_work.h [edit]
[-] drm_modes.h [edit]
[-] drm_vma_manager.h [edit]
[-] drm_buddy.h [edit]
[-] drm_of.h [edit]
[+] ..
[+] bridge
[-] drm_modeset_lock.h [edit]
[-] drm_rect.h [edit]
[-] drm_flip_work.h [edit]
[-] drm_util.h [edit]
[-] drm_damage_helper.h [edit]
[-] drm_drv.h [edit]
[-] drm_kunit_helpers.h [edit]
[-] drm_color_mgmt.h [edit]
[-] drm_crtc.h [edit]
[-] drm_privacy_screen_driver.h [edit]