| # Copyright 2020 The Android Open Source Project |
| # |
| # 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. |
| """Verifies 3A converges in CONTINUOUS_PICTURE mode.""" |
| |
| |
| import logging |
| import os.path |
| |
| from mobly import test_runner |
| |
| import its_base_test |
| import camera_properties_utils |
| import capture_request_utils |
| import image_processing_utils |
| import its_session_utils |
| |
| _CONTINUOUS_PICTURE_MODE = 4 |
| _CONVERGED_3A = (2, 2, 2) # (AE, AF, AWB) |
| _M_TO_CM = 100 |
| _NAME = os.path.splitext(os.path.basename(__file__))[0] |
| _NS_TO_MS = 1E-6 |
| _NUM_FRAMES = 50 |
| _PATCH_H = 0.1 # center 10% |
| _PATCH_W = 0.1 |
| _PATCH_X = 0.5 - _PATCH_W/2 |
| _PATCH_Y = 0.5 - _PATCH_H/2 |
| _RGB_G_CH = 1 |
| _VGA_W, _VGA_H = 640, 480 |
| |
| |
| def _capture_frames(cam, log_path, debug): |
| """Captures frames, logs info, and creates cap_3a_state_list. |
| |
| Args: |
| cam: a camera capture object. |
| log_path: str to identify saved image location. |
| debug: bool for debugging info. |
| Returns: |
| cap_3a_state_list: list of 3a states [AE, AF, AWB] during captures. |
| """ |
| cap_3a_state_list = [] |
| req = capture_request_utils.auto_capture_request() |
| req['android.control.afMode'] = _CONTINUOUS_PICTURE_MODE |
| fmt = {'format': 'yuv', 'width': _VGA_W, 'height': _VGA_H} |
| caps = cam.do_capture([req]*_NUM_FRAMES, fmt) |
| |
| # Extract frame metadata and frame. |
| for i, cap in enumerate(caps): |
| md = cap['metadata'] |
| exp = md['android.sensor.exposureTime'] |
| iso = md['android.sensor.sensitivity'] |
| fd = md['android.lens.focalLength'] |
| ae_state = md['android.control.aeState'] |
| af_state = md['android.control.afState'] |
| awb_state = md['android.control.awbState'] |
| fd_str = 'infinity' |
| if fd != 0.0: |
| fd_str = '%.2fcm' % (_M_TO_CM/fd) |
| img = image_processing_utils.convert_capture_to_rgb_image(cap) |
| patch = image_processing_utils.get_image_patch( |
| img, _PATCH_X, _PATCH_Y, _PATCH_W, _PATCH_H) |
| green_mean = image_processing_utils.compute_image_means(patch)[_RGB_G_CH] |
| logging.debug( |
| '%d, iso: %d, exp: %.2fms, fd: %s, avg: %.3f, [ae,af,awb]' |
| ': [%d,%d,%d]', i, iso, exp * _NS_TO_MS, fd_str, green_mean, ae_state, |
| af_state, awb_state) |
| cap_3a_state_list.append([ae_state, af_state, awb_state]) |
| if debug: |
| image_processing_utils.write_image( |
| img, '%s_%d.jpg' % (os.path.join(log_path, _NAME), i)) |
| return cap_3a_state_list |
| |
| |
| class ContinuousPictureTest(its_base_test.ItsBaseTest): |
| """Test 3A converges in CONTINUOUS_PICTURE mode. |
| |
| Sets camera into CONTINUOUS_PICTURE mode and does NUM_FRAMES capture. |
| By the end of NUM_FRAMES capture, 3A should be in converged state. |
| Converged state is [2, 2, 2] for [AE, AF, AWB] |
| |
| State information: |
| AE_STATES: {0: INACTIVE, 1: SEARCHING, 2: CONVERGED, 3: LOCKED, |
| 4: FLASH_REQ, 5: PRECAPTURE} |
| AF_STATES: {0: INACTIVE, 1: PASSIVE_SCAN, 2: PASSIVE_FOCUSED, |
| 3: ACTIVE_SCAN, 4: FOCUS_LOCKED, 5: NOT_FOCUSED_LOCKED, |
| 6: PASSIVE_UNFOCUSED} |
| AWB_STATES: {0: INACTIVE, 1: SEARCHING, 2: CONVERGED, 3: LOCKED} |
| """ |
| |
| def test_continuous_picture(self): |
| logging.debug('Starting %s', _NAME) |
| with its_session_utils.ItsSession( |
| device_id=self.dut.serial, |
| camera_id=self.camera_id, |
| hidden_physical_id=self.hidden_physical_id) as cam: |
| props = cam.get_camera_properties() |
| props = cam.override_with_hidden_physical_camera_props(props) |
| log_path = self.log_path |
| debug = self.debug_mode |
| |
| # Check SKIP conditions. |
| camera_properties_utils.skip_unless( |
| camera_properties_utils.continuous_picture(props) and |
| camera_properties_utils.read_3a(props)) |
| |
| # Load chart for scene. |
| its_session_utils.load_scene( |
| cam, props, self.scene, self.tablet, self.chart_distance) |
| |
| # Do 3A up front. |
| cam.do_3a() |
| |
| # Ensure 3A settles in CONTINUOUS_PICTURE mode with no scene change. |
| cap_3a_state_list = _capture_frames(cam, log_path, debug) |
| final_3a = cap_3a_state_list[_NUM_FRAMES-1] |
| if final_3a != list(_CONVERGED_3A): |
| raise AssertionError( |
| f'Last frame [AE,AF,AWB]: {final_3a}. CONVERGED: {_CONVERGED_3A}.') |
| |
| if __name__ == '__main__': |
| test_runner.main() |
| |