# AcquireImage

La fonction AcquireImage spécifie les paramètres de capture d’une image numérique et de son transfert vers la mémoire de traitement du système de vision In-Sight.

Un système de vision In-Sight acquiert toutes les images à l’aide d’une réinitialisation asynchrone et d’un balayage progressif. Un système de vision en nuances de gris produit des images 8 bits, tandis qu’un système de vision en couleurs (indiqué par un suffixe C) produit des images 24 bits. La procédure d’acquisition d’image commence approximativement dans les 250µs pour chaque système de vision et se poursuit de la manière suivante :

- Le capteur optique est exposé à la lumière pendant la durée spécifiée par le paramètre Exposition.
- L’image cumulée dans le capteur d’image est transférée ligne par ligne dans un registre à décalage série.

- À chaque transfert de ligne, le capteur temporise la sortie du capteur d’image dans un registre à décalage, pixel par pixel, par le chemin suivant :

  Amplificateur vidéo -> Gain et Offset -> Convertisseur analogique/numérique -> Mémoire du processeur de vision

La mémoire tampon contenant l’image acquise est représentée dans la feuille de calcul comme structure de données Image. La structure de données Image renvoyée par AcquireImage est à son tour référencée par d’autres fonctions de la feuille de calcul In-Sight pour le traitement de régions de l’image. Toute fonction qui dépend directement ou indirectement des données d’une image acquise doit se mettre à jour dès l’acquisition d’une nouvelle image. Le rapport entre l’image d’entrée et les autres fonctions de la feuille de calcul est le facteur entraînant l’exécution des tâches de vision dans le système de vision In-Sight. Pour en savoir plus sur les dépendances et l’ordre d’exécution des cellules, consultez Exécution des cellules de feuille de calcul.

Lorsqu’une feuille de calcul est créée, une fonction AcquireImage est automatiquement ajoutée dans la cellule A0. Ceci présente des avantages pour la plupart des fonctions d’outil de vision, ainsi que de nombreuses autres fonctions, puisqu’une référence absolue à la cellule A0 peut servir de source d’image par défaut. Pour plus d’informations, consultez Références à des cellules.

Attention : Vous pouvez supprimer la fonction AcquireImage de la feuille de calcul, mais vous NE DEVEZ PAS LE FAIRE, car cela rend l’acquisition d’images impossible. Si vous supprimez par erreur la fonction AcquireImage de la cellule A0, annulez la suppression depuis le menu Édition > Annuler ou en appuyant sur Ctrl+Z, ou rajoutez la fonction en entrant l’expression AcquireImage() dans la cellule..

Si vous souhaitez modifier les paramètres de la fonction AcquireImage, cliquez sur le volet Acquisition à côté de la feuille de calcul. Pour plus d’informations, consultez Volet Acquisition.

Remarque :

- Puisque la fonction ne contient pas d’arguments, les paramètres d’acquisition configurés ne sont pas conservés lors de l’exportation des cellules comme modèle de cellule. Pour exporter les paramètres d’acquisition, ajoutez « ApplyAcquisitionSettings » à la feuille de calcul, activez les paramètres que vous souhaitez conserver, définissez les paramètres avec les valeurs souhaitées, puis exportez « ApplyAcquisitionSettings » en comme modèle de cellule. Lorsque le modèle de cellule contenant « ApplyAcquisitionSettings » est importé, les paramètres d’acquisition sont appliqués à la fonction une fois que la cellule « ApplyAcquisitionSettings » est exécutée.
- Les fonctions nécessitant un paramètre Image doivent faire référence à une cellule de feuille de calcul contenant une structure de données Image valide. La référence par défaut du paramètre Image de toutes les feuilles de propriétés est la cellule A0. Celle-ci contient la structure de données Image renvoyée par la fonction AcquireImage. Cependant, les structures de données Image renvoyées par des fonctions Image constituent également des références valides pour les valeurs des paramètres d’image dans les feuilles de propriétés.

## ApplyAcquisitionSettings

Lorsque vous faites glisser un paramètre du volet Acquisition sur la feuille de calcul, une fonction ApplyAcquisitionSettings est ajoutée à la feuille de calcul, ce qui vous permet de modifier les paramètres d’acquisition au moment de l’exécution sans ouvrir le volet Acquisition. Dans le volet Acquisition, le paramètre déposé présente un point d’exclamation bleu à ses côtés. Cette icône indique que la fonction ApplyAcquisitionSettings remplace ce paramètre. Lorsque vous passez la souris sur l’icône, l’emplacement de la cellule de la fonction ApplyAcquisitionSettings s’affiche sous forme d’une infobulle.

Remarque :

- La feuille de propriétés AcquireImage affiche également un point d’exclamation bleu si un de ses paramètres associés a été déposé depuis la feuille de propriétés ApplyAcquisitionSettings. Pour plus d’informations, consultez la rubrique ApplyAcquisitionSettings.
- Si un paramètre est référencé par plusieurs fonctions ApplyAcquisitionSettings, l’icône indique l’emplacement des cellules de la fonction ApplyAcquisitionSettings (jusqu’à cinq emplacements).

- Si vous désactivez un paramètre dans la feuille de propriétés ApplyAcquisitionSettings, le point d’exclamation bleu du paramètre associé ne s’affiche plus dans la feuille de propriétés AcquireImage.