diff options
Diffstat (limited to 'include/ia_imaging/ia_isp_2_2.h')
| -rw-r--r-- | include/ia_imaging/ia_isp_2_2.h | 161 |
1 files changed, 161 insertions, 0 deletions
diff --git a/include/ia_imaging/ia_isp_2_2.h b/include/ia_imaging/ia_isp_2_2.h new file mode 100644 index 0000000..2ac7d5f --- /dev/null +++ b/include/ia_imaging/ia_isp_2_2.h @@ -0,0 +1,161 @@ +/* + * Copyright (C) 2015 - 2017 Intel Corporation. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +/*! + * \file ia_isp_2_2.h + * \brief Hive ISP 2.2 specific implementation. +*/ + + +#ifndef IA_ISP_2_2_H_ +#define IA_ISP_2_2_H_ + +#include "ia_mkn_types.h" +#include "ia_types.h" +#include "ia_aiq_types.h" +#include "ia_isp_types.h" +#include "ia_cmc_types.h" + +#ifdef __cplusplus +extern "C" { +#endif + +typedef struct ia_isp_t ia_isp; + +/*! + * \brief Initialize IA_ISP and its submodules. + * This function must be called before any other function in the library. It allocates memories and parses ISP specific parts from CPFF. + * Initialization returns a handle to the ISP instance, which is given as input parameter for all the + * ISP functions. + * + * \param[in] aiqb_data Mandatory although function will not return error, if it not given.\n + * ISP Block from CPFF. Contains ISP specific parameters for ISP 1.5. + * \param[in] stats_max_width Mandatory.\n + * Maximum width of RGBS and AF statistics grids from ISP. Used to calculate size of + * memory buffers for the IA_AIQ algorithms. The same maximum width will be used for all RGBS + * and AF statistics grid allocations. + * \param[in] stats_max_height Mandatory.\n + * Maximum height of RGBS and AF statistics grids from ISP. Used to calculate size of + * memory buffers for the IA_AIQ algorithms. The same maximum height will be used for all RGBS + * and AF statistics grid allocations. + * \param[in] ia_cmc Mandatory.\n + * Parsed camera module characterization structure. Essential parts of the structure will be copied + * into internal structure. + * \param[in,out] ia_mkn Optional.\n + * Makernote handle which can be initialized with ia_mkn library. If debug data from AIQ is needed + * to be stored into EXIF, this parameter is needed. Algorithms will update records inside this makernote instance. + * Client writes the data into Makernote section in EXIF. + * return IA_AIQ handle. Use the returned handle as input parameter for the consequent IA_AIQ calls. + */ +LIBEXPORT ia_isp* +ia_isp_2_2_init(const ia_binary_data *aiqb_data, + unsigned int stats_max_width, + unsigned int stats_max_height, + ia_cmc_t *ia_cmc, + ia_mkn *ia_mkn); + +/*! + * \brief De-initialize IA_ISP. + * All memory allocated by ISP are freed. ISP handle can no longer be used. + * + * \param[in] ia_isp Mandatory.\n + * ISP instance handle. + */ +LIBEXPORT void +ia_isp_2_2_deinit(ia_isp *ia_isp); + +/*! + * \brief Input parameter structure for ISP. + */ +typedef struct +{ + ia_aiq_frame_use frame_use; /*!< Mandatory. Target frame type of the AIC calculations (Preview, Still, video etc.). */ + ia_aiq_frame_params *sensor_frame_params; /*!< Mandatory. Sensor frame parameters. Describe frame scaling/cropping done in sensor. */ + ia_aiq_exposure_parameters *exposure_results; /*!< Mandatory. Exposure parameters which are to be used to calculate next ISP parameters. */ + ia_aiq_awb_results *awb_results; /*!< Mandatory. WB results which are to be used to calculate next ISP parameters (WB gains, color matrix,etc). */ + ia_aiq_gbce_results *gbce_results; /*!< Mandatory. GBCE Gamma tables which are to be used to calculate next ISP parameters. + If NULL pointer is passed, AIC will use static gamma table from the CPF. */ + ia_aiq_pa_results *pa_results; /*!< Mandatory. Parameter adaptor results from AIQ. */ + uint32_t isp_vamem_type; /*!< Mandatory. ISP vamem type. */ + ia_isp_feature_setting nr_setting; /*!< Mandatory. Feature setting for noise reduction algorithms. */ + ia_isp_feature_setting ee_setting; /*!< Mandatory. Feature setting for edge enhancement algorithms. */ + char manual_brightness; /*!< Optional. Manual brightness value range [-128,127]. */ + char manual_contrast; /*!< Optional. Manual contrast value range [-128,127]. */ + char manual_hue; /*!< Optional. Manual hue value range [-128,127]. */ + char manual_saturation; /*!< Optional. Manual saturation value range [-128,127]. */ + ia_isp_effect effects; /*!< Optional. Manual setting for special effects. Combination of ia_isp_effect enums.*/ + bool reduced_range_yuv; /*!< Mandatory. false configures ISP to output full YUV range data [0,255], true configures ISP to output BT601 reduced YUV range data. */ + ia_aiq_frame_params *isp_frame_params; /*!< Optional. Image output resolution and information about scaling done for the image in the ISP. NULL if not available. */ + int *custom_tunings_list; /*!< Optional. Array of indices for tunings selected by the user. Tunings are applied in the order they + are listed in the array. Indices must match ISP tunings defined in CPF. Index 0 must be last + in the list, which indicates the end of custom tunings. */ + ia_aiq_sa_results *sa_results; /*!< Mandatory. Shading adaptor results from AIQ. */ +} ia_isp_2_2_input_params; + +/*! + * \brief ISP configuration for the next frame + * Computes ISP parameters from input parameters and CPF values for the next image. + * + * \param[in] ia_isp Mandatory.\n + * ISP instance handle. + * \param[in] ia_isp_2_2_input_params Mandatory.\n + * Input parameters for ISP calculations. + * \return Binary data structure with pointer to the ISP configuration structure. + */ +LIBEXPORT ia_err +ia_isp_2_2_run(ia_isp *ia_isp, + const ia_isp_2_2_input_params *isp_input_params, + ia_binary_data *output_data); + + +/*! + * \brief Converts ISP specific statistics to IA_AIQ format. + * ISP generated statistics may not be in the format in which AIQ algorithms expect. Statistics need to be converted + * from various ISP formats into AIQ statistics format. + * + * \param[in] ia_isp Mandatory.\n + * ISP instance handle. + * \param[in] statistics Mandatory.\n + * Statistics in ISP specific format. + * \param[out] out_rgbs_grid Mandatory.\n + * Pointer's pointer where address of converted statistics are stored. + * Converted RGBS grid statistics. Output can be directly used as input in function ia_aiq_statistics_set. + * \param[out] out_af_grid Mandatory.\n + * Pointer's pointer where address of converted statistics are stored. + * Converted AF grid statistics. Output can be directly used as input in function ia_aiq_statistics_set. + * \return Error code. + */ +LIBEXPORT ia_err +ia_isp_2_2_statistics_convert(ia_isp *ia_isp, + void *statistics, + ia_aiq_rgbs_grid **out_rgbs_grid, + ia_aiq_af_grid **out_af_grid); + + +/*! + * \brief Get version. + * Get version from version header. + * + * \return Version string. + */ +LIBEXPORT const char* ia_isp_2_2_get_version(void); + + +#ifdef __cplusplus +} +#endif + +#endif /* IA_ISP_2_2_H_ */ |