# Copyright 2013 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 os
import os.path
import sys
import re
import json
import tempfile
import time
import unittest
import subprocess
import math
def int_to_rational(i):
"""Function to convert Python integers to Camera2 rationals.
Args:
i: Python integer or list of integers.
Returns:
Python dictionary or list of dictionaries representing the given int(s)
as rationals with denominator=1.
"""
if isinstance(i, list):
return [{"numerator":val, "denominator":1} for val in i]
else:
return {"numerator":i, "denominator":1}
def float_to_rational(f, denom=128):
"""Function to convert Python floats to Camera2 rationals.
Args:
f: Python float or list of floats.
denom: (Optonal) the denominator to use in the output rationals.
Returns:
Python dictionary or list of dictionaries representing the given
float(s) as rationals.
"""
if isinstance(f, list):
return [{"numerator":math.floor(val*denom+0.5), "denominator":denom}
for val in f]
else:
return {"numerator":math.floor(f*denom+0.5), "denominator":denom}
def rational_to_float(r):
"""Function to convert Camera2 rational objects to Python floats.
Args:
r: Rational or list of rationals, as Python dictionaries.
Returns:
Float or list of floats.
"""
if isinstance(r, list):
return [float(val["numerator"]) / float(val["denominator"])
for val in r]
else:
return float(r["numerator"]) / float(r["denominator"])
def manual_capture_request(sensitivity, exp_time, linear_tonemap=False):
"""Return a capture request with everything set to manual.
Uses identity/unit color correction, and the default tonemap curve.
Optionally, the tonemap can be specified as being linear.
Args:
sensitivity: The sensitivity value to populate the request with.
exp_time: The exposure time, in nanoseconds, to populate the request
with.
linear_tonemap: [Optional] whether a linear tonemap should be used
in this request.
Returns:
The default manual capture request, ready to be passed to the
its.device.do_capture function.
"""
req = {
"android.control.mode": 0,
"android.control.aeMode": 0,
"android.control.awbMode": 0,
"android.control.afMode": 0,
"android.control.effectMode": 0,
"android.sensor.frameDuration": 0,
"android.sensor.sensitivity": sensitivity,
"android.sensor.exposureTime": exp_time,
"android.colorCorrection.mode": 0,
"android.colorCorrection.transform":
int_to_rational([1,0,0, 0,1,0, 0,0,1]),
"android.colorCorrection.gains": [1,1,1,1],
"android.tonemap.mode": 1,
}
if linear_tonemap:
req["android.tonemap.mode"] = 0
req["android.tonemap.curveRed"] = [0.0,0.0, 1.0,1.0]
req["android.tonemap.curveGreen"] = [0.0,0.0, 1.0,1.0]
req["android.tonemap.curveBlue"] = [0.0,0.0, 1.0,1.0]
return req
def auto_capture_request():
"""Return a capture request with everything set to auto.
"""
return {
"android.control.mode": 1,
"android.control.aeMode": 1,
"android.control.awbMode": 1,
"android.control.afMode": 1,
"android.colorCorrection.mode": 1,
"android.tonemap.mode": 1,
}
def get_available_output_sizes(fmt, props):
"""Return a sorted list of available output sizes for a given format.
Args:
fmt: the output format, as a string in ["jpg", "yuv", "raw"].
props: the object returned from its.device.get_camera_properties().
Returns:
A sorted list of (w,h) tuples (sorted large-to-small).
"""
fmt_codes = {"raw":0x20, "raw10":0x25, "yuv":0x23, "jpg":0x100, "jpeg":0x100}
configs = props['android.scaler.streamConfigurationMap']\
['availableStreamConfigurations']
fmt_configs = [cfg for cfg in configs if cfg['format'] == fmt_codes[fmt]]
out_configs = [cfg for cfg in fmt_configs if cfg['input'] == False]
out_sizes = [(cfg['width'],cfg['height']) for cfg in out_configs]
out_sizes.sort(reverse=True)
return out_sizes
def get_fastest_manual_capture_settings(props):
"""Return a capture request and format spec for the fastest capture.
Args:
props: the object returned from its.device.get_camera_properties().
Returns:
Two values, the first is a capture request, and the second is an output
format specification, for the fastest possible (legal) capture that
can be performed on this device (with the smallest output size).
"""
fmt = "yuv"
size = get_available_output_sizes(fmt, props)[-1]
out_spec = {"format":fmt, "width":size[0], "height":size[1]}
s = min(props['android.sensor.info.sensitivityRange'])
e = min(props['android.sensor.info.exposureTimeRange'])
req = manual_capture_request(s,e)
return req, out_spec
class __UnitTest(unittest.TestCase):
"""Run a suite of unit tests on this module.
"""
def test_int_to_rational(self):
"""Unit test for int_to_rational.
"""
self.assertEqual(int_to_rational(10),
{"numerator":10,"denominator":1})
self.assertEqual(int_to_rational([1,2]),
[{"numerator":1,"denominator":1},
{"numerator":2,"denominator":1}])
def test_float_to_rational(self):
"""Unit test for float_to_rational.
"""
self.assertEqual(float_to_rational(0.5001, 64),
{"numerator":32, "denominator":64})
def test_rational_to_float(self):
"""Unit test for rational_to_float.
"""
self.assertTrue(
abs(rational_to_float({"numerator":32,"denominator":64})-0.5)
< 0.0001)
if __name__ == '__main__':
unittest.main()