# Copyright 2015 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.
import its.image
import its.caps
import its.device
import its.objects
import its.target
import math
import matplotlib
import matplotlib.pyplot
import numpy
import os.path
import pylab
def test_edge_mode(cam, edge_mode, sensitivity, exp, fd, out_surface,
reprocess_format=None):
"""Return sharpness of the output image and the capture result metadata
for a capture request with the given edge mode, sensitivity, exposure
time, focus distance, output surface parameter, and reprocess format
(None for a regular request.)
Args:
cam: An open device session.
edge_mode: Edge mode for the request as defined in android.edge.mode
sensitivity: Sensitivity for the request as defined in
android.sensor.sensitivity
exp: Exposure time for the request as defined in
android.sensor.exposureTime.
fd: Focus distance for the request as defined in
android.lens.focusDistance
output_surface: Specifications of the output image format and size.
reprocess_format: (Optional) The reprocessing format. If not None,
reprocessing will be enabled.
Returns:
Object containing reported edge mode and the sharpness of the output
image, keyed by the following strings:
"edge_mode"
"sharpness"
"""
NAME = os.path.basename(__file__).split(".")[0]
NUM_SAMPLES = 4
req = its.objects.manual_capture_request(sensitivity, exp)
req["android.lens.focusDistance"] = fd
req["android.edge.mode"] = edge_mode
if (reprocess_format != None):
req["android.reprocess.effectiveExposureFactor"] = 1.0
sharpness_list = []
for n in range(NUM_SAMPLES):
cap = cam.do_capture(req, out_surface, reprocess_format)
img = its.image.convert_capture_to_rgb_image(cap)
if n == 0:
its.image.write_image(img, "%s_reprocess_fmt_%s_edge=%d.jpg" %
(NAME, reprocess_format, edge_mode))
res_edge_mode = cap["metadata"]["android.edge.mode"]
tile = its.image.get_image_patch(img, 0.45, 0.45, 0.1, 0.1)
sharpness_list.append(its.image.compute_image_sharpness(tile))
ret = {}
ret["edge_mode"] = res_edge_mode
ret["sharpness"] = numpy.mean(sharpness_list)
return ret
def main():
"""Test that the android.edge.mode param is applied when set for
reprocessing requests.
Capture non-reprocess images for each edge mode and calculate their
sharpness as a baseline.
Capture reprocessed images for each supported reprocess format and edge_mode
mode. Calculate the sharpness of reprocessed images and compare them against
the sharpess of non-reprocess images.
"""
THRESHOLD_RELATIVE_SHARPNESS_DIFF = 0.15
with its.device.ItsSession() as cam:
props = cam.get_camera_properties()
its.caps.skip_unless(its.caps.read_3a(props) and
its.caps.per_frame_control(props) and
its.caps.edge_mode(props, 0) and
(its.caps.yuv_reprocess(props) or
its.caps.private_reprocess(props)))
# If reprocessing is supported, ZSL EE mode must be avaiable.
assert(its.caps.edge_mode(props, 3))
reprocess_formats = []
if (its.caps.yuv_reprocess(props)):
reprocess_formats.append("yuv")
if (its.caps.private_reprocess(props)):
reprocess_formats.append("private")
size = its.objects.get_available_output_sizes("jpg", props)[0]
out_surface = {"width":size[0], "height":size[1], "format":"jpg"}
# Get proper sensitivity, exposure time, and focus distance.
s,e,_,_,fd = cam.do_3a(get_results=True)
# Get the sharpness for each edge mode for regular requests
sharpness_regular = []
edge_mode_reported_regular = []
for edge_mode in range(4):
# Skip unavailable modes
if not its.caps.edge_mode(props, edge_mode):
edge_mode_reported_regular.append(edge_mode)
sharpness_regular.append(0)
continue
ret = test_edge_mode(cam, edge_mode, s, e, fd, out_surface)
edge_mode_reported_regular.append(ret["edge_mode"])
sharpness_regular.append(ret["sharpness"])
print "Reported edge modes:", edge_mode_reported_regular
print "Sharpness with EE mode [0,1,2,3]:", sharpness_regular
# Get the sharpness for each reprocess format and edge mode for
# reprocess requests.
sharpnesses_reprocess = []
edge_mode_reported_reprocess = []
for reprocess_format in reprocess_formats:
# List of sharpness
sharpnesses = []
edge_mode_reported = []
for edge_mode in range(4):
# Skip unavailable modes
if not its.caps.edge_mode(props, edge_mode):
edge_mode_reported.append(edge_mode)
sharpnesses.append(0)
continue
ret = test_edge_mode(cam, edge_mode, s, e, fd, out_surface,
reprocess_format)
edge_mode_reported.append(ret["edge_mode"])
sharpnesses.append(ret["sharpness"])
sharpnesses_reprocess.append(sharpnesses)
edge_mode_reported_reprocess.append(edge_mode_reported)
print "Reported edge modes:", edge_mode_reported
print "Sharpness with EE mode [0,1,2,3] for %s reprocess:" % \
(reprocess_format) , sharpnesses
# Verify HQ(2) is sharper than OFF(0)
assert(sharpness_regular[2] > sharpness_regular[0])
# Verify ZSL(3) is similar to OFF(0)
assert(numpy.isclose(sharpness_regular[3], sharpness_regular[0],
THRESHOLD_RELATIVE_SHARPNESS_DIFF))
# Verify OFF(0) is not sharper than FAST(1)
assert(sharpness_regular[1] >
sharpness_regular[0] * (1.0 - THRESHOLD_RELATIVE_SHARPNESS_DIFF))
# Verify FAST(1) is not sharper than HQ(2)
assert(sharpness_regular[2] >
sharpness_regular[1] * (1.0 - THRESHOLD_RELATIVE_SHARPNESS_DIFF))
for reprocess_format in range(len(reprocess_formats)):
# Verify HQ(2) is sharper than OFF(0)
assert(sharpnesses_reprocess[reprocess_format][2] >
sharpnesses_reprocess[reprocess_format][0])
# Verify ZSL(3) is similar to OFF(0)
assert(numpy.isclose(sharpnesses_reprocess[reprocess_format][3],
sharpnesses_reprocess[reprocess_format][0],
THRESHOLD_RELATIVE_SHARPNESS_DIFF))
# Verify OFF(0) is not sharper than FAST(1)
assert(sharpnesses_reprocess[reprocess_format][1] >
sharpnesses_reprocess[reprocess_format][0] *
(1.0 - THRESHOLD_RELATIVE_SHARPNESS_DIFF))
# Verify FAST(1) is not sharper than HQ(2)
assert(sharpnesses_reprocess[reprocess_format][2] >
sharpnesses_reprocess[reprocess_format][1] *
(1.0 - THRESHOLD_RELATIVE_SHARPNESS_DIFF))
# Verify reprocessing HQ(2) is similar to regular HQ(2) relative to
# OFF(0)
assert(numpy.isclose(sharpnesses_reprocess[reprocess_format][2] /
sharpnesses_reprocess[reprocess_format][0],
sharpness_regular[2] / sharpness_regular[0],
THRESHOLD_RELATIVE_SHARPNESS_DIFF))
if __name__ == '__main__':
main()