1b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala/* 2b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * Copyright (C) 2013 The Android Open Source Project 3b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * 4b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * Licensed under the Apache License, Version 2.0 (the "License"); 5b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * you may not use this file except in compliance with the License. 6b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * You may obtain a copy of the License at 7b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * 8b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * http://www.apache.org/licenses/LICENSE-2.0 9b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * 10b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * Unless required by applicable law or agreed to in writing, software 11b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * distributed under the License is distributed on an "AS IS" BASIS, 12b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * See the License for the specific language governing permissions and 14b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * limitations under the License. 15b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala */ 16b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala 172f1a2e423e0fbb64467d6fcfa4e82c6384f31210Eino-Ville Talvalapackage android.hardware.camera2; 18b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala 198b905578b54041f7d0b8dc04dd158d16d28262a1Eino-Ville Talvalaimport android.annotation.NonNull; 20cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkinimport android.hardware.camera2.impl.CameraMetadataNative; 216c76f58f31635c19c14ae161f96dad2082537860Igor Murashkinimport android.hardware.camera2.impl.PublicKey; 226c76f58f31635c19c14ae161f96dad2082537860Igor Murashkinimport android.hardware.camera2.impl.SyntheticKey; 23d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkinimport android.util.Log; 24b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala 257a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkinimport java.lang.reflect.Field; 2603fdb14ba8779f2941ad2f7c627c0be11f92cea5Igor Murashkinimport java.lang.reflect.Modifier; 277a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkinimport java.util.ArrayList; 28cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkinimport java.util.Arrays; 297a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkinimport java.util.Collections; 307a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkinimport java.util.List; 317a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin 32b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala/** 33b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * The base class for camera controls and information. 34b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * 357a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * <p> 36b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * This class defines the basic key/value map used for querying for camera 37b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * characteristics or capture results, and for setting camera request 38b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * parameters. 397a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * </p> 407a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * 417a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * <p> 427a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * All instances of CameraMetadata are immutable. The list of keys with {@link #getKeys()} 43d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin * never changes, nor do the values returned by any key with {@code #get} throughout 447a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * the lifetime of the object. 457a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * </p> 46b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * 47b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * @see CameraDevice 48b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * @see CameraManager 4968f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * @see CameraCharacteristics 50b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala **/ 51d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkinpublic abstract class CameraMetadata<TKey> { 52d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin 53d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin private static final String TAG = "CameraMetadataAb"; 54a78791f22af6c6985d186494737468bb19b69540Eino-Ville Talvala private static final boolean DEBUG = false; 5570725500dcf3b666b43d50563d64705aab58d2d3Igor Murashkin 56b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala /** 5768f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * Set a camera metadata field to a value. The field definitions can be 5868f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * found in {@link CameraCharacteristics}, {@link CaptureResult}, and 5968f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * {@link CaptureRequest}. 6068f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * 6168f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * @param key The metadata field to write. 6268f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * @param value The value to set the field to, which must be of a matching 6368f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * type to the key. 6468f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * 6570c2207c34cf0e6b3b383b1b1500ff5385aa51a6Eino-Ville Talvala * @hide 66b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala */ 6770c2207c34cf0e6b3b383b1b1500ff5385aa51a6Eino-Ville Talvala protected CameraMetadata() { 68b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala } 69b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala 70b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala /** 717a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * Get a camera metadata field value. 727a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * 737a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * <p>The field definitions can be 7468f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * found in {@link CameraCharacteristics}, {@link CaptureResult}, and 757a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * {@link CaptureRequest}.</p> 767a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * 777a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * <p>Querying the value for the same key more than once will return a value 787a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * which is equal to the previous queried value.</p> 79b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala * 80b519cc52ecba8f44da31173c9fc90a7b66d52b79Igor Murashkin * @throws IllegalArgumentException if the key was not valid 81b519cc52ecba8f44da31173c9fc90a7b66d52b79Igor Murashkin * 8224eb8a313f1a80a35566b8dc456ec2684a05a22eBenjamin Hendricks * @param key The metadata field to read. 8324eb8a313f1a80a35566b8dc456ec2684a05a22eBenjamin Hendricks * @return The value of that key, or {@code null} if the field is not set. 84d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin * 85d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin * @hide 86b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala */ 87d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin protected abstract <T> T getProtected(TKey key); 88d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin 89d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin /** 90d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin * @hide 91d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin */ 92d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin protected abstract Class<TKey> getKeyClass(); 93b2675542c2f414154125b534767ae0903fba581eEino-Ville Talvala 947a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin /** 957a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * Returns a list of the keys contained in this map. 967a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * 977a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * <p>The list returned is not modifiable, so any attempts to modify it will throw 987a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * a {@code UnsupportedOperationException}.</p> 997a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * 100d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin * <p>All values retrieved by a key from this list with {@code #get} are guaranteed to be 1017a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * non-{@code null}. Each key is only listed once in the list. The order of the keys 1027a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * is undefined.</p> 1037a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * 1047a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * @return List of the keys contained in this map. 1057a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin */ 106d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin @SuppressWarnings("unchecked") 1078b905578b54041f7d0b8dc04dd158d16d28262a1Eino-Ville Talvala @NonNull 108d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin public List<TKey> getKeys() { 109d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin Class<CameraMetadata<TKey>> thisClass = (Class<CameraMetadata<TKey>>) getClass(); 110cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin return Collections.unmodifiableList( 111cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin getKeysStatic(thisClass, getKeyClass(), this, /*filterTags*/null)); 1127a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin } 1137a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin 1147a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin /** 1157a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * Return a list of all the Key<?> that are declared as a field inside of the class 1167a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * {@code type}. 1177a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * 1187a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * <p> 1197a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * Optionally, if {@code instance} is not null, then filter out any keys with null values. 1207a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin * </p> 121cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin * 122cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin * <p> 123cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin * Optionally, if {@code filterTags} is not {@code null}, then filter out any keys 124cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin * whose native {@code tag} is not in {@code filterTags}. The {@code filterTags} array will be 125cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin * sorted as a side effect. 126cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin * </p> 1277a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin */ 128d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin /*package*/ @SuppressWarnings("unchecked") 129d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin static <TKey> ArrayList<TKey> getKeysStatic( 130d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin Class<?> type, Class<TKey> keyClass, 131cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin CameraMetadata<TKey> instance, 132cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin int[] filterTags) { 133d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin 134a78791f22af6c6985d186494737468bb19b69540Eino-Ville Talvala if (DEBUG) Log.v(TAG, "getKeysStatic for " + type); 135d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin 136696bbee963eb67875371fb9063308f60b28d679dIgor Murashkin // TotalCaptureResult does not have any of the keys on it, use CaptureResult instead 137696bbee963eb67875371fb9063308f60b28d679dIgor Murashkin if (type.equals(TotalCaptureResult.class)) { 138696bbee963eb67875371fb9063308f60b28d679dIgor Murashkin type = CaptureResult.class; 139696bbee963eb67875371fb9063308f60b28d679dIgor Murashkin } 140696bbee963eb67875371fb9063308f60b28d679dIgor Murashkin 141cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin if (filterTags != null) { 142cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin Arrays.sort(filterTags); 143cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin } 144cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin 145d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin ArrayList<TKey> keyList = new ArrayList<TKey>(); 1467a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin 1477a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin Field[] fields = type.getDeclaredFields(); 1487a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin for (Field field : fields) { 14903fdb14ba8779f2941ad2f7c627c0be11f92cea5Igor Murashkin // Filter for Keys that are public 150d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin if (field.getType().isAssignableFrom(keyClass) && 15103fdb14ba8779f2941ad2f7c627c0be11f92cea5Igor Murashkin (field.getModifiers() & Modifier.PUBLIC) != 0) { 152d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin 153d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin TKey key; 1547a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin try { 155d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin key = (TKey) field.get(instance); 1567a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin } catch (IllegalAccessException e) { 1577a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin throw new AssertionError("Can't get IllegalAccessException", e); 1587a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin } catch (IllegalArgumentException e) { 1597a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin throw new AssertionError("Can't get IllegalArgumentException", e); 1607a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin } 161d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin 162d6d65154e55612b489aae95b60f3145f3b81f3b4Igor Murashkin if (instance == null || instance.getProtected(key) != null) { 1636c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin if (shouldKeyBeAdded(key, field, filterTags)) { 164cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin keyList.add(key); 165cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin 166a78791f22af6c6985d186494737468bb19b69540Eino-Ville Talvala if (DEBUG) { 167cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin Log.v(TAG, "getKeysStatic - key was added - " + key); 168cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin } 169a78791f22af6c6985d186494737468bb19b69540Eino-Ville Talvala } else if (DEBUG) { 170cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin Log.v(TAG, "getKeysStatic - key was filtered - " + key); 171cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin } 1727a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin } 1737a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin } 1747a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin } 1757a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin 176c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk ArrayList<TKey> vendorKeys = CameraMetadataNative.getAllVendorKeys(keyClass); 177c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk 178c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk if (vendorKeys != null) { 179c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk for (TKey k : vendorKeys) { 180c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk String keyName; 181c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk if (k instanceof CaptureRequest.Key<?>) { 182c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk keyName = ((CaptureRequest.Key<?>) k).getName(); 183c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk } else if (k instanceof CaptureResult.Key<?>) { 184c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk keyName = ((CaptureResult.Key<?>) k).getName(); 185c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk } else if (k instanceof CameraCharacteristics.Key<?>) { 186c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk keyName = ((CameraCharacteristics.Key<?>) k).getName(); 187c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk } else { 188c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk continue; 189c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk } 190c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk 191c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk if (filterTags == null || Arrays.binarySearch(filterTags, 192c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk CameraMetadataNative.getTag(keyName)) >= 0) { 193c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk keyList.add(k); 194c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk } 195c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk } 196c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk } 197c620eb7e864e5505f5a6f867223fa8e525669d0bRuben Brunk 1987a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin return keyList; 1997a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin } 2007a36a0fbb0a5f14047a3680668da954beca05dcbIgor Murashkin 201cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin @SuppressWarnings("rawtypes") 2026c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin private static <TKey> boolean shouldKeyBeAdded(TKey key, Field field, int[] filterTags) { 203cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin if (key == null) { 204cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin throw new NullPointerException("key must not be null"); 205cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin } 206cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin 207cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin CameraMetadataNative.Key nativeKey; 208cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin 209cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin /* 210cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin * Get the native key from the public api key 211cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin */ 212cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin if (key instanceof CameraCharacteristics.Key) { 213cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin nativeKey = ((CameraCharacteristics.Key)key).getNativeKey(); 214cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin } else if (key instanceof CaptureResult.Key) { 215cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin nativeKey = ((CaptureResult.Key)key).getNativeKey(); 216cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin } else if (key instanceof CaptureRequest.Key) { 217cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin nativeKey = ((CaptureRequest.Key)key).getNativeKey(); 218cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin } else { 219cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin // Reject fields that aren't a key 220cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin throw new IllegalArgumentException("key type must be that of a metadata key"); 221cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin } 222cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin 2236c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin if (field.getAnnotation(PublicKey.class) == null) { 2246c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin // Never expose @hide keys up to the API user 2256c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin return false; 2266c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin } 2276c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin 228cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin // No filtering necessary 229cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin if (filterTags == null) { 230cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin return true; 231cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin } 232cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin 2336c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin if (field.getAnnotation(SyntheticKey.class) != null) { 2346c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin // This key is synthetic, so calling #getTag will throw IAE 2356c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin 2366c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin // TODO: don't just assume all public+synthetic keys are always available 2376c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin return true; 2386c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin } 2396c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin 2406c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin /* 2416c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin * Regular key: look up it's native tag and see if it's in filterTags 2426c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin */ 2436c76f58f31635c19c14ae161f96dad2082537860Igor Murashkin 244cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin int keyTag = nativeKey.getTag(); 245cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin 246cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin // non-negative result is returned iff the value is in the array 247cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin return Arrays.binarySearch(filterTags, keyTag) >= 0; 248cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin } 249cc542a4e7441202aef8c54af6675fcb5d5c6f63fIgor Murashkin 2505a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /*@O~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~ 2515a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * The enum values below this point are generated from metadata 2525a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * definitions in /system/media/camera/docs. Do not modify by hand or 2535a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * modify the comment blocks at the start or end. 2545a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala *~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~*/ 2555a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 2565a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 257ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He // Enumeration values for CameraCharacteristics#LENS_INFO_FOCUS_DISTANCE_CALIBRATION 258ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He // 259ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He 260ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He /** 261ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * <p>The lens focus distance is not accurate, and the units used for 262e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * {@link CaptureRequest#LENS_FOCUS_DISTANCE android.lens.focusDistance} do not correspond to any physical units.</p> 263e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Setting the lens to the same focus distance on separate occasions may 264ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * result in a different real focus distance, depending on factors such 265ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * as the orientation of the device, the age of the focusing mechanism, 266ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * and the device temperature. The focus distance value will still be 267ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * in the range of <code>[0, {@link CameraCharacteristics#LENS_INFO_MINIMUM_FOCUS_DISTANCE android.lens.info.minimumFocusDistance}]</code>, where 0 268ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * represents the farthest focus.</p> 269ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * 270ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * @see CaptureRequest#LENS_FOCUS_DISTANCE 271ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * @see CameraCharacteristics#LENS_INFO_MINIMUM_FOCUS_DISTANCE 272ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * @see CameraCharacteristics#LENS_INFO_FOCUS_DISTANCE_CALIBRATION 273ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He */ 274ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He public static final int LENS_INFO_FOCUS_DISTANCE_CALIBRATION_UNCALIBRATED = 0; 275ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He 276ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He /** 277e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The lens focus distance is measured in diopters.</p> 278e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>However, setting the lens to the same focus distance 279e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * on separate occasions may result in a different real 280e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * focus distance, depending on factors such as the 281e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * orientation of the device, the age of the focusing 282e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * mechanism, and the device temperature.</p> 283ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * @see CameraCharacteristics#LENS_INFO_FOCUS_DISTANCE_CALIBRATION 284ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He */ 285ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He public static final int LENS_INFO_FOCUS_DISTANCE_CALIBRATION_APPROXIMATE = 1; 286ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He 287ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He /** 288e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The lens focus distance is measured in diopters, and 289e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * is calibrated.</p> 290e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The lens mechanism is calibrated so that setting the 291e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * same focus distance is repeatable on multiple 292e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * occasions with good accuracy, and the focus distance 293e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * corresponds to the real physical distance to the plane 294e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * of best focus.</p> 295ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He * @see CameraCharacteristics#LENS_INFO_FOCUS_DISTANCE_CALIBRATION 296ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He */ 297ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He public static final int LENS_INFO_FOCUS_DISTANCE_CALIBRATION_CALIBRATED = 2; 298ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He 299ff41393d06b43223aacf3cde6c5139b9b0d1d161Zhijun He // 30068f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin // Enumeration values for CameraCharacteristics#LENS_FACING 3015a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 3025a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 3035a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 304e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device faces the same direction as the device's screen.</p> 30568f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * @see CameraCharacteristics#LENS_FACING 3065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 3075a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int LENS_FACING_FRONT = 0; 3085a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 3095a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 310e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device faces the opposite direction as the device's screen.</p> 31168f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * @see CameraCharacteristics#LENS_FACING 3125a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 3135a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int LENS_FACING_BACK = 1; 3145a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 315503e815a6f393f21972e322faff16f2a3cfe07a3Zhijun He /** 316503e815a6f393f21972e322faff16f2a3cfe07a3Zhijun He * <p>The camera device is an external camera, and has no fixed facing relative to the 317503e815a6f393f21972e322faff16f2a3cfe07a3Zhijun He * device's screen.</p> 318503e815a6f393f21972e322faff16f2a3cfe07a3Zhijun He * @see CameraCharacteristics#LENS_FACING 319503e815a6f393f21972e322faff16f2a3cfe07a3Zhijun He */ 320503e815a6f393f21972e322faff16f2a3cfe07a3Zhijun He public static final int LENS_FACING_EXTERNAL = 2; 321503e815a6f393f21972e322faff16f2a3cfe07a3Zhijun He 3225a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 323e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin // Enumeration values for CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 324e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin // 325e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin 326e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin /** 327e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <p>The minimal set of capabilities that every camera 328e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * device (regardless of {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel}) 32908bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * supports.</p> 3300b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * <p>This capability is listed by all normal devices, and 33108bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * indicates that the camera device has a feature set 33208bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * that's comparable to the baseline requirements for the 33308bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * older android.hardware.Camera API.</p> 3340b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * <p>Devices with the DEPTH_OUTPUT capability might not list this 3350b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * capability, indicating that they support only depth measurement, 3360b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * not standard color output.</p> 337e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * 338e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL 339e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 340e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin */ 341e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin public static final int REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE = 0; 342e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin 343e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin /** 344e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <p>The camera device can be manually controlled (3A algorithms such 345e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * as auto-exposure, and auto-focus can be bypassed). 34650f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * The camera device supports basic manual control of the sensor image 34750f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * acquisition related stages. This means the following controls are 34850f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * guaranteed to be supported:</p> 349e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <ul> 35050f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * <li>Manual frame duration control<ul> 35150f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * <li>{@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration}</li> 35250f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * <li>{@link CameraCharacteristics#SENSOR_INFO_MAX_FRAME_DURATION android.sensor.info.maxFrameDuration}</li> 35350f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * </ul> 35450f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * </li> 355e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>Manual exposure control<ul> 356e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>{@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime}</li> 357e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>{@link CameraCharacteristics#SENSOR_INFO_EXPOSURE_TIME_RANGE android.sensor.info.exposureTimeRange}</li> 358e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 359e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </li> 360e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>Manual sensitivity control<ul> 361e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>{@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}</li> 362e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>{@link CameraCharacteristics#SENSOR_INFO_SENSITIVITY_RANGE android.sensor.info.sensitivityRange}</li> 363e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 364e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </li> 365e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <li>Manual lens control (if the lens is adjustable)<ul> 366e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>android.lens.*</li> 367e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 368e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </li> 369e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <li>Manual flash control (if a flash unit is present)<ul> 370e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>android.flash.*</li> 371e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 372e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </li> 373e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>Manual black level locking<ul> 374e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>{@link CaptureRequest#BLACK_LEVEL_LOCK android.blackLevel.lock}</li> 375e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 376e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </li> 3777e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * <li>Auto exposure lock<ul> 3787e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * <li>{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock}</li> 3797e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * </ul> 3807e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * </li> 381e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 382e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <p>If any of the above 3A algorithms are enabled, then the camera 383e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * device will accurately report the values applied by 3A in the 384e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * result.</p> 38550f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * <p>A given camera device may also support additional manual sensor controls, 38650f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * but this capability only covers the above list of controls.</p> 3873e4fed203fe7c945c53c6d6bb9f160932a1d15b3Ruben Brunk * <p>If this is supported, {@link CameraCharacteristics#SCALER_STREAM_CONFIGURATION_MAP android.scaler.streamConfigurationMap} will 3883e4fed203fe7c945c53c6d6bb9f160932a1d15b3Ruben Brunk * additionally return a min frame duration that is greater than 3893e4fed203fe7c945c53c6d6bb9f160932a1d15b3Ruben Brunk * zero for each supported size-format combination.</p> 390e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * 391e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CaptureRequest#BLACK_LEVEL_LOCK 3927e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * @see CaptureRequest#CONTROL_AE_LOCK 39350f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * @see CameraCharacteristics#SCALER_STREAM_CONFIGURATION_MAP 394e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CaptureRequest#SENSOR_EXPOSURE_TIME 39550f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * @see CaptureRequest#SENSOR_FRAME_DURATION 396e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CameraCharacteristics#SENSOR_INFO_EXPOSURE_TIME_RANGE 39750f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * @see CameraCharacteristics#SENSOR_INFO_MAX_FRAME_DURATION 398e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CameraCharacteristics#SENSOR_INFO_SENSITIVITY_RANGE 399e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CaptureRequest#SENSOR_SENSITIVITY 400e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 401e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin */ 40208bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala public static final int REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR = 1; 403e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin 404e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin /** 40550f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * <p>The camera device post-processing stages can be manually controlled. 40650f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * The camera device supports basic manual control of the image post-processing 40750f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * stages. This means the following controls are guaranteed to be supported:</p> 408e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <ul> 409956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <li> 410956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <p>Manual tonemap control</p> 411956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <ul> 4128490ace76fd350e53de9554c11fca715c5a37aafYin-Chia Yeh * <li>{@link CaptureRequest#TONEMAP_CURVE android.tonemap.curve}</li> 413e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>{@link CaptureRequest#TONEMAP_MODE android.tonemap.mode}</li> 414e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>{@link CameraCharacteristics#TONEMAP_MAX_CURVE_POINTS android.tonemap.maxCurvePoints}</li> 41503d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * <li>{@link CaptureRequest#TONEMAP_GAMMA android.tonemap.gamma}</li> 41603d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * <li>{@link CaptureRequest#TONEMAP_PRESET_CURVE android.tonemap.presetCurve}</li> 417e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 418e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </li> 419956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <li> 420956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <p>Manual white balance control</p> 421956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <ul> 422e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>{@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform}</li> 423e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <li>{@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains}</li> 424e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 425e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </li> 42628288ca72c9b69df642514ab23c10e72c6b88c8cZhijun He * <li>Manual lens shading map control<ul> 42728288ca72c9b69df642514ab23c10e72c6b88c8cZhijun He * <li>{@link CaptureRequest#SHADING_MODE android.shading.mode}</li> 42828288ca72c9b69df642514ab23c10e72c6b88c8cZhijun He * <li>{@link CaptureRequest#STATISTICS_LENS_SHADING_MAP_MODE android.statistics.lensShadingMapMode}</li> 429574936894d3044445a272b39f2d925af40ece5d8Ruben Brunk * <li>android.statistics.lensShadingMap</li> 430574936894d3044445a272b39f2d925af40ece5d8Ruben Brunk * <li>android.lens.info.shadingMapSize</li> 431e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 432e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </li> 433a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He * <li>Manual aberration correction control (if aberration correction is supported)<ul> 4349e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He * <li>{@link CaptureRequest#COLOR_CORRECTION_ABERRATION_MODE android.colorCorrection.aberrationMode}</li> 4359e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He * <li>{@link CameraCharacteristics#COLOR_CORRECTION_AVAILABLE_ABERRATION_MODES android.colorCorrection.availableAberrationModes}</li> 436a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He * </ul> 437a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He * </li> 4387e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * <li>Auto white balance lock<ul> 4397e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * <li>{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock}</li> 4407e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * </ul> 4417e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * </li> 442e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 443e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <p>If auto white balance is enabled, then the camera device 444e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * will accurately report the values applied by AWB in the result.</p> 44550f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * <p>A given camera device may also support additional post-processing 44650f7243ca068c793c8b5aca37a9e983b630c477fZhijun He * controls, but this capability only covers the above list of controls.</p> 447e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * 4489e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He * @see CaptureRequest#COLOR_CORRECTION_ABERRATION_MODE 4499e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He * @see CameraCharacteristics#COLOR_CORRECTION_AVAILABLE_ABERRATION_MODES 450e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CaptureRequest#COLOR_CORRECTION_GAINS 451e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 4527e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * @see CaptureRequest#CONTROL_AWB_LOCK 45328288ca72c9b69df642514ab23c10e72c6b88c8cZhijun He * @see CaptureRequest#SHADING_MODE 45428288ca72c9b69df642514ab23c10e72c6b88c8cZhijun He * @see CaptureRequest#STATISTICS_LENS_SHADING_MAP_MODE 4558490ace76fd350e53de9554c11fca715c5a37aafYin-Chia Yeh * @see CaptureRequest#TONEMAP_CURVE 45603d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * @see CaptureRequest#TONEMAP_GAMMA 457e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CameraCharacteristics#TONEMAP_MAX_CURVE_POINTS 458e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CaptureRequest#TONEMAP_MODE 45903d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * @see CaptureRequest#TONEMAP_PRESET_CURVE 460e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 461e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin */ 46208bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala public static final int REQUEST_AVAILABLE_CAPABILITIES_MANUAL_POST_PROCESSING = 2; 46308bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala 46408bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala /** 465611fecec08eb9efeb4393b986d590369df5c812fEino-Ville Talvala * <p>The camera device supports outputting RAW buffers and 466611fecec08eb9efeb4393b986d590369df5c812fEino-Ville Talvala * metadata for interpreting them.</p> 467611fecec08eb9efeb4393b986d590369df5c812fEino-Ville Talvala * <p>Devices supporting the RAW capability allow both for 468611fecec08eb9efeb4393b986d590369df5c812fEino-Ville Talvala * saving DNG files, and for direct application processing of 469611fecec08eb9efeb4393b986d590369df5c812fEino-Ville Talvala * raw sensor images.</p> 47008bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * <ul> 47108bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * <li>RAW_SENSOR is supported as an output format.</li> 47208bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * <li>The maximum available resolution for RAW_SENSOR streams 473fd3e2892f29ded5a25a0a064275b282ce93ed258Eino-Ville Talvala * will match either the value in 474fd3e2892f29ded5a25a0a064275b282ce93ed258Eino-Ville Talvala * {@link CameraCharacteristics#SENSOR_INFO_PIXEL_ARRAY_SIZE android.sensor.info.pixelArraySize} or 475d8407271ffa83d27e9a524f485a0799e422e1fd6Eino-Ville Talvala * {@link CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE android.sensor.info.preCorrectionActiveArraySize}.</li> 47608bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * <li>All DNG-related optional metadata entries are provided 477fd3e2892f29ded5a25a0a064275b282ce93ed258Eino-Ville Talvala * by the camera device.</li> 47808bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * </ul> 47908bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * 48008bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * @see CameraCharacteristics#SENSOR_INFO_PIXEL_ARRAY_SIZE 481d8407271ffa83d27e9a524f485a0799e422e1fd6Eino-Ville Talvala * @see CameraCharacteristics#SENSOR_INFO_PRE_CORRECTION_ACTIVE_ARRAY_SIZE 48208bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 48308bc3b0f0299a02d00004f4b2886469c1ed75569Eino-Ville Talvala */ 484611fecec08eb9efeb4393b986d590369df5c812fEino-Ville Talvala public static final int REQUEST_AVAILABLE_CAPABILITIES_RAW = 3; 485e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin 486e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin /** 4870e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <p>The camera device supports the Zero Shutter Lag reprocessing use case.</p> 488e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * <ul> 4890e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <li>One input stream is supported, that is, <code>{@link CameraCharacteristics#REQUEST_MAX_NUM_INPUT_STREAMS android.request.maxNumInputStreams} == 1</code>.</li> 490b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>{@link android.graphics.ImageFormat#PRIVATE } is supported as an output/input format, 491b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * that is, {@link android.graphics.ImageFormat#PRIVATE } is included in the lists of 492b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * formats returned by {@link android.hardware.camera2.params.StreamConfigurationMap#getInputFormats } and {@link android.hardware.camera2.params.StreamConfigurationMap#getOutputFormats }.</li> 493b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>{@link android.hardware.camera2.params.StreamConfigurationMap#getValidOutputFormatsForInput } 494b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * returns non empty int[] for each supported input format returned by {@link android.hardware.camera2.params.StreamConfigurationMap#getInputFormats }.</li> 495b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>Each size returned by {@link android.hardware.camera2.params.StreamConfigurationMap#getInputSizes getInputSizes(ImageFormat.PRIVATE)} is also included in {@link android.hardware.camera2.params.StreamConfigurationMap#getOutputSizes getOutputSizes(ImageFormat.PRIVATE)}</li> 496b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>Using {@link android.graphics.ImageFormat#PRIVATE } does not cause a frame rate drop 497b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * relative to the sensor's maximum capture rate (at that resolution).</li> 498b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>{@link android.graphics.ImageFormat#PRIVATE } will be reprocessable into both 499b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * {@link android.graphics.ImageFormat#YUV_420_888 } and 500b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * {@link android.graphics.ImageFormat#JPEG } formats.</li> 5018062d31d27943da4d652878b4c36aeabb8bb8b08Chien-Yu Chen * <li>The maximum available resolution for PRIVATE streams 502fd3e2892f29ded5a25a0a064275b282ce93ed258Eino-Ville Talvala * (both input/output) will match the maximum available 503fd3e2892f29ded5a25a0a064275b282ce93ed258Eino-Ville Talvala * resolution of JPEG streams.</li> 504513f7c33eae0084ecd70062d660f2b873032d895Zhijun He * <li>Static metadata {@link CameraCharacteristics#REPROCESS_MAX_CAPTURE_STALL android.reprocess.maxCaptureStall}.</li> 5050e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <li>Only below controls are effective for reprocessing requests and 5060e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * will be present in capture results, other controls in reprocess 5070e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * requests will be ignored by the camera device.<ul> 5080e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <li>android.jpeg.*</li> 5090e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <li>{@link CaptureRequest#NOISE_REDUCTION_MODE android.noiseReduction.mode}</li> 5100e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <li>{@link CaptureRequest#EDGE_MODE android.edge.mode}</li> 511e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * </ul> 5120e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * </li> 5130dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * <li>{@link CameraCharacteristics#NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES android.noiseReduction.availableNoiseReductionModes} and 5140dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * {@link CameraCharacteristics#EDGE_AVAILABLE_EDGE_MODES android.edge.availableEdgeModes} will both list ZERO_SHUTTER_LAG as a supported mode.</li> 5150e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * </ul> 5160e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * 5170dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * @see CameraCharacteristics#EDGE_AVAILABLE_EDGE_MODES 5180e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * @see CaptureRequest#EDGE_MODE 5190dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * @see CameraCharacteristics#NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES 5200e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * @see CaptureRequest#NOISE_REDUCTION_MODE 521513f7c33eae0084ecd70062d660f2b873032d895Zhijun He * @see CameraCharacteristics#REPROCESS_MAX_CAPTURE_STALL 5220e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * @see CameraCharacteristics#REQUEST_MAX_NUM_INPUT_STREAMS 523e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 524e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin */ 5258062d31d27943da4d652878b4c36aeabb8bb8b08Chien-Yu Chen public static final int REQUEST_AVAILABLE_CAPABILITIES_PRIVATE_REPROCESSING = 4; 526e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin 5270c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk /** 5280c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <p>The camera device supports accurately reporting the sensor settings for many of 5290c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * the sensor controls while the built-in 3A algorithm is running. This allows 5300c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * reporting of sensor settings even when these settings cannot be manually changed.</p> 5310c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <p>The values reported for the following controls are guaranteed to be available 5320c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * in the CaptureResult, including when 3A is enabled:</p> 5330c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <ul> 5340c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <li>Exposure control<ul> 5350c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <li>{@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime}</li> 5360c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * </ul> 5370c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * </li> 5380c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <li>Sensitivity control<ul> 5390c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <li>{@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}</li> 5400c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * </ul> 5410c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * </li> 5420c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <li>Lens controls (if the lens is adjustable)<ul> 5430c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <li>{@link CaptureRequest#LENS_FOCUS_DISTANCE android.lens.focusDistance}</li> 5440c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <li>{@link CaptureRequest#LENS_APERTURE android.lens.aperture}</li> 5450c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * </ul> 5460c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * </li> 5470c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * </ul> 5480c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * <p>This capability is a subset of the MANUAL_SENSOR control capability, and will 5490c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * always be included if the MANUAL_SENSOR capability is available.</p> 5500c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * 5510c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * @see CaptureRequest#LENS_APERTURE 5520c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * @see CaptureRequest#LENS_FOCUS_DISTANCE 5530c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * @see CaptureRequest#SENSOR_EXPOSURE_TIME 5540c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * @see CaptureRequest#SENSOR_SENSITIVITY 5550c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 5560c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk */ 5570c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk public static final int REQUEST_AVAILABLE_CAPABILITIES_READ_SENSOR_SETTINGS = 5; 5580c22e6919ab56e85f02b3255493d0009d711a807Ruben Brunk 559126a7468c2b86f27779443f5f2578a03f3ad78e8Eino-Ville Talvala /** 5600819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * <p>The camera device supports capturing high-resolution images at >= 20 frames per 5610819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * second, in at least the uncompressed YUV format, when post-processing settings are set 5620819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * to FAST. Additionally, maximum-resolution images can be captured at >= 10 frames 5630819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * per second. Here, 'high resolution' means at least 8 megapixels, or the maximum 5640819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * resolution of the device, whichever is smaller.</p> 5650819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * <p>More specifically, this means that a size matching the camera device's active array 5660819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * size is listed as a supported size for the {@link android.graphics.ImageFormat#YUV_420_888 } format in either {@link android.hardware.camera2.params.StreamConfigurationMap#getOutputSizes } or {@link android.hardware.camera2.params.StreamConfigurationMap#getHighResolutionOutputSizes }, 5670819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * with a minimum frame duration for that format and size of either <= 1/20 s, or 5680819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * <= 1/10 s, respectively; and the {@link CameraCharacteristics#CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES android.control.aeAvailableTargetFpsRanges} entry 5690819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * lists at least one FPS range where the minimum FPS is >= 1 / minimumFrameDuration 5700819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * for the maximum-size YUV_420_888 format. If that maximum size is listed in {@link android.hardware.camera2.params.StreamConfigurationMap#getHighResolutionOutputSizes }, 5710819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * then the list of resolutions for YUV_420_888 from {@link android.hardware.camera2.params.StreamConfigurationMap#getOutputSizes } contains at 5720819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * least one resolution >= 8 megapixels, with a minimum frame duration of <= 1/20 5730819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * s.</p> 5740819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * <p>If the device supports the {@link android.graphics.ImageFormat#RAW10 }, {@link android.graphics.ImageFormat#RAW12 }, then those can also be captured at the same rate 5750819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * as the maximum-size YUV_420_888 resolution is.</p> 5760819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * <p>If the device supports the PRIVATE_REPROCESSING capability, then the same guarantees 5770819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * as for the YUV_420_888 format also apply to the {@link android.graphics.ImageFormat#PRIVATE } format.</p> 5780819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * <p>In addition, the {@link CameraCharacteristics#SYNC_MAX_LATENCY android.sync.maxLatency} field is guaranted to have a value between 0 5790819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * and 4, inclusive. {@link CameraCharacteristics#CONTROL_AE_LOCK_AVAILABLE android.control.aeLockAvailable} and {@link CameraCharacteristics#CONTROL_AWB_LOCK_AVAILABLE android.control.awbLockAvailable} 5800819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * are also guaranteed to be <code>true</code> so burst capture with these two locks ON yields 5810819c75680c81a4e9c8a1ec518ac62cceccf3f56Eino-Ville Talvala * consistent image output.</p> 582126a7468c2b86f27779443f5f2578a03f3ad78e8Eino-Ville Talvala * 5838d709f3d5381795cdad942f64b9441d54e48d774Eino-Ville Talvala * @see CameraCharacteristics#CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES 5847e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * @see CameraCharacteristics#CONTROL_AE_LOCK_AVAILABLE 5857e3e431934aef6c7ca954fed00facaff8a4ee1d3Yin-Chia Yeh * @see CameraCharacteristics#CONTROL_AWB_LOCK_AVAILABLE 586126a7468c2b86f27779443f5f2578a03f3ad78e8Eino-Ville Talvala * @see CameraCharacteristics#SYNC_MAX_LATENCY 587126a7468c2b86f27779443f5f2578a03f3ad78e8Eino-Ville Talvala * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 588126a7468c2b86f27779443f5f2578a03f3ad78e8Eino-Ville Talvala */ 589126a7468c2b86f27779443f5f2578a03f3ad78e8Eino-Ville Talvala public static final int REQUEST_AVAILABLE_CAPABILITIES_BURST_CAPTURE = 6; 590126a7468c2b86f27779443f5f2578a03f3ad78e8Eino-Ville Talvala 5910e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He /** 5920a551f1487e00a598b20b1bc58a1ccd7226e7091Chien-Yu Chen * <p>The camera device supports the YUV_420_888 reprocessing use case, similar as 5938062d31d27943da4d652878b4c36aeabb8bb8b08Chien-Yu Chen * PRIVATE_REPROCESSING, This capability requires the camera device to support the 5940e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * following:</p> 5950e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <ul> 5960e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <li>One input stream is supported, that is, <code>{@link CameraCharacteristics#REQUEST_MAX_NUM_INPUT_STREAMS android.request.maxNumInputStreams} == 1</code>.</li> 597b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>{@link android.graphics.ImageFormat#YUV_420_888 } is supported as an output/input format, that is, 5980a551f1487e00a598b20b1bc58a1ccd7226e7091Chien-Yu Chen * YUV_420_888 is included in the lists of formats returned by 599b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * {@link android.hardware.camera2.params.StreamConfigurationMap#getInputFormats } and 600b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * {@link android.hardware.camera2.params.StreamConfigurationMap#getOutputFormats }.</li> 601b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>{@link android.hardware.camera2.params.StreamConfigurationMap#getValidOutputFormatsForInput } 602b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * returns non-empty int[] for each supported input format returned by {@link android.hardware.camera2.params.StreamConfigurationMap#getInputFormats }.</li> 603b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>Each size returned by {@link android.hardware.camera2.params.StreamConfigurationMap#getInputSizes getInputSizes(YUV_420_888)} is also included in {@link android.hardware.camera2.params.StreamConfigurationMap#getOutputSizes getOutputSizes(YUV_420_888)}</li> 604b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>Using {@link android.graphics.ImageFormat#YUV_420_888 } does not cause a frame rate drop 6050a551f1487e00a598b20b1bc58a1ccd7226e7091Chien-Yu Chen * relative to the sensor's maximum capture rate (at that resolution).</li> 606b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>{@link android.graphics.ImageFormat#YUV_420_888 } will be reprocessable into both 607b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * {@link android.graphics.ImageFormat#YUV_420_888 } and {@link android.graphics.ImageFormat#JPEG } formats.</li> 608b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>The maximum available resolution for {@link android.graphics.ImageFormat#YUV_420_888 } streams (both input/output) will match the 609b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * maximum available resolution of {@link android.graphics.ImageFormat#JPEG } streams.</li> 610513f7c33eae0084ecd70062d660f2b873032d895Zhijun He * <li>Static metadata {@link CameraCharacteristics#REPROCESS_MAX_CAPTURE_STALL android.reprocess.maxCaptureStall}.</li> 611b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>Only the below controls are effective for reprocessing requests and will be present 612b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * in capture results. The reprocess requests are from the original capture results that 613b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * are associated with the intermediate {@link android.graphics.ImageFormat#YUV_420_888 } 614b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * output buffers. All other controls in the reprocess requests will be ignored by the 615b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * camera device.<ul> 6160e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <li>android.jpeg.*</li> 6170e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <li>{@link CaptureRequest#NOISE_REDUCTION_MODE android.noiseReduction.mode}</li> 6180e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <li>{@link CaptureRequest#EDGE_MODE android.edge.mode}</li> 6190e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <li>{@link CaptureRequest#REPROCESS_EFFECTIVE_EXPOSURE_FACTOR android.reprocess.effectiveExposureFactor}</li> 6200e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * </ul> 6210e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * </li> 6220dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * <li>{@link CameraCharacteristics#NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES android.noiseReduction.availableNoiseReductionModes} and 6230dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * {@link CameraCharacteristics#EDGE_AVAILABLE_EDGE_MODES android.edge.availableEdgeModes} will both list ZERO_SHUTTER_LAG as a supported mode.</li> 6240e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * </ul> 6250e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * 6260dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * @see CameraCharacteristics#EDGE_AVAILABLE_EDGE_MODES 6270e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * @see CaptureRequest#EDGE_MODE 6280dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * @see CameraCharacteristics#NOISE_REDUCTION_AVAILABLE_NOISE_REDUCTION_MODES 6290e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * @see CaptureRequest#NOISE_REDUCTION_MODE 6300e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * @see CaptureRequest#REPROCESS_EFFECTIVE_EXPOSURE_FACTOR 631513f7c33eae0084ecd70062d660f2b873032d895Zhijun He * @see CameraCharacteristics#REPROCESS_MAX_CAPTURE_STALL 6320e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * @see CameraCharacteristics#REQUEST_MAX_NUM_INPUT_STREAMS 6330e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 6340e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He */ 6350e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He public static final int REQUEST_AVAILABLE_CAPABILITIES_YUV_REPROCESSING = 7; 6360e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He 6370b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala /** 6380b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * <p>The camera device can produce depth measurements from its field of view.</p> 6390b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * <p>This capability requires the camera device to support the following:</p> 6400b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * <ul> 641b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>{@link android.graphics.ImageFormat#DEPTH16 } is supported as an output format.</li> 642b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>{@link android.graphics.ImageFormat#DEPTH_POINT_CLOUD } is optionally supported as an 643b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * output format.</li> 644b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * <li>This camera device, and all camera devices with the same {@link CameraCharacteristics#LENS_FACING android.lens.facing}, 645b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * will list the following calibration entries in both 646b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * {@link android.hardware.camera2.CameraCharacteristics } and 647b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * {@link android.hardware.camera2.CaptureResult }:<ul> 6480b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * <li>{@link CameraCharacteristics#LENS_POSE_TRANSLATION android.lens.poseTranslation}</li> 6490b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * <li>{@link CameraCharacteristics#LENS_POSE_ROTATION android.lens.poseRotation}</li> 650abf0b8b0a8515d8a8a3eaebf471eed7b40bcedfaEino-Ville Talvala * <li>{@link CameraCharacteristics#LENS_INTRINSIC_CALIBRATION android.lens.intrinsicCalibration}</li> 651abf0b8b0a8515d8a8a3eaebf471eed7b40bcedfaEino-Ville Talvala * <li>{@link CameraCharacteristics#LENS_RADIAL_DISTORTION android.lens.radialDistortion}</li> 6520b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * </ul> 6530b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * </li> 6540b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * <li>The {@link CameraCharacteristics#DEPTH_DEPTH_IS_EXCLUSIVE android.depth.depthIsExclusive} entry is listed by this device.</li> 6550b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * <li>A LIMITED camera with only the DEPTH_OUTPUT capability does not have to support 6560b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * normal YUV_420_888, JPEG, and PRIV-format outputs. It only has to support the DEPTH16 6570b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * format.</li> 6580b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * </ul> 6590b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * <p>Generally, depth output operates at a slower frame rate than standard color capture, 6600b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * so the DEPTH16 and DEPTH_POINT_CLOUD formats will commonly have a stall duration that 6610b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * should be accounted for (see 662b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * {@link android.hardware.camera2.params.StreamConfigurationMap#getOutputStallDuration }). 663b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * On a device that supports both depth and color-based output, to enable smooth preview, 664b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * using a repeating burst is recommended, where a depth-output target is only included 665b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * once every N frames, where N is the ratio between preview output rate and depth output 6660b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * rate, including depth stall time.</p> 6670b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * 6680b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * @see CameraCharacteristics#DEPTH_DEPTH_IS_EXCLUSIVE 669b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * @see CameraCharacteristics#LENS_FACING 670abf0b8b0a8515d8a8a3eaebf471eed7b40bcedfaEino-Ville Talvala * @see CameraCharacteristics#LENS_INTRINSIC_CALIBRATION 6710b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * @see CameraCharacteristics#LENS_POSE_ROTATION 6720b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * @see CameraCharacteristics#LENS_POSE_TRANSLATION 673abf0b8b0a8515d8a8a3eaebf471eed7b40bcedfaEino-Ville Talvala * @see CameraCharacteristics#LENS_RADIAL_DISTORTION 6740b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 6750b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala */ 6760b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala public static final int REQUEST_AVAILABLE_CAPABILITIES_DEPTH_OUTPUT = 8; 6770b7b03b35f3b29a068580be0ab0f68ca11d00bdbEino-Ville Talvala 678fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He /** 679fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <p>The device supports constrained high speed video recording (frame rate >=120fps) 680fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * use case. The camera device will support high speed capture session created by 681fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * {@link android.hardware.camera2.CameraDevice#createConstrainedHighSpeedCaptureSession }, which 682639fffee624302ec5b175503d7bd8a441340a629Eino-Ville Talvala * only accepts high speed request lists created by 683639fffee624302ec5b175503d7bd8a441340a629Eino-Ville Talvala * {@link android.hardware.camera2.CameraConstrainedHighSpeedCaptureSession#createHighSpeedRequestList }.</p> 684fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <p>A camera device can still support high speed video streaming by advertising the high speed 685fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * FPS ranges in {@link CameraCharacteristics#CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES android.control.aeAvailableTargetFpsRanges}. For this case, all normal 686fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * capture request per frame control and synchronization requirements will apply to 687fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * the high speed fps ranges, the same as all other fps ranges. This capability describes 688fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * the capability of a specialized operating mode with many limitations (see below), which 689fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * is only targeted at high speed video recording.</p> 690fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <p>The supported high speed video sizes and fps ranges are specified in 691fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * {@link android.hardware.camera2.params.StreamConfigurationMap#getHighSpeedVideoFpsRanges }. 692fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * To get desired output frame rates, the application is only allowed to select video size 693fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * and FPS range combinations provided by 694fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * {@link android.hardware.camera2.params.StreamConfigurationMap#getHighSpeedVideoSizes }. 695fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * The fps range can be controlled via {@link CaptureRequest#CONTROL_AE_TARGET_FPS_RANGE android.control.aeTargetFpsRange}.</p> 696fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <p>In this capability, the camera device will override aeMode, awbMode, and afMode to 697ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * ON, AUTO, and CONTINUOUS_VIDEO, respectively. All post-processing block mode 698fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * controls will be overridden to be FAST. Therefore, no manual control of capture 699fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * and post-processing parameters is possible. All other controls operate the 700fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * same as when {@link CaptureRequest#CONTROL_MODE android.control.mode} == AUTO. This means that all other 701fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * android.control.* fields continue to work, such as</p> 702fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <ul> 703fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#CONTROL_AE_TARGET_FPS_RANGE android.control.aeTargetFpsRange}</li> 704fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#CONTROL_AE_EXPOSURE_COMPENSATION android.control.aeExposureCompensation}</li> 705fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock}</li> 706fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock}</li> 707fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#CONTROL_EFFECT_MODE android.control.effectMode}</li> 708fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#CONTROL_AE_REGIONS android.control.aeRegions}</li> 709fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#CONTROL_AF_REGIONS android.control.afRegions}</li> 710fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#CONTROL_AWB_REGIONS android.control.awbRegions}</li> 711fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#CONTROL_AF_TRIGGER android.control.afTrigger}</li> 712fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger}</li> 713fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * </ul> 714fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <p>Outside of android.control.*, the following controls will work:</p> 715fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <ul> 716fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#FLASH_MODE android.flash.mode} (TORCH mode only, automatic flash for still capture will not 717fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * work since aeMode is ON)</li> 718fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE android.lens.opticalStabilizationMode} (if it is supported)</li> 719fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegion}</li> 720fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>{@link CaptureRequest#STATISTICS_FACE_DETECT_MODE android.statistics.faceDetectMode} (if it is supported)</li> 721fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * </ul> 722fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <p>For high speed recording use case, the actual maximum supported frame rate may 723fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * be lower than what camera can output, depending on the destination Surfaces for 724fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * the image data. For example, if the destination surface is from video encoder, 725fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * the application need check if the video encoder is capable of supporting the 726fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * high frame rate for a given video size, or it will end up with lower recording 727fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * frame rate. If the destination surface is from preview window, the actual preview frame 728fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * rate will be bounded by the screen refresh rate.</p> 729fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <p>The camera device will only support up to 2 high speed simultaneous output surfaces 730fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * (preview and recording surfaces) 731fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * in this mode. Above controls will be effective only if all of below conditions are true:</p> 732fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <ul> 733fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>The application creates a camera capture session with no more than 2 surfaces via 734fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * {@link android.hardware.camera2.CameraDevice#createConstrainedHighSpeedCaptureSession }. The 735fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * targeted surfaces must be preview surface (either from 736fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * {@link android.view.SurfaceView } or {@link android.graphics.SurfaceTexture }) or 737fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * recording surface(either from {@link android.media.MediaRecorder#getSurface } or 738fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * {@link android.media.MediaCodec#createInputSurface }).</li> 739fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>The stream sizes are selected from the sizes reported by 740fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * {@link android.hardware.camera2.params.StreamConfigurationMap#getHighSpeedVideoSizes }.</li> 741fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <li>The FPS ranges are selected from 742fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * {@link android.hardware.camera2.params.StreamConfigurationMap#getHighSpeedVideoFpsRanges }.</li> 743fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * </ul> 744639fffee624302ec5b175503d7bd8a441340a629Eino-Ville Talvala * <p>When above conditions are NOT satistied, 745fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * {@link android.hardware.camera2.CameraDevice#createConstrainedHighSpeedCaptureSession } 746639fffee624302ec5b175503d7bd8a441340a629Eino-Ville Talvala * will fail.</p> 747fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * <p>Switching to a FPS range that has different maximum FPS may trigger some camera device 748fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * reconfigurations, which may introduce extra latency. It is recommended that 749fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * the application avoids unnecessary maximum target FPS changes as much as possible 750fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * during high speed streaming.</p> 751fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * 752fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CameraCharacteristics#CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES 753fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_AE_EXPOSURE_COMPENSATION 754fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_AE_LOCK 755fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 756fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_AE_REGIONS 757fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_AE_TARGET_FPS_RANGE 758fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_AF_REGIONS 759fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_AF_TRIGGER 760fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_AWB_LOCK 761fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_AWB_REGIONS 762fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_EFFECT_MODE 763fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#CONTROL_MODE 764fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#FLASH_MODE 765fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE 766fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#SCALER_CROP_REGION 767fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CaptureRequest#STATISTICS_FACE_DETECT_MODE 768fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 769fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He */ 770fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He public static final int REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEO = 9; 771fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He 772e46c0dad3787ebb05438cb161128aab71c97cb24Igor Murashkin // 7731498615d56851664c96e51d530e445ed73be7a22Zhijun He // Enumeration values for CameraCharacteristics#SCALER_CROPPING_TYPE 7741498615d56851664c96e51d530e445ed73be7a22Zhijun He // 7751498615d56851664c96e51d530e445ed73be7a22Zhijun He 7761498615d56851664c96e51d530e445ed73be7a22Zhijun He /** 777e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device only supports centered crop regions.</p> 7781498615d56851664c96e51d530e445ed73be7a22Zhijun He * @see CameraCharacteristics#SCALER_CROPPING_TYPE 7791498615d56851664c96e51d530e445ed73be7a22Zhijun He */ 7801498615d56851664c96e51d530e445ed73be7a22Zhijun He public static final int SCALER_CROPPING_TYPE_CENTER_ONLY = 0; 7811498615d56851664c96e51d530e445ed73be7a22Zhijun He 7821498615d56851664c96e51d530e445ed73be7a22Zhijun He /** 783e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device supports arbitrarily chosen crop regions.</p> 7841498615d56851664c96e51d530e445ed73be7a22Zhijun He * @see CameraCharacteristics#SCALER_CROPPING_TYPE 7851498615d56851664c96e51d530e445ed73be7a22Zhijun He */ 7861498615d56851664c96e51d530e445ed73be7a22Zhijun He public static final int SCALER_CROPPING_TYPE_FREEFORM = 1; 7871498615d56851664c96e51d530e445ed73be7a22Zhijun He 7881498615d56851664c96e51d530e445ed73be7a22Zhijun He // 789d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He // Enumeration values for CameraCharacteristics#SENSOR_INFO_COLOR_FILTER_ARRANGEMENT 790d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He // 791d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He 792d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He /** 793d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He * @see CameraCharacteristics#SENSOR_INFO_COLOR_FILTER_ARRANGEMENT 794d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He */ 795d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He public static final int SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_RGGB = 0; 796d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He 797d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He /** 798d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He * @see CameraCharacteristics#SENSOR_INFO_COLOR_FILTER_ARRANGEMENT 799d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He */ 800d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He public static final int SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_GRBG = 1; 801d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He 802d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He /** 803d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He * @see CameraCharacteristics#SENSOR_INFO_COLOR_FILTER_ARRANGEMENT 804d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He */ 805d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He public static final int SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_GBRG = 2; 806d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He 807d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He /** 808d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He * @see CameraCharacteristics#SENSOR_INFO_COLOR_FILTER_ARRANGEMENT 809d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He */ 810d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He public static final int SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_BGGR = 3; 811d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He 812d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He /** 813d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He * <p>Sensor is not Bayer; output has 3 16-bit 814d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He * values for each pixel, instead of just 1 16-bit value 815d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He * per pixel.</p> 816d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He * @see CameraCharacteristics#SENSOR_INFO_COLOR_FILTER_ARRANGEMENT 817d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He */ 818d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He public static final int SENSOR_INFO_COLOR_FILTER_ARRANGEMENT_RGB = 4; 819d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He 820d178496b7e823efdc9c9780ab1d980207a36a19aZhijun He // 821abd9d3c5c7100c45812ee80975ac59f5b1902a71Eino-Ville Talvala // Enumeration values for CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE 82245fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He // 82345fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He 82445fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He /** 82545fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * <p>Timestamps from {@link CaptureResult#SENSOR_TIMESTAMP android.sensor.timestamp} are in nanoseconds and monotonic, 82645fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * but can not be compared to timestamps from other subsystems 82745fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * (e.g. accelerometer, gyro etc.), or other instances of the same or different 82845fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * camera devices in the same system. Timestamps between streams and results for 82945fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * a single camera instance are comparable, and the timestamps for all buffers 83045fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * and the result metadata generated by a single capture are identical.</p> 83145fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * 83245fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * @see CaptureResult#SENSOR_TIMESTAMP 833abd9d3c5c7100c45812ee80975ac59f5b1902a71Eino-Ville Talvala * @see CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE 83445fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He */ 835abd9d3c5c7100c45812ee80975ac59f5b1902a71Eino-Ville Talvala public static final int SENSOR_INFO_TIMESTAMP_SOURCE_UNKNOWN = 0; 83645fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He 83745fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He /** 83845fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * <p>Timestamps from {@link CaptureResult#SENSOR_TIMESTAMP android.sensor.timestamp} are in the same timebase as 839b6eb52ffc51cec78c3adc2e5b25c4c3214344983Eino-Ville Talvala * {@link android.os.SystemClock#elapsedRealtimeNanos }, 84045fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * and they can be compared to other timestamps using that base.</p> 84145fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * 84245fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He * @see CaptureResult#SENSOR_TIMESTAMP 843abd9d3c5c7100c45812ee80975ac59f5b1902a71Eino-Ville Talvala * @see CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE 84445fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He */ 845abd9d3c5c7100c45812ee80975ac59f5b1902a71Eino-Ville Talvala public static final int SENSOR_INFO_TIMESTAMP_SOURCE_REALTIME = 1; 84645fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He 84745fa43a1815e2d0a25ed3a126e4e732a03b7ed7fZhijun He // 8487c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk // Enumeration values for CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 8497c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk // 8507c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 8517c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 8527c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 8537c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 8547c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_DAYLIGHT = 1; 8557c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 8567c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 8577c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 8587c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 8597c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_FLUORESCENT = 2; 8607c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 8617c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 8627c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * <p>Incandescent light</p> 8637c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 8647c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 8657c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_TUNGSTEN = 3; 8667c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 8677c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 8687c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 8697c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 8707c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_FLASH = 4; 8717c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 8727c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 8737c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 8747c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 8757c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_FINE_WEATHER = 9; 8767c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 8777c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 8787c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 8797c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 8807c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_CLOUDY_WEATHER = 10; 8817c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 8827c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 8837c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 8847c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 8857c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_SHADE = 11; 8867c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 8877c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 8887c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * <p>D 5700 - 7100K</p> 8897c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 8907c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 8917c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_DAYLIGHT_FLUORESCENT = 12; 8927c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 8937c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 8947c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * <p>N 4600 - 5400K</p> 8957c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 8967c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 8977c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_DAY_WHITE_FLUORESCENT = 13; 8987c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 8997c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 9007c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * <p>W 3900 - 4500K</p> 9017c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 9027c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 9037c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_COOL_WHITE_FLUORESCENT = 14; 9047c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 9057c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 9067c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * <p>WW 3200 - 3700K</p> 9077c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 9087c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 9097c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_WHITE_FLUORESCENT = 15; 9107c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 9117c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 9127c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 9137c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 9147c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_STANDARD_A = 17; 9157c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 9167c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 9177c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 9187c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 9197c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_STANDARD_B = 18; 9207c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 9217c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 9227c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 9237c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 9247c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_STANDARD_C = 19; 9257c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 9267c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 9277c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 9287c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 9297c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_D55 = 20; 9307c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 9317c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 9327c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 9337c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 9347c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_D65 = 21; 9357c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 9367c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 9377c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 9387c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 9397c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_D75 = 22; 9407c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 9417c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 9427c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 9437c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 9447c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_D50 = 23; 9457c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 9467c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk /** 9477c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk * @see CameraCharacteristics#SENSOR_REFERENCE_ILLUMINANT1 9487c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk */ 9497c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk public static final int SENSOR_REFERENCE_ILLUMINANT1_ISO_STUDIO_TUNGSTEN = 24; 9507c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk 9517c062369d55ad6f6f0c9c3bd8439c50cbfb88f42Ruben Brunk // 95268f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin // Enumeration values for CameraCharacteristics#LED_AVAILABLE_LEDS 9535a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 9545a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 9555a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 956e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>android.led.transmit control is used.</p> 95768f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * @see CameraCharacteristics#LED_AVAILABLE_LEDS 9585a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @hide 9595a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 9605a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int LED_AVAILABLE_LEDS_TRANSMIT = 0; 9615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 9625a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 96368f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin // Enumeration values for CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL 9645a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 9655a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 9665a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 9677c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>This camera device does not have enough capabilities to qualify as a <code>FULL</code> device or 9687c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * better.</p> 9697c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>Only the stream configurations listed in the <code>LEGACY</code> and <code>LIMITED</code> tables in the 9707c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * {@link android.hardware.camera2.CameraDevice#createCaptureSession createCaptureSession} documentation are guaranteed to be supported.</p> 9717c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>All <code>LIMITED</code> devices support the <code>BACKWARDS_COMPATIBLE</code> capability, indicating basic 9727c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * support for color image capture. The only exception is that the device may 9737c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * alternatively support only the <code>DEPTH_OUTPUT</code> capability, if it can only output depth 9747c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * measurements and not color images.</p> 9757c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p><code>LIMITED</code> devices and above require the use of {@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} 9767c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * to lock exposure metering (and calculate flash power, for cameras with flash) before 9777c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * capturing a high-quality still image.</p> 9787c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>A <code>LIMITED</code> device that only lists the <code>BACKWARDS_COMPATIBLE</code> capability is only 9797c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * required to support full-automatic operation and post-processing (<code>OFF</code> is not 9807c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * supported for {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode}, {@link CaptureRequest#CONTROL_AF_MODE android.control.afMode}, or 9817c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * {@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode})</p> 9827c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>Additional capabilities may optionally be supported by a <code>LIMITED</code>-level device, and 9837c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * can be checked for in {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities}.</p> 9847c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * 9857c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_MODE 9867c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 9877c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_MODE 9887c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CaptureRequest#CONTROL_AWB_MODE 9897c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 99068f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL 9915a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 9925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED = 0; 9935a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 9945a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 9954a61a86b366db4e8cbc6f699e0b4331b1f07f7c8Ruben Brunk * <p>This camera device is capable of supporting advanced imaging applications.</p> 9967c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>The stream configurations listed in the <code>FULL</code>, <code>LEGACY</code> and <code>LIMITED</code> tables in the 9977c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * {@link android.hardware.camera2.CameraDevice#createCaptureSession createCaptureSession} documentation are guaranteed to be supported.</p> 9987c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>A <code>FULL</code> device will support below capabilities:</p> 9997c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <ul> 10007c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <li><code>BURST_CAPTURE</code> capability ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains 10017c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <code>BURST_CAPTURE</code>)</li> 10027c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <li>Per frame control ({@link CameraCharacteristics#SYNC_MAX_LATENCY android.sync.maxLatency} <code>==</code> PER_FRAME_CONTROL)</li> 10037c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <li>Manual sensor control ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains <code>MANUAL_SENSOR</code>)</li> 10047c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <li>Manual post-processing control ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains 10057c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <code>MANUAL_POST_PROCESSING</code>)</li> 10067c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <li>The required exposure time range defined in {@link CameraCharacteristics#SENSOR_INFO_EXPOSURE_TIME_RANGE android.sensor.info.exposureTimeRange}</li> 10077c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <li>The required maxFrameDuration defined in {@link CameraCharacteristics#SENSOR_INFO_MAX_FRAME_DURATION android.sensor.info.maxFrameDuration}</li> 10087c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * </ul> 10097c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>Note: 10107c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * Pre-API level 23, FULL devices also supported arbitrary cropping region 10117c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * ({@link CameraCharacteristics#SCALER_CROPPING_TYPE android.scaler.croppingType} <code>== FREEFORM</code>); this requirement was relaxed in API level 10127c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * 23, and <code>FULL</code> devices may only support <code>CENTERED</code> cropping.</p> 10137c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * 10147c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 10157c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CameraCharacteristics#SCALER_CROPPING_TYPE 10167c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CameraCharacteristics#SENSOR_INFO_EXPOSURE_TIME_RANGE 10177c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CameraCharacteristics#SENSOR_INFO_MAX_FRAME_DURATION 10187c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CameraCharacteristics#SYNC_MAX_LATENCY 101968f40066c914aefc1f88819dd46dd1135fb9f5bcIgor Murashkin * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL 10205a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 10215a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int INFO_SUPPORTED_HARDWARE_LEVEL_FULL = 1; 10225a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 10234a61a86b366db4e8cbc6f699e0b4331b1f07f7c8Ruben Brunk /** 10244a61a86b366db4e8cbc6f699e0b4331b1f07f7c8Ruben Brunk * <p>This camera device is running in backward compatibility mode.</p> 10257c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>Only the stream configurations listed in the <code>LEGACY</code> table in the {@link android.hardware.camera2.CameraDevice#createCaptureSession createCaptureSession} 10267c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * documentation are supported.</p> 10277c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>A <code>LEGACY</code> device does not support per-frame control, manual sensor control, manual 10287c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * post-processing, arbitrary cropping regions, and has relaxed performance constraints. 10297c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * No additional capabilities beyond <code>BACKWARD_COMPATIBLE</code> will ever be listed by a 10307c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <code>LEGACY</code> device in {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities}.</p> 10317c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>In addition, the {@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} is not functional on <code>LEGACY</code> 10327c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * devices. Instead, every request that includes a JPEG-format output target is treated 10337c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * as triggering a still capture, internally executing a precapture trigger. This may 10347c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * fire the flash for flash power metering during precapture, and then fire the flash 10357c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * for the final capture, if a flash is available on the device and the AE mode is set to 10367c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * enable the flash.</p> 10377c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * 10387c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 10397c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 10404a61a86b366db4e8cbc6f699e0b4331b1f07f7c8Ruben Brunk * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL 10414a61a86b366db4e8cbc6f699e0b4331b1f07f7c8Ruben Brunk */ 10424a61a86b366db4e8cbc6f699e0b4331b1f07f7c8Ruben Brunk public static final int INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY = 2; 10434a61a86b366db4e8cbc6f699e0b4331b1f07f7c8Ruben Brunk 10447c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala /** 10457c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>This camera device is capable of YUV reprocessing and RAW data capture, in addition to 10467c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * FULL-level capabilities.</p> 10477c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>The stream configurations listed in the <code>LEVEL_3</code>, <code>RAW</code>, <code>FULL</code>, <code>LEGACY</code> and 10487c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <code>LIMITED</code> tables in the {@link android.hardware.camera2.CameraDevice#createCaptureSession createCaptureSession} 10497c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * documentation are guaranteed to be supported.</p> 10507c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <p>The following additional capabilities are guaranteed to be supported:</p> 10517c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <ul> 10527c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <li><code>YUV_REPROCESSING</code> capability ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains 10537c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <code>YUV_REPROCESSING</code>)</li> 10547c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <li><code>RAW</code> capability ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains 10557c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * <code>RAW</code>)</li> 10567c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * </ul> 10577c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * 10587c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 10597c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala * @see CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL 10607c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala */ 10617c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala public static final int INFO_SUPPORTED_HARDWARE_LEVEL_3 = 3; 10627c6d73f41f162c591acef4758c3403ab19dcc197Eino-Ville Talvala 10635a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 10643865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin // Enumeration values for CameraCharacteristics#SYNC_MAX_LATENCY 10653865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin // 10663865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin 10673865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin /** 1068e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Every frame has the requests immediately applied.</p> 10693865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * <p>Changing controls over multiple requests one after another will 10703865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * produce results that have those controls applied atomically 10713865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * each frame.</p> 10723865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * <p>All FULL capability devices will have this as their maxLatency.</p> 10733865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * @see CameraCharacteristics#SYNC_MAX_LATENCY 10743865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin */ 10753865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin public static final int SYNC_MAX_LATENCY_PER_FRAME_CONTROL = 0; 10763865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin 10773865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin /** 10783865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * <p>Each new frame has some subset (potentially the entire set) 10793865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * of the past requests applied to the camera settings.</p> 10803865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * <p>By submitting a series of identical requests, the camera device 10813865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * will eventually have the camera settings applied, but it is 10823865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * unknown when that exact point will be.</p> 1083bdf366cc70639b0e16b8f84eebe612a48a8b8b06Igor Murashkin * <p>All LEGACY capability devices will have this as their maxLatency.</p> 10843865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * @see CameraCharacteristics#SYNC_MAX_LATENCY 10853865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin */ 10863865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin public static final int SYNC_MAX_LATENCY_UNKNOWN = -1; 10873865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin 10883865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin // 10895a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#COLOR_CORRECTION_MODE 10905a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 10915a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 10925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 10930da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * <p>Use the {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform} matrix 10947d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * and {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} to do color conversion.</p> 10957d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * <p>All advanced white balance adjustments (not specified 10967d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * by our white balance pipeline) must be disabled.</p> 10977d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * <p>If AWB is enabled with <code>{@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode} != OFF</code>, then 10987d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * TRANSFORM_MATRIX is ignored. The camera device will override 10997d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * this value to either FAST or HIGH_QUALITY.</p> 11000da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * 11010da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_GAINS 1102265b34ce331cbe296f82ca357645312718c8d4c7Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 11037d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * @see CaptureRequest#CONTROL_AWB_MODE 11045a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_MODE 11055a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 11065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int COLOR_CORRECTION_MODE_TRANSFORM_MATRIX = 0; 11075a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 11085a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1109e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Color correction processing must not slow down 1110e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * capture rate relative to sensor raw output.</p> 11117d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * <p>Advanced white balance adjustments above and beyond 11127d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * the specified white balance pipeline may be applied.</p> 11137d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * <p>If AWB is enabled with <code>{@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode} != OFF</code>, then 11147d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * the camera device uses the last frame's AWB values 11157d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * (or defaults if AWB has never been run).</p> 11167d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * 11177d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * @see CaptureRequest#CONTROL_AWB_MODE 11185a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_MODE 11195a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 11205a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int COLOR_CORRECTION_MODE_FAST = 1; 11215a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 11225a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1123e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Color correction processing operates at improved 1124fba08dd9b4ecd8cb49d69d7537dce220996ec641Yin-Chia Yeh * quality but the capture rate might be reduced (relative to sensor 1125fba08dd9b4ecd8cb49d69d7537dce220996ec641Yin-Chia Yeh * raw output rate)</p> 11267d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * <p>Advanced white balance adjustments above and beyond 11277d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * the specified white balance pipeline may be applied.</p> 11287d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * <p>If AWB is enabled with <code>{@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode} != OFF</code>, then 11297d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * the camera device uses the last frame's AWB values 11307d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * (or defaults if AWB has never been run).</p> 11317d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * 11327d2a5c5e7350658d0da4eaf75f9380593083e969Igor Murashkin * @see CaptureRequest#CONTROL_AWB_MODE 11335a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_MODE 11345a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 11355a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int COLOR_CORRECTION_MODE_HIGH_QUALITY = 2; 11365a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 11375a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 11389e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He // Enumeration values for CaptureRequest#COLOR_CORRECTION_ABERRATION_MODE 1139a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He // 1140a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He 1141a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He /** 1142a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He * <p>No aberration correction is applied.</p> 11439e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He * @see CaptureRequest#COLOR_CORRECTION_ABERRATION_MODE 1144a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He */ 11459e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He public static final int COLOR_CORRECTION_ABERRATION_MODE_OFF = 0; 1146a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He 1147a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He /** 1148a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He * <p>Aberration correction will not slow down capture rate 1149a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He * relative to sensor raw output.</p> 11509e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He * @see CaptureRequest#COLOR_CORRECTION_ABERRATION_MODE 1151a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He */ 11529e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He public static final int COLOR_CORRECTION_ABERRATION_MODE_FAST = 1; 1153a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He 1154a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He /** 1155fba08dd9b4ecd8cb49d69d7537dce220996ec641Yin-Chia Yeh * <p>Aberration correction operates at improved quality but the capture rate might be 1156fba08dd9b4ecd8cb49d69d7537dce220996ec641Yin-Chia Yeh * reduced (relative to sensor raw output rate)</p> 11579e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He * @see CaptureRequest#COLOR_CORRECTION_ABERRATION_MODE 1158a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He */ 11599e4e439a688f1859cd895f2ff7ecad75cddb116bZhijun He public static final int COLOR_CORRECTION_ABERRATION_MODE_HIGH_QUALITY = 2; 1160a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He 1161a05e59d12b410638e97bc2d88c64442c47907fe3Zhijun He // 11625a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#CONTROL_AE_ANTIBANDING_MODE 11635a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 11645a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 11655a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 11660da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * <p>The camera device will not adjust exposure duration to 11670da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * avoid banding problems.</p> 11685a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_ANTIBANDING_MODE 11695a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 11705a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_ANTIBANDING_MODE_OFF = 0; 11715a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 11725a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 11730da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * <p>The camera device will adjust exposure duration to 11740da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * avoid banding problems with 50Hz illumination sources.</p> 11755a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_ANTIBANDING_MODE 11765a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 11775a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_ANTIBANDING_MODE_50HZ = 1; 11785a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 11795a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 11800da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * <p>The camera device will adjust exposure duration to 11810da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * avoid banding problems with 60Hz illumination 11820da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * sources.</p> 11835a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_ANTIBANDING_MODE 11845a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 11855a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_ANTIBANDING_MODE_60HZ = 2; 11865a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 11875a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 11880da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * <p>The camera device will automatically adapt its 11890da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * antibanding routine to the current illumination 11907b2cae6ceca680f6034a9fe43df2446cbae2f090Yin-Chia Yeh * condition. This is the default mode if AUTO is 11917b2cae6ceca680f6034a9fe43df2446cbae2f090Yin-Chia Yeh * available on given camera device.</p> 11925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_ANTIBANDING_MODE 11935a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 11945a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_ANTIBANDING_MODE_AUTO = 3; 11955a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 11965a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 11975a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#CONTROL_AE_MODE 11985a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 11995a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 12005a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1201e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device's autoexposure routine is disabled.</p> 1202e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application-selected {@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime}, 12030da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity} and 12040da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration} are used by the camera 12050da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * device, along with android.flash.* fields, if there's 12060da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * a flash unit for this camera device.</p> 12077144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * <p>Note that auto-white balance (AWB) and auto-focus (AF) 12087144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * behavior is device dependent when AE is in OFF mode. 12097144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * To have consistent behavior across different devices, 12107144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * it is recommended to either set AWB and AF to OFF mode 12117144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * or lock AWB and AF before setting AE to OFF. 12127144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * See {@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode}, {@link CaptureRequest#CONTROL_AF_MODE android.control.afMode}, 12137144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * {@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock}, and {@link CaptureRequest#CONTROL_AF_TRIGGER android.control.afTrigger} 12147144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * for more details.</p> 12154b8cd6b44cf800cf5dd88e5afbcff4968398779dIgor Murashkin * <p>LEGACY devices do not support the OFF mode and will 12164b8cd6b44cf800cf5dd88e5afbcff4968398779dIgor Murashkin * override attempts to use this value to ON.</p> 12170da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * 12187144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * @see CaptureRequest#CONTROL_AF_MODE 12197144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * @see CaptureRequest#CONTROL_AF_TRIGGER 12207144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * @see CaptureRequest#CONTROL_AWB_LOCK 12217144b5d2cf445ed245cfd9b09c7897966d01b5ffYin-Chia Yeh * @see CaptureRequest#CONTROL_AWB_MODE 12225f2a47f3dedfc7859457067d8cdcdbfc28ee08acZhijun He * @see CaptureRequest#SENSOR_EXPOSURE_TIME 1223265b34ce331cbe296f82ca357645312718c8d4c7Eino-Ville Talvala * @see CaptureRequest#SENSOR_FRAME_DURATION 12240da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * @see CaptureRequest#SENSOR_SENSITIVITY 12255a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_MODE 12265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 12275a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_MODE_OFF = 0; 12285a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 12295a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 12300da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * <p>The camera device's autoexposure routine is active, 1231e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * with no flash control.</p> 1232e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application's values for 12330da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * {@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime}, 12340da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}, and 12350da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * {@link CaptureRequest#SENSOR_FRAME_DURATION android.sensor.frameDuration} are ignored. The 12360da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * application has control over the various 12370da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * android.flash.* fields.</p> 12380da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * 12395f2a47f3dedfc7859457067d8cdcdbfc28ee08acZhijun He * @see CaptureRequest#SENSOR_EXPOSURE_TIME 1240265b34ce331cbe296f82ca357645312718c8d4c7Eino-Ville Talvala * @see CaptureRequest#SENSOR_FRAME_DURATION 12410da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * @see CaptureRequest#SENSOR_SENSITIVITY 12425a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_MODE 12435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 12445a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_MODE_ON = 1; 12455a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 12465a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 12470da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * <p>Like ON, except that the camera device also controls 12480da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * the camera's flash unit, firing it in low-light 1249e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * conditions.</p> 1250e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The flash may be fired during a precapture sequence 1251e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * (triggered by {@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger}) and 1252e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * may be fired for captures for which the 12530da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * {@link CaptureRequest#CONTROL_CAPTURE_INTENT android.control.captureIntent} field is set to 12540da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * STILL_CAPTURE</p> 12550da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * 12563242f4fb19b77bcd2435cbe710188d012d08b005Igor Murashkin * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 12575f2a47f3dedfc7859457067d8cdcdbfc28ee08acZhijun He * @see CaptureRequest#CONTROL_CAPTURE_INTENT 12585a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_MODE 12595a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 12605a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_MODE_ON_AUTO_FLASH = 2; 12615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 12625a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 12630da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * <p>Like ON, except that the camera device also controls 12640da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * the camera's flash unit, always firing it for still 1265e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * captures.</p> 1266e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The flash may be fired during a precapture sequence 1267e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * (triggered by {@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger}) and 1268e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * will always be fired for captures for which the 12690da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * {@link CaptureRequest#CONTROL_CAPTURE_INTENT android.control.captureIntent} field is set to 12700da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * STILL_CAPTURE</p> 12710da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * 12723242f4fb19b77bcd2435cbe710188d012d08b005Igor Murashkin * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 12735f2a47f3dedfc7859457067d8cdcdbfc28ee08acZhijun He * @see CaptureRequest#CONTROL_CAPTURE_INTENT 12745a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_MODE 12755a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 12765a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_MODE_ON_ALWAYS_FLASH = 3; 12775a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 12785a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 12790da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * <p>Like ON_AUTO_FLASH, but with automatic red eye 1280e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * reduction.</p> 1281e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>If deemed necessary by the camera device, a red eye 1282e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * reduction flash will fire during the precapture 1283e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * sequence.</p> 12845a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_MODE 12855a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 12865a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_MODE_ON_AUTO_FLASH_REDEYE = 4; 12875a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 12885a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 12895a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 12905a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 12915a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 12925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1293ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>The trigger is idle.</p> 12945a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 12955a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 12965a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_PRECAPTURE_TRIGGER_IDLE = 0; 12975a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 12985a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1299228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * <p>The precapture metering sequence will be started 1300e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * by the camera device.</p> 1301e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The exact effect of the precapture trigger depends on 1302e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * the current AE mode and state.</p> 13035a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 13045a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 13055a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_PRECAPTURE_TRIGGER_START = 1; 13065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 1307fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He /** 1308fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He * <p>The camera device will cancel any currently active or completed 1309fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He * precapture metering sequence, the auto-exposure routine will return to its 1310fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He * initial state.</p> 1311fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 1312fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He */ 1313fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He public static final int CONTROL_AE_PRECAPTURE_TRIGGER_CANCEL = 2; 1314fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He 13155a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 13165a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#CONTROL_AF_MODE 13175a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 13185a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 13195a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1320f353742124af698098884b4172644af0851b30caZhijun He * <p>The auto-focus routine does not control the lens; 13210da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * {@link CaptureRequest#LENS_FOCUS_DISTANCE android.lens.focusDistance} is controlled by the 1322e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * application.</p> 13230da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * 13240da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * @see CaptureRequest#LENS_FOCUS_DISTANCE 13255a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_MODE 13265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 13275a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_MODE_OFF = 0; 13285a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 13295a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1330b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * <p>Basic automatic focus mode.</p> 1331b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * <p>In this mode, the lens does not move unless 13325a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * the autofocus trigger action is called. When that trigger 1333b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * is activated, AF will transition to ACTIVE_SCAN, then to 1334f353742124af698098884b4172644af0851b30caZhijun He * the outcome of the scan (FOCUSED or NOT_FOCUSED).</p> 1335b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * <p>Always supported if lens is not fixed focus.</p> 1336b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * <p>Use {@link CameraCharacteristics#LENS_INFO_MINIMUM_FOCUS_DISTANCE android.lens.info.minimumFocusDistance} to determine if lens 1337b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * is fixed-focus.</p> 1338f353742124af698098884b4172644af0851b30caZhijun He * <p>Triggering AF_CANCEL resets the lens position to default, 1339ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * and sets the AF state to INACTIVE.</p> 13400da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * 13410da8bf5dbc8912cf70df14bfa655189a04c75476Eino-Ville Talvala * @see CameraCharacteristics#LENS_INFO_MINIMUM_FOCUS_DISTANCE 13425a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_MODE 13435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 13445a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_MODE_AUTO = 1; 13455a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 13465a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1347b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * <p>Close-up focusing mode.</p> 1348ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>In this mode, the lens does not move unless the 1349b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * autofocus trigger action is called. When that trigger is 1350b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * activated, AF will transition to ACTIVE_SCAN, then to 1351b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * the outcome of the scan (FOCUSED or NOT_FOCUSED). This 1352b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * mode is optimized for focusing on objects very close to 1353b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * the camera.</p> 1354b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * <p>When that trigger is activated, AF will transition to 13555a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * ACTIVE_SCAN, then to the outcome of the scan (FOCUSED or 1356b67a3b36fd569e63c1b8ca6b2701c34c7a3927c1Eino-Ville Talvala * NOT_FOCUSED). Triggering cancel AF resets the lens 13575a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * position to default, and sets the AF state to 1358ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * INACTIVE.</p> 13595a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_MODE 13605a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 13615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_MODE_MACRO = 2; 13625a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 13635a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1364ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>In this mode, the AF algorithm modifies the lens 13655a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * position continually to attempt to provide a 1366ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * constantly-in-focus image stream.</p> 1367ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>The focusing behavior should be suitable for good quality 13685a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * video recording; typically this means slower focus 13695a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * movement and no overshoots. When the AF trigger is not 13705a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * involved, the AF algorithm should start in INACTIVE state, 13715a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * and then transition into PASSIVE_SCAN and PASSIVE_FOCUSED 13725a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * states as appropriate. When the AF trigger is activated, 13735a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * the algorithm should immediately transition into 13745a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * AF_FOCUSED or AF_NOT_FOCUSED as appropriate, and lock the 1375ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * lens position until a cancel AF trigger is received.</p> 1376ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>Once cancel is received, the algorithm should transition 13775a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * back to INACTIVE and resume passive scan. Note that this 13785a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * behavior is not identical to CONTINUOUS_PICTURE, since an 13795a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * ongoing PASSIVE_SCAN must immediately be 1380ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * canceled.</p> 13815a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_MODE 13825a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 13835a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_MODE_CONTINUOUS_VIDEO = 3; 13845a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 13855a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1386ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>In this mode, the AF algorithm modifies the lens 13875a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * position continually to attempt to provide a 1388ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * constantly-in-focus image stream.</p> 1389ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>The focusing behavior should be suitable for still image 13905a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * capture; typically this means focusing as fast as 13915a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * possible. When the AF trigger is not involved, the AF 13925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * algorithm should start in INACTIVE state, and then 13935a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * transition into PASSIVE_SCAN and PASSIVE_FOCUSED states as 13945a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * appropriate as it attempts to maintain focus. When the AF 13955a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * trigger is activated, the algorithm should finish its 13965a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * PASSIVE_SCAN if active, and then transition into 13975a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * AF_FOCUSED or AF_NOT_FOCUSED as appropriate, and lock the 1398ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * lens position until a cancel AF trigger is received.</p> 1399ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>When the AF cancel trigger is activated, the algorithm 14005a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * should transition back to INACTIVE and then act as if it 1401ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * has just been started.</p> 14025a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_MODE 14035a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 14045a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_MODE_CONTINUOUS_PICTURE = 4; 14055a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 14065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1407e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Extended depth of field (digital focus) mode.</p> 1408e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device will produce images with an extended 1409e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * depth of field automatically; no special focusing 1410e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * operations need to be done before taking a picture.</p> 1411e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>AF triggers are ignored, and the AF state will always be 1412ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * INACTIVE.</p> 14135a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_MODE 14145a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 14155a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_MODE_EDOF = 5; 14165a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 14175a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 14185a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#CONTROL_AF_TRIGGER 14195a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 14205a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 14215a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1422ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>The trigger is idle.</p> 14235a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_TRIGGER 14245a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 14255a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_TRIGGER_IDLE = 0; 14265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 14275a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1428228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * <p>Autofocus will trigger now.</p> 14295a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_TRIGGER 14305a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 14315a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_TRIGGER_START = 1; 14325a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 14335a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1434228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * <p>Autofocus will return to its initial 1435228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * state, and cancel any currently active trigger.</p> 14365a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_TRIGGER 14375a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 14385a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_TRIGGER_CANCEL = 2; 14395a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 14405a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 14415a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#CONTROL_AWB_MODE 14425a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 14435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 14445a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1445e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device's auto-white balance routine is disabled.</p> 1446e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application-selected color transform matrix 1447399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * ({@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform}) and gains 1448399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * ({@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains}) are used by the camera 1449399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * device for manual white balance control.</p> 1450399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * 1451399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * @see CaptureRequest#COLOR_CORRECTION_GAINS 1452265b34ce331cbe296f82ca357645312718c8d4c7Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 14535a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AWB_MODE 14545a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 14555a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_MODE_OFF = 0; 14565a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 14575a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1458e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device's auto-white balance routine is active.</p> 1459e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application's values for {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform} 1460e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * and {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} are ignored. 1461e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * For devices that support the MANUAL_POST_PROCESSING capability, the 1462e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * values used by the camera device for the transform and gains 1463e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * will be available in the capture result for this request.</p> 1464399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * 1465399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * @see CaptureRequest#COLOR_CORRECTION_GAINS 1466d8fd67931e17c66e530de5482b63863e6c4301aaEino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 14675a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AWB_MODE 14685a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 14695a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_MODE_AUTO = 1; 14705a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 14715a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1472e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device's auto-white balance routine is disabled; 1473399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * the camera device uses incandescent light as the assumed scene 1474e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * illumination for white balance.</p> 1475e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>While the exact white balance transforms are up to the 1476e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * camera device, they will approximately match the CIE 1477e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * standard illuminant A.</p> 1478e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application's values for {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform} 1479e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * and {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} are ignored. 1480e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * For devices that support the MANUAL_POST_PROCESSING capability, the 1481e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * values used by the camera device for the transform and gains 1482e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * will be available in the capture result for this request.</p> 1483e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * 1484e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_GAINS 1485e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 14865a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AWB_MODE 14875a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 14885a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_MODE_INCANDESCENT = 2; 14895a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 14905a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1491e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device's auto-white balance routine is disabled; 1492399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * the camera device uses fluorescent light as the assumed scene 1493e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * illumination for white balance.</p> 1494e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>While the exact white balance transforms are up to the 1495e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * camera device, they will approximately match the CIE 1496e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * standard illuminant F2.</p> 1497e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application's values for {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform} 1498e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * and {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} are ignored. 1499e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * For devices that support the MANUAL_POST_PROCESSING capability, the 1500e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * values used by the camera device for the transform and gains 1501e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * will be available in the capture result for this request.</p> 1502e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * 1503e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_GAINS 1504e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 15055a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AWB_MODE 15065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 15075a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_MODE_FLUORESCENT = 3; 15085a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 15095a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1510e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device's auto-white balance routine is disabled; 1511399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * the camera device uses warm fluorescent light as the assumed scene 1512e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * illumination for white balance.</p> 1513e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>While the exact white balance transforms are up to the 1514e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * camera device, they will approximately match the CIE 1515e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * standard illuminant F4.</p> 1516e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application's values for {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform} 1517e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * and {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} are ignored. 1518e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * For devices that support the MANUAL_POST_PROCESSING capability, the 1519e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * values used by the camera device for the transform and gains 1520e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * will be available in the capture result for this request.</p> 1521e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * 1522e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_GAINS 1523e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 15245a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AWB_MODE 15255a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 15265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_MODE_WARM_FLUORESCENT = 4; 15275a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 15285a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1529e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device's auto-white balance routine is disabled; 1530399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * the camera device uses daylight light as the assumed scene 1531e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * illumination for white balance.</p> 1532e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>While the exact white balance transforms are up to the 1533e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * camera device, they will approximately match the CIE 1534e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * standard illuminant D65.</p> 1535e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application's values for {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform} 1536e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * and {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} are ignored. 1537e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * For devices that support the MANUAL_POST_PROCESSING capability, the 1538e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * values used by the camera device for the transform and gains 1539e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * will be available in the capture result for this request.</p> 1540e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * 1541e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_GAINS 1542e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 15435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AWB_MODE 15445a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 15455a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_MODE_DAYLIGHT = 5; 15465a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 15475a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1548e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device's auto-white balance routine is disabled; 1549399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * the camera device uses cloudy daylight light as the assumed scene 1550399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * illumination for white balance.</p> 1551e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application's values for {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform} 1552e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * and {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} are ignored. 1553e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * For devices that support the MANUAL_POST_PROCESSING capability, the 1554e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * values used by the camera device for the transform and gains 1555e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * will be available in the capture result for this request.</p> 1556e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * 1557e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_GAINS 1558e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 15595a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AWB_MODE 15605a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 15615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_MODE_CLOUDY_DAYLIGHT = 6; 15625a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 15635a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1564e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device's auto-white balance routine is disabled; 1565399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * the camera device uses twilight light as the assumed scene 1566399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * illumination for white balance.</p> 1567e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application's values for {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform} 1568e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * and {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} are ignored. 1569e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * For devices that support the MANUAL_POST_PROCESSING capability, the 1570e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * values used by the camera device for the transform and gains 1571e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * will be available in the capture result for this request.</p> 1572e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * 1573e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_GAINS 1574e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 15755a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AWB_MODE 15765a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 15775a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_MODE_TWILIGHT = 7; 15785a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 15795a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1580e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device's auto-white balance routine is disabled; 1581399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * the camera device uses shade light as the assumed scene 1582399f05d1e7182ef6c88d30d3b98a467b845ca7c4Zhijun He * illumination for white balance.</p> 1583e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The application's values for {@link CaptureRequest#COLOR_CORRECTION_TRANSFORM android.colorCorrection.transform} 1584e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * and {@link CaptureRequest#COLOR_CORRECTION_GAINS android.colorCorrection.gains} are ignored. 1585e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * For devices that support the MANUAL_POST_PROCESSING capability, the 1586e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * values used by the camera device for the transform and gains 1587e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * will be available in the capture result for this request.</p> 1588e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * 1589e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_GAINS 1590e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#COLOR_CORRECTION_TRANSFORM 15915a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_AWB_MODE 15925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 15935a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_MODE_SHADE = 8; 15945a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 15955a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 15965a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#CONTROL_CAPTURE_INTENT 15975a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 15985a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 15995a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1600e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The goal of this request doesn't fall into the other 1601e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * categories. The camera device will default to preview-like 1602ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * behavior.</p> 16035a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_CAPTURE_INTENT 16045a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16055a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_CAPTURE_INTENT_CUSTOM = 0; 16065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 16075a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1608e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>This request is for a preview-like use case.</p> 1609e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The precapture trigger may be used to start off a metering 1610e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * w/flash sequence.</p> 16115a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_CAPTURE_INTENT 16125a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16135a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_CAPTURE_INTENT_PREVIEW = 1; 16145a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 16155a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1616ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>This request is for a still capture-type 1617e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * use case.</p> 1618e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>If the flash unit is under automatic control, it may fire as needed.</p> 16195a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_CAPTURE_INTENT 16205a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16215a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_CAPTURE_INTENT_STILL_CAPTURE = 2; 16225a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 16235a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1624ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>This request is for a video recording 1625e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * use case.</p> 16265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_CAPTURE_INTENT 16275a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16285a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_CAPTURE_INTENT_VIDEO_RECORD = 3; 16295a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 16305a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1631ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>This request is for a video snapshot (still 1632e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * image while recording video) use case.</p> 1633e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device should take the highest-quality image 1634e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * possible (given the other settings) without disrupting the 1635126a7468c2b86f27779443f5f2578a03f3ad78e8Eino-Ville Talvala * frame rate of video recording. </p> 16365a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_CAPTURE_INTENT 16375a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16385a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_CAPTURE_INTENT_VIDEO_SNAPSHOT = 4; 16395a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 16405a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1641ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>This request is for a ZSL usecase; the 16425a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * application will stream full-resolution images and 16435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * reprocess one or several later for a final 1644e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * capture.</p> 16455a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_CAPTURE_INTENT 16465a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16475a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_CAPTURE_INTENT_ZERO_SHUTTER_LAG = 5; 16485a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 1649e30adb762ad17fc49fd3f7c1aa9ba6bd24bc43a0Zhijun He /** 1650e30adb762ad17fc49fd3f7c1aa9ba6bd24bc43a0Zhijun He * <p>This request is for manual capture use case where 1651e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * the applications want to directly control the capture parameters.</p> 1652e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>For example, the application may wish to manually control 1653e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * {@link CaptureRequest#SENSOR_EXPOSURE_TIME android.sensor.exposureTime}, {@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}, etc.</p> 1654e30adb762ad17fc49fd3f7c1aa9ba6bd24bc43a0Zhijun He * 1655e30adb762ad17fc49fd3f7c1aa9ba6bd24bc43a0Zhijun He * @see CaptureRequest#SENSOR_EXPOSURE_TIME 1656e30adb762ad17fc49fd3f7c1aa9ba6bd24bc43a0Zhijun He * @see CaptureRequest#SENSOR_SENSITIVITY 1657e30adb762ad17fc49fd3f7c1aa9ba6bd24bc43a0Zhijun He * @see CaptureRequest#CONTROL_CAPTURE_INTENT 1658e30adb762ad17fc49fd3f7c1aa9ba6bd24bc43a0Zhijun He */ 1659e30adb762ad17fc49fd3f7c1aa9ba6bd24bc43a0Zhijun He public static final int CONTROL_CAPTURE_INTENT_MANUAL = 6; 1660e30adb762ad17fc49fd3f7c1aa9ba6bd24bc43a0Zhijun He 16615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 16625a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#CONTROL_EFFECT_MODE 16635a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 16645a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 16655a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 16665f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * <p>No color effect will be applied.</p> 16675a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_EFFECT_MODE 16685a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16695a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_EFFECT_MODE_OFF = 0; 16705a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 16715a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 16725f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * <p>A "monocolor" effect where the image is mapped into 1673e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * a single color.</p> 1674e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>This will typically be grayscale.</p> 16755a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_EFFECT_MODE 16765a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16775a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_EFFECT_MODE_MONO = 1; 16785a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 16795a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 16805f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * <p>A "photo-negative" effect where the image's colors 16815f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * are inverted.</p> 16825a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_EFFECT_MODE 16835a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16845a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_EFFECT_MODE_NEGATIVE = 2; 16855a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 16865a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 16875f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * <p>A "solarisation" effect (Sabattier effect) where the 16885f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * image is wholly or partially reversed in 16895f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * tone.</p> 16905a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_EFFECT_MODE 16915a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_EFFECT_MODE_SOLARIZE = 3; 16935a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 16945a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 16955f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * <p>A "sepia" effect where the image is mapped into warm 16965f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * gray, red, and brown tones.</p> 16975a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_EFFECT_MODE 16985a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 16995a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_EFFECT_MODE_SEPIA = 4; 17005a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17015a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 17025f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * <p>A "posterization" effect where the image uses 17035f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * discrete regions of tone rather than a continuous 17045f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * gradient of tones.</p> 17055a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_EFFECT_MODE 17065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 17075a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_EFFECT_MODE_POSTERIZE = 5; 17085a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17095a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 17105f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * <p>A "whiteboard" effect where the image is typically displayed 17115f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * as regions of white, with black or grey details.</p> 17125a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_EFFECT_MODE 17135a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 17145a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_EFFECT_MODE_WHITEBOARD = 6; 17155a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17165a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 17175f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * <p>A "blackboard" effect where the image is typically displayed 17185f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * as regions of black, with white or grey details.</p> 17195a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_EFFECT_MODE 17205a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 17215a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_EFFECT_MODE_BLACKBOARD = 7; 17225a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17235a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 17245f1dcfe49dfe7b9a4a40482152638af6ca925a6dRuben Brunk * <p>An "aqua" effect where a blue hue is added to the image.</p> 17255a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_EFFECT_MODE 17265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 17275a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_EFFECT_MODE_AQUA = 8; 17285a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17295a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 17305a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#CONTROL_MODE 17315a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 17325a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17335a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1734e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Full application control of pipeline.</p> 1735e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>All control by the device's metering and focusing (3A) 1736e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * routines is disabled, and no other settings in 1737e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * android.control.* have any effect, except that 1738e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * {@link CaptureRequest#CONTROL_CAPTURE_INTENT android.control.captureIntent} may be used by the camera 1739e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * device to select post-processing values for processing 1740e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * blocks that do not allow for manual control, or are not 1741e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * exposed by the camera API.</p> 1742e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>However, the camera device's 3A routines may continue to 1743e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * collect statistics and update their internal state so that 1744e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * when control is switched to AUTO mode, good control values 1745e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * can be immediately applied.</p> 1746e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * 1747e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#CONTROL_CAPTURE_INTENT 17485a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_MODE 17495a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 17505a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_MODE_OFF = 0; 17515a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17525a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1753e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Use settings for each individual 3A routine.</p> 1754e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Manual control of capture parameters is disabled. All 17555a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * controls in android.control.* besides sceneMode take 1756e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * effect.</p> 17575a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_MODE 17585a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 17595a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_MODE_AUTO = 1; 17605a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1762e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Use a specific scene mode.</p> 1763e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Enabling this disables control.aeMode, control.awbMode and 1764e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * control.afMode controls; the camera device will ignore 1765e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * those settings while USE_SCENE_MODE is active (except for 1766ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * FACE_PRIORITY scene mode). Other control entries are still active. 1767ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * This setting can only be used if scene mode is supported (i.e. 1768ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * {@link CameraCharacteristics#CONTROL_AVAILABLE_SCENE_MODES android.control.availableSceneModes} 1769e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * contain some modes other than DISABLED).</p> 1770a486624a6d9631fd434468fec7e3b57431f0b785Zhijun He * 1771a486624a6d9631fd434468fec7e3b57431f0b785Zhijun He * @see CameraCharacteristics#CONTROL_AVAILABLE_SCENE_MODES 17725a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_MODE 17735a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 17745a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_MODE_USE_SCENE_MODE = 2; 17755a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17762d5e89778e955b4ff209a93e738761356349d48cZhijun He /** 17772d5e89778e955b4ff209a93e738761356349d48cZhijun He * <p>Same as OFF mode, except that this capture will not be 17782d5e89778e955b4ff209a93e738761356349d48cZhijun He * used by camera device background auto-exposure, auto-white balance and 1779e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * auto-focus algorithms (3A) to update their statistics.</p> 1780e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Specifically, the 3A routines are locked to the last 1781e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * values set from a request with AUTO, OFF, or 1782e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * USE_SCENE_MODE, and any statistics or state updates 1783e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * collected from manual captures with OFF_KEEP_STATE will be 1784e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * discarded by the camera device.</p> 17852d5e89778e955b4ff209a93e738761356349d48cZhijun He * @see CaptureRequest#CONTROL_MODE 17862d5e89778e955b4ff209a93e738761356349d48cZhijun He */ 17872d5e89778e955b4ff209a93e738761356349d48cZhijun He public static final int CONTROL_MODE_OFF_KEEP_STATE = 3; 17882d5e89778e955b4ff209a93e738761356349d48cZhijun He 17895a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 17905a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#CONTROL_SCENE_MODE 17915a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 17925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17935a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1794e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Indicates that no scene modes are set for a given capture request.</p> 17955a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 17965a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 1797e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk public static final int CONTROL_SCENE_MODE_DISABLED = 0; 17985a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 17995a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1800e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>If face detection support exists, use face 1801e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * detection data for auto-focus, auto-white balance, and 1802e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * auto-exposure routines.</p> 1803e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>If face detection statistics are disabled 1804e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * (i.e. {@link CaptureRequest#STATISTICS_FACE_DETECT_MODE android.statistics.faceDetectMode} is set to OFF), 1805e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * this should still operate correctly (but will not return 1806e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * face detection statistics to the framework).</p> 1807e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Unlike the other scene modes, {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode}, 1808d8fd67931e17c66e530de5482b63863e6c4301aaEino-Ville Talvala * {@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode}, and {@link CaptureRequest#CONTROL_AF_MODE android.control.afMode} 1809e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * remain active when FACE_PRIORITY is set.</p> 1810e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * 1811e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * @see CaptureRequest#CONTROL_AE_MODE 1812d8fd67931e17c66e530de5482b63863e6c4301aaEino-Ville Talvala * @see CaptureRequest#CONTROL_AF_MODE 1813e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * @see CaptureRequest#CONTROL_AWB_MODE 1814e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * @see CaptureRequest#STATISTICS_FACE_DETECT_MODE 18155a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18165a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18175a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_FACE_PRIORITY = 1; 18185a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18195a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1820e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Optimized for photos of quickly moving objects.</p> 1821e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Similar to SPORTS.</p> 18225a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18235a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18245a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_ACTION = 2; 18255a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1827e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for still photos of people.</p> 18285a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18295a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18305a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_PORTRAIT = 3; 18315a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18325a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1833e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for photos of distant macroscopic objects.</p> 18345a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18355a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18365a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_LANDSCAPE = 4; 18375a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18385a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1839e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for low-light settings.</p> 18405a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18415a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18425a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_NIGHT = 5; 18435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18445a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1845e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for still photos of people in low-light 1846e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * settings.</p> 18475a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18485a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18495a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_NIGHT_PORTRAIT = 6; 18505a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18515a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1852e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for dim, indoor settings where flash must 1853e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * remain off.</p> 18545a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18555a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18565a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_THEATRE = 7; 18575a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18585a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1859e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for bright, outdoor beach settings.</p> 18605a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18625a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_BEACH = 8; 18635a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18645a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1865e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for bright, outdoor settings containing snow.</p> 18665a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18675a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18685a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_SNOW = 9; 18695a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18705a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1871e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for scenes of the setting sun.</p> 18725a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18735a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18745a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_SUNSET = 10; 18755a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18765a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1877e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized to avoid blurry photos due to small amounts of 1878e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * device motion (for example: due to hand shake).</p> 18795a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18805a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18815a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_STEADYPHOTO = 11; 18825a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18835a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1884e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for nighttime photos of fireworks.</p> 18855a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18865a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18875a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_FIREWORKS = 12; 18885a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18895a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1890e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Optimized for photos of quickly moving people.</p> 1891e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Similar to ACTION.</p> 18925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 18935a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 18945a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_SPORTS = 13; 18955a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 18965a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1897e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for dim, indoor settings with multiple moving 1898e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * people.</p> 18995a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 19005a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 19015a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_PARTY = 14; 19025a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 19035a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1904e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for dim settings where the main light source 1905e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * is a flame.</p> 19065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 19075a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 19085a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_CANDLELIGHT = 15; 19095a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 19105a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 1911e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * <p>Optimized for accurately capturing a photo of barcode 1912e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * for use by camera applications that wish to read the 1913e6679366938fd3ed197ba1ff1b2ad0bf2ff4246bRuben Brunk * barcode value.</p> 19145a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#CONTROL_SCENE_MODE 19155a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 19165a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_SCENE_MODE_BARCODE = 16; 19175a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 1918e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He /** 1919639fffee624302ec5b175503d7bd8a441340a629Eino-Ville Talvala * <p>This is deprecated, please use {@link android.hardware.camera2.CameraDevice#createConstrainedHighSpeedCaptureSession } 1920639fffee624302ec5b175503d7bd8a441340a629Eino-Ville Talvala * and {@link android.hardware.camera2.CameraConstrainedHighSpeedCaptureSession#createHighSpeedRequestList } 1921fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * for high speed video recording.</p> 1922e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <p>Optimized for high speed video recording (frame rate >=60fps) use case.</p> 1923e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <p>The supported high speed video sizes and fps ranges are specified in 1924e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * android.control.availableHighSpeedVideoConfigurations. To get desired 1925e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * output frame rates, the application is only allowed to select video size 1926e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * and fps range combinations listed in this static metadata. The fps range 1927e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * can be control via {@link CaptureRequest#CONTROL_AE_TARGET_FPS_RANGE android.control.aeTargetFpsRange}.</p> 1928e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <p>In this mode, the camera device will override aeMode, awbMode, and afMode to 1929e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * ON, ON, and CONTINUOUS_VIDEO, respectively. All post-processing block mode 1930e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * controls will be overridden to be FAST. Therefore, no manual control of capture 1931e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * and post-processing parameters is possible. All other controls operate the 1932e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * same as when {@link CaptureRequest#CONTROL_MODE android.control.mode} == AUTO. This means that all other 1933e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * android.control.* fields continue to work, such as</p> 1934e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <ul> 1935e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#CONTROL_AE_TARGET_FPS_RANGE android.control.aeTargetFpsRange}</li> 1936e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#CONTROL_AE_EXPOSURE_COMPENSATION android.control.aeExposureCompensation}</li> 1937e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#CONTROL_AE_LOCK android.control.aeLock}</li> 1938e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#CONTROL_AWB_LOCK android.control.awbLock}</li> 1939e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#CONTROL_EFFECT_MODE android.control.effectMode}</li> 1940e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#CONTROL_AE_REGIONS android.control.aeRegions}</li> 1941e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#CONTROL_AF_REGIONS android.control.afRegions}</li> 1942e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#CONTROL_AWB_REGIONS android.control.awbRegions}</li> 1943e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#CONTROL_AF_TRIGGER android.control.afTrigger}</li> 1944e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger}</li> 1945e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * </ul> 1946e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <p>Outside of android.control.*, the following controls will work:</p> 1947e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <ul> 1948e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#FLASH_MODE android.flash.mode} (automatic flash for still capture will not work since aeMode is ON)</li> 1949e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE android.lens.opticalStabilizationMode} (if it is supported)</li> 1950e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#SCALER_CROP_REGION android.scaler.cropRegion}</li> 1951e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>{@link CaptureRequest#STATISTICS_FACE_DETECT_MODE android.statistics.faceDetectMode}</li> 1952e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * </ul> 1953e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <p>For high speed recording use case, the actual maximum supported frame rate may 1954e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * be lower than what camera can output, depending on the destination Surfaces for 1955e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * the image data. For example, if the destination surface is from video encoder, 1956e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * the application need check if the video encoder is capable of supporting the 1957e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * high frame rate for a given video size, or it will end up with lower recording 1958e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * frame rate. If the destination surface is from preview window, the preview frame 1959e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * rate will be bounded by the screen refresh rate.</p> 1960e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <p>The camera device will only support up to 2 output high speed streams 1961e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * (processed non-stalling format defined in android.request.maxNumOutputStreams) 1962e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * in this mode. This control will be effective only if all of below conditions are true:</p> 1963e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <ul> 1964e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>The application created no more than maxNumHighSpeedStreams processed non-stalling 1965e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * format output streams, where maxNumHighSpeedStreams is calculated as 1966e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * min(2, android.request.maxNumOutputStreams[Processed (but not-stalling)]).</li> 1967e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>The stream sizes are selected from the sizes reported by 1968e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * android.control.availableHighSpeedVideoConfigurations.</li> 1969e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <li>No processed non-stalling or raw streams are configured.</li> 1970e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * </ul> 1971e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <p>When above conditions are NOT satistied, the controls of this mode and 1972e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * {@link CaptureRequest#CONTROL_AE_TARGET_FPS_RANGE android.control.aeTargetFpsRange} will be ignored by the camera device, 1973e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * the camera device will fall back to {@link CaptureRequest#CONTROL_MODE android.control.mode} <code>==</code> AUTO, 1974e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * and the returned capture result metadata will give the fps range choosen 1975e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * by the camera device.</p> 1976e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * <p>Switching into or out of this mode may trigger some camera ISP/sensor 1977e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * reconfigurations, which may introduce extra latency. It is recommended that 1978e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * the application avoids unnecessary scene mode switch as much as possible.</p> 1979e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * 1980e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_AE_EXPOSURE_COMPENSATION 1981e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_AE_LOCK 1982e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 1983e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_AE_REGIONS 1984e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_AE_TARGET_FPS_RANGE 1985e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_AF_REGIONS 1986e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_AF_TRIGGER 1987e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_AWB_LOCK 1988e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_AWB_REGIONS 1989e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_EFFECT_MODE 1990e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_MODE 1991e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#FLASH_MODE 1992e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE 1993e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#SCALER_CROP_REGION 1994e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#STATISTICS_FACE_DETECT_MODE 1995e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He * @see CaptureRequest#CONTROL_SCENE_MODE 1996fab663ebfdbb7c0c8e12e27dd82b0c9331f14184Zhijun He * @deprecated Please refer to this API documentation to find the alternatives 1997e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He */ 1998e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He public static final int CONTROL_SCENE_MODE_HIGH_SPEED_VIDEO = 17; 1999e040418f4779c37aa9df69a3916d376af9d2e868Zhijun He 2000ff99a0add9700b423a0da3e332840e3907ae96a5Ruben Brunk /** 2001f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * <p>Turn on a device-specific high dynamic range (HDR) mode.</p> 2002f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * <p>In this scene mode, the camera device captures images 2003f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * that keep a larger range of scene illumination levels 2004f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * visible in the final image. For example, when taking a 2005f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * picture of a object in front of a bright window, both 2006f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * the object and the scene through the window may be 2007f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * visible when using HDR mode, while in normal AUTO mode, 2008f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * one or the other may be poorly exposed. As a tradeoff, 2009f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * HDR mode generally takes much longer to capture a single 2010f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * image, has no user control, and may have other artifacts 2011f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * depending on the HDR method used.</p> 2012f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * <p>Therefore, HDR captures operate at a much slower rate 2013f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * than regular captures.</p> 2014f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * <p>In this mode, on LIMITED or FULL devices, when a request 2015f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * is made with a {@link CaptureRequest#CONTROL_CAPTURE_INTENT android.control.captureIntent} of 2016f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * STILL_CAPTURE, the camera device will capture an image 2017f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * using a high dynamic range capture technique. On LEGACY 2018f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * devices, captures that target a JPEG-format output will 2019f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * be captured with HDR, and the capture intent is not 2020f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * relevant.</p> 2021f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * <p>The HDR capture may involve the device capturing a burst 2022f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * of images internally and combining them into one, or it 2023f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * may involve the device using specialized high dynamic 2024f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * range capture hardware. In all cases, a single image is 2025f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * produced in response to a capture request submitted 2026f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * while in HDR mode.</p> 2027f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * <p>Since substantial post-processing is generally needed to 2028c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * produce an HDR image, only YUV, PRIVATE, and JPEG 2029c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * outputs are supported for LIMITED/FULL device HDR 2030c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * captures, and only JPEG outputs are supported for LEGACY 2031c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * HDR captures. Using a RAW output for HDR capture is not 2032f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * supported.</p> 2033c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * <p>Some devices may also support always-on HDR, which 2034c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * applies HDR processing at full frame rate. For these 2035c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * devices, intents other than STILL_CAPTURE will also 2036c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * produce an HDR output with no frame rate impact compared 2037c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * to normal operation, though the quality may be lower 2038c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * than for STILL_CAPTURE intents.</p> 2039c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * <p>If SCENE_MODE_HDR is used with unsupported output types 2040c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * or capture intents, the images captured will be as if 2041c7c569d5e42c1d7c17881fd89dcbbbab42dafea1Eino-Ville Talvala * the SCENE_MODE was not enabled at all.</p> 2042f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * 2043f4eac129545fd583d33d9e7ab05cc87f61079bb9Eino-Ville Talvala * @see CaptureRequest#CONTROL_CAPTURE_INTENT 2044ff99a0add9700b423a0da3e332840e3907ae96a5Ruben Brunk * @see CaptureRequest#CONTROL_SCENE_MODE 2045ff99a0add9700b423a0da3e332840e3907ae96a5Ruben Brunk */ 2046ff99a0add9700b423a0da3e332840e3907ae96a5Ruben Brunk public static final int CONTROL_SCENE_MODE_HDR = 18; 2047ff99a0add9700b423a0da3e332840e3907ae96a5Ruben Brunk 2048ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He /** 2049ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * <p>Same as FACE_PRIORITY scene mode, except that the camera 20504fb81253edc726936d4b71b7e9c0789cab45e9daZhijun He * device will choose higher sensitivity values ({@link CaptureRequest#SENSOR_SENSITIVITY android.sensor.sensitivity}) 2051ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * under low light conditions.</p> 2052ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * <p>The camera device may be tuned to expose the images in a reduced 2053ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * sensitivity range to produce the best quality images. For example, 2054ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * if the {@link CameraCharacteristics#SENSOR_INFO_SENSITIVITY_RANGE android.sensor.info.sensitivityRange} gives range of [100, 1600], 2055ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * the camera device auto-exposure routine tuning process may limit the actual 20564fb81253edc726936d4b71b7e9c0789cab45e9daZhijun He * exposure sensitivity range to [100, 1200] to ensure that the noise level isn't 20574fb81253edc726936d4b71b7e9c0789cab45e9daZhijun He * exessive in order to preserve the image quality. Under this situation, the image under 2058ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * low light may be under-exposed when the sensor max exposure time (bounded by the 2059ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * {@link CaptureRequest#CONTROL_AE_TARGET_FPS_RANGE android.control.aeTargetFpsRange} when {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode} is one of the 20604fb81253edc726936d4b71b7e9c0789cab45e9daZhijun He * ON_* modes) and effective max sensitivity are reached. This scene mode allows the 2061ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * camera device auto-exposure routine to increase the sensitivity up to the max 2062ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * sensitivity specified by {@link CameraCharacteristics#SENSOR_INFO_SENSITIVITY_RANGE android.sensor.info.sensitivityRange} when the scene is too 2063ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * dark and the max exposure time is reached. The captured images may be noisier 20644fb81253edc726936d4b71b7e9c0789cab45e9daZhijun He * compared with the images captured in normal FACE_PRIORITY mode; therefore, it is 2065ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * recommended that the application only use this scene mode when it is capable of 2066ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * reducing the noise level of the captured images.</p> 2067ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * <p>Unlike the other scene modes, {@link CaptureRequest#CONTROL_AE_MODE android.control.aeMode}, 2068ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * {@link CaptureRequest#CONTROL_AWB_MODE android.control.awbMode}, and {@link CaptureRequest#CONTROL_AF_MODE android.control.afMode} 2069ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * remain active when FACE_PRIORITY_LOW_LIGHT is set.</p> 2070ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * 2071ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * @see CaptureRequest#CONTROL_AE_MODE 2072ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * @see CaptureRequest#CONTROL_AE_TARGET_FPS_RANGE 2073ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * @see CaptureRequest#CONTROL_AF_MODE 2074ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * @see CaptureRequest#CONTROL_AWB_MODE 2075ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * @see CameraCharacteristics#SENSOR_INFO_SENSITIVITY_RANGE 2076ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * @see CaptureRequest#SENSOR_SENSITIVITY 2077ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * @see CaptureRequest#CONTROL_SCENE_MODE 2078ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He * @hide 2079ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He */ 2080ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He public static final int CONTROL_SCENE_MODE_FACE_PRIORITY_LOW_LIGHT = 19; 2081ee2ebdedccaa708cfe810c50cc047990cc2054c5Zhijun He 2082373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh /** 2083373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh * <p>Scene mode values within the range of 2084373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh * <code>[DEVICE_CUSTOM_START, DEVICE_CUSTOM_END]</code> are reserved for device specific 2085373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh * customized scene modes.</p> 2086373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh * @see CaptureRequest#CONTROL_SCENE_MODE 2087373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh * @hide 2088373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh */ 2089373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh public static final int CONTROL_SCENE_MODE_DEVICE_CUSTOM_START = 100; 2090373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh 2091373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh /** 2092373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh * <p>Scene mode values within the range of 2093373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh * <code>[DEVICE_CUSTOM_START, DEVICE_CUSTOM_END]</code> are reserved for device specific 2094373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh * customized scene modes.</p> 2095373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh * @see CaptureRequest#CONTROL_SCENE_MODE 2096373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh * @hide 2097373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh */ 2098373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh public static final int CONTROL_SCENE_MODE_DEVICE_CUSTOM_END = 127; 2099373482009b158cdb0954d29cf308e530cca92663Yin-Chia Yeh 21005a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 21014793af5e3577c51858719a8977d300c3aafdf881Zhijun He // Enumeration values for CaptureRequest#CONTROL_VIDEO_STABILIZATION_MODE 21024793af5e3577c51858719a8977d300c3aafdf881Zhijun He // 21034793af5e3577c51858719a8977d300c3aafdf881Zhijun He 21044793af5e3577c51858719a8977d300c3aafdf881Zhijun He /** 2105e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Video stabilization is disabled.</p> 21064793af5e3577c51858719a8977d300c3aafdf881Zhijun He * @see CaptureRequest#CONTROL_VIDEO_STABILIZATION_MODE 21074793af5e3577c51858719a8977d300c3aafdf881Zhijun He */ 21084793af5e3577c51858719a8977d300c3aafdf881Zhijun He public static final int CONTROL_VIDEO_STABILIZATION_MODE_OFF = 0; 21094793af5e3577c51858719a8977d300c3aafdf881Zhijun He 21104793af5e3577c51858719a8977d300c3aafdf881Zhijun He /** 2111e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Video stabilization is enabled.</p> 21124793af5e3577c51858719a8977d300c3aafdf881Zhijun He * @see CaptureRequest#CONTROL_VIDEO_STABILIZATION_MODE 21134793af5e3577c51858719a8977d300c3aafdf881Zhijun He */ 21144793af5e3577c51858719a8977d300c3aafdf881Zhijun He public static final int CONTROL_VIDEO_STABILIZATION_MODE_ON = 1; 21154793af5e3577c51858719a8977d300c3aafdf881Zhijun He 21164793af5e3577c51858719a8977d300c3aafdf881Zhijun He // 21175a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#EDGE_MODE 21185a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 21195a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 21205a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2121e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>No edge enhancement is applied.</p> 21225a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#EDGE_MODE 21235a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 21245a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int EDGE_MODE_OFF = 0; 21255a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 21265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 21279c9167efe229f2d7bad0422c371923d5d1776f52Chien-Yu Chen * <p>Apply edge enhancement at a quality level that does not slow down frame rate 21289c9167efe229f2d7bad0422c371923d5d1776f52Chien-Yu Chen * relative to sensor output. It may be the same as OFF if edge enhancement will 21299c9167efe229f2d7bad0422c371923d5d1776f52Chien-Yu Chen * slow down frame rate relative to sensor.</p> 21305a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#EDGE_MODE 21315a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 21325a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int EDGE_MODE_FAST = 1; 21335a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 21345a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2135fba08dd9b4ecd8cb49d69d7537dce220996ec641Yin-Chia Yeh * <p>Apply high-quality edge enhancement, at a cost of possibly reduced output frame rate.</p> 21365a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#EDGE_MODE 21375a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 21385a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int EDGE_MODE_HIGH_QUALITY = 2; 21395a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 21400dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala /** 21410dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * <p>Edge enhancement is applied at different levels for different output streams, 21420dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * based on resolution. Streams at maximum recording resolution (see {@link android.hardware.camera2.CameraDevice#createCaptureSession }) or below have 21430dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * edge enhancement applied, while higher-resolution streams have no edge enhancement 21440dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * applied. The level of edge enhancement for low-resolution streams is tuned so that 21450dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * frame rate is not impacted, and the quality is equal to or better than FAST (since it 21460dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * is only applied to lower-resolution outputs, quality may improve from FAST).</p> 21470dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * <p>This mode is intended to be used by applications operating in a zero-shutter-lag mode 21480dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * with YUV or PRIVATE reprocessing, where the application continuously captures 21490dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * high-resolution intermediate buffers into a circular buffer, from which a final image is 21500dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * produced via reprocessing when a user takes a picture. For such a use case, the 21510dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * high-resolution buffers must not have edge enhancement applied to maximize efficiency of 21520dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * preview and to avoid double-applying enhancement when reprocessed, while low-resolution 21530dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * buffers (used for recording or preview, generally) need edge enhancement applied for 21540dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * reasonable preview quality.</p> 21550dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * <p>This mode is guaranteed to be supported by devices that support either the 21560dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * YUV_REPROCESSING or PRIVATE_REPROCESSING capabilities 215772333917a7802d2a1f233418a0e2c15d7e86a357Chien-Yu Chen * ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} lists either of those capabilities) and it will 215872333917a7802d2a1f233418a0e2c15d7e86a357Chien-Yu Chen * be the default mode for CAMERA3_TEMPLATE_ZERO_SHUTTER_LAG template.</p> 21590dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * 21600dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 21610dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * @see CaptureRequest#EDGE_MODE 21620dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala */ 21630dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala public static final int EDGE_MODE_ZERO_SHUTTER_LAG = 3; 21640dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala 21655a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 21665a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#FLASH_MODE 21675a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 21685a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 21695a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 217066d065a6d48cafe390c697c77b44ba5196ee0870Zhijun He * <p>Do not fire the flash for this capture.</p> 21715a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#FLASH_MODE 21725a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 21735a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int FLASH_MODE_OFF = 0; 21745a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 21755a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 217666d065a6d48cafe390c697c77b44ba5196ee0870Zhijun He * <p>If the flash is available and charged, fire flash 21778949225294479d6152b3bd0f56f9520e700f84b7Zhijun He * for this capture.</p> 21785a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#FLASH_MODE 21795a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 21805a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int FLASH_MODE_SINGLE = 1; 21815a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 21825a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 218366d065a6d48cafe390c697c77b44ba5196ee0870Zhijun He * <p>Transition flash to continuously on.</p> 21845a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#FLASH_MODE 21855a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 21865a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int FLASH_MODE_TORCH = 2; 21875a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 21885a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 2189eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk // Enumeration values for CaptureRequest#HOT_PIXEL_MODE 2190eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk // 2191eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk 2192eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk /** 2193e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>No hot pixel correction is applied.</p> 2194eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk * <p>The frame rate must not be reduced relative to sensor raw output 2195eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk * for this option.</p> 2196e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The hotpixel map may be returned in {@link CaptureResult#STATISTICS_HOT_PIXEL_MAP android.statistics.hotPixelMap}.</p> 21979d454fd6096dad310a476d50b5e7175e38cdc4eaRuben Brunk * 21989d454fd6096dad310a476d50b5e7175e38cdc4eaRuben Brunk * @see CaptureResult#STATISTICS_HOT_PIXEL_MAP 2199eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk * @see CaptureRequest#HOT_PIXEL_MODE 2200eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk */ 2201eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk public static final int HOT_PIXEL_MODE_OFF = 0; 2202eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk 2203eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk /** 2204e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Hot pixel correction is applied, without reducing frame 2205e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * rate relative to sensor raw output.</p> 2206e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The hotpixel map may be returned in {@link CaptureResult#STATISTICS_HOT_PIXEL_MAP android.statistics.hotPixelMap}.</p> 22079d454fd6096dad310a476d50b5e7175e38cdc4eaRuben Brunk * 22089d454fd6096dad310a476d50b5e7175e38cdc4eaRuben Brunk * @see CaptureResult#STATISTICS_HOT_PIXEL_MAP 2209eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk * @see CaptureRequest#HOT_PIXEL_MODE 2210eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk */ 2211eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk public static final int HOT_PIXEL_MODE_FAST = 1; 2212eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk 2213eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk /** 2214e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>High-quality hot pixel correction is applied, at a cost 2215fba08dd9b4ecd8cb49d69d7537dce220996ec641Yin-Chia Yeh * of possibly reduced frame rate relative to sensor raw output.</p> 2216e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The hotpixel map may be returned in {@link CaptureResult#STATISTICS_HOT_PIXEL_MAP android.statistics.hotPixelMap}.</p> 22179d454fd6096dad310a476d50b5e7175e38cdc4eaRuben Brunk * 22189d454fd6096dad310a476d50b5e7175e38cdc4eaRuben Brunk * @see CaptureResult#STATISTICS_HOT_PIXEL_MAP 2219eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk * @see CaptureRequest#HOT_PIXEL_MODE 2220eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk */ 2221eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk public static final int HOT_PIXEL_MODE_HIGH_QUALITY = 2; 2222eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk 2223eba1b3a843278a92611edf153faa41a01d793b25Ruben Brunk // 22245a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE 22255a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 22265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 22275a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 222800849b3a430ce164af2db94eeacfd46131de4be8Ruben Brunk * <p>Optical stabilization is unavailable.</p> 22295a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE 22305a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 22315a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int LENS_OPTICAL_STABILIZATION_MODE_OFF = 0; 22325a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 22335a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 223400849b3a430ce164af2db94eeacfd46131de4be8Ruben Brunk * <p>Optical stabilization is enabled.</p> 22355a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#LENS_OPTICAL_STABILIZATION_MODE 22365a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 22375a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int LENS_OPTICAL_STABILIZATION_MODE_ON = 1; 22385a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 22395a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 22405a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#NOISE_REDUCTION_MODE 22415a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 22425a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 22435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2244e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>No noise reduction is applied.</p> 22455a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#NOISE_REDUCTION_MODE 22465a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 22475a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int NOISE_REDUCTION_MODE_OFF = 0; 22485a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 22495a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2250e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Noise reduction is applied without reducing frame rate relative to sensor 22519c9167efe229f2d7bad0422c371923d5d1776f52Chien-Yu Chen * output. It may be the same as OFF if noise reduction will reduce frame rate 22529c9167efe229f2d7bad0422c371923d5d1776f52Chien-Yu Chen * relative to sensor.</p> 22535a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#NOISE_REDUCTION_MODE 22545a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 22555a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int NOISE_REDUCTION_MODE_FAST = 1; 22565a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 22575a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2258fba08dd9b4ecd8cb49d69d7537dce220996ec641Yin-Chia Yeh * <p>High-quality noise reduction is applied, at the cost of possibly reduced frame 2259fba08dd9b4ecd8cb49d69d7537dce220996ec641Yin-Chia Yeh * rate relative to sensor output.</p> 22605a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#NOISE_REDUCTION_MODE 22615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 22625a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int NOISE_REDUCTION_MODE_HIGH_QUALITY = 2; 22635a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 22640e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He /** 22650e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * <p>MINIMAL noise reduction is applied without reducing frame rate relative to 22660e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * sensor output. </p> 22670e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He * @see CaptureRequest#NOISE_REDUCTION_MODE 22680e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He */ 22690e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He public static final int NOISE_REDUCTION_MODE_MINIMAL = 3; 22700e99c2260d874eaeb62ddeb75c2f29f26818ad99Zhijun He 22710dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala /** 22720dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * <p>Noise reduction is applied at different levels for different output streams, 22730dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * based on resolution. Streams at maximum recording resolution (see {@link android.hardware.camera2.CameraDevice#createCaptureSession }) or below have noise 22740dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * reduction applied, while higher-resolution streams have MINIMAL (if supported) or no 22750dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * noise reduction applied (if MINIMAL is not supported.) The degree of noise reduction 22760dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * for low-resolution streams is tuned so that frame rate is not impacted, and the quality 22770dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * is equal to or better than FAST (since it is only applied to lower-resolution outputs, 22780dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * quality may improve from FAST).</p> 22790dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * <p>This mode is intended to be used by applications operating in a zero-shutter-lag mode 22800dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * with YUV or PRIVATE reprocessing, where the application continuously captures 22810dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * high-resolution intermediate buffers into a circular buffer, from which a final image is 22820dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * produced via reprocessing when a user takes a picture. For such a use case, the 22830dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * high-resolution buffers must not have noise reduction applied to maximize efficiency of 22840dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * preview and to avoid over-applying noise filtering when reprocessing, while 22850dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * low-resolution buffers (used for recording or preview, generally) need noise reduction 22860dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * applied for reasonable preview quality.</p> 22870dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * <p>This mode is guaranteed to be supported by devices that support either the 22880dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * YUV_REPROCESSING or PRIVATE_REPROCESSING capabilities 228972333917a7802d2a1f233418a0e2c15d7e86a357Chien-Yu Chen * ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} lists either of those capabilities) and it will 229072333917a7802d2a1f233418a0e2c15d7e86a357Chien-Yu Chen * be the default mode for CAMERA3_TEMPLATE_ZERO_SHUTTER_LAG template.</p> 22910dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * 22920dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES 22930dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala * @see CaptureRequest#NOISE_REDUCTION_MODE 22940dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala */ 22950dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala public static final int NOISE_REDUCTION_MODE_ZERO_SHUTTER_LAG = 4; 22960dd17509a953774039c0e73beac4b0546504c774Eino-Ville Talvala 22975a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 2298c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin // Enumeration values for CaptureRequest#SENSOR_TEST_PATTERN_MODE 2299c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin // 2300c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin 2301c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin /** 2302e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>No test pattern mode is used, and the camera 2303c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * device returns captures from the image sensor.</p> 2304e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>This is the default if the key is not set.</p> 2305c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * @see CaptureRequest#SENSOR_TEST_PATTERN_MODE 2306c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin */ 2307c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin public static final int SENSOR_TEST_PATTERN_MODE_OFF = 0; 2308c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin 2309c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin /** 2310c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>Each pixel in <code>[R, G_even, G_odd, B]</code> is replaced by its 2311c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * respective color channel provided in 2312c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * {@link CaptureRequest#SENSOR_TEST_PATTERN_DATA android.sensor.testPatternData}.</p> 2313c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>For example:</p> 2314c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <pre><code>android.testPatternData = [0, 0xFFFFFFFF, 0xFFFFFFFF, 0] 2315c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * </code></pre> 2316c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>All green pixels are 100% green. All red/blue pixels are black.</p> 2317c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <pre><code>android.testPatternData = [0xFFFFFFFF, 0, 0xFFFFFFFF, 0] 2318c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * </code></pre> 2319c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>All red pixels are 100% red. Only the odd green pixels 2320c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * are 100% green. All blue pixels are 100% black.</p> 2321c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * 2322c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * @see CaptureRequest#SENSOR_TEST_PATTERN_DATA 2323c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * @see CaptureRequest#SENSOR_TEST_PATTERN_MODE 2324c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin */ 2325c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin public static final int SENSOR_TEST_PATTERN_MODE_SOLID_COLOR = 1; 2326c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin 2327c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin /** 2328c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>All pixel data is replaced with an 8-bar color pattern.</p> 2329c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>The vertical bars (left-to-right) are as follows:</p> 2330c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <ul> 2331c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <li>100% white</li> 2332c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <li>yellow</li> 2333c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <li>cyan</li> 2334c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <li>green</li> 2335c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <li>magenta</li> 2336c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <li>red</li> 2337c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <li>blue</li> 2338c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <li>black</li> 2339c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * </ul> 2340c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>In general the image would look like the following:</p> 2341c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <pre><code>W Y C G M R B K 2342c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * W Y C G M R B K 2343c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * W Y C G M R B K 2344c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * W Y C G M R B K 2345c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * W Y C G M R B K 2346c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * . . . . . . . . 2347c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * . . . . . . . . 2348c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * . . . . . . . . 2349c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * 2350c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * (B = Blue, K = Black) 2351c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * </code></pre> 2352c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>Each bar should take up 1/8 of the sensor pixel array width. 2353c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * When this is not possible, the bar size should be rounded 2354c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * down to the nearest integer and the pattern can repeat 2355c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * on the right side.</p> 2356c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>Each bar's height must always take up the full sensor 2357c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * pixel array height.</p> 2358c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>Each pixel in this test pattern must be set to either 2359c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * 0% intensity or 100% intensity.</p> 2360c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * @see CaptureRequest#SENSOR_TEST_PATTERN_MODE 2361c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin */ 2362c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin public static final int SENSOR_TEST_PATTERN_MODE_COLOR_BARS = 2; 2363c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin 2364c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin /** 2365c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>The test pattern is similar to COLOR_BARS, except that 2366c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * each bar should start at its specified color at the top, 2367c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * and fade to gray at the bottom.</p> 2368c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>Furthermore each bar is further subdivided into a left and 2369c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * right half. The left half should have a smooth gradient, 2370c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * and the right half should have a quantized gradient.</p> 2371c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>In particular, the right half's should consist of blocks of the 2372c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * same color for 1/16th active sensor pixel array width.</p> 2373c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>The least significant bits in the quantized gradient should 2374c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * be copied from the most significant bits of the smooth gradient.</p> 2375c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>The height of each bar should always be a multiple of 128. 2376c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * When this is not the case, the pattern should repeat at the bottom 2377c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * of the image.</p> 2378c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * @see CaptureRequest#SENSOR_TEST_PATTERN_MODE 2379c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin */ 2380c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin public static final int SENSOR_TEST_PATTERN_MODE_COLOR_BARS_FADE_TO_GRAY = 3; 2381c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin 2382c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin /** 2383c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>All pixel data is replaced by a pseudo-random sequence 2384c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * generated from a PN9 512-bit sequence (typically implemented 2385c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * in hardware with a linear feedback shift register).</p> 2386c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>The generator should be reset at the beginning of each frame, 2387c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * and thus each subsequent raw frame with this test pattern should 2388c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * be exactly the same as the last.</p> 2389c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * @see CaptureRequest#SENSOR_TEST_PATTERN_MODE 2390c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin */ 2391c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin public static final int SENSOR_TEST_PATTERN_MODE_PN9 = 4; 2392c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin 2393c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin /** 2394c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>The first custom test pattern. All custom patterns that are 2395c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * available only on this camera device are at least this numeric 2396c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * value.</p> 2397c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * <p>All of the custom test patterns will be static 2398c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * (that is the raw image must not vary from frame to frame).</p> 2399c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin * @see CaptureRequest#SENSOR_TEST_PATTERN_MODE 2400c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin */ 2401c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin public static final int SENSOR_TEST_PATTERN_MODE_CUSTOM1 = 256; 2402c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin 2403c127f05292919ef1646b08b16dca1fe7c324afd4Igor Murashkin // 2404ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He // Enumeration values for CaptureRequest#SHADING_MODE 2405ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He // 2406ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He 2407ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He /** 2408e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>No lens shading correction is applied.</p> 2409ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He * @see CaptureRequest#SHADING_MODE 2410ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He */ 2411ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He public static final int SHADING_MODE_OFF = 0; 2412ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He 2413ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He /** 2414e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Apply lens shading corrections, without slowing 2415e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * frame rate relative to sensor raw output</p> 2416ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He * @see CaptureRequest#SHADING_MODE 2417ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He */ 2418ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He public static final int SHADING_MODE_FAST = 1; 2419ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He 2420ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He /** 2421e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Apply high-quality lens shading correction, at the 2422fba08dd9b4ecd8cb49d69d7537dce220996ec641Yin-Chia Yeh * cost of possibly reduced frame rate.</p> 2423ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He * @see CaptureRequest#SHADING_MODE 2424ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He */ 2425ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He public static final int SHADING_MODE_HIGH_QUALITY = 2; 2426ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He 2427ba93fe6468ef14865ec341bc14fc4a1dc7e88704Zhijun He // 24285a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#STATISTICS_FACE_DETECT_MODE 24295a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 24305a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 24315a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2432e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Do not include face detection statistics in capture 2433e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * results.</p> 24345a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#STATISTICS_FACE_DETECT_MODE 24355a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 24365a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int STATISTICS_FACE_DETECT_MODE_OFF = 0; 24375a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 24385a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2439e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Return face rectangle and confidence values only.</p> 24405a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#STATISTICS_FACE_DETECT_MODE 24415a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 24425a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int STATISTICS_FACE_DETECT_MODE_SIMPLE = 1; 24435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 24445a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2445e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Return all face 2446e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * metadata.</p> 2447fd3e2892f29ded5a25a0a064275b282ce93ed258Eino-Ville Talvala * <p>In this mode, face rectangles, scores, landmarks, and face IDs are all valid.</p> 24485a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#STATISTICS_FACE_DETECT_MODE 24495a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 24505a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int STATISTICS_FACE_DETECT_MODE_FULL = 2; 24515a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 24525a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 2453d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala // Enumeration values for CaptureRequest#STATISTICS_LENS_SHADING_MAP_MODE 2454d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala // 2455d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala 2456d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala /** 2457e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Do not include a lens shading map in the capture result.</p> 2458d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala * @see CaptureRequest#STATISTICS_LENS_SHADING_MAP_MODE 2459d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala */ 2460d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala public static final int STATISTICS_LENS_SHADING_MAP_MODE_OFF = 0; 2461d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala 2462d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala /** 2463e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Include a lens shading map in the capture result.</p> 2464d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala * @see CaptureRequest#STATISTICS_LENS_SHADING_MAP_MODE 2465d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala */ 2466d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala public static final int STATISTICS_LENS_SHADING_MAP_MODE_ON = 1; 2467d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala 2468d96748b02a468e484f864f4e3e4b7819f7dcdbd0Eino-Ville Talvala // 24695a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureRequest#TONEMAP_MODE 24705a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 24715a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 24725a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2473ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>Use the tone mapping curve specified in 24748490ace76fd350e53de9554c11fca715c5a37aafYin-Chia Yeh * the {@link CaptureRequest#TONEMAP_CURVE android.tonemap.curve}* entries.</p> 2475e0060930cbff1af0486466e03605e6e8ee525302Igor Murashkin * <p>All color enhancement and tonemapping must be disabled, except 2476e0060930cbff1af0486466e03605e6e8ee525302Igor Murashkin * for applying the tonemapping curve specified by 24778490ace76fd350e53de9554c11fca715c5a37aafYin-Chia Yeh * {@link CaptureRequest#TONEMAP_CURVE android.tonemap.curve}.</p> 2478e0060930cbff1af0486466e03605e6e8ee525302Igor Murashkin * <p>Must not slow down frame rate relative to raw 2479e0060930cbff1af0486466e03605e6e8ee525302Igor Murashkin * sensor output.</p> 2480e0060930cbff1af0486466e03605e6e8ee525302Igor Murashkin * 24818490ace76fd350e53de9554c11fca715c5a37aafYin-Chia Yeh * @see CaptureRequest#TONEMAP_CURVE 24825a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#TONEMAP_MODE 24835a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 24845a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int TONEMAP_MODE_CONTRAST_CURVE = 0; 24855a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 24865a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2487e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Advanced gamma mapping and color enhancement may be applied, without 2488e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * reducing frame rate compared to raw sensor output.</p> 24895a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#TONEMAP_MODE 24905a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 24915a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int TONEMAP_MODE_FAST = 1; 24925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 24935a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2494e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>High-quality gamma mapping and color enhancement will be applied, at 2495fba08dd9b4ecd8cb49d69d7537dce220996ec641Yin-Chia Yeh * the cost of possibly reduced frame rate compared to raw sensor output.</p> 24965a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureRequest#TONEMAP_MODE 24975a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 24985a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int TONEMAP_MODE_HIGH_QUALITY = 2; 24995a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 2500956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh /** 250103d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * <p>Use the gamma value specified in {@link CaptureRequest#TONEMAP_GAMMA android.tonemap.gamma} to peform 2502956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * tonemapping.</p> 2503956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <p>All color enhancement and tonemapping must be disabled, except 250403d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * for applying the tonemapping curve specified by {@link CaptureRequest#TONEMAP_GAMMA android.tonemap.gamma}.</p> 2505956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <p>Must not slow down frame rate relative to raw sensor output.</p> 250603d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * 250703d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * @see CaptureRequest#TONEMAP_GAMMA 2508956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * @see CaptureRequest#TONEMAP_MODE 2509956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh */ 2510956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh public static final int TONEMAP_MODE_GAMMA_VALUE = 3; 2511956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh 2512956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh /** 2513956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <p>Use the preset tonemapping curve specified in 251403d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * {@link CaptureRequest#TONEMAP_PRESET_CURVE android.tonemap.presetCurve} to peform tonemapping.</p> 2515956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <p>All color enhancement and tonemapping must be disabled, except 2516956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * for applying the tonemapping curve specified by 251703d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * {@link CaptureRequest#TONEMAP_PRESET_CURVE android.tonemap.presetCurve}.</p> 2518956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <p>Must not slow down frame rate relative to raw sensor output.</p> 251903d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * 252003d50da3b15d0ea4675650d2510e2abc6c139fbfYin-Chia Yeh * @see CaptureRequest#TONEMAP_PRESET_CURVE 2521956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * @see CaptureRequest#TONEMAP_MODE 2522956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh */ 2523956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh public static final int TONEMAP_MODE_PRESET_CURVE = 4; 2524956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh 2525956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh // 2526956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh // Enumeration values for CaptureRequest#TONEMAP_PRESET_CURVE 2527956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh // 2528956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh 2529956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh /** 2530956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <p>Tonemapping curve is defined by sRGB</p> 2531956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * @see CaptureRequest#TONEMAP_PRESET_CURVE 2532956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh */ 2533956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh public static final int TONEMAP_PRESET_CURVE_SRGB = 0; 2534956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh 2535956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh /** 2536956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * <p>Tonemapping curve is defined by ITU-R BT.709</p> 2537956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh * @see CaptureRequest#TONEMAP_PRESET_CURVE 2538956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh */ 2539956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh public static final int TONEMAP_PRESET_CURVE_REC709 = 1; 2540956c52b5a09fa6b193b162bdb3aee629323cde2bYin-Chia Yeh 25415a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 25425a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureResult#CONTROL_AE_STATE 25435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 25445a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 25455a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2546e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>AE is off or recently reset.</p> 2547e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>When a camera device is opened, it starts in 254860b19dc2df1afef1caf151b9df4cc60af3c395e8Zhijun He * this state. This is a transient state, the camera device may skip reporting 254960b19dc2df1afef1caf151b9df4cc60af3c395e8Zhijun He * this state in capture result.</p> 25505a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AE_STATE 25515a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 25525a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_STATE_INACTIVE = 0; 25535a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 25545a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2555ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>AE doesn't yet have a good set of control values 2556e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * for the current scene.</p> 2557e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>This is a transient state, the camera device may skip 255860b19dc2df1afef1caf151b9df4cc60af3c395e8Zhijun He * reporting this state in capture result.</p> 25595a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AE_STATE 25605a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 25615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_STATE_SEARCHING = 1; 25625a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 25635a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2564ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>AE has a good set of control values for the 2565228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * current scene.</p> 25665a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AE_STATE 25675a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 25685a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_STATE_CONVERGED = 2; 25695a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 25705a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2571228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * <p>AE has been locked.</p> 25725a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AE_STATE 25735a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 25745a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_STATE_LOCKED = 3; 25755a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 25765a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2577ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>AE has a good set of control values, but flash 25785a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * needs to be fired for good quality still 2579228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * capture.</p> 25805a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AE_STATE 25815a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 25825a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_STATE_FLASH_REQUIRED = 4; 25835a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 25845a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2585ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>AE has been asked to do a precapture sequence 2586e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * and is currently executing it.</p> 2587e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Precapture can be triggered through setting 2588fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He * {@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} to START. Currently 2589fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He * active and completed (if it causes camera device internal AE lock) precapture 2590fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He * metering sequence can be canceled through setting 2591fa95b0420ce819e5f559cd97f9edb086e9eebb71Zhijun He * {@link CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER android.control.aePrecaptureTrigger} to CANCEL.</p> 2592e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Once PRECAPTURE completes, AE will transition to CONVERGED 2593e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * or FLASH_REQUIRED as appropriate. This is a transient 2594e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * state, the camera device may skip reporting this state in 2595e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * capture result.</p> 2596228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * 2597228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * @see CaptureRequest#CONTROL_AE_PRECAPTURE_TRIGGER 25985a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AE_STATE 25995a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 26005a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AE_STATE_PRECAPTURE = 5; 26015a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 26025a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 26035a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureResult#CONTROL_AF_STATE 26045a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 26055a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 26065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2607e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>AF is off or has not yet tried to scan/been asked 2608e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * to scan.</p> 2609e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>When a camera device is opened, it starts in this 2610e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * state. This is a transient state, the camera device may 2611e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * skip reporting this state in capture 2612e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * result.</p> 26135a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AF_STATE 26145a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 26155a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_STATE_INACTIVE = 0; 26165a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 26175a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2618e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>AF is currently performing an AF scan initiated the 2619e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * camera device in a continuous autofocus mode.</p> 2620e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Only used by CONTINUOUS_* AF modes. This is a transient 2621e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * state, the camera device may skip reporting this state in 2622e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * capture result.</p> 26235a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AF_STATE 26245a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 26255a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_STATE_PASSIVE_SCAN = 1; 26265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 26275a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2628e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>AF currently believes it is in focus, but may 2629e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * restart scanning at any time.</p> 2630e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Only used by CONTINUOUS_* AF modes. This is a transient 2631e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * state, the camera device may skip reporting this state in 2632e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * capture result.</p> 26335a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AF_STATE 26345a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 26355a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_STATE_PASSIVE_FOCUSED = 2; 26365a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 26375a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2638e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>AF is performing an AF scan because it was 2639e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * triggered by AF trigger.</p> 2640e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Only used by AUTO or MACRO AF modes. This is a transient 2641e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * state, the camera device may skip reporting this state in 2642e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * capture result.</p> 26435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AF_STATE 26445a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 26455a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_STATE_ACTIVE_SCAN = 3; 26465a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 26475a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2648e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>AF believes it is focused correctly and has locked 2649e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * focus.</p> 2650e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>This state is reached only after an explicit START AF trigger has been 2651e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * sent ({@link CaptureRequest#CONTROL_AF_TRIGGER android.control.afTrigger}), when good focus has been obtained.</p> 2652e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The lens will remain stationary until the AF mode ({@link CaptureRequest#CONTROL_AF_MODE android.control.afMode}) is changed or 2653e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * a new AF trigger is sent to the camera device ({@link CaptureRequest#CONTROL_AF_TRIGGER android.control.afTrigger}).</p> 2654e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * 2655e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_MODE 2656e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_TRIGGER 26575a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AF_STATE 26585a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 26595a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_STATE_FOCUSED_LOCKED = 4; 26605a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 26615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2662e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>AF has failed to focus successfully and has locked 2663e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * focus.</p> 2664e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>This state is reached only after an explicit START AF trigger has been 2665e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * sent ({@link CaptureRequest#CONTROL_AF_TRIGGER android.control.afTrigger}), when good focus cannot be obtained.</p> 2666e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The lens will remain stationary until the AF mode ({@link CaptureRequest#CONTROL_AF_MODE android.control.afMode}) is changed or 2667e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * a new AF trigger is sent to the camera device ({@link CaptureRequest#CONTROL_AF_TRIGGER android.control.afTrigger}).</p> 2668e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * 2669e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_MODE 2670e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * @see CaptureRequest#CONTROL_AF_TRIGGER 26715a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AF_STATE 26725a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 26735a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AF_STATE_NOT_FOCUSED_LOCKED = 5; 26745a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 26759f880f79a3f179443c8b37c3434717432b2ec8d9Eino-Ville Talvala /** 2676e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>AF finished a passive scan without finding focus, 2677e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * and may restart scanning at any time.</p> 2678e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Only used by CONTINUOUS_* AF modes. This is a transient state, the camera 267960b19dc2df1afef1caf151b9df4cc60af3c395e8Zhijun He * device may skip reporting this state in capture result.</p> 26804b8cd6b44cf800cf5dd88e5afbcff4968398779dIgor Murashkin * <p>LEGACY camera devices do not support this state. When a passive 26814b8cd6b44cf800cf5dd88e5afbcff4968398779dIgor Murashkin * scan has finished, it will always go to PASSIVE_FOCUSED.</p> 26829f880f79a3f179443c8b37c3434717432b2ec8d9Eino-Ville Talvala * @see CaptureResult#CONTROL_AF_STATE 26839f880f79a3f179443c8b37c3434717432b2ec8d9Eino-Ville Talvala */ 26849f880f79a3f179443c8b37c3434717432b2ec8d9Eino-Ville Talvala public static final int CONTROL_AF_STATE_PASSIVE_UNFOCUSED = 6; 26859f880f79a3f179443c8b37c3434717432b2ec8d9Eino-Ville Talvala 26865a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 26875a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureResult#CONTROL_AWB_STATE 26885a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 26895a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 26905a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2691e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>AWB is not in auto mode, or has not yet started metering.</p> 2692e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>When a camera device is opened, it starts in this 2693e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * state. This is a transient state, the camera device may 2694e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * skip reporting this state in capture 2695e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * result.</p> 26965a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AWB_STATE 26975a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 26985a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_STATE_INACTIVE = 0; 26995a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27005a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2701ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>AWB doesn't yet have a good set of control 2702e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * values for the current scene.</p> 2703e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>This is a transient state, the camera device 270460b19dc2df1afef1caf151b9df4cc60af3c395e8Zhijun He * may skip reporting this state in capture result.</p> 27055a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AWB_STATE 27065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 27075a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_STATE_SEARCHING = 1; 27085a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27095a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2710ace5bf04126f7dd49d75fca9218031f0db02e5ddIgor Murashkin * <p>AWB has a good set of control values for the 2711228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * current scene.</p> 27125a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AWB_STATE 27135a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 27145a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_STATE_CONVERGED = 2; 27155a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27165a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2717228f4f92e70d9326d473e02bcdcc8faf9e706a4dZhijun He * <p>AWB has been locked.</p> 27185a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#CONTROL_AWB_STATE 27195a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 27205a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int CONTROL_AWB_STATE_LOCKED = 3; 27215a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27225a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 27235a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureResult#FLASH_STATE 27245a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 27255a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27265a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 27278dda7273dbb4ff6eeffe7d4c3831e9b31b8e5ac1Zhijun He * <p>No flash on camera.</p> 27285a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#FLASH_STATE 27295a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 27305a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int FLASH_STATE_UNAVAILABLE = 0; 27315a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27325a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 27338dda7273dbb4ff6eeffe7d4c3831e9b31b8e5ac1Zhijun He * <p>Flash is charging and cannot be fired.</p> 27345a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#FLASH_STATE 27355a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 27365a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int FLASH_STATE_CHARGING = 1; 27375a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27385a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 27398dda7273dbb4ff6eeffe7d4c3831e9b31b8e5ac1Zhijun He * <p>Flash is ready to fire.</p> 27405a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#FLASH_STATE 27415a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 27425a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int FLASH_STATE_READY = 2; 27435a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27445a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 27458dda7273dbb4ff6eeffe7d4c3831e9b31b8e5ac1Zhijun He * <p>Flash fired for this capture.</p> 27465a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#FLASH_STATE 27475a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 27485a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int FLASH_STATE_FIRED = 3; 27495a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27508dda7273dbb4ff6eeffe7d4c3831e9b31b8e5ac1Zhijun He /** 2751e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Flash partially illuminated this frame.</p> 2752e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>This is usually due to the next or previous frame having 2753e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * the flash fire, and the flash spilling into this capture 27548dda7273dbb4ff6eeffe7d4c3831e9b31b8e5ac1Zhijun He * due to hardware limitations.</p> 27558dda7273dbb4ff6eeffe7d4c3831e9b31b8e5ac1Zhijun He * @see CaptureResult#FLASH_STATE 27568dda7273dbb4ff6eeffe7d4c3831e9b31b8e5ac1Zhijun He */ 27578dda7273dbb4ff6eeffe7d4c3831e9b31b8e5ac1Zhijun He public static final int FLASH_STATE_PARTIAL = 4; 27588dda7273dbb4ff6eeffe7d4c3831e9b31b8e5ac1Zhijun He 27595a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 27605a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureResult#LENS_STATE 27615a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 27625a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27635a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2764d8fd67931e17c66e530de5482b63863e6c4301aaEino-Ville Talvala * <p>The lens parameters ({@link CaptureRequest#LENS_FOCAL_LENGTH android.lens.focalLength}, {@link CaptureRequest#LENS_FOCUS_DISTANCE android.lens.focusDistance}, 2765d8fd67931e17c66e530de5482b63863e6c4301aaEino-Ville Talvala * {@link CaptureRequest#LENS_FILTER_DENSITY android.lens.filterDensity} and {@link CaptureRequest#LENS_APERTURE android.lens.aperture}) are not changing.</p> 2766ca1b73a5f4e8ae4a7cef2cb2127024d0ddb9e0e0Zhijun He * 2767ca1b73a5f4e8ae4a7cef2cb2127024d0ddb9e0e0Zhijun He * @see CaptureRequest#LENS_APERTURE 2768d8fd67931e17c66e530de5482b63863e6c4301aaEino-Ville Talvala * @see CaptureRequest#LENS_FILTER_DENSITY 2769ca1b73a5f4e8ae4a7cef2cb2127024d0ddb9e0e0Zhijun He * @see CaptureRequest#LENS_FOCAL_LENGTH 2770d8fd67931e17c66e530de5482b63863e6c4301aaEino-Ville Talvala * @see CaptureRequest#LENS_FOCUS_DISTANCE 27715a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#LENS_STATE 27725a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 27735a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int LENS_STATE_STATIONARY = 0; 27745a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27759ea4ae67fb10a10c464db8372b58bfe574cac03dIgor Murashkin /** 2776e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>One or several of the lens parameters 2777e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * ({@link CaptureRequest#LENS_FOCAL_LENGTH android.lens.focalLength}, {@link CaptureRequest#LENS_FOCUS_DISTANCE android.lens.focusDistance}, 2778e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * {@link CaptureRequest#LENS_FILTER_DENSITY android.lens.filterDensity} or {@link CaptureRequest#LENS_APERTURE android.lens.aperture}) is 2779e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * currently changing.</p> 2780ca1b73a5f4e8ae4a7cef2cb2127024d0ddb9e0e0Zhijun He * 2781ca1b73a5f4e8ae4a7cef2cb2127024d0ddb9e0e0Zhijun He * @see CaptureRequest#LENS_APERTURE 2782d8fd67931e17c66e530de5482b63863e6c4301aaEino-Ville Talvala * @see CaptureRequest#LENS_FILTER_DENSITY 2783ca1b73a5f4e8ae4a7cef2cb2127024d0ddb9e0e0Zhijun He * @see CaptureRequest#LENS_FOCAL_LENGTH 2784d8fd67931e17c66e530de5482b63863e6c4301aaEino-Ville Talvala * @see CaptureRequest#LENS_FOCUS_DISTANCE 27859ea4ae67fb10a10c464db8372b58bfe574cac03dIgor Murashkin * @see CaptureResult#LENS_STATE 27869ea4ae67fb10a10c464db8372b58bfe574cac03dIgor Murashkin */ 27879ea4ae67fb10a10c464db8372b58bfe574cac03dIgor Murashkin public static final int LENS_STATE_MOVING = 1; 27889ea4ae67fb10a10c464db8372b58bfe574cac03dIgor Murashkin 27895a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 27905a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // Enumeration values for CaptureResult#STATISTICS_SCENE_FLICKER 27915a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala // 27925a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 27935a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2794e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device does not detect any flickering illumination 2795e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * in the current scene.</p> 27965a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#STATISTICS_SCENE_FLICKER 27975a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 27985a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int STATISTICS_SCENE_FLICKER_NONE = 0; 27995a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 28005a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2801e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device detects illumination flickering at 50Hz 2802e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * in the current scene.</p> 28035a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#STATISTICS_SCENE_FLICKER 28045a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 28055a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int STATISTICS_SCENE_FLICKER_50HZ = 1; 28065a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 28075a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /** 2808e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The camera device detects illumination flickering at 60Hz 2809e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * in the current scene.</p> 28105a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * @see CaptureResult#STATISTICS_SCENE_FLICKER 28115a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala */ 28125a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala public static final int STATISTICS_SCENE_FLICKER_60HZ = 2; 28135a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 28143865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin // 28153865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin // Enumeration values for CaptureResult#SYNC_FRAME_NUMBER 28163865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin // 28173865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin 28183865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin /** 2819e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The current result is not yet fully synchronized to any request.</p> 2820e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>Synchronization is in progress, and reading metadata from this 28213865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * result may include a mix of data that have taken effect since the 28223865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * last synchronization time.</p> 28233865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * <p>In some future result, within {@link CameraCharacteristics#SYNC_MAX_LATENCY android.sync.maxLatency} frames, 28243865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * this value will update to the actual frame number frame number 28253865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * the result is guaranteed to be synchronized to (as long as the 28263865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * request settings remain constant).</p> 28273865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * 28283865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * @see CameraCharacteristics#SYNC_MAX_LATENCY 28293865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * @see CaptureResult#SYNC_FRAME_NUMBER 28303865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * @hide 28313865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin */ 28323865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin public static final int SYNC_FRAME_NUMBER_CONVERGING = -1; 28333865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin 28343865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin /** 2835e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The current result's synchronization status is unknown.</p> 2836e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * <p>The result may have already converged, or it may be in 2837e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * progress. Reading from this result may include some mix 2838e600d6ad60373821472e6338792109fa3103f7e2Eino-Ville Talvala * of settings from past requests.</p> 28393865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * <p>After a settings change, the new settings will eventually all 28403865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * take effect for the output buffers and results. However, this 28413865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * value will not change when that happens. Altering settings 28423865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * rapidly may provide outcomes using mixes of settings from recent 28433865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * requests.</p> 28443865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * <p>This value is intended primarily for backwards compatibility with 28453865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * the older camera implementations (for android.hardware.Camera).</p> 28463865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * @see CaptureResult#SYNC_FRAME_NUMBER 28473865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin * @hide 28483865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin */ 28493865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin public static final int SYNC_FRAME_NUMBER_UNKNOWN = -2; 28503865a84255a4e65a5d9790083a1e519b05f40d50Igor Murashkin 28515a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala /*~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~ 28525a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala * End generated code 28535a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala *~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~O@*/ 28545a32b20ccc34fd7d4f048de05c427a7a96786531Eino-Ville Talvala 2855b519cc52ecba8f44da31173c9fc90a7b66d52b79Igor Murashkin} 2856