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[]
フォーカス距離をメートル単位で指定します。 出力は、3 つの要素を含む float 配列である必要があります。 近いフォーカス距離、最適なフォーカス距離、遠くのフォーカス距離が配列に入力されます。
- 属性
注釈
カメラからオブジェクトがフォーカスされている場所までの距離を取得します。 オブジェクトは、最適なフォーカス距離で最もシャープです。 被写界深度は、遠いフォーカス距離から近いフォーカス距離を引いた値です。
フォーカスの距離は、呼び出し#autoFocus(AutoFocusCallback)
#cancelAutoFocus
後、または #startPreview()
. アプリケーションは、いつでもこのメソッドを呼び出 #getParameters()
して、最新のフォーカス距離を取得できます。 フォーカス モードがFOCUS_MODE_CONTINUOUS_VIDEOの場合、フォーカスの距離が随時変化する可能性があります。
この方法は、カメラと被写体の間の距離を推定するためのものです。 オートフォーカス後、被写体の距離は近距離と遠方フォーカス距離の範囲内に収まるようにすることができます。 ただし、精度はカメラ ハードウェア、オートフォーカス アルゴリズム、フォーカス領域、シーンによって異なります。 エラーは大きくなる可能性があり、参照としてのみ使用する必要があります。
遠距離 >= 最適なフォーカス距離 >= 近いフォーカス距離。 フォーカス距離が無限大の場合、値は Float.POSITIVE_INFINITY
.
の Java ドキュメントandroid.hardware.Camera.Parameters.getFocusDistances(float[])
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。