1 /* 2 * Copyright 2012-15 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 __DAL_TRANSFORM_H__ 27 #define __DAL_TRANSFORM_H__ 28 29 #include "hw_shared.h" 30 #include "dc_hw_types.h" 31 #include "fixed31_32.h" 32 33 #define CSC_TEMPERATURE_MATRIX_SIZE 12 34 35 struct bit_depth_reduction_params; 36 37 struct transform { 38 const struct transform_funcs *funcs; 39 struct dc_context *ctx; 40 int inst; 41 struct dpp_caps *caps; 42 struct pwl_params regamma_params; 43 }; 44 45 /* Colorimetry */ 46 enum colorimetry { 47 COLORIMETRY_NO_DATA = 0, 48 COLORIMETRY_ITU601 = 1, 49 COLORIMETRY_ITU709 = 2, 50 COLORIMETRY_EXTENDED = 3 51 }; 52 53 enum colorimetry_ext { 54 COLORIMETRYEX_XVYCC601 = 0, 55 COLORIMETRYEX_XVYCC709 = 1, 56 COLORIMETRYEX_SYCC601 = 2, 57 COLORIMETRYEX_ADOBEYCC601 = 3, 58 COLORIMETRYEX_ADOBERGB = 4, 59 COLORIMETRYEX_BT2020YCC = 5, 60 COLORIMETRYEX_BT2020RGBYCBCR = 6, 61 COLORIMETRYEX_RESERVED = 7 62 }; 63 64 enum active_format_info { 65 ACTIVE_FORMAT_NO_DATA = 0, 66 ACTIVE_FORMAT_VALID = 1 67 }; 68 69 /* Active format aspect ratio */ 70 enum active_format_aspect_ratio { 71 ACTIVE_FORMAT_ASPECT_RATIO_SAME_AS_PICTURE = 8, 72 ACTIVE_FORMAT_ASPECT_RATIO_4_3 = 9, 73 ACTIVE_FORMAT_ASPECT_RATIO_16_9 = 0XA, 74 ACTIVE_FORMAT_ASPECT_RATIO_14_9 = 0XB 75 }; 76 77 enum bar_info { 78 BAR_INFO_NOT_VALID = 0, 79 BAR_INFO_VERTICAL_VALID = 1, 80 BAR_INFO_HORIZONTAL_VALID = 2, 81 BAR_INFO_BOTH_VALID = 3 82 }; 83 84 enum picture_scaling { 85 PICTURE_SCALING_UNIFORM = 0, 86 PICTURE_SCALING_HORIZONTAL = 1, 87 PICTURE_SCALING_VERTICAL = 2, 88 PICTURE_SCALING_BOTH = 3 89 }; 90 91 /* RGB quantization range */ 92 enum rgb_quantization_range { 93 RGB_QUANTIZATION_DEFAULT_RANGE = 0, 94 RGB_QUANTIZATION_LIMITED_RANGE = 1, 95 RGB_QUANTIZATION_FULL_RANGE = 2, 96 RGB_QUANTIZATION_RESERVED = 3 97 }; 98 99 /* YYC quantization range */ 100 enum yyc_quantization_range { 101 YYC_QUANTIZATION_LIMITED_RANGE = 0, 102 YYC_QUANTIZATION_FULL_RANGE = 1, 103 YYC_QUANTIZATION_RESERVED2 = 2, 104 YYC_QUANTIZATION_RESERVED3 = 3 105 }; 106 107 enum graphics_gamut_adjust_type { 108 GRAPHICS_GAMUT_ADJUST_TYPE_BYPASS = 0, 109 GRAPHICS_GAMUT_ADJUST_TYPE_HW, /* without adjustments */ 110 GRAPHICS_GAMUT_ADJUST_TYPE_SW /* use adjustments */ 111 }; 112 113 enum lb_memory_config { 114 /* Enable all 3 pieces of memory */ 115 LB_MEMORY_CONFIG_0 = 0, 116 117 /* Enable only the first piece of memory */ 118 LB_MEMORY_CONFIG_1 = 1, 119 120 /* Enable only the second piece of memory */ 121 LB_MEMORY_CONFIG_2 = 2, 122 123 /* Only applicable in 4:2:0 mode, enable all 3 pieces of memory and the 124 * last piece of chroma memory used for the luma storage 125 */ 126 LB_MEMORY_CONFIG_3 = 3 127 }; 128 129 struct xfm_grph_csc_adjustment { 130 struct fixed31_32 temperature_matrix[CSC_TEMPERATURE_MATRIX_SIZE]; 131 enum graphics_gamut_adjust_type gamut_adjust_type; 132 }; 133 134 struct overscan_info { 135 int left; 136 int right; 137 int top; 138 int bottom; 139 }; 140 141 struct scaling_ratios { 142 struct fixed31_32 horz; 143 struct fixed31_32 vert; 144 struct fixed31_32 horz_c; 145 struct fixed31_32 vert_c; 146 }; 147 148 struct sharpness_adj { 149 int horz; 150 int vert; 151 }; 152 153 struct line_buffer_params { 154 bool alpha_en; 155 bool pixel_expan_mode; 156 bool interleave_en; 157 int dynamic_pixel_depth; 158 enum lb_pixel_depth depth; 159 }; 160 161 struct scl_inits { 162 struct fixed31_32 h; 163 struct fixed31_32 h_c; 164 struct fixed31_32 v; 165 struct fixed31_32 v_bot; 166 struct fixed31_32 v_c; 167 struct fixed31_32 v_c_bot; 168 }; 169 170 struct scaler_data { 171 int h_active; 172 int v_active; 173 struct scaling_taps taps; 174 struct rect viewport; 175 struct rect viewport_c; 176 struct rect viewport_unadjusted; 177 struct rect viewport_c_unadjusted; 178 struct rect recout; 179 struct scaling_ratios ratios; 180 struct scl_inits inits; 181 struct sharpness_adj sharpness; 182 enum pixel_format format; 183 struct line_buffer_params lb_params; 184 }; 185 186 struct transform_funcs { 187 void (*transform_reset)(struct transform *xfm); 188 189 void (*transform_set_scaler)(struct transform *xfm, 190 const struct scaler_data *scl_data); 191 192 void (*transform_set_pixel_storage_depth)( 193 struct transform *xfm, 194 enum lb_pixel_depth depth, 195 const struct bit_depth_reduction_params *bit_depth_params); 196 197 bool (*transform_get_optimal_number_of_taps)( 198 struct transform *xfm, 199 struct scaler_data *scl_data, 200 const struct scaling_taps *in_taps); 201 202 void (*transform_set_gamut_remap)( 203 struct transform *xfm, 204 const struct xfm_grph_csc_adjustment *adjust); 205 206 void (*opp_set_csc_default)( 207 struct transform *xfm, 208 const struct default_adjustment *default_adjust); 209 210 void (*opp_set_csc_adjustment)( 211 struct transform *xfm, 212 const struct out_csc_color_matrix *tbl_entry); 213 214 void (*opp_power_on_regamma_lut)( 215 struct transform *xfm, 216 bool power_on); 217 218 void (*opp_program_regamma_lut)( 219 struct transform *xfm, 220 const struct pwl_result_data *rgb, 221 uint32_t num); 222 223 void (*opp_configure_regamma_lut)( 224 struct transform *xfm, 225 bool is_ram_a); 226 227 void (*opp_program_regamma_lutb_settings)( 228 struct transform *xfm, 229 const struct pwl_params *params); 230 231 void (*opp_program_regamma_luta_settings)( 232 struct transform *xfm, 233 const struct pwl_params *params); 234 235 void (*opp_program_regamma_pwl)( 236 struct transform *xfm, const struct pwl_params *params); 237 238 void (*opp_set_regamma_mode)( 239 struct transform *xfm_base, 240 enum opp_regamma mode); 241 242 void (*ipp_set_degamma)( 243 struct transform *xfm_base, 244 enum ipp_degamma_mode mode); 245 246 void (*ipp_program_input_lut)( 247 struct transform *xfm_base, 248 const struct dc_gamma *gamma); 249 250 void (*ipp_program_degamma_pwl)(struct transform *xfm_base, 251 const struct pwl_params *params); 252 253 void (*ipp_setup)( 254 struct transform *xfm_base, 255 enum surface_pixel_format format, 256 enum expansion_mode mode, 257 struct dc_csc_transform input_csc_color_matrix, 258 enum dc_color_space input_color_space); 259 260 void (*ipp_full_bypass)(struct transform *xfm_base); 261 262 void (*set_cursor_attributes)( 263 struct transform *xfm_base, 264 const struct dc_cursor_attributes *attr); 265 266 }; 267 268 const uint16_t *get_filter_2tap_16p(void); 269 const uint16_t *get_filter_2tap_64p(void); 270 const uint16_t *get_filter_3tap_16p(struct fixed31_32 ratio); 271 const uint16_t *get_filter_3tap_64p(struct fixed31_32 ratio); 272 const uint16_t *get_filter_4tap_16p(struct fixed31_32 ratio); 273 const uint16_t *get_filter_4tap_64p(struct fixed31_32 ratio); 274 const uint16_t *get_filter_5tap_64p(struct fixed31_32 ratio); 275 const uint16_t *get_filter_6tap_64p(struct fixed31_32 ratio); 276 const uint16_t *get_filter_7tap_64p(struct fixed31_32 ratio); 277 const uint16_t *get_filter_8tap_64p(struct fixed31_32 ratio); 278 279 280 /* Defines the pixel processing capability of the DSCL */ 281 enum dscl_data_processing_format { 282 DSCL_DATA_PRCESSING_FIXED_FORMAT, /* The DSCL processes pixel data in fixed format */ 283 DSCL_DATA_PRCESSING_FLOAT_FORMAT, /* The DSCL processes pixel data in float format */ 284 }; 285 286 /* 287 * The DPP capabilities structure contains enumerations to specify the 288 * HW processing features and an associated function pointers to 289 * provide the function interface that can be overloaded for implementations 290 * based on different capabilities 291 */ 292 struct dpp_caps { 293 /* DSCL processing pixel data in fixed or float format */ 294 enum dscl_data_processing_format dscl_data_proc_format; 295 296 /* Calculates the number of partitions in the line buffer. 297 * The implementation of this function is overloaded for 298 * different versions of DSCL LB. 299 */ 300 void (*dscl_calc_lb_num_partitions)( 301 const struct scaler_data *scl_data, 302 enum lb_memory_config lb_config, 303 int *num_part_y, 304 int *num_part_c); 305 }; 306 307 308 #endif 309