1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
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_7.h
* \brief Hive ISP 2.7 specific implementation.
*/
#ifndef IA_ISP_2_7_H_
#define IA_ISP_2_7_H_
#include "ia_mkn_types.h"
#include "ia_abstraction.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_7_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_7_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. */
ia_aiq_sa_results *sa_results; /*!< Mandatory. Shading 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_isp_2_7_input_params;
/*!
* \brief Record header for AIC output .
*/
typedef struct {
int uuid;
int size;
} record_header;
/*!
* \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_7_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_7_run(ia_isp *ia_isp,
const ia_isp_2_7_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_7_statistics_convert(ia_isp *ia_isp,
void *statistics,
ia_aiq_rgbs_grid **out_rgbs_grid,
ia_aiq_af_grid **out_af_grid);
#ifdef __cplusplus
}
#endif
#endif /* IA_ISP_2_7_H_ */
|
