1 /* 2 * Copyright (C) 2014 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.camera.one; 18 19 import android.graphics.ImageFormat; 20 import android.graphics.Rect; 21 import android.hardware.camera2.CameraCharacteristics; 22 23 import com.android.camera.ui.motion.LinearScale; 24 import com.android.camera.util.Size; 25 26 import java.util.List; 27 28 /** 29 * The properties describing a OneCamera device. These properties are fixed for 30 * a given OneCamera device. 31 */ 32 public interface OneCameraCharacteristics { 33 public enum SupportedHardwareLevel { 34 FULL, LIMITED, LEGACY 35 } 36 37 public enum FaceDetectMode { 38 FULL, SIMPLE, NONE 39 } 40 41 /** 42 * Gets the supported picture sizes for the given image format. 43 * 44 * @param imageFormat The specific image format listed on 45 * {@link ImageFormat}. 46 */ getSupportedPictureSizes(int imageFormat)47 public List<Size> getSupportedPictureSizes(int imageFormat); 48 49 /** 50 * Gets the supported preview sizes. 51 */ getSupportedPreviewSizes()52 public List<Size> getSupportedPreviewSizes(); 53 54 /** 55 * @See {@link CameraCharacteristics#SENSOR_ORIENTATION} 56 */ getSensorOrientation()57 public int getSensorOrientation(); 58 59 /** 60 * @Return The direction of the camera 61 */ getCameraDirection()62 public OneCamera.Facing getCameraDirection(); 63 64 /** 65 * @See {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE} 66 */ getSensorInfoActiveArraySize()67 public Rect getSensorInfoActiveArraySize(); 68 69 /** 70 * @See {@link CameraCharacteristics#SCALER_AVAILABLE_MAX_DIGITAL_ZOOM} 71 */ getAvailableMaxDigitalZoom()72 public float getAvailableMaxDigitalZoom(); 73 74 /** 75 * @return If flash is supported for this camera. 76 */ isFlashSupported()77 public boolean isFlashSupported(); 78 79 /** 80 * @return If Scene-mode HDR is supported. 81 */ isHdrSceneSupported()82 public boolean isHdrSceneSupported(); 83 84 /** 85 * @return The supported hardware level. 86 */ getSupportedHardwareLevel()87 public SupportedHardwareLevel getSupportedHardwareLevel(); 88 89 /** 90 * @return The supported face detection modes. 91 */ getSupportedFaceDetectModes()92 public List<FaceDetectMode> getSupportedFaceDetectModes(); 93 94 /** 95 * A converter from the physical focus range of the camera to a ratio. 96 */ getLensFocusRange()97 public LinearScale getLensFocusRange(); 98 99 /** 100 * @return A List of available focal lengths for this camera. 101 */ getAvailableFocalLengths()102 public List<Float> getAvailableFocalLengths(); 103 104 /** 105 * Whether exposure compensation is supported for this camera. 106 * 107 * @return true if exposure compensation is supported for this camera. 108 */ isExposureCompensationSupported()109 public boolean isExposureCompensationSupported(); 110 111 /** 112 * @return The min exposure compensation index. The EV is the compensation 113 * index multiplied by the step value. If {@link 114 * #isExposureCompensationSupported()} is false, return -1. 115 */ getMinExposureCompensation()116 public int getMinExposureCompensation(); 117 118 /** 119 * @return The max exposure compensation index. The EV is the compensation 120 * index multiplied by the step value. If {@link 121 * #isExposureCompensationSupported()} is false, return -1. 122 */ getMaxExposureCompensation()123 public int getMaxExposureCompensation(); 124 125 /** 126 * @return The exposure compensation step. The EV is the compensation index 127 * multiplied by the step value. If {@link 128 * #isExposureCompensationSupported()} is false, return -1. 129 */ getExposureCompensationStep()130 public float getExposureCompensationStep(); 131 132 /** 133 * @return true if this camera supports custom AutoFocus regions. 134 */ isAutoFocusSupported()135 public boolean isAutoFocusSupported(); 136 137 /** 138 * @return true if this camera supports custom AutoExposure regions. 139 */ isAutoExposureSupported()140 public boolean isAutoExposureSupported(); 141 } 142