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[]
對焦距離以公尺為單位。 輸出必須是包含三個元素的浮點陣列。 陣列中會填滿近焦距、最佳對焦距離和遠距。
- 屬性
備註
取得相機到物體對焦的距離。 物體在最佳對焦距離下最為銳利。 景深是遠對焦距離減去近焦距。
呼叫 #autoFocus(AutoFocusCallback)、 #cancelAutoFocus或 #startPreview()後，對焦距離可能會改變。 應用程式可以隨時呼叫 #getParameters() 這個方法，以取得最新的對焦距離。 如果對焦模式FOCUS_MODE_CONTINUOUS_VIDEO，對焦距離可能會不時改變。
此方法旨在估算相機與主體之間的距離。 自動對焦後，主體距離可能在近焦和遠焦範圍內。 然而，精度取決於相機硬體、自動對焦演算法、對焦區域以及場景。 誤差可能很大，應該只當作參考。
遠焦距 >= 最佳對焦距離 >= 近焦距。 若對焦距離為無限大，則值為 Float.POSITIVE_INFINITY。
Java 文件 android.hardware.Camera.Parameters.getFocusDistances(float[])。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。