1 /* Copyright (c) 2012-2016, The Linux Foundation. All rights reserved.
2  *
3  * Redistribution and use in source and binary forms, with or without
4  * modification, are permitted provided that the following conditions are
5  * met:
6  *     * Redistributions of source code must retain the above copyright
7  *       notice, this list of conditions and the following disclaimer.
8  *     * Redistributions in binary form must reproduce the above
9  *       copyright notice, this list of conditions and the following
10  *       disclaimer in the documentation and/or other materials provided
11  *       with the distribution.
12  *     * Neither the name of The Linux Foundation nor the names of its
13  *       contributors may be used to endorse or promote products derived
14  *       from this software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
17  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
20  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
23  * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
24  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
25  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
26  * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  *
28  */
29 
30 #ifndef __QCamera3_POSTPROC_H__
31 #define __QCamera3_POSTPROC_H__
32 
33 // Camera dependencies
34 #include "camera3.h"
35 #include "QCamera3HALHeader.h"
36 #include "QCameraCmdThread.h"
37 #include "QCameraQueue.h"
38 
39 extern "C" {
40 #include "mm_camera_interface.h"
41 #include "mm_jpeg_interface.h"
42 }
43 
44 namespace qcamera {
45 
46 class QCamera3Exif;
47 class QCamera3ProcessingChannel;
48 class QCamera3ReprocessChannel;
49 class QCamera3Stream;
50 class QCamera3StreamMem;
51 
52 typedef struct {
53     camera3_stream_buffer_t src_frame;// source frame
54     mm_camera_buf_def_t metadata_buffer;
55     mm_camera_buf_def_t input_buffer;
56     reprocess_config_t reproc_config;
57     buffer_handle_t *output_buffer;
58     uint32_t frameNumber;
59 } qcamera_fwk_input_pp_data_t;
60 
61 typedef struct {
62     uint32_t jobId;                  // job ID
63     uint32_t client_hdl;             // handle of jpeg client (obtained when open jpeg)
64     mm_camera_super_buf_t *src_frame;// source frame (need to be returned back to kernel after done)
65     mm_camera_super_buf_t *src_reproc_frame; // original source frame for reproc if not NULL
66     qcamera_fwk_input_pp_data_t *fwk_frame; // source framework buffer
67     qcamera_fwk_input_pp_data_t *fwk_src_buffer; // original framework source frame for reproc
68     QCamera3Exif *pJpegExifObj;
69     metadata_buffer_t *metadata;
70     mm_camera_super_buf_t *src_metadata;
71     jpeg_settings_t *jpeg_settings;
72 } qcamera_hal3_jpeg_data_t;
73 
74 typedef struct {
75     uint32_t jobId;                  // job ID
76     mm_camera_super_buf_t *src_frame;// source frame (need to be returned back to kernel after done)
77     qcamera_fwk_input_pp_data_t *fwk_src_frame;// source frame
78     metadata_buffer_t *metadata;
79     jpeg_settings_t *jpeg_settings;
80     mm_camera_super_buf_t *src_metadata;
81 } qcamera_hal3_pp_data_t;
82 
83 typedef struct {
84     mm_camera_super_buf_t *input;
85     buffer_handle_t *output;
86     uint32_t frameNumber;
87 } qcamera_hal3_pp_buffer_t;
88 
89 #define MAX_HAL3_EXIF_TABLE_ENTRIES 23
90 class QCamera3Exif
91 {
92 public:
93     QCamera3Exif();
94     virtual ~QCamera3Exif();
95 
96     int32_t addEntry(exif_tag_id_t tagid,
97                      exif_tag_type_t type,
98                      uint32_t count,
99                      void *data);
getNumOfEntries()100     uint32_t getNumOfEntries() {return m_nNumEntries;};
getEntries()101     QEXIF_INFO_DATA *getEntries() {return m_Entries;};
102 
103 private:
104     QEXIF_INFO_DATA m_Entries[MAX_HAL3_EXIF_TABLE_ENTRIES];  // exif tags for JPEG encoder
105     uint32_t  m_nNumEntries;                            // number of valid entries
106 };
107 
108 class QCamera3PostProcessor
109 {
110 public:
111     QCamera3PostProcessor(QCamera3ProcessingChannel *ch_ctrl);
112     virtual ~QCamera3PostProcessor();
113 
114     int32_t init(QCamera3StreamMem *mMemory,
115             uint32_t postprocess_mask);
116     int32_t initJpeg(jpeg_encode_callback_t jpeg_cb,
117             cam_dimension_t *m_max_pic_dim,
118             void *user_data);
119     int32_t deinit();
120     int32_t start(const reprocess_config_t &config);
121     int32_t stop();
122     int32_t flush();
123     int32_t processData(qcamera_fwk_input_pp_data_t *frame);
124     int32_t processData(mm_camera_super_buf_t *input,
125             buffer_handle_t *output, uint32_t frameNumber);
126     int32_t processData(mm_camera_super_buf_t *input);
127     int32_t processPPData(mm_camera_super_buf_t *frame);
128     int32_t processPPMetadata(mm_camera_super_buf_t *reproc_meta);
129     int32_t processJpegSettingData(jpeg_settings_t *jpeg_settings);
130     qcamera_hal3_pp_data_t *dequeuePPJob(uint32_t frameNumber);
131     qcamera_hal3_jpeg_data_t *findJpegJobByJobId(uint32_t jobId);
132     void releaseJpegJobData(qcamera_hal3_jpeg_data_t *job);
133     int32_t releaseOfflineBuffers(bool all);
134     void releasePPJobData(qcamera_hal3_pp_data_t *job);
135 
136 private:
137     int32_t sendEvtNotify(int32_t msg_type, int32_t ext1, int32_t ext2);
138     mm_jpeg_color_format getColorfmtFromImgFmt(cam_format_t img_fmt);
139     mm_jpeg_format_t getJpegImgTypeFromImgFmt(cam_format_t img_fmt);
140     int32_t getJpegEncodeConfig(mm_jpeg_encode_params_t& encode_parm,
141                                   QCamera3Stream *main_stream,
142                                   jpeg_settings_t *jpeg_settings);
143     int32_t getFWKJpegEncodeConfig(mm_jpeg_encode_params_t& encode_parm,
144             qcamera_fwk_input_pp_data_t *frame,
145             jpeg_settings_t *jpeg_settings);
146     QCamera3Exif * getExifData(metadata_buffer_t *metadata,
147             jpeg_settings_t *jpeg_settings);
148     int32_t encodeData(qcamera_hal3_jpeg_data_t *jpeg_job_data,
149                        uint8_t &needNewSess);
150     int32_t encodeFWKData(qcamera_hal3_jpeg_data_t *jpeg_job_data,
151             uint8_t &needNewSess);
152     void releaseSuperBuf(mm_camera_super_buf_t *super_buf);
153     static void releaseNotifyData(void *user_data, void *cookie);
154     int32_t processRawImageImpl(mm_camera_super_buf_t *recvd_frame);
155 
156     static void releaseJpegData(void *data, void *user_data);
157     static void releasePPInputData(void *data, void *user_data);
158     static void releaseMetadata(void *data, void *user_data);
159     static void releaseOngoingPPData(void *data, void *user_data);
160 
161     static void *dataProcessRoutine(void *data);
162 
163 private:
164     QCamera3ProcessingChannel  *m_parent;
165     jpeg_encode_callback_t     mJpegCB;
166     void *                     mJpegUserData;
167     mm_jpeg_ops_t              mJpegHandle;
168     uint32_t                   mJpegClientHandle;
169     uint32_t                   mJpegSessionId;
170     uint32_t                   mPostProcMask;
171 
172     uint32_t                   m_bThumbnailNeeded;
173     QCamera3StreamMem          *mOutputMem;
174     QCamera3ReprocessChannel *  m_pReprocChannel;
175 
176     QCameraQueue m_inputPPQ;            // input queue for postproc
177     QCameraQueue m_inputFWKPPQ;         // framework input queue for postproc
178     QCameraQueue m_ongoingPPQ;          // ongoing postproc queue
179     QCameraQueue m_inputJpegQ;          // input jpeg job queue
180     QCameraQueue m_ongoingJpegQ;        // ongoing jpeg job queue
181     QCameraQueue m_inputRawQ;           // input raw job queue
182     QCameraQueue m_inputMetaQ;          // input meta queue
183     QCameraQueue m_jpegSettingsQ;       // input jpeg setting queue
184     QCameraCmdThread m_dataProcTh;      // thread for data processing
185 
186     pthread_mutex_t mReprocJobLock;
187 };
188 
189 }; // namespace qcamera
190 
191 #endif /* __QCamera3_POSTPROC_H__ */
192