Language

Camera.Parameters.GetFocusDistances(Single[]) メソッド

定義

名前空間:
Android.Hardware
アセンブリ:
Mono.Android.dll

注意事項

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

属性
RegisterAttribute ObsoleteAttribute

注釈

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

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

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

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

Javaドキュメント。

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

適用対象

こちらもご覧ください