Camera.Parameters.GetFocusDistances(Single[]) 方法

定义

命名空间:

Android.Hardware

程序集:

Mono.Android.dll

注意

deprecated

获取从相机到对象似乎处于焦点位置的距离。

[Android.Runtime.Register("getFocusDistances", "([F)V", "GetGetFocusDistances_arrayFHandler")]
[System.Obsolete("deprecated")]
public virtual void GetFocusDistances (float[]? output);

[<Android.Runtime.Register("getFocusDistances", "([F)V", "GetGetFocusDistances_arrayFHandler")>]
[<System.Obsolete("deprecated")>]
abstract member GetFocusDistances : single[] -> unit
override this.GetFocusDistances : single[] -> unit

参数

output

Single[]

焦点距离（以米为单位）。 输出必须是具有三个元素的浮点数组。 近焦点距离、最佳焦点距离和远焦距离将填充到数组中。

属性

RegisterAttribute ObsoleteAttribute

注解

获取从相机到对象似乎处于焦点位置的距离。 该对象在最佳焦点距离处最锐利。 字段的深度是远焦距离减去近焦点距离。

焦点距离在通话 #autoFocus(AutoFocusCallback)后可能会更改， #cancelAutoFocus或者 #startPreview()。 应用程序可以随时调用 #getParameters() 此方法以获取最新的焦点距离。 如果焦点模式FOCUS_MODE_CONTINUOUS_VIDEO，焦点距离可能会不时更改。

此方法旨在估计相机和主题之间的距离。 自动对焦后，主题距离可能位于近和远焦点距离内。 但是，精度取决于相机硬件、自动对焦算法、焦点区域和场景。 该错误可能很大，它只应用作引用。

远焦距离 >= 最佳焦点距离 >= 近焦点距离。 如果焦点距离为无穷大，则值为 Float.POSITIVE_INFINITY。

适用于 . 的 android.hardware.Camera.Parameters.getFocusDistances(float[])Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

另请参阅

• FocusDistanceNearIndex
• FocusDistanceOptimalIndex
• FocusDistanceFarIndex