# ApplyAcquisitionSettings

Vous pouvez ajouter la fonction ApplyAcquisitionSettings à la feuille de calcul en sélectionnant un paramètre dans la feuille de propriétés AcquireImage puis en faisant glisser ce paramètre sur la feuille de calcul. La fonction ApplyAcquisitionSettings permet de régler les paramètres d’acquisition présents dans la fonction AcquireImage. Cette fonction vous permet de modifier rapidement et facilement les paramètres d’acquisition dans la feuille de calcul pendant l’exécution, ou de modifier un paramètre en fonction des communications externes (FFP) ou de la sortie d’un outil de vision, sans ouvrir la feuille de propriétés AcquireImage.

La fonction ApplyAcquisitionSettings prend en charge les paramètres suivants :

- Type de déclenchement, Antirebond (ms), Retard (ms), Exposition (ms), Offset, Gain, Orientation, Ligne de départ, Nombre de lignes
- Éclairage : Mode, Intensité, Séries activées, Toujours actif
- High Dynamic Range : Mode HDR, taille du noyau HDR+

Remarque :

- Vous ne pouvez pas glisser-déposer d’autres paramètres (par exemple le mode de déclenchement) de la feuille de propriétés AcquireImage vers la feuille de calcul.

- Les paramètres qui ne sont pas pris en charge par le périphérique connecté sont grisés et ne peuvent pas être glissés-déposés.
- 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. Pour en savoir davantage sur les modèles des cellules de feuille de calcul, consultez Exporter/importer des cellules vers/depuis des modèles.

## Utilisation de ApplyAcquisitionSettings

1. Ouvrez la feuille de propriétés AcquireImage dans la cellule A0.
2. Faites glisser un paramètre de la feuille de propriétés AcquireImage vers la feuille de calcul.

3. La fonction ApplyAcquisitionSettings est ajoutée à la feuille de calcul et renvoie une structure de données AcquisitionSettings, l’étiquette du paramètre et un contrôle d’édition. Par exemple, si vous faites glisser le paramètre Antirebond (ms) dans la feuille de calcul, la structure de données AcquisitionSettings, l’étiquette « Antirebond (ms) » et un contrôle d’édition sont ajoutés dans la feuille de calcul.

4. Cliquez sur OK pour fermer la feuille de propriétés AcquireImage.

5. Si vous souhaitez ajouter un autre paramètre d’acquisition à la feuille de calcul, ouvrez la feuille de propriétés ApplyAcquisitionSettings.

   Remarque : Il est fortement recommandé de glisser-déposer un paramètre de la feuille de propriétés ApplyAcquisitionSettings après avoir créé la première fonction ApplyAcquisitionSettings. Si vous faites glisser plusieurs paramètres depuis AcquireImage, vous créez plusieurs fonctions ApplyAcquisitionSettings, et vous ne saurez plus quels sont les paramètres définis pour chacun d’entre eux

6. Cochez la case du paramètre souhaité. Par exemple, si vous souhaitez ajouter le paramètre Retard (ms) à la feuille de calcul, cochez la case qui correspond à Retard (ms).

7. Glissez-déposez le paramètre dans la feuille de calcul.

8. L’étiquette du paramètre et un contrôle d’édition sont placés dans la feuille de calcul. Par exemple, si vous faites glisser le paramètre dans la feuille de calcul, l’étiquette « Retard (ms) » et un contrôle d’édition sont ajoutés dans la feuille de calcul.

9. Répétez les étapes 5 à 8 jusqu’à ce que tous les paramètres souhaités aient été ajoutés.
10. Modifiez les valeurs dans les contrôles d’édition pour répondre à vos besoins.

11. Les nouvelles valeurs seront appliquées à la prochaine acquisition d’image.

    Remarque : Si vous utilisez le mode de déclenchement Caméra, les nouvelles valeurs seront appliquées après le prochain déclenchement de l’appareil.

Remarque :

- Si vous avez plusieurs fonctions ApplyAcquisitionSettings dans la feuille de calcul, seule la dernière valeur modifiée sera utilisée lors de l’acquisition de l’image.
- L’étiquette et le contrôle d’édition du paramètre sont renseignés uniquement lorsque vous glissez-déposez le paramètre depuis la feuille de propriétés AcquireImage ou ApplyAcquisitionSettings sur la feuille de calcul. Si vous insérez la fonction ApplyAcquisitionSettings par d’autres méthodes (par exemple en tapant ApplyAcquisitionSettings dans une cellule), seule la structure de données AcquisitionSettings est renseignée.
- Si vous désactivez un paramètre dans la feuille de propriétés ApplyAcquisitionSettings, le contrôle d’édition placé sur la feuille de calcul ne modifie plus la valeur présente dans la fonction AcquireImage.

## ApplyAcquisitionSettings – Sorties

Lorsqu’un paramètre pris en charge est glissé et déposé de la feuille de propriétés AcquireImage dans la feuille de calcul, les éléments suivants sont renvoyés.

Renvoie | Structure de données AcquisitionSettings Étiquette du paramètre Contrôle d’édition du paramètre