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 は、3 つの要素を持つ float 配列である必要があります。 近距離、最適なフォーカス距離、遠距離は配列に入力されます。

属性

注釈

カメラからオブジェクトがフォーカスされている場所までの距離を取得します。 オブジェクトは、最適なフォーカス距離で最もシャープです。 被写界深度は、遠距離から近距離を引いた距離です。

#cancelAutoFocus、または #startPreview()を呼び出#autoFocus(AutoFocusCallback)した後、フォーカスの距離が変わる場合があります。 アプリケーションは、いつでも と このメソッドを呼び出 #getParameters() して、最新のフォーカス距離を取得できます。 フォーカス モードがFOCUS_MODE_CONTINUOUS_VIDEOの場合、フォーカスの距離が時間によって変わる可能性があります。

この方法は、カメラと被写体の間の距離を推定することを目的としています。 オートフォーカス後、被写体の距離は近距離と遠方フォーカス距離の範囲内に収まる可能性があります。 ただし、精度はカメラ ハードウェア、オートフォーカス アルゴリズム、フォーカス領域、シーンによって異なります。 エラーは大きくなる可能性があり、参照としてのみ使用する必要があります。

遠距離 >= 最適なフォーカス距離 >= 近距離。 フォーカス距離が無限大の場合、値は になります Float.POSITIVE_INFINITY

の Java ドキュメント android.hardware.Camera.Parameters.getFocusDistances(float[])

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

こちらもご覧ください