Camera ITS Tests

This page provides a comprehensive list of the tests under the Camera Image Test Suite (ITS), which is part of the Android Compatibility Test Suite (CTS) Verifier. ITS tests are functional tests, meaning that they do not measure image quality, but that all of the advertised camera functions are working as expected. This document lets developers and testers understand what the individual tests do and how to debug test failures.

Tests are grouped by scene as follows:

  • scene0: Capture metadata, jitter, gyroscope, vibration
  • scene1: Exposure, sensitivity, EV compensation, YUV vs JPEG/RAW
  • scene2: Face detection
  • scene3: Edge enhancement, lens movement
  • scene4: Aspect ratio, cropping, field-of-view
  • scene5: Lens shading
  • scene6: Zoom
  • sensor_fusion: Camera/gyroscope timing offset

See individual sections for a description of each scene.

scene0

Scene0 tests require no specific scene information. However, the phone must be stationary for gyroscope and vibration testing.

test_burst_capture

Verifies that the entire capture pipeline can keep up with the speed of fullsize capture and CPU time.

Pass: Captures a burst of full size images and the camera is fast enough to avoid timeout.

test_capture_result_dump

Tests that a capture result is returned from a manual capture and then dumps it.

Pass: Completes capture and dumps the capture results.

test_gyro_bias

Tests if the gyro has stable output when the device is stationary. Data is plotted as an average of 20 data points.

Pass: The gyro reading's delta is less than 0.01 over time.

test_gyro_bias_plot.png

test_gyro_bias_plot.png

test_jitter

Measures jitter in camera timestamps.

Pass: There's at least a 30 ms delta between frames.

Impacted camera parameters:

  • AE_TARGET_FPS_RANGE
  • SENSOR_TIMESTAMP

test_jitter_plot.png

test_jitter_plot.png (Note the small y-axis range. Jitter is actually small in this plot.)

test_metadata

Tests the validity of metadata entries. Looks at capture results and at the camera characteristics objects. This test uses auto_capture_request exposure and gain values because image content isn't important.

Pass: Hardware level, rollingShutterSkew, frameDuration tags, timestampSource, croppingType, blackLevelPattern, pixel_pitch, FOV, hyperfocal distance are present and have valid values.

Impacted camera parameters:

  • CONTROL_AE_TARGET_FPS_RANGE
  • LENS_FOCAL_DISTANCE
  • SCALER_TYPE_REGION
  • SENSOR_DYNAMIC_BLACK_LEVEL
  • SENSOR_FRAME_DURATION
  • SENSOR_TIMESTAMP
  • SENSOR_ROLLING_SHUTTER_SKEW

test_param_sensitivity_burst

Tests that the android.sensor.sensitivity parameter is applied properly in burst. Inspects the output metadata only.

Pass: Output data has an error tolerance of less than 0.2%.

Impacted camera parameters:

  • SENSOR_SENSITIVITY

test_read_write

Tests that the device writes the correct exposure and gain values by reading back the capture metadata.

Pass: Read and write values match across all shots.

Impacted camera parameters:

  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY

test_sensor_events

Tests that device queries and prints out sensor events for devices that advertise sensor fusion support. The sensors expected are accelerometer, gyroscope, and magnetometer. This test only works if the screen is on, meaning the device isn't in standby mode.

Pass: Events for each sensor are received.

test_solid_color_test_pattern

Tests that solid color test patterns are generated properly for camera muting. If camera muting is supported, solid color test patterns must be supported. If camera muting is not supported, solid color test patterns are only tested if the capability is advertised.

If RAW images are supported, color assigment is tested as well. The colors tested are black, white, red, blue, and green. For cameras that do not support RAW images, only black is tested.

Pass: Solid test patterns supported are the correct color and there is low variance in the image.

Impacted camera parameters:

  • SENSOR_AVAILABLE_TEST_PATTERN_MODES
  • SENSOR_TEST_PATTERN_DATA
  • SENSOR_TEST_PATTERN_MODE

test_test_pattern

Tests the android.sensor.testPatternMode parameter to capture frames for each valid test pattern and checks that the frames are generated correctly for solid colors and color bars. This test includes the following steps:

  1. Captures images for all supported test patterns.
  2. Performs a simple correctness check for solid color test pattern and color bars.

Pass: Supported test patterns are generated correctly.

Impacted camera parameters:

  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY
  • SENSOR_AVAILABLE_TEST_PATTERN_MODES
  • SENSOR_TEST_PATTERN_MODE

test_test_patterns_2

test_test_patterns_2.jpg

test_tonemap_curve

Tests conversion of test pattern from RAW to YUV with linear tonemap. This test requires android.sensor.testPatternMode = 2 (COLOR_BARS) to generate a perfect image pattern for tonemap conversion. Ensures pipeline has proper color outputs with linear tonemap and ideal image input (relies on test_test_patterns).

Pass: The YUV and the RAW look similar to each other.

Impacted camera parameters:

  • DISTORTION_CORRECTION_MODE
  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY
  • SENSOR_TEST_PATTERN_MODE
  • TONEMAP_CURVE
  • TONEMAP_MODE

test_tonemap_curve_raw_2

test_tonemap_curve_raw_2.jpg

test_tonemap_curve_yuv_2.jpg

test_tonemap_curve_yuv_2.jpg

test_unified_timestamp

Tests if image and motion sensor events are in the same time domain.

Pass: Motion timestamps are between the two image timestamps.

Impacted camera parameters:

  • SENSOR_TIMESTAMP

test_vibration_restriction

Tests if the device's vibration is functioning as expected.

Pass: The device doesn't vibrate when muted by the camera audio restriction API.

scene1

scene1 is a gray chart. The gray chart must cover the center 30% of the camera field of view. The gray chart is expected to challenge 3A (auto exposure, auto white balance, auto focus) moderately as the center region has no features. However, the capture request specifies the entire scene which includes sufficient features for 3A to converge.

RFoV cameras can be tested in the WFoV or the RFoV test rig. If a RFoV camera is tested in the WFoV test rig, the chart is scaled by ⅔ to ensure some boundaries for the gray chart in the FoV to help 3A converge.

scene1

scene1: Full size chart (left). ⅔ scaled chart (right).

test_3a

Tests the convergence of 3A with a moderately challenging target.

Pass: 3A converges and the returned 3A values are valid.

test_ae_af

Tests the 3A auto exposure (AE) and auto focus (AF) algorithms individually.

Pass: 3A converges and the returned 3A values are legal.

test_ae_precapture_trigger

Tests the AE state machine when using the precapture trigger. Captures five manual requests with AE disabled. The last request has an AE precapture trigger, which should be ignored because AE is disabled.

Pass: AE converges.

Impacted camera parameters:

  • CONTROL_AE_MODE
  • CONTROL_AE_STATE
  • CONTROL_AE_PRECAPTURE_TRIGGER

test_auto_vs_manual

Tests that captured auto and manual shots look the same.

Pass: Manual white balance gains and transform reported in each capture result match with the auto white balance estimate from camera's 3A algorithm.

Impacted camera parameters:

  • COLOR_CORRECTION_GAINS
  • COLOR_CORRECTION_TRANSFORM
  • TONEMAP_CURVE
  • TONEMAP_MODE

test_auto_vs_manual_auto

test_auto_vs_manual_auto.jpg

test_auto_vs_manual_wb

test_auto_vs_manual_wb.jpg

test_auto_vs_manual_manual_wb_tm

test_auto_vs_manual_manual_wb_tm.jpg

test_black_white

Tests that the device produces full black and white images. Takes two captures, the first with extremely low gain and short exposure, which results in a black photo, and the second with extremely high gain and long exposure, which results in a white photo.

Pass: Produces black and white images.

Impacted camera parameters:

  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY
test_black_white_black test_black_white_black
test_black_white_black.jpg test_black_white_white.jpg

test_black_white_plot_means

test_black_white_plot_means.png

test_burst_sameness_manual

Takes 5 bursts of 50 images with manual capture setting and checks that they're all identical. This test can be used to identify if there are sporadic frames that are processed differently or have artifacts.

Pass: Images are identical visually and in RGB values.

Fail: Shows a spike or drop of the RGB average chart at the beginning of each burst

  • Tolerance is 3% for first_API_level < 30
  • Tolerance is 2% for first_API_level >= 30

test_burst_sameness_manual_mean

test_burst_sameness_manual_mean.jpg

test_burst_sameness_manual_plot_means

test_burst_sameness_manual_plot_means.png

test_capture_result

Tests that valid data comes back in CaptureResult objects. Does an auto, manual, and auto capture.

Pass: Metadata is valid for all captures and the manual settings don't leak into the second auto capture. Plots out the lens shading correction for the captures.

Impacted camera parameters:

  • CONTROL_AE_MODE
  • CONTROL_AE_REGIONS
  • CONTROL_AF_MODE
  • CONTROL_AF_REGIONS
  • CONTROL_AWB_MODE
  • CONTROL_AWB_REGIONS
  • CONTROL_MODE
  • COLOR_CORRECTION_GAINS
  • COLOR_CORRECTION_TRANSFORM
  • COLOR_CORRECTION_MODE
  • CONTROL_MODE
  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY
  • STATISTICS_LENS_SHADING_CORRECTION_MAP
  • STATISTICS_LENS_SHADING_MAP_MODE
  • TONEMAP_CURVE
  • TONEMAP_MODE

test_capture_result_plot_lsc_auto_ch0

test_capture_result_plot_lsc_auto_ch0.png

test_channel_saturation

Tests that RGB channels saturate evenly to eliminate tinting in saturated regions of image.

Pass: Saturated channels have RGB values of [255, 255, 255] with a margin of error of less than 1% difference.

Impacted camera parameters:

  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY

test_channel_saturation

test_channel_saturation.jpg

test_crop_region_raw

Tests that the RAW streams aren't croppable.

Pass: YUV images get center-cropped but not RAW images.

Impacted camera parameters:

  • SCALER_CROP_REGION

test_crop_region_raw_comp_raw_crop

test_crop_region_raw_comp_raw_crop.jpg

test_crop_region_raw_comp_raw_full

test_crop_region_raw_comp_raw_full.jpg

test_crop_region_raw_comp_yuv_crop

test_crop_region_raw_comp_yuv_crop.jpg

test_crop_region_raw_yuv_full

test_crop_region_raw_yuv_full.jpg

test_crop_regions

Tests that crop regions work. Takes a full image and creates patches of 5 different regions (corners and center.) Takes images with crop set for the 5 regions. Compares the patch and the crop image values.

Pass: Image of the cropped region matches the patch that corresponds to the crop image.

Impacted camera parameters:

  • SCALER_CROP_REGION

test_dng_noise_model

Verifies that the DNG raw model parameters are correct. The plot depicts the measured variance of a center patch of the grey card in raw shots captured over a range of sensitivities, and compares these values with the variance that is expected at each sensitivity by the DNG noise model in the camera HAL (based on the O,S parameters returned in the capture result objects). For a more details on the DNG noise model, download the following document on the DNG Noise Model.

Pass: DNG raw model parameters are correct. Expected RGB values match that of the actual RGB values measured.

Impacted camera parameters:

  • SENSOR_DYNAMIC_WHITE_LEVEL
  • SENSOR_SENSITIVITY

test_dng_noise_model_plog

test_dng_noise_model_plog.png

test_ev_compensation_advanced

Tests that the exposure value (EV) compensation is applied. The test increases exposure in eight steps, and checks measured brightness versus expected brightness. Expected values are calculated from image brightness of image with no EV compensation applied and the expected value will saturate if the calculated values exceed the actual image value range. Test fails if the expected values and measured values don't match or images overexpose within five steps.

Pass: Images show increasing exposure without overexposing within five steps.

Impacted camera parameters:

  • AE_EXPOSURE_COMPENSATION
  • CONTROL_AE_EXPOSURE_COMPENSATION
  • CONTROL_AE_LOCK
  • CONTROL_AE_STATE
  • TONEMAP_CURVE
  • TONEMAP_MODE

test_ev_compensation_advanced_plot_means

test_ev_compensation_advanced_plot_means.png

test_ev_compensation_basic

Tests that the EV compensation is applied by increasing exposure gradually. Images increase exposure gradually, but doesn't overexpose as in the test_ev_compensation_advanced test.

Pass: Captures increase in luma.

Impacted camera parameters:

  • CONTROL_AE_EXPOSURE_COMPENSATION
  • CONTROL_AE_LOCK
  • CONTROL_AE_STATE

test_ev_compensation_basic

test_ev_compensation_basic.png

test_exposure

Tests that a constant exposure is achieved as ISO and exposure time vary. Takes a series of shots that have ISO and exposure time chosen to balance each other. Results should have the same brightness, but over the sequence the image should get noisier. Verifies sample pixel mean values are close to each other. Ensures that the images aren't clamped to 0 or 1 (which would make them look like flat lines).

Pass: Images have the same brightness, but get noisier with higher ISO. RGB planes are flat with constant ISO exposure.

Impacted camera parameters:

  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY

test_exposure_plot_means

test_exposure_plot_means.png

test_exposure_mult=1.00 test_exposure_mult=64.00
test_exposure_mult=1.00.jpg test_exposure_mult=64.00.jpg

test_jpeg

Tests that converted YUV images and device JPEG images look the same. Test takes the center 10% of the image and calculates the RGB value, and verifies that they match.

Pass: The average RGB difference between each image is less than 3%.

test_jpeg_fmt=jpg.jpg test_jpeg=fmt=yuv.jpg
test_jpeg_fmt=jpg.jpg test_jpeg=fmt=yuv.jpg

test_latching

Tests that settings (exposure and gain) latch on the right frame. Takes a series of shots using back-to-back requests, varying the capture request parameters between shots. Checks that the images have the expected properties.

Pass: Images [2, 3, 6, 8, 10, 12, 13] have increased ISO or exposure and show up with higher RGB means on test_latching_plot_means.png.

test_latching_i=00.jpg test_latching_i=01.jpg test_latching_i=02.jpg
test_latching_i=00.jpg test_latching_i=01.jpg test_latching_i=02.jpg
test_latching_i=03.jpg test_latching_i=04.jpg test_latching_i=05.jpg
test_latching_i=03.jpg test_latching_i=04.jpg test_latching_i=05.jpg
test_latching_i=06.jpg test_latching_i=07.jpg test_latching_i=08.jpg
test_latching_i=06.jpg test_latching_i=07.jpg test_latching_i=08.jpg
test_latching_i=09.jpg test_latching_i=10.jpg test_latching_i=11.jpg
test_latching_i=09.jpg test_latching_i=10.jpg test_latching_i=11.jpg
test_latching_i=12.jpg
test_latching_i=12.jpg

test_latching_plot_means

test_latching_plot_means.png

test_linearity

Tests that device processing can be inverted to linear pixels. Captures a sequence of shots with the device pointed at a uniform target.

Pass: Inverts all the ISP processing to get back to linear R, G, B pixel data.

Impacted camera parameters:

  • BLACK_LEVEL_LOCK
  • SENSOR_SENSITIVITY
  • TONEMAP_CURVE
  • TONEMAP_MODE

test_linearity_sens=0597

test_linearity_sens=0597.jpg

test_linearity_sens=1194

test_linearity_sens=1194.jpg

test_linearity_sens=1791

test_linearity_sens=1791.jpg

test_linearity_sens=2388

test_linearity_sens=2388.jpg

test_linearity_sens=2985

test_linearity_sens=2985.jpg

test_linearity_plot_means

test_linearity_plot_means.png

test_locked_burst

Tests 3A lock and YUV burst (using auto setting). This test is designed to pass even on limited devices that don't have MANUAL_SENSOR or PER_FRAME_CONTROLS. The test checks YUV image consistency while the frame rate check is in CTS.

Pass: Captures look consistent.

Impacted camera parameters:

  • CONTROL_AE_LOCK
  • CONTROL_AWB_LOCK

test_locked_burst_frame0

test_locked_burst_frame0.jpg

test_locked_burst_frame1

test_locked_burst_frame1.jpg

test_locked_burst_frame2

test_locked_burst_frame2.jpg

test_multi_camera_match

Tests to see if multi cameras on devices give similar RGB values for a gray patch.

Pass: Different cameras produce similar RGB values for the same gray patch.

Impacted camera parameters:

  • LENS_FOCAL_LENGTH
  • SCALER_CROP_REGION

test_multi_camera+match_yuv_fl=4.38

test_multi_camera+match_yuv_fl=4.38.jpg

test_param_color_correction

Tests that the android.colorCorrection.* parameters are applied when set. Takes shots with different transform and gain values, and tests that they look correspondingly different. The transform and gains are chosen to make the output increasingly red or blue. Uses a linear tonemap. Tone mapping is a technique used in image processing to map one set of colors to another to approximate the appearance of high-dynamic-range images in a medium that has a more limited dynamic range.

Pass: R and B values boost according to transformation.

Impacted camera parameters:

  • COLOR_CORRECTION_GAINS
  • COLOR_CORRECTION_MODE
  • COLOR_CORRECTION_TRANSFORM

test_param_color_correction_plot_means

test_param_color_correction_plot_means.png

*The x-axis is the capture requests: 0 = unity, 1=red boost, 2= blue boost

test_param_color_correction_req=0

test_param_color_correction_req=0.jpg

test_param_color_correctness_req=1

test_param_color_correctness_req=1.jpg (R boost)

test_param_color_correction_req=2

test_param_color_correction_req=2.jpg (B boost)

test_param_exposure_time

Tests that the android.sensor.exposureTime parameter is applied.

Pass: Each shot is brighter than the previous shot.

Impacted camera parameters:

  • SENSOR_EXPOSURE_TIME

test_param_exposure_time_frame0

test_param_exposure_time_frame0.jpg

test_param_exposure_time_plot

test_param_exposure_time_plot.png

test_param_flash_mode

Tests that the android.flash.mode parameter is applied. Manually sets the exposure to be on the dark side, so that it is obvious whether the flash fired or not, and uses a linear tonemap. Checks the center with the tile image to see if there's a large gradient that's created to verify whether the flash fired.

Pass: The center of the tile image has a large gradient meaning that the flash fired.

Impacted camera parameters:

  • FLASH_MODE
  • FLASH_STATE

test_param_flash_mode_1

test_param_flash_mode_1.jpg

test_param_flash_mode_1_tile

test_param_flash_mode_1_tile.jpg

test_param_flash_mode_2

test_param_flash_mode_2.jpg

test_param_flash_mode_2_tile

test_param_flash_mode_2_tile.jpg

test_param_noise_reduction

Tests that the android.noiseReduction.mode parameter is applied correctly when set. Captures images with the camera dimly lit. Uses a high analog gain to ensure the captured image is noisy. Captures three images, for NR off, "fast", and "high quality". Also captures an image with low gain and NR off, and uses the variance of this as the baseline. The higher the SNR (Signal to Noise Ratio), the better the image quality.

Pass: SNR varies with different noise reduction modes and behaves similarly as the graph below.

Impacted camera parameters:

  • NOISE_REDUCTION_MODE

test_param_noise_reduction_plot_SNRs

test_param_noise_reduction_plot_SNRs.png

0: OFF, 1: FAST, 2: HQ, 3: MIN , 4: ZSL

test_param_noise_reduction_high_gain_nr=0

test_param_noise_reduction_high_gain_nr=0.jpg

test_param_noise_reduction_high_gain_nr=1

test_param_noise_reduction_high_gain_nr=1.jpg

test_param_noise_reduction_high_gain_nr=2

test_param_noise_reduction_high_gain_nr=2.jpg

test_param_noise_reduction_high_gain_nr=3

test_param_noise_reduction_high_gain_nr=3.jpg

test_param_noise_reduction_low_gain

test_param_noise_reduction_low_gain.jpg

test_param_sensitivity

Tests that the android.sensor.sensitivity parameter is applied. The test increases the sensitivity in 5 steps with fixed exposure for each shot.

Pass: RGB means of center 10% gets brighter with increased sensitivity.

Impacted camera parameters:

  • SENSOR_SENSITIVITY

test_param_sensitivity_iso=0055

test_param_sensitivity_iso=0055.jpg

test_param_sensitivity_iso=1819

test_param_sensitivity_iso=1819.jpg

test_param_sensitivity_iso=3583

test_param_sensitivity_iso=3583.jpg

test_param_sensitivity_iso=5347

test_param_sensitivity_iso=5347.jpg

test_param_sensitivity_iso=7111

test_param_sensitivity_iso=7111.jpg

test_param_sensitivity_plot

test_param_sensitivity_plot.png

test_param_shading_mode

Tests that the android.shading.mode parameter is applied.

Pass: Shading modes are switched and the lens shading maps are modified as expected.

Impacted camera parameters:

  • SHADING_MODE
  • STATISTICS_LENS_SHADING_CORRECTION_MAP
  • STATISTICS_LENS_SHADING_MAP_MODE

test_param_shading_mode_ls_maps_mode_0_loop_0

test_param_shading_mode_ls_maps_mode_0_loop_0.png

test_param_shading_mode_ls_maps_mode_1_loop_0

test_param_shading_mode_ls_maps_mode_1_loop_0.png

test_param_shading_mode_ls_maps_mode_2_loop_0

test_param_shading_mode_ls_maps_mode_2_loop_0.png

test_param_tonemap_mode

Tests that the android.tonemap.mode parameter is applied. Applies different tonemap curves to each R, G, B channel, and checks that the output images are modified as expected. This test consists of two tests, test1 and test2.

Pass:

  • test1: Both images have a linear tonemap, but n=1 has a steeper gradient. The G (green) channel is brighter for the n=1 image.
  • test2: Same tonemap, but different length. Images are the same.

Impacted camera parameters:

  • TONEMAP_CURVE
  • TONEMAP_MODE
test_param_tonemap_mode_n=0.jpg test_param_tonemap_mode_n=1.jpg
test_param_tonemap_mode_n=0.jpg test_param_tonemap_mode_n=1.jpg

test_post_raw_sensitivity_boost

Checks post RAW sensitivity boost. Captures a set of RAW and YUV images with different sensitivity, posts RAW sensitivity boost combination and checks if the output pixel mean matches request settings.

Pass: RAW images get darker as boost increases while YUV images stay constant in brightness

Impacted camera parameters:

  • CONTROL_POST_RAW_SENSITIVITY_BOOST

test_post_raw_sensitivity_boost_raw_s=3583_boost=0100

test_post_raw_sensitivity_boost_raw_s=3583_boost=0100.jpg

test_post_raw_sensitivity_boost_raw_s=1792_boost=0200

test_post_raw_sensitivity_boost_raw_s=1792_boost=0200.jpg

test_post_raw_sensitivity_boost_raw_s=0896_boost=0400

test_post_raw_sensitivity_boost_raw_s=0896_boost=0400.jpg

test_post_raw_sensitivity_boost_raw_s=0448_boost=0800

test_post_raw_sensitivity_boost_raw_s=0448_boost=0800.jpg

test_post_raw_sensitivity_boost_raw_s=0224_boost=1600

test_post_raw_sensitivity_boost_raw_s=0224_boost=1600.jpg

test_post_raw_sensitivity_boost_raw_s=0112_boost=3199

test_post_raw_sensitivity_boost_raw_s=0112_boost=3199.jpg

test_post_raw_sensitivity_boost_raw_plot_means

test_post_raw_sensitivity_boost_raw_plot_means.png

test_post_raw_sensitivity_boost_yuv_s=0112_boost=3199

test_post_raw_sensitivity_boost_yuv_s=0112_boost=3199.jpg

test_post_raw_sensitivity_boost_yuv_s=0448_boost=0800

test_post_raw_sensitivity_boost_yuv_s=0448_boost=0800.jpg

test_post_raw_sensitivity_boost_yuv_s=0896_boost=0400

test_post_raw_sensitivity_boost_yuv_s=0896_boost=0400.jpg

test_post_raw_sensitivity_boost_yuv_s=1792_boost=0200

test_post_raw_sensitivity_boost_yuv_s=1792_boost=0200.jpg

test_post_raw_sensitivity_boost_yuv_s=3585_boost=0100

test_post_raw_sensitivity_boost_yuv_s=3585_boost=0100.jpg

test_post_raw_sensitivity_boost_yuv_plot_means

test_post_raw_sensitivity_boost_yuv_plot_means.png

test_raw_burst_sensitivity

Captures a set of raw images with increasing gains and measures the noise. Captures raw-only, in a burst.

Pass: Each shot is noisier than the previous shot, as the gain is increasing.

Uses the variance of the center stats grid cell.

test_raw_burst_sensitivity_variance

test_raw_burst_sensitivity_variance.png

test_raw_exposure

Captures a set of raw images with increasing exposure time and measures the pixel values.

Pass: Increasing the ISO (gain) makes the pixels more sensitive to light, so the plot moves towards the left.

test_raw_exposure_s=55

test_raw_exposure_s=55.png

(10⁰ is 1 ms, 10¹ is 10 ms, 10⁻¹ is 0.1 ms)

test_raw_exposure_s=132

test_raw_exposure_s=132.png

test_raw_exposure_s=209

test_raw_exposure_s=209.png

test_raw_exposure_s=286

test_raw_exposure_s=286.png

test_raw_exposure_s=363

test_raw_exposure_s=363.png

test_raw_exposure_s=440

test_raw_exposure_s=440.png

test_raw_sensitivity

Captures a set of raw images with increasing sensitivities and measures the noise (variance) in the center 10% of image. Tests that each shot is noisier than the previous one.

Pass: Variance increases with each shot.

test_raw_sensitivity_variance

test_raw_sensitivity_variance.png

test_reprocess_noise_reduction

Tests thatandroid.noiseReduction.mode is applied for reprocessing requests. Captures reprocessed images with the camera dimly lit. Uses a high analog gain to ensure the capture image is noisy. Captures three reprocessed images, for NR off, "fast", and "high quality". Captures a reprocessed image with low gain and NR off, and uses the variance of this as the baseline.

Pass: FAST >= OFF, HQ >= FAST, HQ >> OFF

Impacted camera parameters:

  • NOISE_REDUCTION_MODE

Typical SNR vs NR_MODE plot

Typical SNR vs NR_MODE plot

test_tonemap_sequence

Tests a sequence of shots with different tonemap curves. Captures 3 manual shots with a linear tonemap. Captures 3 manual shots with default tonemap. Computes the delta between each consecutive frame pair.

Pass: There are 3 identical frames followed by a different set of 3 identical frames.

test_tonemap_sequence_i=0

test_tonemap_sequence_i=0.jpg

test_tonemap_sequence_i=1

test_tonemap_sequence_i=1.jpg

test_tonemap_sequence_i=2

test_tonemap_sequence_i=2.jpg

test_tonemap_sequence_i=3

test_tonemap_sequence_i=3.jpg

test_tonemap_sequence_i=4

test_tonemap_sequence_i=4.jpg

test_tonemap_sequence_i=5

test_tonemap_sequence_i=5.jpg

test_yuv_jpeg_all

Tests that all reported sizes and formats for image capture work. Uses a manual request with a linear tonemap so that the YUV and JPEG look the same when converted by the its.image module.

Pass: All image centers have a max RMS (root-mean-square value of a signal) difference in RGB converted images with 3% of highest resolution YUV image.

test_yuv_jpeg_all

test_yuv_jpeg_all.png

test_yuv_plus_dng

Tests that the reported sizes and formats for image capture work.

Pass: Test completes and returns the images requested.

test_yuv_plus_dng

test_yuv_plus_dng.jpg

test_yuv_plus_jpeg

Tests capturing a single frame as both YUV and JPEG outputs. Uses a manual request with a linear tonemap so that the YUV and JPEG look the same (when converted by the its.image module.)

Pass: YUV and JPEG images are similar and have less than 1% RMS (root-mean-square value of a signal) difference.

test_yuv_plus_jpg_jpg.jpg test_yuv_plus_jpeg_yuv.jpg
test_yuv_plus_jpg_jpg.jpg test_yuv_plus_jpeg_yuv.jpg

test_yuv_plus_raw

Tests capturing a single frame as both RAW and YUV outputs. Uses a manual request with linear tonemap so RAW and YUV are expected to be the same. Compares RGB converted images' center 10% RGB values. Logsandroid.shading.mode.

Pass: YUV and JPEG images are similar and have less than 3.5% RMS (root-mean-square value of a signal) difference.

test_yuv_plus_raw_shading=1_raw.jpg test_yuv_plus_raw_shading=1_yuv.jpg
test_yuv_plus_raw_shading=1_raw.jpg test_yuv_plus_raw_shading=1_yuv.jpg

Impacted camera parameters:

  • SHADING_MODE

test_yuv_plus_raw10

Tests capturing a single frame as both RAW10 and YUV outputs. Uses a manual request with linear tonemap so RAW and YUV are expected to be the same. Compares RGB converted images' center 10% RGB values. Logsandroid.shading.mode.

Pass: RAW10 and YUV images are similar and have less than 3.5% RMS (root-mean-square value of a signal) difference.

Impacted camera parameters:

  • SHADING_MODE
test_yuv_plus_raw10_shading=1_raw test_yuv_plus_raw10_shading=1_yuv
test_yuv_plus_raw10_shading=1_raw.jpg test_yuv_plus_raw10_shading=1_yuv.jpg

test_yuv_plus_raw12

Tests capturing a single frame as both RAW12 and YUV outputs. Uses a manual request with linear tonemap so RAW and YUV are expected to be the same. Compares RGB converted images' center 10% RGB values. Logs android.shading.mode.

Pass: RAW12 and YUV images are similar and have less than 3.5% RMS (root-mean-square value of a signal) difference.

test_yuv_plus_raw12_shading=1_raw.jpg test_yuv_plus_raw12_shading=1_yuv.jpg
test_yuv_plus_raw12_shading=1_raw.jpg test_yuv_plus_raw12_shading=1_yuv.jpg

scene2_a

scene2_a has three faces with a gray background and neutral clothing. The faces are chosen to have a wide range of skin tones.

scene2_a

scene2_a

test_effects

Captures frame for supported camera effects and checks if they are generated correctly. The test only checks effects OFF and MONO, but saves images for all supported effects.

Pass: Captures the scene image with effects OFF and a monochrome image with effects set to MONO.

Impacted camera parameters:

  • CONTROL_EFFECT_MODE

test_effects_MONO

test_effects_MONO.jpg

test_faces

Tests face detection. Image is saved, but box and landmark information is tabulated in test_faces_stdout.txt.

Pass: Detects at least one face from the image.

Impacted camera parameters:

  • STATISTICS_FACE_DETECT_MODE

test_format_combos

Tests different combinations of output formats.

Pass: All the combinations are successfully captured.

test_jpeg_quality

Tests the camera JPEG compression quality. Step JPEG qualities through android.jpeg.quality.

Pass: Quantization matrix decreases with quality increase. (Matrix represents the division factor.)

test_jpeg_quality

Pixel 4 rear camera luma/chroma DQT matrix averages vs JPEG quality

test_jpeg_quality failed

Failed test example

Note that for very low quality images (jpeg.quality < 50), there is no increase in compression in the quantization matrix.

Impacted camera parameters:

  • JPEG_QUALITY

test_num_faces

Tests face detection.

Pass: Finds three faces.

Impacted camera parameters:

  • STATISTICS_FACES
  • STATISTICS_FACE_DETECT_MODE

test_num_faces_fd_mode_1

test_num_faces_fd_mode_1.jpg

scene2_b

test_auto_per_frame_control

Tests PER_FRAME_CONTROL properties for auto capture requests.

Pass: All of the PER_FRAME_CONTROL properties are present.

Impacted camera parameters:

  • COLOR_CORRECTION_GAIN
  • COLOR_CORRECTION_TRANSFORM
  • CONTROL_AE_STATE
  • CONTROL_AWB_STATE
  • CONTROL_POST_RAW_SENSITIVITY_BOOST
  • LENS_FOCUS_DISTANCE
  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY
  • STATISTICS_LENS_SHADING_MAP_MODE
  • STATISTICS_LENS_SHADING_CORRECTION_MAP
  • TONEMAP_CURVE
  • TONEMAP_MODE

test_auto_per_frame_control_frame_1

test_auto_per_frame_control_frame_1.jpg

test_auto_per_frame_control_frame_10

test_auto_per_frame_control_frame_10.jpg

test_auto_per_frame_control_frame_29

test_auto_per_frame_control_frame_29.jpg

test_auto_per_frame_control_plot

test_auto_per_frame_control_plot.png

test_num_faces

Tests face detection with increased skin tone diversity in face scenes.

Pass: Finds 3 faces.

Impacted camera parameters:

  • STATISTICS_FACES
  • STATISTICS_FACE_DETECT_MODE

test_num_faces_fd_mode_1

test_num_faces_fd_mode_1.jpg

scene2_c

test_num_faces

Tests face detection with increased skin tone diversity in face scenes.

Pass: Finds 3 faces.

Impacted camera parameters:

  • STATISTICS_FACES
  • STATISTICS_FACE_DETECT_MODE

test_num_faces_fd_mode_1

test_num_faces_fd_mode_1.jpg

scene2_d

test_num_faces

Tests face detection with increased skin tone diversity in face scenes.

Pass: Finds 3 faces.

Impacted camera parameters:

  • STATISTICS_FACES
  • STATISTICS_FACE_DETECT_MODE

Asserts

Assertsnum_faces == 3.

scene2_e

test_continuous_picture

50 VGA resolution frames are captured with the capture request first setting android.control.afMode = 4 (CONTINUOUS_PICTURE).

Pass: 3A system settles at the end of a 50-frame capture.

Impacted camera parameters:

  • CONTROL_AE_STATE
  • CONTROL_AE_REGIONS
  • CONTROL_AF_MODE
  • CONTROL_AF_STATE
  • CONTROL_AWB_STATE
  • CONTROL_CAPTURE_INTENT
  • CONTROL_MODE
  • CONTROL_POST_RAW_SENSITIVITY_BOOST
  • LENS_FOCAL_LENGTH
  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY

test_num_faces

Tests face detection with increased skin tone diversity in face scenes.

Pass: Finds 3 faces.

Impacted camera parameters:

  • STATISTICS_FACES
  • STATISTICS_FACE_DETECT_MODE

Asserts

Assertsnum_faces == 3.

scene3

Scene3 uses the ISO12233 chart, and most tests use a chart extractor method to find the chart in the scene. For this reason, most of the saved images don't have borders like the images for scenes 1, 2 or 4, but only the chart.

test_3a_consistency

Tests for 3A consistency.

Pass: 3A converges for exposure, gain, awb (auto white balance), and fd (focus distance) three times within tolerance.

test_edge_enhancement

Tests that the android.edge.mode parameter is applied correctly. Captures non-reprocess images for each edge mode and returns sharpness of the output image and the capture result metadata. Processes a capture request with a given edge mode, sensitivity, exposure time, focus distance, and output surface parameter.

Pass: Fast mode isn't sharper than HQ (high quality) mode.

Impacted camera parameters:

  • EDGE_MODE
  • LENS_FOCUS_DISTANCE
  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY

test_edge_enhancement_edge=0

test_edge_enhancement_edge=0.jpg

test_edge_enhancement_edge=1

test_edge_enhancement_edge=1.jpg (fast mode)

test_edge_enhancement_edge=2

test_edge_enhancement_edge=2.jpg (high quality mode)

test_flip_mirror

Tests if image is properly oriented. Mirrored, flipped, or rotated images can be identified by the diamond feature near the center.

Pass: Image isn't flipped, mirrored or rotated.

test_flip_mirror_scene_patch

test_flip_mirror_scene_patch.jpg

test_lens_movement_reporting

Tests if the lens movement flag is properly reported. Captures a burst of 24 images with the first 12 frames at the optimum focus distance (as found by 3A) and the last 12 frames at the minimum focus distance. Around frame 12, the lens moves causing the sharpness to drop. The sharpness eventually stabilize as the lens moves to the final position. The lens movement flag should be asserted in all frames where the sharpness is intermediate to sharpness in the first 10 frames with the lens stationary at optimum focal distance, and the final 10 frames where the lens is stationary in the minimum focal distance. The exact frame the lens moves isn't important: what is checked is that the movement flag is asserted when the lens is moving.

Pass: Lens movement flag is True in the frame with sharpness change.

Impacted camera parameters:

  • LENS_FOCUS_DISTANCE
  • LENS_STATE
  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY
  • SENSOR_TIMESTAMP

test_lens_position

Tests if the focus position is properly reported for moving lenses.

Pass: Correct focus positions are reported.

Impacted camera parameters:

  • LENS_FOCUS_DISTANCE
  • LENS_STATE
  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY
  • SENSOR_TIMESTAMP

test_reprocess_edge_enhancement

Returns sharpness of the output images and the capture result metadata. Processes a capture request with a given edge mode, sensitivity, exposure time, focus distance, output surface parameter, and reprocess format.

Pass: Sharpness for the different edge modes is correct.

Impacted camera parameters:

  • EDGE_MODE
  • LENS_FOCUS_DISTANCE
  • REPROCESS_EFFECTIVE_EXPOSURE_FACTOR
  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY

scene4

Scene4 consists of a black circle on a white background inside a square.

scene4

scene4

test_aspect_ratio_and_crop

Takes pictures of a circle inside of a square over all formats. Verifies that the aspect ratio of the circle doesn't change, the cropped images keep the circle in center, and the circle size doesn't change for a constant format or with different resolution (field of view check).

Pass: Images aren't stretched, the center of images don't differ by more than 3%, and the maximum possible FOV (field of view) is preserved.

Impacted camera parameters:

  • LENS_DISTORTION
  • LENS_FOCAL_LENGTH
  • LENS_INTRINSIC_CALIBRATION

test_multi_camera_alignment

Tests the multi camera system parameters related to camera spacing. Using the multi-camera physical sub-cameras, takes a picture with one of the physical cameras. Finds the circle center. Projects the circle center to the world coordinates for each camera. Compares the difference between the cameras' circle centers in world coordinates. Reprojects the world coordinate back to pixel coordinates and compares against originals as a validity check. Compares the circle sizes checking if the focal lengths of the cameras are different.

Pass: Focal lengths and circles sizes are consistent.

Impacted camera parameters:

  • DISTORTION_CORRECTION_MODE
  • LENS_DISTORTION
  • LENS_FOCAL_LENGTH
  • LENS_INTRINSIC_CALIBRATION
  • LENS_POSE_TRANSLATION
  • LENS_POSE_ROTATION
  • SCALER_CROP_REGION

scene5/diffuser

test_lens_shading_and_color_uniformity

Tests that the lens shading correction is applied appropriately, and color of a monochrome uniform scene is evenly distributed. Performs this test on a YUV frame with auto 3A. Lens shading is evaluated based on the y channel. Measures the average y value for each sample block specified, and determines pass or fail by comparing with the center y value. The color uniformity test is evaluated in r/g and b/g space.

Pass: At the specified radius of the image, the variance of r/g and b/g value must be less than 20% to pass the test.

scene6

Scene6 is a grid of small circles with a square in one corner to indicate orientation. The small circles are needed to test zoom function over a large range.

scene6

scene6

test_zoom

Tests the camera zoom behavior. Takes captures over the zoom range and checks if the circles get bigger as the camera zooms in.

Pass: Relative size of captured circle is accurate against requested zoom ratio to ensure camera is zooming correctly.

Impacted camera parameters:

  • CONTROL_ZOOM_RATIO
  • LENS_FOCAL_LENGTH

test_zoom

test_zoom to find the contour of the circle closest to the center.

scene_change

test_scene_change

The scene change makes use of the tablet displaying a face scene and then turns the tablet on and off to create a scene change. The scene reuses scene2_e, but is in a separate scene because of the required tablet control. Additionally, for manual testing, the scene change can be accomplished by waving your hand in front of the camera.

Pass: Theandroid.control.afSceneChange flag is asserted with a scene change.

Impacted camera parameters:

  • CONTROL_AE_STATE
  • CONTROL_AF_STATE
  • CONTROL_AWB_STATE
  • CONTROL_AF_SCENE_CHANGE
  • CONTROL_AWB_STATE
  • SENSOR_EXPOSURE_TIME
  • SENSOR_SENSITIVITY
  • LENS_FOCAL_LENGTH

sensor_fusion

Sensor fusion tests require specific phone movement in front of a checkerboard pattern. The sensor_fusion tests can be automated with the Sensor Fusion Box.

checkerboard

Image of checkerboard

test_multi_camera_frame_sync

Tests that frame timestamps captured by logical camera are within 10 ms by computing angles of squares within the checkerboard to determine the timestamp.

Pass: Angle between images from each camera doesn't change appreciably as phone is rotated.

Impacted camera parameters:

  • LENS_FOCUS_DISTANCE

test_sensor_fusion

Tests the timestamp difference between the camera and the gyroscope for AR and VR applications. Phone is rotated 90 degrees 10 times in front of the checkerboard pattern. Motion is about 2 s round trip. This test is skipped if no gyroscope is included or if the REALTIME parameter is not enabled.

Pass: Camera and gyroscope timestamps' offset is less than 1 ms.

Impacted camera parameters:

  • CONTROL_AE_TARGET_FPS_RANGE
  • LENS_FOCUS_DISTANCE
  • SENSOR_EXPOSURE_TIME
  • SENSOR_FRAME_DURATION
  • SENSOR_ROLLING_SHUTTER_SKEW
  • SENSOR_TIMESTAMP