# AcquireImage

La función AcquireImage especifica los parámetros que rigen la captura de una imagen digital y su transferencia a la memoria de procesamiento del sistema de visión In-Sight.

El sistema de visión In-Sight captura todas las imágenes utilizando el reinicio asíncrono y el barrido progresivo. El sistema de visión en escala de grises produce imágenes de 8 bits, mientras que el sistema de visión en color (identificado mediante el sufijo C) produce imágenes de 24 bits. El proceso de captura de imagen comienza aproximadamente a los 250 µs en todos los sistema de visión y se ejecuta de la siguiente manera:

- El sensor de imágenes integra la luz durante el tiempo especificado en el parámetro Exposición.
- La imagen acumulada en el sensor de imágenes se transfiere, fila por fila, a un registro de desplazamiento en serie.

- El sistema de visión cronometra el registro de desplazamiento, píxel por píxel, por cada fila transferida desde el sensor de imágenes utilizando la siguiente ruta de acceso:

  Video amplifier -> Gain and Offset -> Analog-to-digital converter -> Vision processor memory

La memoria intermedia que contiene la imagen capturada se representa en la hoja de cálculo como una estructura de datos Image. La estructura de datos Image devuelta por la función AcquireImage es a su vez objeto de referencia de otras funciones de hoja de cálculo del In-Sight que procesan regiones de la imagen. Cualquier función que dependa directa o indirectamente de los datos de la imagen capturada se actualiza forzosamente cada vez que se captura una nueva imagen. Esta relación entre la imagen de entrada y otras funciones en la hoja de cálculo es lo que impulsa la ejecución de las tareas de tratamiento de imágenes en el In-Sight sistema de visión. Para más información sobre dependencias entre celdas y el orden de ejecución de las celdas, consulte Ejecución de las celdas de la hoja de cálculo.

Cuando se crea inicialmente una hoja de cálculo, se agrega automáticamente la función AcquireImage en la hoja de cálculo ubicándola en la celda A0. La mayoría de las funciones de Vision Tool, así como muchas otras funciones, utilizan este hecho para especificar su origen predeterminado de datos de imagen mediante una referencia absoluta a la celda A0. Para más información, consulte Referencias de celda.

Precaución: Puede eliminar la función AcquireImage de la hoja de cálculo, pero NO debería hacerlo, porque esto imposibilitaría la captura de imágenes. Si elimina por error la función AcquireImage de la celda A0, anule la eliminación utilizando el menú Edit > Undo o pulse Ctrl+Z o agregue de nuevo la función entrando la expresión AcquireImage() en la celda.

Si desea cambiar los valores de los parámetros de AcquireImage, haga clic sobre el panel de capturas, «Acquisition», junto a la hoja de cálculo. Para más información, consulte el tema Panel de capturas.

Nota:

- Al no tener la función ningún argumento, no se conservan los ajustes configurados para captura cuando se exportan las celdas como plantilla de celdas. Para exportar la configuración de captura, agregue la función ApplyAcquisitionSettings (AplicarConfiguraciónDeCaptura) a la hoja de cálculo, habilite los parámetros que desee conservar, establezca los valores de configuración deseados y, a continuación, exporte ApplyAcquisitionSettings como plantilla de celdas. Cuando se importa la plantilla de celdas que contiene ApplyAcquisitionSettings, se aplicarán los ajustes de captura configurados a la función en cuanto se ejecute la celda ApplyAcquisitionSettings.
- Las funciones que requieren un parámetro de Imagen deben hacer referencia a una celda de la hoja de cálculo que contenga una estructura de datos Image válida. En todas las hojas de propiedades, la celda de referencia para el parámetro Imagen es por defecto la celda A0 que contiene la estructura de datos Image devuelta por la función AcquireImage. Sin embargo, las estructuras de datos Image devueltas por las funciones Imagen son también referencias válidas para los valores del parámetro Imagen en las hojas de propiedades.

## ApplyAcquisitionSettings

Cuando se arrastra un parámetro desde el panel de captura para soltarlo en la hoja de cálculo, se agrega la función ApplyAcquisitionSettings a la hoja de cálculo, lo que posibilita editar parámetros de captura durante la ejecución, sin tener que abrir el panel de capturas. En el panel de capturas, el parámetro arrastrado y soltado presentará un símbolo de exclamación azul. Este símbolo indica que la función ApplyAcquisitionSettings está sobrescribiendo el parámetro. Si se pasa el ratón sobre este símbolo, aparecerá un cuadro emergente que indica la posición de la celda en la que se encuentra la función ApplyAcquisitionSettings.

Nota:

- En la hoja de propiedades de AcquireImage se visualiza también un símbolo de exclamación azul junto a un parámetro que haya sido arrastrado desde la hoja de propiedades de ApplyAcquisitionSettings. Para más información, consulte ApplyAcquisitionSettings.
- Si un parámetro es objeto de referencia de varias funciones ApplyAcquisitionSettings, el símbolo de exclamación azul indicará las posiciones de las celdas que contienen dichas funciones ApplyAcquisitionSettings (hasta cinco posiciones de celda).

- Si desmarca un parámetro en la hoja de propiedades de ApplyAcquisitionSettings, desaparecerá el símbolo de exclamación azul asociado a dicho parámetro de la hoja de propiedades de AcquireImage.