1 /*
2 * Copyright 2016 Advanced Micro Devices, Inc.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 * OTHER DEALINGS IN THE SOFTWARE.
21 *
22 * Authors: AMD
23 *
24 */
25
26 #ifndef COLOR_MOD_COLOR_GAMMA_H_
27 #define COLOR_MOD_COLOR_GAMMA_H_
28
29 struct dc_transfer_func;
30 struct dc_gamma;
31 struct dc_transfer_func_distributed_points;
32 struct dc_rgb_fixed;
33 enum dc_transfer_func_predefined;
34
35 /* For SetRegamma ADL interface support
36 * Must match escape type
37 */
38 union regamma_flags {
39 unsigned int raw;
40 struct {
41 unsigned int gammaRampArray :1; // RegammaRamp is in use
42 unsigned int gammaFromEdid :1; //gamma from edid is in use
43 unsigned int gammaFromEdidEx :1; //gamma from edid is in use , but only for Display Id 1.2
44 unsigned int gammaFromUser :1; //user custom gamma is used
45 unsigned int coeffFromUser :1; //coeff. A0-A3 from user is in use
46 unsigned int coeffFromEdid :1; //coeff. A0-A3 from edid is in use
47 unsigned int applyDegamma :1; //flag for additional degamma correction in driver
48 unsigned int gammaPredefinedSRGB :1; //flag for SRGB gamma
49 unsigned int gammaPredefinedPQ :1; //flag for PQ gamma
50 unsigned int gammaPredefinedPQ2084Interim :1; //flag for PQ gamma, lower max nits
51 unsigned int gammaPredefined36 :1; //flag for 3.6 gamma
52 unsigned int gammaPredefinedReset :1; //flag to return to previous gamma
53 } bits;
54 };
55
56 struct regamma_ramp {
57 unsigned short gamma[256*3]; // gamma ramp packed in same way as OS windows ,r , g & b
58 };
59
60 struct regamma_coeff {
61 int gamma[3];
62 int A0[3];
63 int A1[3];
64 int A2[3];
65 int A3[3];
66 };
67
68 struct regamma_lut {
69 union regamma_flags flags;
70 union {
71 struct regamma_ramp ramp;
72 struct regamma_coeff coeff;
73 };
74 };
75
76 struct freesync_hdr_tf_params {
77 unsigned int sdr_white_level;
78 unsigned int min_content; // luminance in 1/10000 nits
79 unsigned int max_content; // luminance in nits
80 unsigned int min_display; // luminance in 1/10000 nits
81 unsigned int max_display; // luminance in nits
82 unsigned int skip_tm; // skip tm
83 };
84
85 struct translate_from_linear_space_args {
86 struct fixed31_32 arg;
87 struct fixed31_32 a0;
88 struct fixed31_32 a1;
89 struct fixed31_32 a2;
90 struct fixed31_32 a3;
91 struct fixed31_32 gamma;
92 };
93
94 void setup_x_points_distribution(void);
95 void log_x_points_distribution(struct dal_logger *logger);
96 void precompute_pq(void);
97 void precompute_de_pq(void);
98
99 bool mod_color_calculate_regamma_params(struct dc_transfer_func *output_tf,
100 const struct dc_gamma *ramp, bool mapUserRamp, bool canRomBeUsed,
101 const struct freesync_hdr_tf_params *fs_params);
102
103 bool mod_color_calculate_degamma_params(struct dc_transfer_func *output_tf,
104 const struct dc_gamma *ramp, bool mapUserRamp);
105
106 bool mod_color_calculate_curve(enum dc_transfer_func_predefined trans,
107 struct dc_transfer_func_distributed_points *points,
108 uint32_t sdr_ref_white_level);
109
110 bool mod_color_calculate_degamma_curve(enum dc_transfer_func_predefined trans,
111 struct dc_transfer_func_distributed_points *points);
112
113 bool calculate_user_regamma_coeff(struct dc_transfer_func *output_tf,
114 const struct regamma_lut *regamma);
115
116 bool calculate_user_regamma_ramp(struct dc_transfer_func *output_tf,
117 const struct regamma_lut *regamma);
118
119
120 #endif /* COLOR_MOD_COLOR_GAMMA_H_ */