Camera.Parameters.GetFocusDistances(Single[]) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Precaución
deprecated
Obtiene las distancias de la cámara a la que parece que un objeto está en el foco.
[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
Parámetros
- output
- Single[]
distancias de foco en metros. output debe ser una matriz float con tres elementos. Distancia de enfoque cercano, distancia óptima del foco y distancia de foco lejano se rellenará en la matriz.
- Atributos
Comentarios
Obtiene las distancias de la cámara a la que parece que un objeto está en el foco. El objeto es más agudo a la distancia óptima del foco. La profundidad del campo es la distancia del foco lejano menos la distancia de enfoque cercano.
Las distancias de foco pueden cambiar después de llamar a #autoFocus(AutoFocusCallback)
, #cancelAutoFocus
o #startPreview()
. Las aplicaciones pueden llamar a #getParameters()
y este método en cualquier momento para obtener las distancias de foco más recientes. Si el modo de enfoque es FOCUS_MODE_CONTINUOUS_VIDEO, las distancias de foco pueden cambiar de vez en cuando.
Este método está pensado para calcular la distancia entre la cámara y el asunto. Después del autofoco, la distancia del sujeto puede estar dentro y lejos de la distancia de foco. Sin embargo, la precisión depende del hardware de la cámara, el algoritmo de autofoco, el área de enfoque y la escena. El error puede ser grande y solo debe usarse como referencia.
Distancia de >foco lejano = distancia >de foco óptima = distancia de enfoque cercano. Si la distancia de foco es infinita, el valor será Float.POSITIVE_INFINITY
.
Documentación de Java para android.hardware.Camera.Parameters.getFocusDistances(float[])
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.