1 /* Copyright (c) 2015-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 __QCAMERA3CROPREGIONMAPPER_H__
31 #define __QCAMERA3CROPREGIONMAPPER_H__
32 
33 // System dependencies
34 #include <utils/Errors.h>
35 
36 using namespace android;
37 
38 namespace qcamera {
39 
40 class QCamera3CropRegionMapper {
41 public:
42     QCamera3CropRegionMapper();
43     virtual ~QCamera3CropRegionMapper();
44 
45     void update(uint32_t active_array_w, uint32_t active_array_h,
46             uint32_t sensor_w, uint32_t sensor_h);
47     void toActiveArray(int32_t& crop_left, int32_t& crop_top,
48             int32_t& crop_width, int32_t& crop_height, float zoom_ratio);
49     void toSensor(int32_t& crop_left, int32_t& crop_top,
50             int32_t& crop_width, int32_t& crop_height, float zoom_ratio);
51     void toActiveArray(uint32_t& x, uint32_t& y, float zoom_ratio);
52     void toSensor(uint32_t& x, uint32_t& y, float zoom_ratio);
53 
54     // Adjust the crop rectangle to reflect zoom_ratio. For example, if
55     // zoom_ratio is 2.0, and crop region is active array size, this function
56     // will scale the crop region to be 2x zoomed.
57     void applyZoomRatio(int32_t& crop_left, int32_t& crop_top,
58             int32_t& crop_width, int32_t& crop_height, float zoom_ratio);
59 
60 private:
61     /* sensor output size */
62     int32_t mSensorW, mSensorH;
63     int32_t mActiveArrayW, mActiveArrayH;
64 
65     void boundToSize(int32_t& left, int32_t& top, int32_t& width,
66             int32_t& height, int32_t bound_w, int32_t bound_h);
67 
68     static constexpr float MIN_ZOOM_RATIO = 0.0001f;
69     void applyZoomRatioHelper(int32_t& crop_left, int32_t& crop_top,
70             int32_t& crop_width, int32_t& crop_height, float zoom_ratio,
71             bool to_sensor);
72 };
73 
74 }; // namespace qcamera
75 
76 #endif /* __QCAMERA3CROPREGIONMAPPER_H__ */
77