Camera.Parameters.GetFocusDistances(Single[]) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
警告
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 屬性授權中所述的詞彙使用。