# ComputeImageSharpness

La herramienta Compute Image Sharpness calcula una cantidad indicativa del enfoque relativo de una imagen de entrada mientras se realiza un procedimiento iterativo para reenfocar la lente de la cámara de In-Sight.

## ComputeImageSharpness Descripción general

La cantidad denominada puntuación de nitidez de la imagen (image sharpness score) indica el grado de nitidez con el que la imagen o una región de interés (RDI) de la misma presenta los detalles más pequeños que se distinguen en una «escena» (es decir, el objeto y el fondo tal como se han capturado en la imagen).

La operación es sencilla: se captura una imagen y la herramienta ComputeImageSharpness obtiene la puntuación de nitidez de la imagen. A continuación, se vuelve a enfocar el objetivo, no se modifica nada en la escena, se captura una nueva imagen y se puntúa la imagen. Cuanto mayor sea la puntuación, tanto más nítido será el enfoque. Este proceso se repite hasta que el enfoque es aceptable para el usuario.

Nota: La puntuación de nitidez de una sola imagen no transmite ninguna información útil sobre la nitidez absoluta de una imagen; debe compararse con la puntuación de nitidez de otra imagen de exactamente la misma escena. Las escenas deben ser idénticas.

## ComputeImageSharpness Entradas

Parámetro | Descripción
Imagen | Este parámetro ha de utilizar Referencias de celda contenidas en una celda de la hoja de cálculo que contiene una estructura de datos Imagen; por defecto, este parámetro hace referencia a A0, la celda que contiene la estructura de datos Image devuelta por la función . Este parámetro puede hacer también referencia a otras estructuras de datos Image, como las devueltas por las Funciones Image del conjunto Vision Tools.
Elemento posicionador | Define la región de interés (RDI) con relación a un Fixture entrado o al sistema de coordenadas de imagen proporcionado por una función de Vision Tools. Establecer la RDI con relación al un elemento posicionador permite asegurar que si se gira o desplaza el elemento posicionador, se girará o desplazará en consonancia la RDI, manteniéndose fija la relación entre ambos. El valor de configuración predeterminado es (0,0,0), la esquina superior izquierda de la imagen.
X | El desplazamiento en X, en coordenadas de la imagen.
Y | El desplazamiento en Y, en coordenadas de la imagen.
Theta | La rotación desde el eje X de la imagen, en el sistema de coordenadas de imagen. (+/-360 grados en el sentido de las agujas del reloj)
Región | También conocida como región de interés (RDI), especifica la región de la imagen que se somete a análisis. Haga doble clic sobre el parámetro Región para crear un Modo gráfico interactivo que permite transformar y girar. Seleccione este parámetro y pulse el botón «Maximizar región» en la barra de herramientas de edición de tareas de la hoja de propiedades a fin de expandir automáticamente la región hasta cubrir toda la imagen.
X | El desplazamiento en X del origen, en coordenadas del elemento posicionador.
Y | El desplazamiento en Y del origen, en coordenadas del elemento posicionador.
Ancho | El tamaño de la región en la dirección del eje X.
Altura | El tamaño de la región en la dirección del eje Y.
Ángulo | La orientación en coordenadas del elemento posicionador.
Curva | Ángulo entre lados, +/- 360 grados en el sentido de las agujas del reloj
Operación | Gradiente de energía: Calcula la nitidez de la imagen a partir de la energía asociada al gradiente local de niveles de gris de la imagen o RDI. El gradiente local de niveles de gris representa la tasa de cambio de los valores de gris en un área determinada. Un cambio brusco en la escala de grises implica un gradiente de niveles de gris de gran magnitud y una mayor puntuación para la nitidez de la imagen.
Suavizado | Especifica una operación de suavizado de la imagen que ayuda a eliminar el ruido de alta frecuencia que pudiera haber en la RDI. Dispone de tres ajustes:
0 = Ninguno (predeterminado) | No se realiza ningún suavizado; proporciona el tiempo de ejecución más rápido.
1 = Nivel de suavizado 1 | Se aplica un cierto suavizado a la RDI con el que se elimina el ruido de muy alta frecuencia de la RDI.
2 = Nivel de suavizado 2 | Se aplica un suavizado de mayor grado a la RDI con el que elimina ruido de alta frecuencia y de muy alta frecuencia de la ROI.
Mostrar | Especifica qué superposiciones gráficas han de visualizarse sobre la imagen.
0 = ocultar todo (por defecto) | Se ocultan los elementos gráficos disponibles, excepto cuando la celda que contiene la función ComputeImageSharpness está resaltada en la hoja de cálculo.
1 = sólo gráficos de entrada | Se visualizarán en todo momento los elementos gráficos asociados a la región de la imagen entrada.

## ComputeImageSharpness Salidas

Devuelve | Una puntuación de nitidez de la imagen expresada como número en punto flotante o #ERR si alguno de los parámetros de entrada no es válido.