/* * Copyright (C) 2014 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 com.android.camera.one.v2.autofocus; import android.hardware.camera2.CaptureRequest; import android.hardware.camera2.CaptureResult; import com.android.camera.async.Updatable; import com.android.camera.one.v2.camera2proxy.CaptureResultProxy; import com.google.common.base.Objects; import com.google.common.collect.ImmutableSet; import com.google.common.util.concurrent.SettableFuture; import java.util.Set; import java.util.concurrent.ExecutionException; import java.util.concurrent.TimeUnit; import java.util.concurrent.TimeoutException; import javax.annotation.ParametersAreNonnullByDefault; /** * Listens for image metadata and returns the result of an AF scan caused by an * AF_TRIGGER_START. *

* This maintains/implements the subset of the finite state machine of * {@link android.hardware.camera2.CaptureResult#CONTROL_AF_STATE} which relates * to AF_TRIGGER. *

* That is, it invokes the given callback when a scan is complete, according to * the following sequence: * *

 * .* CONTROL_AF_TRIGGER_START .* (STATE_INACTIVE|STATE_FOCUSED_LOCKED|STATE_NOT_FOCUSED_LOCKED)
 * 
*

* See the android documentation for {@link CaptureResult#CONTROL_AF_STATE} for * further documentation on the state machine this class implements. */ @ParametersAreNonnullByDefault public final class AFTriggerResult implements Updatable { private static final Set TRIGGER_DONE_STATES = ImmutableSet.of( CaptureResult.CONTROL_AF_STATE_INACTIVE, CaptureResult.CONTROL_AF_STATE_FOCUSED_LOCKED, CaptureResult.CONTROL_AF_STATE_NOT_FOCUSED_LOCKED); private final TriggerStateMachine mStateMachine; private final SettableFuture mFutureResult; public AFTriggerResult() { mFutureResult = SettableFuture.create(); mStateMachine = new TriggerStateMachine( CaptureRequest.CONTROL_AF_TRIGGER_START, TRIGGER_DONE_STATES); } @Override public void update(CaptureResultProxy result) { Integer afState = result.get(CaptureResult.CONTROL_AF_STATE); boolean done = mStateMachine.update( result.getFrameNumber(), result.getRequest().get(CaptureRequest.CONTROL_AF_TRIGGER), afState); if (done) { boolean inFocus = Objects.equal(afState, CaptureResult.CONTROL_AF_STATE_PASSIVE_FOCUSED) || Objects.equal(afState, CaptureResult.CONTROL_AF_STATE_FOCUSED_LOCKED); mFutureResult.set(inFocus); } } /** * Blocks until the AF scan is complete. * * @return Whether the scene is in-focus or not, based on the camera driver. * @throws InterruptedException */ public boolean get() throws InterruptedException { try { return mFutureResult.get(); } catch (ExecutionException impossible) { throw new RuntimeException(impossible); } } /** * Blocks until the AF scan is complete. * * @return Whether the scene is in-focus or not, based on the camera driver. * @throws InterruptedException */ public boolean get(long timeout, TimeUnit timeUnit) throws InterruptedException, TimeoutException { try { return mFutureResult.get(timeout, timeUnit); } catch (ExecutionException impossible) { throw new RuntimeException(impossible); } } }