共用方式為


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

定義

警告

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[]

以公尺為單位的焦點距離。 output 必須是具有三個元素的 float 陣列。 近焦點距離、最佳焦點距離和遠焦距離將會填入數位中。

屬性

備註

取得相機與對象顯示為焦點的距離。 物件在最佳焦點距離最尖銳。 欄位深度是遠焦點距離減去近焦點距離。

在呼叫 #autoFocus(AutoFocusCallback)#cancelAutoFocus#startPreview()之後,焦點距離可能會變更。 應用程式可以隨時呼叫 #getParameters() 和 此方法,以取得最新的焦點距離。 如果焦點模式FOCUS_MODE_CONTINUOUS_VIDEO,焦點距離可能會不時變更。

此方法的目的是要估計相機與主旨之間的距離。 自動對焦之後,主旨距離可能位於近距焦點距離內。 不過,精確度取決於相機硬體、自動對焦演算法、焦點區域和場景。 錯誤可能很大,而且應該只當做參考使用。

遠焦距離 >= 最佳焦點距離 >= 近焦點距離。 如果焦點距離是無限大,則值會是 Float.POSITIVE_INFINITY

android.hardware.Camera.Parameters.getFocusDistances(float[])Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於

另請參閱