android-34/androidx/camera/extensions/impl/CameraCharacteristicAvailability.java

/*
 * Copyright 2020 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package androidx.camera.extensions.impl;

import android.hardware.camera2.CameraCharacteristics;
import android.util.Log;
import android.util.Range;

import java.util.Arrays;

/**
 * A utility class to check the availabilities of camera characteristics.
 */
final class CameraCharacteristicAvailability {
    private static final String TAG = "CharacteristicAbility";

    private CameraCharacteristicAvailability() {
    }

    /**
     * Check if the given device supports flash.
     *
     * @param cameraCharacteristics the camera characteristics.
     * @return {@code true} if the device supports flash
     * {@code false} otherwise.
     */
    static boolean hasFlashUnit(CameraCharacteristics cameraCharacteristics) {
        Boolean flashInfo = cameraCharacteristics.get(CameraCharacteristics.FLASH_INFO_AVAILABLE);

        return (flashInfo != null) ? flashInfo : false;
    }

    /**
     * Check if the given device supports zoom ratio.
     *
     * @param cameraCharacteristics the camera characteristics.
     * @return {@code true} if the device supports zoom ratio
     * {@code false} otherwise.
     */
    static boolean supportsZoomRatio(CameraCharacteristics cameraCharacteristics) {
        Range<Float> zoomRatioRange = cameraCharacteristics.get(
                CameraCharacteristics.CONTROL_ZOOM_RATIO_RANGE);

        return (zoomRatioRange != null) && (zoomRatioRange.getUpper() > 1.f);
    }

    /**
     * Check if the given device is fixed focus or not.
     *
     * @param cameraCharacteristics the camera characteristics.
     * @return {@code true} if the device is not fixed focus
     * {@code false} otherwise.
     */
    static boolean hasFocuser(CameraCharacteristics cameraCharacteristics) {
        Float minFocusDistance = cameraCharacteristics.get(
                CameraCharacteristics.LENS_INFO_MINIMUM_FOCUS_DISTANCE);
        if (minFocusDistance == null) {
            Log.d(TAG, "No LENS_INFO_MINIMUM_FOCUS_DISTANCE info");
            return false;
        }

        if (minFocusDistance > 0.f) {
            return true;
        }
        return false;
    }

    /**
     * Check if the given white balance mode id is available in the camera characteristics.
     *
     * @param cameraCharacteristics the camera characteristics.
     * @param mode white balance mode id.
     * @return {@code true} if the given white balance mode id is available in the camera
     *                      characteristics.
     * {@code false} otherwise.
     */
    static boolean isWBModeAvailable(CameraCharacteristics cameraCharacteristics,
            int mode) {
        int[] availableModes = cameraCharacteristics.get(
                CameraCharacteristics.CONTROL_AWB_AVAILABLE_MODES);
        if (availableModes == null) {
            Log.d(TAG, "No CONTROL_AWB_AVAILABLE_MODES info");
            return false;
        }

        for (int availableMode : availableModes) {
            if (availableMode == mode) {
                return true;
            }
        }
        Log.d(TAG, "wb mode: " + mode + " is not in available list "
                + Arrays.toString(availableModes));
        return false;
    }

    /**
     * Check if the given effect id is available in the camera characteristics.
     *
     * @param cameraCharacteristics the camera characteristics.
     * @param effect the effect id.
     * @return {@code true} if the given effect id is available in the camera characteristics.
     * {@code false} otherwise.
     */
    static boolean isEffectAvailable(CameraCharacteristics cameraCharacteristics,
            int effect) {
        int[] availableEffects = cameraCharacteristics.get(
                CameraCharacteristics.CONTROL_AVAILABLE_EFFECTS);
        if (availableEffects == null) {
            Log.d(TAG, "No CONTROL_AVAILABLE_EFFECTS info");
            return false;
        }

        for (int availableEffect : availableEffects) {
            if (availableEffect == effect) {
                return true;
            }
        }
        Log.d(TAG, "effect: " + effect + " is not in available list "
                + Arrays.toString(availableEffects));
        return false;
    }
}