# Fonctions de l’outil mathématique

L’outil mathématique fournit un dictionnaire complet d’opérations mathématiques :

- Les fonctions Données datées sauvegardent un flux de valeurs d’une cellule sur une période déterminée. Chaque fonction renvoie une valeur unique sélectionnée à partir du flux de valeurs à chaque fois que l’événement spécifié met à jour le tableur.

- Grâce aux fonctions de géométrie et de mesure, vous pouvez facilement calculer la distance entre des figures géométriques standard, notamment des cercles, des points et des segments de ligne.
- Graphiques :
  - Les fonctions de contrôle permettent d’insérer des éléments interactifs dans la feuille de calcul afin d’apporter des modifications de configuration simples à un projet, sans avoir à utiliser la Boîte de dialogue Insérer une fonction ou la feuille de propriétés.
  - Les fonctions d’image permettent de tracer des calques graphiques sur l’image.
- Fonctions Mathématiques :
  - Les fonctions logiques permettent de manipuler l’algèbre booléenne et les tests conditionnels. Pour toutes les fonctions logiques, la valeur 0 signifie un résultat FAUX et toute valeur non nulle signifie VRAI.
  - Utilisez les fonctions de recherche pour rechercher un maximum, un minimum ou un numéro d’index dans une plage de valeurs ; renvoyez les coordonnées X et Y et les données #ERR ; supprimez les cellules #ERR pour éviter la propagation des erreurs par le biais de plusieurs fonctions.
  - Les fonctions arithmétiques fournissent diverses fonctions mathématiques telles que la valeur absolue, la puissance, la troncature, l’arrondi et la génération de nombres aléatoires.
  - Statistiques : renvoie les données relatives au maximum, au minimum, à la moyenne et à l’écart type pour un groupe de valeurs.
  - Trigonométrie : fournit des fonctions sinus, cosinus, tangente, pi, degrés et radians.
- Les fonctions d’opérateur fournissent des opérateurs de comparaison, notamment =, <>, >, <, >=, <=.

- Les fonctions String formatent les données alphanumériques à afficher et à transmettre entre le système de vision In-Sight et un périphérique distant.

- Les fonctions Résultats de vision extraient les différentes valeurs des structures de données, des fonctions et d’autres références à des cellules.

- Les fonctions des outils de vision se composent de fonctions qui extraient et traitent les caractéristiques des images en vue d’une analyse plus poussée des données et ainsi faciliter la prise de décision.

Remarque : Les noms des catégories n’apparaissent pas dans la liste des fonctions à insérer. Les fonctions s’affichent dans une seule liste par ordre alphabétique.

## Liste des fonctions

Groupe | Type | Fonction | Description
--- | --- | --- | ---
Fonctions de stockage de données datées | Accumulate | Syntaxe : Accumulate(Événement,Valeur,Réinitialiser,Valeur initiale) Additionne une valeur à l’infini. Cette fonction renvoie l’intégrale d’un flux de données calculée à chaque occurrence de l’événement spécifié. #### Entrées
Paramètre | Description
--- | ---
Événement | Détermine l’événement provoquant la lecture de la Valeur spécifiée. Ce paramètre doit être une référence à l’un des éléments suivants : Le mot-clé Acquis(e)(s), qui correspond à l’acquisition d’image la plus récente. Une cellule contenant une fonction Événement. Une cellule contenant une fonction Button. Remarque : La fonction Accumulate met en mémoire tampon l’état d’une valeur référencée avant que cette valeur ne soit mise à jour par toute autre fonction qui dépend de l’événement spécifié.
Valeur | Référence à la cellule contenant la source du flux de données devant être cumulées. (;-16777216 à 16777216 par défaut = 1,000)
Réinitialisation | Force la fonction Accumulate à revenir à la Valeur initiale.
0 = OFF (par défaut) | La fonction Accumulate additionne la valeur spécifiée à l’infini.
1 = ON | La fonction Accumulate est réinitialisée immédiatement.
Valeur initiale | Détermine la valeur minimum à laquelle la fonction Accumulate est réinitialisée lorsque Remise à zéro est réglée sur ON. (-16777216 à 16777216; par défaut = 0,000).
#### Sorties
Renvoie | Une Valeur représentant le cumul du flux de données depuis la dernière Remise à zéro.
ClockedMax | Syntaxe : ClockedMax(Evénement,Valeur,Réinitialiser,Valeur initiale) Échantillonne un flux de données sur un intervalle infini, puis renvoie la valeur maximale prélevée dans le flux pendant cet intervalle. ## Entrées
Paramètre | Description
--- | ---
Événement | Indique l’événement forçant une mise à jour.Ce paramètre doit être une référence à l’un des éléments suivants : Le mot-clé Acquis(e)(s), qui correspond à l’acquisition d’image la plus récente. Une cellule contenant une fonction Événement. Une cellule contenant une fonction Button. Remarque : Contrairement à la fonction Maximum, qui échantillonne l’état d’une valeur référencée avant que cette valeur ne soit mise à jour par une autre fonction qui dépend de l’événement spécifié, ClockedMax échantillonne l’état de la valeur référencée après que cette valeur ait été mise à jour par une autre fonction.
Valeur | Référence à la cellule source du flux de données dans lequel un Minimum est recherché. (-16777216 à 16777216 ; par défaut = 0).
Réinitialisation | Force la fonction à réinitialiser son registre interne à la valeur spécifiée par Valeur initiale.
0 = OFF (par défaut) | La fonction continue de prélever des valeurs dans le flux de données actuel.
1 = ON | La fonction réinitialise la valeur minimale renvoyée et commence un nouveau flux de données dans lequel la valeur doit être prélevée.
Valeur initiale | Détermine la valeur minimale à laquelle la fonction est remise à zéro (-16777216 à 16777216 ; par défaut = -16777216).
#### Sorties
Renvoie | Une valeur représentant le minimum d’un flux de données depuis la Remise à zéro.
ClockedMin | Syntaxe : ClockedMin(Evénement,Valeur,Réinitialisation,Valeur initiale) Échantillonne un flux de données sur un intervalle infini, puis renvoie la valeur minimale prélevée dans le flux pendant cet intervalle. #### Entrées
Paramètre | Description
--- | ---
Événement | Détermine l’événement de mise à jour auquel il faut lire la valeur. Ce paramètre doit être une référence à l’un des éléments suivants : Le mot-clé Acquis(e)(s), qui correspond à l’acquisition d’image la plus récente. Une cellule contenant une fonction Événement. Une cellule contenant une fonction Button. Remarque : Contrairement à la fonction Minimum, qui échantillonne l’état d’une valeur référencée avant que cette valeur ne soit mise à jour par une autre fonction qui dépend de l’événement spécifié, ClockedMin échantillonne l’état de la valeur référencée après que cette valeur ait été mise à jour par une autre fonction.
Valeur | Référence à la cellule source du flux de données dans lequel un Minimum est recherché (-16777216 à 16777216 ; par défaut = 0).
Réinitialisation | Force la fonction à réinitialiser son registre interne à la valeur spécifiée par Valeur initiale.
0 = OFF (par défaut) | La fonction continue de prélever des valeurs dans le flux de données actuel.
1 = ON | La fonction réinitialise la valeur minimale renvoyée et commence un nouveau flux de données dans lequel la valeur doit être prélevée.
Valeur initiale | Détermine la valeur minimale à laquelle la fonction est remise à zéro (-16777216 à 16777216 ; par défaut = -16777216).
#### Sorties
Renvoie | Une valeur représentant le minimum d’un flux de données depuis la Remise à zéro.
ClockedSum | Syntaxe : ClockedSum(Événement,Valeur,Réinitialisation,Valeur initiale)
Décompte | Syntaxe : Count(Événement,Valeur maximale,Réinitialisation,Valeur initiale) Compte les événements pendant une durée illimitée. La fonction renvoie la Valeur initiale, ainsi que le nombre d’événements qui se sont produits depuis la dernière remise à zéro. #### Entrées
Paramètre | Description
--- | ---
Événement | Indique l’événement de mise à jour provoquant l’incrément du compteur. Ce paramètre doit être une référence à l’un des éléments suivants : Le mot-clé Acquis(e)(s), qui correspond à l’acquisition d’image la plus récente. Une cellule contenant une fonction Événement. Une cellule contenant une fonction Button.
Valeur max. | Indique la valeur maximale autorisée avant la remise à zéro automatique du compteur à la valeur initiale minimale (-16777216 à 16777216 ; par défaut : 16777216).
Réinitialisation | Force le compteur à revenir à la Valeur initiale.
0 = OFF (par défaut) | Le compteur est autorisé à atteindre la Valeur max avant la remise à zéro.
1 = ON | Le compteur se remet à zéro immédiatement même si la Valeur max n’a pas été atteinte.
Valeur initiale | Indique la valeur minimale à laquelle le compteur est réinitialisé lorsque la Valeur max est atteinte, ou lorsque le paramètre Remise à zéro est ON. (-16777216 à 16777216 ; par défaut = 0)
#### Sorties
Renvoie | Une valeur qui représente la somme de la Valeur initiale et du nombre d’événements qui se sont produits depuis la dernière remise à zéro.
CountPassFail | Syntaxe : CountPassFail(Événement,Valeur,Compter hors ligne,RéinitialiserÉvénement.Manuel,RéinitialiserÉvénement.EnLigne,RéinitialiserÉvénement.Charger projet) Compte et renvoie les succès, échecs et le nombre total d’événements d’une valeur référencée donnée. #### Entrées
Paramètre | Description
--- | ---
Événement | Indique l’événement provoquant l’incrément du compteur. Ce paramètre doit être une référence à l’un des éléments suivants : Le mot-clé Acquis(e)(s), qui correspond à l’acquisition d’image la plus récente. Une cellule contenant une fonction Événement. Une cellule contenant une fonction Button.
Valeur | Spécifie une référence obligatoire à la cellule contenant la source du flux de données à compter. Si aucune cellule n’est référencée, la fonction renvoie #ERR pour tous les résultats. Le compteur incrémenté (Succès,Échec ou #ERR) est basé sur la valeur renvoyée, comme suit :
Succès | Valeur > 0
Échec | Valeur = 0
#ERR | Valeur < 0
Compter hors ligne | Indique si les compteurs sont incrémentés lorsque le capteur est hors ligne.
0 = OFF | Ne pas incrémenter les compteurs lorsque le capteur est hors ligne.
1 = ON (par défaut) | Incrémenter les compteurs lorsque le capteur est hors ligne.
Réinitialiser les événements | Force la réinitialisation des compteurs sur la base d’événements spécifiques.
Manuel | Indique si les compteurs sont remis à zéro lorsque l’événement spécifié se produit. Ce paramètre fait automatiquement référence au bouton de réinitialisation qui est inséré dans la feuille de calcul lorsque la fonction est créée. Remarque : Si cette case à cocher est activée manuellement dans la feuille de propriétés, la référence au bouton de réinitialisation est supprimée. Pour utiliser le bouton Réinitialisation, ce paramètre doit faire référence à la cellule contenant le bouton Réinitialisation.
0 = OFF (par défaut) | Ne pas remettre les compteurs à zéro lorsque l’événement spécifié se produit.
1 = ON | Remettre les compteurs à zéro lorsque l’événement spécifié se produit.
En ligne | Lorsque le capteur est mis en ligne, indique si les compteurs sont remis à zéro après le premier événement.
0 = OFF | Lorsque le capteur est mis en ligne, ne pas remettre les compteurs à zéro une fois que le premier événement s’est produit.
1 = ON (par défaut) | Lorsque le capteur est mis en ligne, remettre les compteurs à zéro une fois que le premier événement s’est produit.
Ouverture d’un projet | Indique si les compteurs sont remis à zéro lorsque le projet est chargé.
0 = OFF | Ne pas remettre les compteurs à zéro lorsqu’un projet est chargé.
1 = ON (par défaut) | Remettre les compteurs à zéro lorsqu’un projet est chargé.
#### Sorties
Renvoie | Une structure de données Count contenant les compteurs incrémentés ou #ERR, si l’un des paramètres d’entrée n’est pas valide.
Résultats | Lorsque la fonction CountPassFail est insérée dans une cellule pour la première fois, un tableau de résultats avec un bouton de réinitialisation sont créés dans la feuille de calcul. Lorsque vous appuyez sur le bouton Réinitialisation, tous les compteurs sont remis à zéro.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :.
Succès | GetPassCount(Compte) | Le décompte croissant de succès. Le compteur est incrémenté lorsque la valeur renvoyée est supérieure à zéro.
Échecs | GetFailCount(Compte) | Le décompte croissant d’échecs. Le compteur est incrémenté lorsque la valeur renvoyée est égale à zéro.
Erreurs | GetErrorCount(Compte) | Le décompte croissant d’erreurs. Le compteur est incrémenté lorsque la valeur renvoyée est inférieure à zéro.
Total | GetTotalCount(Compte) | Le nombre total de succès, d’échecs et d’erreurs.
Latch | Syntaxe : Latch(Evénement,Valeur) Sauvegarde (verrouille) une valeur d’entrée pour l’événement spécifié. #### Entrées
Paramètre | Description
--- | ---
Événement | Détermine l’événement de mise à jour auquel il faut lire la valeur. Ce paramètre doit être une référence à l’un des éléments suivants : Le mot-clé Acquis(e)(s), qui correspond à l’acquisition d’image la plus récente. Une cellule contenant une fonction Événement. Une cellule contenant une fonction Button.
Valeur | Référence à la cellule contenant les données à sauvegarder (-16777216 à 16777216 ; par défaut = 0,000).
#### Sorties
Renvoie | La valeur sauvegardée lors du dernier événement.
LatchString | Syntaxe : LatchString(Événement, "Chaîne") Sauvegarde (verrouille) une chaîne d’entrée de caractères alphanumériques pour l’événement spécifié. #### Entrées
Paramètre | Description
--- | ---
Événement | Spécifie l’événement de mise à jour sur lequel lire la chaîne. Ce paramètre doit être une référence à l’un des éléments suivants : Le mot-clé Acquis(e)(s), qui correspond à l’acquisition d’image la plus récente. Une cellule contenant une fonction Événement. Une cellule contenant une fonction Button.
Chaîne | Référence à la cellule contenant la chaîne à sauvegarder.
#### Sorties
Renvoie | La chaîne sauvegardée lors du dernier événement.
Maximum | Syntaxe : Maximum(Événement,Valeur,Réinitialisation,Valeur initiale) Échantillonne un flux de données sur un intervalle infini, puis renvoie la valeur maximale prélevée dans le flux pendant cet intervalle. #### Entrées
Paramètre | Description
--- | ---
Événement | Détermine l’événement de mise à jour auquel il faut lire la valeur. Ce paramètre doit être une référence à l’un des éléments suivants : Le mot-clé Acquis(e)(s), qui correspond à l’acquisition d’image la plus récente. Une cellule contenant une fonction Événement. Une cellule contenant une fonction Button. Remarque : La fonction Maximum échantillonne l’état d’une valeur référencée avant que cette valeur ne soit mise à jour par toute autre fonction qui dépend de l’événement spécifié.
Valeur | Référence à la cellule source du flux de données dans lequel un Maximum est recherché.
Réinitialisation | Force la fonction à réinitialiser son registre interne à la valeur spécifiée par Valeur initiale.
0 = OFF (par défaut) | La fonction continue de prélever des valeurs dans le flux de données actuel.
1 = ON | La fonction réinitialise la valeur maximale renvoyée et commence un nouveau flux de données dans lequel la valeur doit être prélevée.
Valeur initiale | Détermine la valeur maximale à laquelle la fonction est réinitialisée (-16777216 à 16777216 ; par défaut = -16777216).
#### Sorties
Renvoie | Une valeur qui est la valeur maximale d’un flux de données depuis la dernière Remise à zéro.
Minimum | Syntaxe : Minimum(Événement,Valeur,Réinitialisation,Valeur initiale) Échantillonne un flux de données sur un intervalle infini, puis renvoie la valeur minimale prélevée dans le flux pendant cet intervalle. #### Entrées
Paramètre | Description
--- | ---
Événement | Détermine l’événement de mise à jour auquel il faut lire la valeur. Ce paramètre doit être une référence à l’un des éléments suivants : Le mot-clé Acquis(e)(s), qui correspond à l’acquisition d’image la plus récente. Une cellule contenant une fonction Événement. Une cellule contenant une fonction Button. Remarque : La fonction Minimum échantillonne l’état d’une valeur référencée avant que cette valeur ne soit mise à jour par toute autre fonction qui dépend de l’événement spécifié.
Valeur | Référence à la cellule source du flux de données dans lequel un Minimum est recherché.
Réinitialisation | Force la fonction à réinitialiser son registre interne à la valeur spécifiée par Valeur initiale.
0 = OFF (par défaut) | La fonction continue de prélever des valeurs dans le flux de données actuel.
1 = ON | La fonction réinitialise la valeur minimale renvoyée et commence un nouveau flux de données dans lequel la valeur doit être prélevée.
Valeur initiale | Détermine la valeur minimale à laquelle la fonction est remise à zéro (-16777216 à 16777216 ; par défaut = 16777216).
#### Sorties
Renvoie | Une valeur représentant le minimum d’un flux de données depuis la Remise à zéro.
ShiftRegister | Syntaxe : ShiftRegister (Événement,Valeur,Nombre de pas,Réinitialisation) Implémente un groupe de registre à décalage, ou "flux" de données, dans lequel les valeurs sont mises en mémoire tampon après chaque événement. Remarque : Après une réinitialisation, la première valeur lue remplit le registre à décalage. #### Entrées
Événement | Détermine l’événement de mise à jour auquel il faut lire la valeur. Ce paramètre doit être une référence à l’un des éléments suivants : Le mot-clé Acquis(e)(s), qui correspond à l’acquisition d’image la plus récente. Une cellule contenant une fonction Événement. Une cellule contenant une fonction Button. Remarque : Contrairement à la fonction DelayLine, qui met en tampon l’état d’une valeur référencée avant que cette valeur ne soit mise à jour par une autre fonction qui dépend de l’événement spécifié, ShiftRegister met en tampon l’état de la valeur référencée après que cette valeur ait été mise à jour par une autre fonction.
Valeur | Une référence à la cellule contenant les données sources (-16777216 à 16777216 ; par défaut = 0).
Nbre de pas | Détermine le nombre de valeurs dans le groupe de registre à décalage interne de la fonction (1 à 5000 ; par défaut = 10).
Réinitialisation | Force la fonction à se vider des valeurs lues auparavant. La première valeur relevée après une Remise à zéro "remplit" le registre à décalage.
0 = OFF (par défaut) | La fonction continue d’enregistrer des valeurs dans le flux de données.
1 = ON | La fonction se vide de toutes les valeurs du flux de données.
#### Sorties
Renvoie | Une structure de données Buffer contenant les statistiques de la Valeur spécifiée sur une période comprise entre la Remise à zéro et aujourd’hui.
Résultats | Un tableau de résultats est créé dans la feuille de calcul lorsque la fonction est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
Dernier | GetValue(Delay, Index) | Dernière valeur contenue dans la structure.
Médian | GetMean(Delay) | Moyenne de toutes les valeurs de la structure.
SDev | GetSDev(Delay) | Écart-type de toutes les valeurs de la structure.
Min | GetMin(Delay) | Plus petite valeur contenue dans la structure.
Max | GetMax(Delay) | Valeur la plus élevée contenue dans la structure.
Il est possible d’accéder à d’autres éléments avec les fonctions Résultats de vision suivantes :
Décompte | GetCount(Delay) | Nombre de valeurs contenues dans la structure.
Sum | GetSum(Delay) | Somme de toutes les valeurs contenues dans la structure.
Géométrie | Fonctions Fit Remarque : Si une fonction géométrique utilise des coordonnées réelles comme référence, les graphiques résultants ne seront pas affichés correctement. | CircleFromNPoints | Syntaxe : CircleFromNPoints(Point X 0,Point Y 0,Point X 1,Point Y 1,Point X 2,Point Y 2,...,Point X N,Point Y N,Afficher) Ajuste un cercle en utilisant trois points d’entrée ou plus. #### Entrées
Paramètre | Description
--- | ---
Point 0 | Détermine les coordonnées du premier point.
Point X 0 | Abscisse du premier point.
Point Y 0 | Ordonnée du premier point.
Point 1 | Détermine les coordonnées du second point.
Point X 1 | Abscisse du second point.
Point Y 1 | Ordonnée du second point.
Point 2 | Détermine les coordonnées du troisième point.
Point X 2 | Abscisse du troisième point.
Point Y 2 | Ordonnée du troisième point.
Point 3..N | En option, spécifie les coordonnées de tout point supplémentaire.
Point X N | Abscisse du point N.
Point Y N | Ordonnée du point N.
Afficher | Détermine les éléments graphiques à afficher de manière permanente.
0 = masquer tout | Tous les graphiques sont masqués, sauf si la cellule qui contient la fonction CircleFromNPoints est la cellule active dans la feuille de calcul.
1 = graphiques de résultats uniquement | Le graphique du cercle ajusté est toujours affiché. Les points d’entrée ne seront affichés que lorsque la cellule qui contient la fonction CircleFromNPoints est la cellule active de la feuille de calcul.
2 = graphiques d’entrées et de résultats | Le cercle ajusté et les points d’entrée sont affichés en permanence.
#### Sorties
Renvoie | Une structure de données CircleFit contenant les valeurs X, Y, le rayon et la valeur sigma du cercle ajusté.
Résultats | Un tableau de résultats est créé dans la feuille de calcul lorsque la fonction est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
X | GetX(CircleFit) | Abscisse du centre du cercle.
Y | GetY(CircleFit) | Ordonnée du centre du cercle.
Rayon | GetRadius(CircleFit) | Rayon du cercle.
Sigma | GetSigma(CircleFit) | La racine carrée de la somme des carrés des distances entre les points et le cercle, divisée par le nombre de points.
Il est possible d’accéder à d’autres éléments avec les fonctions Résultats de vision suivantes :
Distance | GetDistance(CircleFit, Index) | La distance entre le point indexé et le cercle. Si la valeur est négative, le point est à l’intérieur du cercle. Si le point indexé est non valide, un #ERR est renvoyé.
MaxDist | GetMaxDist(CircleFit) | La distance entre le cercle et le point le plus éloigné du cercle. Si la valeur est négative, le point est à l’intérieur du cercle.
IndexDistMax | GetMaxDistIndex(CircleFit) | L’indice du point le plus éloigné du cercle.
NPointsUtilisés | GetNPointsUsed(CircleFit) | Le nombre de points utilisés pour ajuster le cercle.
LineFromNPoints | Syntaxe : LineFromNPoints(Point X 0,Point Y 0,Point X 1,Point Y 1,[...Point X N,Point Y N,Afficher]) Ajuste une ligne en utilisant deux ou plusieurs points d’entrée. #### Entrées
Paramètre | Description
--- | ---
Point 0 | Détermine les coordonnées du premier point.
Point X 0 | Abscisse du premier point.
Point Y 0 | Ordonnée du premier point.
Point 1 | Détermine les coordonnées du second point.
Point X 1 | Abscisse du second point.
Point Y 1 | Ordonnée du second point.
Point 2..N | Spécifie les coordonnées de tout point supplémentaire.
Point X N | Abscisse du point N.
Point Y N | Ordonnée du point N.
Afficher | Détermine les éléments graphiques à afficher de manière permanente.
0 = masquer tout | Tous les graphiques sont masqués, sauf si la cellule qui contient la fonction LineFromNPoints est la cellule active dans la feuille de calcul.
1 = graphiques de résultats uniquement | Le graphique de la ligne ajustée est toujours affiché. Les points d’entrée ne seront affichés que lorsque la cellule qui contient la fonction LineFromNPoints est la cellule active de la feuille de calcul.
2 = graphiques d’entrées et de résultats | La ligne ajustée et les points d’entrée sont affichés en permanence.
#### Sorties
Renvoie | Une structure de données LineFit si les données contiennent plus de deux points valides, ou #ERR si les données ne contiennent qu’un seul ou aucun point valide.
Résultats | Un tableau de résultats est créé dans la feuille de calcul lorsque la fonction est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
X0 | GetX(LineFit, 0) | Abscisse du premier point de terminaison.
Y0 | GetY(LineFit, 0) | Ordonnée du premier point de terminaison.
X1 | GetX(LineFit, 1) | Abscisse du second point de terminaison.
Y1 | GetY(LineFit, 1) | Ordonnée du second point de terminaison.
Chi2 | GetChi2(LineFit) | La somme des carrés des distances entre les points et la ligne.
Il est possible d’accéder à d’autres éléments avec les fonctions Résultats de vision suivantes.
Distance | GetDistance(LineFit, Index) | La distance entre le point indexé et la ligne.
MaxDist | GetMaxDist(LineFit) | Le point le plus éloigné de la ligne.
IndexDistMax | GetMaxDistIndex(LineFit) | L’index du point le plus éloigné de la ligne.
NPointsUtilisés | GetNPointsUsed(LineFit) | Le nombre de points utilisés pour calculer la ligne.
Mesure | PointToCircle | Syntaxe : PointToCircle(Point.X,Point.Y,Cercle.X,Cercle.Y,Cercle.Rayon,Afficher) Calcule la distance minimale entre un point et le point d’un cercle le plus proche. Si le point est à l’intérieur d’un cercle, la distance est renvoyée sous forme d’un nombre négatif. #### Entrées
Paramètre | Description
--- | ---
Point | Détermine les coordonnées du point qui sera utilisé comme origine.
X | Abscisse du point.
Y | Ordonnée du point.
Cercle | Détermine les coordonnées et la taille du cercle.
X | Abscisse du centre du cercle.
Y | Ordonnée du centre du cercle.
Rayon | Rayon du cercle.
Afficher | Détermine le mode d’affichage des graphiques, superposés à l’image, de la fonction.
0 = masquer tout | Tous les graphiques sont masqués, sauf lorsque la cellule contenant la fonction est mise en évidence dans la feuille de calcul.
1 = graphiques de résultats uniquement | Un segment indiquant la distance minimale entre le point et le cercle est toujours affiché.
2 = graphiques d’entrées et de résultats | Le point, le cercle et le segment entre eux sont toujours affichés.
#### Sorties
Renvoie | Structure de données Dist contenant la distance orientée entre le point et le point le plus proche sur le cercle.
Résultats | Un tableau de résultats est créé dans la feuille de calcul lorsque la fonction est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
X0 | GetX(Dist, 0) | Abscisse du point.
Y0 | GetY(Dist, 0) | Ordonnée du point.
X1 | GetX(Dist, 1) | Abscisse du point le plus proche sur le cercle.
Y1 | GetY(Dist, 1) | Ordonnée du point le plus proche sur le cercle.
Angle | GetAngle(Dist) | Angle de point à point.
Distance | GetDistance(Dist) | Distance de point à point.
PointToLine | Syntaxe : PointToLine(Point.X,Point.Y,Ligne.X 0,Ligne.Y 0,Ligne.X 1,Ligne.Y 1,Afficher) Calcule la distance minimale entre un point et une ligne. Dans cet exemple, la fonction PointToLine mesure la distance entre un point et une ligne. Le point est l’origine, et l’angle est calculé en fonction de sa position par rapport à la ligne. #### Entrées
Paramètre | Description
--- | ---
Point | Détermine les coordonnées du point qui sera utilisé comme origine.
X | Abscisse du point.
Y | Ordonnée du point.
Ligne | Détermine les coordonnées de la ligne.
X 0 | Abscisse du premier point de terminaison de la ligne.
Y 0 | Ordonnée du premier point de terminaison de la ligne.
X 1 | Abscisse du second point de terminaison de la ligne.
Y 1 | Ordonnée du second point de terminaison de la ligne.
Afficher | Détermine le mode d’affichage des graphiques, superposés à l’image, de la fonction.
0 = masquer tout | Tous les graphiques sont masqués, sauf lorsque la cellule contenant la fonction est mise en évidence dans la feuille de calcul.
1 = graphiques de résultats uniquement | Un segment indiquant la distance minimale entre le point et la ligne d’entrée est toujours affiché.
2 = graphiques d’entrées et de résultats | Le point, la ligne d’entrée et le segment de ligne situés entre les deux sont affichés en permanence.
#### Sorties
Renvoie | Structure de données Dist contenant la distance orientée entre le point et le point le plus proche sur la ligne.
Résultats | Un tableau de résultats est créé dans la feuille de calcul lorsque la fonction est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
X0 | GetX(Dist, 0) | Abscisse du point.
Y0 | GetY(Dist, 0) | Ordonnée du point.
X1 | GetX(Dist, 1) | Abscisse du point le plus proche sur la ligne.
Y1 | GetY(Dist, 1) | Ordonnée du point le plus proche sur la ligne.
Angle | GetAngle(Dist) | L’angle point à ligne.
Distance | GetDistance(Dist) | La distance point à ligne.
PointToPoint | Syntaxe : PointToPoint(Point 0.X,Point 0.Y,Point 1.X,Point 1.Y,Afficher) Calcule la distance orientée entre deux points. Dans cet exemple, la fonction PointToPoint mesure la distance entre deux points. L’angle est calculé en fonction de la position du premier point par rapport au second. #### Entrées
Paramètre | Description
--- | ---
Point 0 | Spécifie les coordonnées du premier point, qui sera utilisé comme origine.
X | Abscisse du premier point.
Y | Ordonnée du premier point.
Point 1 | Détermine les coordonnées du second point.
X | Abscisse du second point.
Y | Ordonnée du second point.
Afficher | Détermine le mode d’affichage des graphiques, superposés à l’image, de la fonction.
0 = masquer tout | Tous les graphiques sont masqués, sauf lorsque la cellule contenant la fonction est mise en évidence dans la feuille de calcul.
1 = graphiques de résultats uniquement | Un segment indiquant la distance minimale entre les deux points est toujours affiché.
2 = graphiques d’entrées et de résultats | Les deux points d’entrée et le segment entre eux sont toujours affichés.
#### Sorties
Renvoie | Structure de données Dist contenant la distance orientée entre les points.
Résultats | Un tableau de résultats est créé dans la feuille de calcul lorsque la fonction est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
X0 | GetX(Dist, 0) | Abscisse du premier point.
Y0 | GetY(Dist, 0) | Ordonnée du premier point.
X1 | GetX(Dist, 1) | Abscisse du second point.
Y1 | GetY(Dist, 1) | Ordonnée du second point.
Angle | GetAngle(Dist) | Angle de point à point.
Distance | GetDistance(Dist) | Distance de point à point.
PointToPointAngle | Syntaxe : PointToPointAngle(Point 0.X,Point 0.Y,Point 1.X,Point 1.Y) Calcule l’angle entre deux points. #### Entrées
Paramètre | Description
--- | ---
Point 0 | Spécifie les coordonnées du premier point, qui sera utilisé comme origine.
X | Abscisse du premier point.
Y | Ordonnée du premier point.
Point 1 | Détermine les coordonnées du second point.
X | Abscisse du second point.
Y | Ordonnée du second point.
#### Sorties
Renvoie | Une valeur contenant l’angle entre les deux points, par rapport à l’axe X de l’image.
Remarque : Contrairement à la plupart des autres fonctions de mesure de la catégorie Géométrie, PointToPointAngle n’insère pas de structure de données Dist ou de tableau de résultats dans la feuille de calcul.
PointToPointDistance | Syntaxe : PointToPointDistance(Point 0.X,Point 0.Y,Point 1.X,Point 1.Y) Calcule la distance entre deux points. #### Entrées
Paramètre | Description
--- | ---
Point 0 | Détermine les coordonnées du premier point.
X | Abscisse du premier point.
Y | Ordonnée du premier point.
Point 1 | Détermine les coordonnées du second point.
X | Abscisse du second point.
Y | Ordonnée du second point.
#### Sorties
Renvoie | Une valeur contenant la distance entre les deux points.
Remarque : Contrairement à la plupart des autres fonctions de mesure de la catégorie Géométrie, PointToPointDistance n’insère pas de structure de données Dist ou de tableau de résultats dans la feuille de calcul.
Graphiques | Contrôle Remarque : Veillez à utiliser le mot-clé « Acquis(e)(s) » pour spécifier l’image actuelle. | Button | Syntaxe : Button(Nom,Déclencheur) Insère une commande par bouton-poussoir dans le tableur. Un bouton peut également être configuré pour indiquer un déclencheur Event de tableur. Conseil : Pour accéder à la feuille de propriétés d’un bouton, effectuez un clic droit sur le bouton et sélectionnez Modifier la fonction. Remarque : Un contrôle Button peut être contrôlé par programmation par l’intermédiaire des commandes In-Sight en mode natif, à l’aide de la commande EV SetCellValue. Entrez 1 pour appuyer sur le bouton, et 0 pour le relâcher. Assurez-vous d’envoyer la commande de relâchement du bouton après l’avoir enfoncé, sinon le bouton considérera qu’il reste enfoncé. Cliquer sur un bouton génère deux événements : L’état du bouton passe de 0 à 1 lorsque l’on appuie sur le bouton, puis de 1 à 0 lorsque l’on relâche le bouton. Si le bouton est configuré pour déclencher un événement logiciel, l’événement n’est déclenché qu’une seule fois, lors de la pression vers le bas du bouton. #### Entrées
Paramètre | Description
--- | ---
Nom | Spécifie une chaîne de caractères qui est le nom qui s’affiche sur le bouton.
Déclencheur | Peut indiquer un signal de déclenchement à générer lorsque le bouton est activé.
-1 = aucun (par défaut) | Aucun déclencheur n’est signalé.
32 = manuel | Un déclencheur manuel est signalé.
80 à 87 = soft 0 à 7 (soft 0 par défaut) | Un déclencheur logiciel d’événement est signalé.
#### Sorties
Renvoie | Une valeur 1 lorsque vous actionnez le bouton. Sinon la valeur remise est 0.
Résultats | Un contrôle Button avec légende.
CheckBox | Syntaxe : CheckBox(Nom) Insère dans la feuille de calcul un contrôle Checkbox avec légende. Remarque : Pour accéder à la feuille de propriétés du contrôle Checkbox, effectuez un clic droit et sélectionnez Modifier la fonction. #### Entrées
Paramètre | Description
--- | ---
Nom | Spécifie une légende qui s’affiche à côté de la case à cocher CheckBox.
#### Sorties
Renvoie | 0 lorsqu’elle est désactivée (non cochée), et 1 lorsqu’elle est activée (cochée).
Résultats | Un contrôle CheckBox avec légende.
#### Exemple Une feuille de calcul est configurée comme suit : A3=CheckBox("On") A4=A3 La cellule A4 fait référence à la cellule A3 pour déterminer l’état activé/désactivé de la case "On". Lorsque la case n’est pas cochée, la valeur 0,000 est renvoyée dans la cellule A4. Lorsque la case est cochée, la valeur 1,000 est renvoyée.
EditFloat | Syntaxe : EditFloat(Min,Max) Insère un contrôle d’édition de valeurs à virgule flottante dans la feuille de calcul. Ce contrôle agit comme les autres contrôles interactifs d’entrée numérique. Remarque : Pour accéder à la feuille de propriétés d’un contrôle EditFloat, effectuez un clic droit sur le contrôle et sélectionnez Modifier la fonction. #### Entrées
Paramètre | Description
--- | ---
Min | Spécifie la valeur minimale acceptée par le contrôle de zone de saisie (-16777216 à 16777216 ; par défaut = 0).
Max | Spécifie la valeur maximale acceptée par le contrôle de zone de saisie (-16777216 à 16777216 ; par défaut = 100).
#### Sorties
Renvoie | La valeur saisie dans la commande.
Résultats | Un contrôle EditFloat .
EditInt | Syntaxe : EditInt(Min,Max) Insère un contrôle d’édition de nombre entier dans la feuille de calcul. Ce contrôle agit comme les autres contrôles interactifs d’entrée numérique d’In-Sight. Remarque : Pour accéder à la feuille de propriétés d’un contrôle EditInt, effectuez un clic droit sur le contrôle et sélectionnez Modifier la fonction. #### Entrées
Paramètre | Description
--- | ---
Min | Spécifie la valeur minimale acceptée par le contrôle de zone de saisie (-16777216 à 16777216 ; par défaut = 0).
Max | Spécifie la valeur maximale acceptée par le contrôle de zone de saisie (-16777216 à 16777216 ; par défaut = 255).
#### Sorties
Renvoie | La valeur saisie dans la commande.
Résultats | Un contrôle EditInt .
EditString | Syntaxe : EditString(Longueur max. de la chaîne) Insère un contrôle d’édition de nombre entier dans la feuille de calcul. Ce contrôle agit comme les autres contrôles interactifs d’entrée numérique d’In-Sight. Remarque : Pour accéder à la feuille de propriétés d’un contrôle EditInt, effectuez un clic droit sur le contrôle et sélectionnez Modifier la fonction. #### Entrées
Paramètre | Description
--- | ---
Min | Spécifie la valeur minimale acceptée par le contrôle de zone de saisie (-16777216 à 16777216 ; par défaut = 0).
Max | Spécifie la valeur maximale acceptée par le contrôle de zone de saisie (-16777216 à 16777216 ; par défaut = 255).
#### Sorties
Renvoie | La valeur saisie dans la commande.
Résultats | Un contrôle EditInt .
ListBox | Syntaxe : ListBox("Chaîne0","Chaîne1","Chaîne2",...) Insère une commande à liste déroulante dans la feuille de calcul. Remarque : Étant donné que la fonction ListBox peut accepter un nombre variable de chaînes, cette fonction ne peut être configurée par le biais d’une feuille de propriétés. Cette fonction peut être configurée directement dans la cellule ou dans la barre de formule de la barre d’outils Modification de projet. #### Entrées
Paramètre | Description
--- | ---
Chaîne0, 1, 2, ... | Une liste de longueur variable de chaînes de caractères distinctes. Chacune d’entre elles renvoie une valeur différente lorsqu’elle est sélectionnée sur la liste déroulante.
#### Sorties
Renvoie | Une valeur représentant le numéro d’index (basé sur zéro) de l’élément sélectionné.
Résultats | Une commande ListBox . Remarque : La chaîne de caractères actuellement sélectionnée dans la liste est également accessible à l’aide de la fonction de résultat de vision GetString.
#### Exemple Une feuille de calcul est configurée comme suit : A3=ListBox("Item1","Item2","Item3") A4=A3 La fonction de la cellule A3 crée le contrôle de liste, avec "Item1" comme sélection par défaut. La valeur de l’index de l’élément 1 "Item1" est 0, la valeur de la cellule A4 sera donc 0,000. Si l’utilisateur sélectionne "Item2", la valeur dans la cellule A4 sera de 1,000. Si vous sélectionnez "Item3", la valeur dans la cellule A4 est 2.000. #### Fonctions Vision Data Access (VDA) Il est possible d’accéder à d’autres éléments avec les fonctions Résultats de vision suivantes :
GetString | GetString(ListBox) | Renvoie la chaîne de caractères.
Image Remarque : Veillez à utiliser le mot-clé « Acquis(e)(s) » pour spécifier l’image actuelle. | PlotCircle | Syntaxe : PlotCircle(Cercle.X,Cercle.Y,Cercle.Rayon,Nom,Couleur,Afficher) Trace un cercle sur l’image. #### Entrées
Paramètre | Description
--- | ---
Cercle | Spécifie les coordonnées d’image du cercle à tracer (-16777216 à 16777216).
X | La coordonnée X du centre du cercle.
Y | La coordonnée Y du centre du cercle.
Rayon | Rayon du cercle.
Nom | Détermine le libellé à afficher avec le graphique sur l’image.
Couleur | Détermine la couleur du graphique tracé. (Valeur par défaut : 0x32cd32, LimeGreen ; Max : 0xffffff)
Afficher | Détermine le mode d’affichage des graphiques superposés à l’image.
0 = OFF | Le graphique est masqué, sauf lorsque la cellule contenant la fonction est mise en évidence dans la feuille de calcul.
1 = ON (par défaut) | Le graphique est toujours affiché.
#### Sorties
Renvoie | Une structure de données Plot contenant le graphique.
PlotCross | Syntaxe : PlotCro(Croix.X,Croix.Y,Croix.Angle,Croix.Hauteur,Croix.Laurgeur,Nom,Couleur,Afficher) Trace une croix sur l’image. #### Entrées
Paramètre | Description
--- | ---
Croix | Spécifie les coordonnées d’image de la croix à tracer (-16777216 à 16777216).
X | La coordonnée X du centre de la croix.
Y | La coordonnée Y du centre de la croix.
Angle | Orientation de la croix.
Hauteur | Hauteur de la croix.
Largeur | Largeur de la croix.
Nom | Détermine le libellé à afficher avec le graphique sur l’image.
Couleur | Détermine la couleur du graphique tracé. (Valeur par défaut : 0x32cd32, LimeGreen ; Max : 0xffffff)
Afficher | Détermine le mode d’affichage des graphiques superposés à l’image.
0 = OFF | Le graphique est masqué, sauf lorsque la cellule contenant la fonction est mise en évidence dans la feuille de calcul.
1 = ON (par défaut) | Le graphique est toujours affiché.
#### Sorties
Renvoie | Une structure de données Plot contenant le graphique.
PlotLine | Syntaxe : PlotLine(Ligne.X 0,Ligne.Y 0,Ligne.X 1,Ligne.Y 1,Nom,Couleur,Afficher,Ornement de début,Ornement de fin) Trace un segment sur l’image. #### Entrées
Paramètre | Description
--- | ---
Ligne | Détermine les coordonnées de la ligne à tracer ().
X 0 | La coordonnée X du premier point de terminaison de la ligne.
Y 0 | La coordonnée Y du premier point de terminaison de la ligne.
X 1 | La coordonnée X du deuxième point de terminaison de la ligne.
Y 1 | La coordonnée Y du deuxième point de terminaison de la ligne.
Nom | Détermine le libellé à afficher avec le graphique sur l’image.
Couleur | Détermine la couleur du graphique tracé. (Valeur par défaut : 0x32cd32, LimeGreen ; Max : 0xffffff)
Afficher | Détermine le mode d’affichage des graphiques superposés à l’image.
0 = OFF | Le graphique est masqué, sauf lorsque la cellule contenant la fonction est mise en évidence dans la feuille de calcul.
1 = ON (par défaut) | Le graphique est toujours affiché.
Ornement de début | Spécifie l’ornement pour le point de départ de la ligne.
0 = aucun (par défaut)
1 = Flèche
Ornement de fin | Spécifie l’ornement pour le point de fin de la ligne.
0 = aucun (par défaut)
1 = Flèche
#### Sorties
Renvoie | Une structure de données Plot contenant le graphique.
PlotPoint | Syntaxe : PlotPoint(Point.X,Point.Y,Nom,Couleur,Afficher) Trace une cible ponctuelle sur l’image. #### Entrées
Paramètre | Description
--- | ---
Point | Spécifie les coordonnées d’image du point à tracer (-16777216 à 16777216).
X | Abscisse du point.
Y | Ordonnée du point.
Nom | Détermine le libellé à afficher avec le graphique sur l’image.
Couleur | Détermine la couleur du graphique tracé. (Valeur par défaut : 0x32cd32, LimeGreen ; Max : 0xffffff)
Afficher | Détermine le mode d’affichage des graphiques superposés à l’image.
0 = OFF | Le graphique est masqué, sauf lorsque la cellule contenant la fonction est mise en évidence dans la feuille de calcul.
1 = ON (par défaut) | Le graphique est toujours affiché.
#### Sorties
Renvoie | Une structure de données Plot contenant le graphique.
PlotString | Syntaxe : PlotString(Chaîne,Point.X,Point.Y,Couleur,Afficher) Trace une chaîne de caractères sur l’image. Conseil : Après avoir inséré la fonction PlotString dans la feuille de calcul, mettez en surbrillance la cellule de la fonction et utilisez la boîte de dialogue Formater les cellules pour choisir la police, la taille et le style de police de la cellule PlotString et de la chaîne de caractères tracée. #### Entrées
Paramètre | Description
--- | ---
Chaîne | Détermine la Chaîne de caractères à tracer.
Point | Détermine les coordonnées de la chaîne à tracer (-16777216 à 16777216).
X | La coordonnée X de la chaîne.
Y | La coordonnée Y de la chaîne.
Couleur | Détermine la couleur du graphique tracé. (Valeur par défaut : 0x32cd32, LimeGreen ; Max : 0xffffff)
Afficher | Détermine le mode d’affichage des graphiques superposés à l’image.
0 = OFF | Le graphique est masqué, sauf lorsque la cellule contenant la fonction est mise en évidence dans la feuille de calcul.
1 = ON (par défaut) | Le graphique est toujours affiché.
#### Sorties
Renvoie | Une structure de données Plot contenant le graphique.
Mathématiques | Logique | And | Syntaxe : And(Valeur1, Valeur2, ...) Renvoie le résultat d’un ET logique sur une liste de valeurs de longueur variable.
BitAnd | BitAnd(Valeur1, Valeur2, ...) Renvoie le ET bit par bit des valeurs. Remarque : s’effectue uniquement sur les 16 premiers bits (entiers). Exemples BitAnd(45, 77) renvoie 13. 45 = 0000 0000 0010 1101 en binaire. 77 = 0000 0000 0100 1101 en binaire. En réalisant une opération ET entre les bits correspondants de chacun de ces deux nombres binaires de 16 bits, on obtient 0000 0000 0000 1101, soit 13 en décimal.
BitNot | Syntaxe : BitNot(Value) Renvoie l’inverse bit à bit de la Valeur. Remarque : s’effectue uniquement sur les 16 premiers bits (entiers). Exemples BitNot(45) renvoie 65490. 45 = 0000 0000 0010 1101 en binaire. En remplaçant chaque 0 par 1 et chaque 1 par 0, on obtient 1111 1111 1101 0010 en binaire, soit 65490 en décimal.
BitOr | Syntaxe : BitOr(Valeur1, Valeur2, ...) Renvoie le OU bit par bit des valeurs. Remarque : s’effectue uniquement sur les 16 premiers bits (entiers). Exemples BitOr(45, 77) renvoie 109. 45 = 0000 0000 0010 1101 en binaire. 77 = 0000 0000 0100 1101 en binaire. En réalisant une opération OU entre les bits correspondants de chacun de ces deux nombres binaires de 16 bits, on obtient 0000 0000 0110 1101, soit 109 en décimal.
BitXor | Syntaxe : BitXor(Valeur1, Valeur2, ...) Renvoie le XOR (OU exclusif) bit par bit des valeurs. (XOR logique Le résultat est VRAI si un – et seulement un – des bits est VRAI. Le résultat est FAUX si au moins 2 bits sont égaux.) Remarque : s’effectue uniquement sur les 16 premiers bits (entiers). Exemples BitXor(45, 77) renvoie 96. 45 = 0000 0000 0010 1101 en binaire 77 = 0000 0000 0100 1101 en binaire. 0110 0000 sont les seuls bits non communs entre 45 et 77, comme démontré ci-dessous.
45 | 77 | XOR par bit | Bit XOR
--- | --- | --- | ---
0 | 0 | deux 0 ≥ XOR FAUX | 0 (FAUX)
0 | 1 | seulement un 1 ≥ XOR VRAI | 1 (VRAI)
1 | 0 | seulement un 1 ≥ XOR VRAI | 1 (VRAI)
0 | 0 | deux 0 ≥ XOR FAUX | 0 (FAUX)
1 | 1 | deux 1 ≥ XOR FAUX | 0 (FAUX)
1 | 1 | deux 1 ≥ XOR FAUX | 0 (FAUX)
0 | 0 | deux 0 ≥ XOR FAUX | 0 (FAUX)
1 | 1 | deux 0 ≥ XOR FAUX | 0 (FAUX)
0110 0000 = 96 en décimal.
If | Syntaxe : If(Cond, Valeur1, Valeur2) Renvoie Valeur1 si Cond est différent de zéro ; sinon, renvoie Valeur2. Remarque : Si la condition ou les arguments font référence à des cellules vides, ils sont interprétés comme un zéro (FAUX).
InRange | Syntaxe : InRange(Valeur, Début, Fin) Renvoie VRAI si Min(Début,Fin) ≤ Valeur ≤ Max(Début,Fin).
InTolerance | Syntaxe : InTolerance(réel, attendu, % tolérance, marge) Détermine si la valeur réelle se situe dans les limites de tolérance correspondantes par rapport à la valeur attendue, si la différence entre les deux valeurs est supérieure à la marge.
Not | Syntaxe : Not(Value) Renvoie 0 si Valeur est autre que zéro ou 1 si Valeur est 0. (Inverse logique) Exemples Not(-12345) renvoie 0. Not(3.14) renvoie 0. Not(2-1) renvoie 0. Not(1-1) renvoie 1.
OneShot | Syntaxe : OneShot(Val) Retourne VRAI si Val est 1 au cours de cette exécution et 0 dans l’exécution précédente.
Or | Syntaxe : Or(Valeur1, Valeur2, ...) Renvoie 0 si toutes les valeurs sont nulles ; sinon, renvoie 1. (OU logique le résultat est VRAI si l’une des valeurs est VRAIE). Exemples Or(45, -77) renvoie 1. Or(-1, 0, 1) renvoie 1. Or(0, 1-1) renvoie 0.
Recherche Remarque : pour les arguments de fonctions requérant une chaîne de texte, vous ne pouvez pas entrer la chaîne directement avec If, Switch ou Choose. Exemple de chaîne de texte non valide :, Len(If(...)) Pour résoudre ce problème, placez If, Switch ou Choose dans une cellule distincte et créez une référence à cette cellule. Vous pouvez également changer l’ordre de la syntaxe : entrez "If(Len( ) )" dans une cellule, ce qui donne une chaîne de texte valide. | Choose | Syntaxe : Choose(Index, Valeur0, [Valeur1, ...]) Renvoie la valeur de l’argument occupant une position donnée dans une liste de longueur variable.
CountError | Syntaxe : CountError(Cellule1, [Cellule2, ...]) Renvoie le nombre d’erreurs dans une ou plusieurs cellules ou plages de cellules.
ErrFree | Syntaxe : ErrFree(cellule ou plage de cellules) Efface le contenu de cellules #ERR pour éviter la propagation d’erreurs.
If | Syntaxe : If(Cond, Valeur1, Valeur2) Renvoie Valeur1 si Test est non nul ; renvoie Valeur2 si Test est nul.
MaxI | Syntaxe : MaxI(Valeur0, [Valeur1, ...]) Renvoie l’index de la Valeur maximale d’une liste de valeurs de longueur variable.
MinI | Syntaxe : MinI(Valeur0, [Valeur1, ...]) Renvoie l’index de la Valeur minimale d’une liste de valeurs de longueur variable.
NthMaxI | Syntaxe : NthMaxI(N, Valeur0, [Valeur1, ...]) Renvoie la position de la nième plus grande Valeur d’une liste de valeurs de longueur variable.
NthMinI | Syntaxe : NthMinI(N, Value0, [Value1, ...]) Renvoie la position de la nième plus petite Valeur d’une liste de valeurs de longueur variable.
Switch | Syntaxe : Switch(Cas, Par défaut, Cas0, Valeur0, [Cas1, Valeur1, ...]) Renvoie la valeur correspondant au premier cas correspondant à Cas. Si le cas indexé est FAUX, la valeur par défaut spécifiée est renvoyée. Si plusieurs cas de la formule correspondent à Cas, la valeur correspondant au premier cas est renvoyée. Exemple de commutateur Switch A4 = Switch(A2,-1,2,"C",3,"B",A3,"A") Si cellule A2=2, la Valeur renvoyée dans la cellule A4 est C. Si cellule A2=3, la Valeur renvoyée dans la cellule A4 est B. Si cellule A2=5, la Valeur renvoyée dans la cellule A4 est la valeur par défaut, -1, car il n’y a aucun Cas dans la formule qui corresponde à FindCase.
X | Syntaxe : X(Cellule) Renvoie le nombre de coordonnées X d’une cellule de feuille de calcul.
Y | Syntaxe : Y(Cellule) Renvoie le nombre de coordonnées Y d’une cellule de feuille de calcul. Remarque : Y A = 0,0 et Y Z = 25,0
Arithmétique | Abs | Syntaxe : Abs(Value) Renvoie la valeur absolue de la Valeur.
Exp | Syntaxe : Exp(Value) Renvoie e à la puissance Valeur.
Mod | Syntaxe : Mod(Valeur1, Valeur2) Renvoie le reste de Valeur1 divisée par Valeur2.
Power | Syntaxe : Power(Base, Exp) Renvoie l’expression de base à la puissance exp.
Rand | Syntaxe : Rand(Event) Renvoie un nombre aléatoire (0,0 à 1,0) sur un événement d’entrée. Chaque événement déclenche un nouveau nombre aléatoire. Remarque : doit être utilisé seul dans la cellule.
Round | Syntaxe : Round(Value) Renvoie la Valeur arrondie au nombre entier le plus proche.
RoundDown | Syntaxe : RoundDown(Value) Renvoie la valeur tronquée à l’entier immédiatement inférieur.
RoundUp | Syntaxe : RoundUp(Value) Renvoie la Valeur arrondie au nombre entier supérieur.
Sqrt | Syntaxe : Sqrt(Value) Renvoie la racine carrée de la Valeur.
Sum | Syntaxe : Sum(Valeur1, [Valeur2, ...]) Renvoie la somme d’une liste de Valeurs de longueur variable.
Trunc | Syntaxe : Trunc(Value) Renvoie la Valeur tronquée au nombre entier. Le résultat est la valeur sans aucune fraction.
Opérateurs Remarque : Lorsque certains Snippets sont insérés dans la feuille de calcul, la formule qui s’affiche dans la barre d’outils Modifier le projet peut contenir des caractères tels que !, &&, ||, ==, <>, >=, <= et !=. Ces caractères sont des codes alternatifs pour les opérateurs logiques et de comparaison suivants : | NON | Syntaxe : ! NON logique
ET | Syntaxe : && ET logique
OU | Syntaxe : || OU logique
Équivalent à | Syntaxe : == Équivalent à
Différent de | Syntaxe : <> (ou !=) Différent de
Égal | Syntaxe : = Égal
Différent | Syntaxe : <> Différent
Supérieur à | Syntaxe : > Supérieur à
Inférieur à | Syntaxe : < Inférieur à
Supérieur ou égal à | Syntaxe : >= Supérieur ou égal à
Inférieur ou égal à | Syntaxe : <= Inférieur ou égal à
Pourcentage | Syntaxe : % Pourcentage
Ajouter | Syntaxe : + Ajouter
Soustraction | Syntaxe : - Soustraction
Multiplication | Syntaxe : * Multiplication
Diviser | Syntaxe : / Diviser
Statistiques | ComputeStats | Syntaxe : ComputeStats Calcule les statistiques pour une valeur référencée.
Max | Syntaxe : Max(Valeur0, [Valeur1, ...]) Renvoie la Valeur maximale d’une liste de Valeurs de longueur variable.
Médian | Syntaxe : Moyenne(Valeur0, [Valeur1, ...]) Renvoie la moyenne d’une liste de Valeurs de longueur variable.
Min | Syntaxe : Min(Valeur0, [Valeur1, ...]) Renvoie la Valeur minimale d’une liste de Valeurs de longueur variable.
NthMax | Syntaxe : NthMax(N, Valeur0, [Valeur1, ...]) Renvoie la nième plus grande valeur d’une liste de Valeurs de longueur variable.
NthMin | Syntaxe : NthMin(N, Valeur0, [Valeur1, ...]) Renvoie la nième plus petite valeur d’une liste de Valeurs de longueur variable.
SDev | Syntaxe : SDev(Valeur0, Valeur1, [Valeur2, ...]) Renvoie l’écart-type corrigé (avec un dénominateur de N-1) d’une liste de valeurs de longueur variable.
SDevUnbiased | Syntaxe : SDevUnbiased(Valeur0, Valeur1, [Valeur2, ...]) Renvoie l’écart-type non corrigé (avec un dénominateur de N) d’une liste de valeurs de longueur variable.
Trigonométriques | ACos | Syntaxe : ACos(Value) Renvoie l’arc cosinus de la Valeur en degrés. Remarque : -1 ≤ Valeur ≤ 1
ASin | Syntaxe : ASin(Value) Renvoie l’arc sinus de la Valeur en degrés. Remarque : -1 ≤ Valeur ≤ 1
ATan | Syntaxe : ATan(Value) Renvoie l’arc tangente de la Valeur en degrés, ±90.
ATan2 | Syntaxe : ATan2(DY,DX) Renvoie l’arc tangente du vecteur (x,y) = (DY, DX) en degrés, ±180.
Cos | Syntaxe : Cos(Angle) Renvoie le cosinus d’un angle en degrés.
Degrees | Syntaxe : Degrees(Radians) Renvoie un angle en degrés, à partir d’un angle en radians.
Pi | Syntaxe : Pi Renvoie la valeur de pi ≈ 3,142.
Radians | Syntaxe : Radians(Degrés) Renvoie un angle en radians, à partir d’un angle en degrés.
Sin | Syntaxe : Sin(Angle) Renvoie le sinus d’un angle en degrés.
Tan | Syntaxe : Tan(Angle) Renvoie la tangente d’un angle en degrés.
Structures | Cercle | Syntaxe : Circle(Repère.X,Repère.Y,Repère.Theta,Cercle.X,Cercle.Y,Cercle.Rayon,Afficher) Crée une structure Circle munie d’un repère. #### Entrées Remarque : Les paramètres Repère et Cercle doivent être ajustés en fonction des limites de l’image. S’ils sont hors limites, la fonction renvoie #ERR.
Paramètre | Description
--- | ---
Repère | Désigne le système de coordonnées de l’image dans lequel est défini le cercle.
X | Le décalage x.
Y | Le décalage y.
Thêta | Orientation.
Cercle | Spécifie la taille et la position du cercle, dans des coordonnées de repère.
X | L’offset en X du cercle.
Y | Ordonnée du cercle.
Rayon | Le rayon du cercle (1 à 16777216 ; par défaut = 100).
Afficher | Spécifie le mode d’affichage de la superposition du cercle sur l’image.
0 = masquer tout (par défaut) | La structure du cercle n’est pas affichée, sauf si la cellule contenant la fonction Circle est en surbrillance dans la feuille de calcul.
2 = graphiques d’entrée uniquement | La structure Circle est toujours affichée.
#### Sorties
Renvoie | Une structure de données Cercle, ou #ERR si l’un des paramètres d’entrée n’est pas valide.
Résultats | Un tableau de résultats est créé dans le tableur lorsque la fonction Circle est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
X | GetX(Cercle) | Le décalage en abscisse x du centre du cercle, dans les coordonnées d’image.
Y | GetY(Cercle) | Le décalage en ordonnée y du centre du cercle, dans les coordonnées d’image.
Rayon | GetRadius(Circle) | Rayon du cercle.
Repère | Syntaxe : Fixture(Repère.X,Repère.Y,Repère.Theta,Afficher Crée une structure de repère. #### Entrées
Paramètre | Description.
--- | ---
Repère | Détermine le système de coordonnées de l’image dans lequel est défini le repère.
X | Le décalage x.
Y | Le décalage y.
Thêta | Orientation.
Afficher | Détermine le mode d’affichage du point de repère superposé à l’image.
0 = masquer tout (par défaut) | Le point de repère n’est pas affiché, à moins que la cellule contenant la fonction Fixture ne soit en surbrillance dans le tableur.
2 = graphiques d’entrée uniquement | Le point de repère est toujours affiché.
#### Sorties
Renvoie | Une structure de données Repère, ou #ERR si l’un des paramètres d’entrée est non valide.
Résultats | Un tableau de résultats est créé dans le tableur lorsqu’une fonction est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
X | GetX(Repère) | Renvoie le décalage sur l’axe X du repère (coordonnées de l’image).
Y | GetY(Repère) | Renvoie le décalage sur l’axe Y du repère (coordonnées de l’image).
Angle | GetAngle(Fixture) | Renvoie l’angle d’orientation, dans les coordonnées de l’image.
Ligne | Syntaxe : Line(Repère.X,Repère.Y,Repère.Theta,Ligne.X 0,Ligne.Y 0,Ligne.X 1,Ligne.Y 1,Afficher) Crée une structure Line munie d’un repère. #### Entrées Remarque : Les paramètres Repère et Ligne doivent être ajustés en fonction des limites de l’image. S’ils sont hors limites, la fonction renvoie #ERR.
Paramètre | Description
--- | ---
Repère | Détermine le système de coordonnées de l’image dans lequel est définie la ligne.
X | Le décalage x.
Y | Le décalage y.
Thêta | Orientation.
Ligne | Détermine les points de terminaison de la ligne.
X 0 | Le décalage sur l’axe X du premier point de terminaison.
Y 0 | Le décalage sur l’axe Y du premier point de terminaison.
X 1 | Le décalage sur l’axe X du deuxième point de terminaison.
Y 1 | Le décalage sur l’axe Y du deuxième point de terminaison.
Afficher | Détermine le mode d’affichage des graphiques Line superposés à l’image.
0 = masquer tout (par défaut) | La structure Ligne n’est pas affichée, sauf si la cellule contenant la fonction Line est en surbrillance dans la feuille de calcul.
2 = graphiques d’entrée uniquement | La structure Line est toujours affichée.
#### Sorties
Renvoie | Une structure de données Ligne, ou #ERR si l’un des paramètres d’entrée est non valide.
Résultats | Un tableau de résultats est créé dans le tableur lorsque la fonction Line est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
X0 | GetX(Ligne, 0) | Abscisse du premier point de terminaison (coordonnées de l’image).
Y0 | GetY(Ligne, 0) | Ordonnée du premier point de terminaison (coordonnées de l’image).
X1 | GetX(Ligne, 1) | Abscisse du second point de terminaison (coordonnées de l’image).
Y1 | GetY(Ligne, 1) | Ordonnée du second point de terminaison (coordonnées de l’image).
Point | Syntaxe : Point(Repère.X,Repère.Y,Repère.Theta,Point.X,Point.Y,Afficher) Crée une structure Point munie d’un repère. #### Entrées
Paramètre | Description
--- | ---
Repère | Détermine le système de coordonnées de l’image dans lequel est défini le point.
X | Le décalage x.
Y | Le décalage en y.
Thêta | Orientation.
Point | Spécifie l’emplacement du point, dans les coordonnées du repère.
X | L’offset en X de la croix.
Y | L’offset en Y de la croix.
Remarque : Les paramètres Repère et Point doivent être définis dans les limites de l’image, sinon la fonction renvoie #ERR.
Afficher | Détermine le mode d’affichage du graphique Point superposé à l’image.
0 = masquer tout (par défaut) | La structure de point est masquée, sauf si la cellule contenant la fonction Point est en surbrillance dans la feuille de calcul.
2 = graphiques d’entrée uniquement | La structure de point est toujours affichée.
#### Sorties
Renvoie | Une structure de données Point, ou #ERR si l’un des paramètres d’entrée est non valide.
Résultats | Un tableau de résultats est créé dans le tableur lorsque la structure Point est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
X | GetX(Point) | Le décalage en x du point, en coordonnées d’image.
Y | GetY(Point) | Le décalage y du point, en coordonnées image.
Région | Syntaxe : Region(Repère.X,Repère.Y,Repère.Theta,Région.X,Région.Y,Région.Hauteur,Région.Largeur,Région.Angle,Région.Courbure,Afficher) Crée une structure Region munie d’un repère. #### Entrées Remarque : Les paramètres Repère et Région doivent être ajustés en fonction des limites de l’image. S’ils sont hors limites, la fonction renvoie #ERR.
Paramètre | Description
--- | ---
Repère | Détermine le système de coordonnées de l’image dans lequel est définie la région.
X | Le décalage x.
Y | Le décalage y.
Thêta | Orientation.
Région | Détermine la position, la taille, la rotation et la courbure (dans le cas d’un secteur circulaire, en forme de cercle ou d’anneau). Les régions sont toujours définies dans le système de coordonnées d’un Repère.
X | L’offset en X de l’origine (coordonnées du repère).
Y | L’offset en Y de l’origine (coordonnées du repère).
Hauteur | Dimension de l’axe X de la région.
Largeur | Dimension de l’axe Y de la région.
Angle | Orientation du repère.
Courbure | Écart angulaire entre l’axe X de la région et la ligne de la limite opposée.
Afficher | Détermine le mode d’affichage des graphiques de la fonction Region sur l’image.
0 = masquer tout (par défaut) | Le graphique de structure de région est masqué, sauf si la cellule contenant la fonction Region est en surbrillance dans la feuille de calcul.
2 = graphiques d’entrée uniquement | Le graphique de structure de région est toujours affiché.
#### Sorties
Renvoie | Une structure de données Région, ou #ERR si l’un des paramètres d’entrée est non valide.
Résultats | Un tableau de résultats est créé dans le tableur lorsque la fonction Region est insérée dans une cellule pour la première fois.
#### Fonctions Vision Data Access (VDA) Les fonctions Résultats de vision suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
X | GetX(Structure, [Index1], [Index2]) | Renvoie une coordonnée X. Remarque : Index2, Edges-only, détermine un point final (0 ou 1). Index2, ReadIDMax spécifie l’angle du symbole.
Y | GetY(Structure, [Index1], [Index2]) | Renvoie une coordonnée Y. Remarque : Index2, Edges-only, détermine un point final (0 ou 1). Index2, ReadIDMax spécifie l’angle du symbole.
Hauteur | GetHigh(Region) | Dimension de l’axe X de la région.
Largeur | GetWide(Region) | Dimension de l’axe Y de la région.
Angle | GetAngle(Region) | Orientation de l’image.
Courbure | GetCurve(Region) | Écart angulaire entre l’axe X de la région et la ligne de la limite opposée.
Texte | Chaîne | Code | Syntaxe : Code(Text) Renvoie l’entier correspondant au code ASCII du premier caractère d’une chaîne. Exemple de code Si la cellule A2 contient la chaîne alphanumérique "ABC123", la fonction Code(A2) renvoie 65.000, le code ASCII pour "A".
Concatenate | Syntaxe : Concatenate(Arg1, [Arg2, Arg3, ...]) Renvoie la concaténation de plusieurs chaînes de caractères alphanumériques. Les arguments numériques sont automatiquement convertis en texte. Remarque : Le capteur de vision In-Sight 2000-110/120/120C est uniquement capable de renvoyer des données de type Succès/échec en sortie, et la valeur renvoyée est convertie en 0 ou 1. Exemple de concaténation Si la cellule A2 contient la chaîne alphanumérique "A1B1", la cellule A3 contient la chaîne alphanumérique "C1D2" et la cellule A4 contient le nombre à virgule flottante 4,556, alors la fonction Concatenate(A2,A3,A4) renvoie "A1B1C1D24.556".
Exact | Syntaxe : Exact(texte1, texte2) Renvoie 1 si texte1 et texte2 sont identiques, sinon 0. Remarque : sensible à la casse. Exemples précis Si la cellule A2 contient la chaîne "ABC123" et la cellule A3 la chaîne "ABC1234", Exact(A2,A3) renvoie 0,000. Si la cellule A2 contient la chaîne de caractères "VISION" et la cellule A3 contient la chaîne de caractères "VISION", Exact(A2,A3) renvoie 1,000.
Find | Syntaxe : Find(TrouverTexte, TexteSource, [CarDébut]) Renvoie la position indexée de la chaîne Texte1 contenue dans la chaîne Texte2. La recherche de Texte1 démarre à la position spécifiée en option de CaracDépart dans Texte2. Remarque : sensible à la casse. Exemples de la fonction Find Si la cellule A2 contient la chaîne de caractères "123" et la cellule A3 contient la chaîne de caractères "ABC123", alors Find(A2,A3,2) renvoie la valeur d’index 3.000 (en commençant à zéro). La fonction Find(A2,A3,4) renvoie -1.000, car la chaîne entière "123" est introuvable dans la chaîne "ABC123" si la recherche commence à l’index 4.
Left | Syntaxe : Left(texte, n) Renvoie le nombre de caractères de gauche (NumChars) d’une chaîne de Texte. Exemple de la fonction Left Si la cellule A2 contient la chaîne alphanumérique "ABC123", la fonction Left(A2,2) renvoie la chaîne "AB".
Len | Syntaxe : Len(Text) Renvoie le nombre de caractères (en octets) d’une chaîne de texte. Exemple de la fonction Len Si la cellule A2 contient la chaîne alphanumérique "ABC123", la fonction Len(A2) renvoie la valeur entière 6.000.
Lower | Syntaxe : Lower(Texte) Renvoie le texte converti en minuscules. Exemple de la fonction Lower Si la cellule A2 contient la chaîne alphanumérique "ABC123", la fonction Lower(A2) renvoie la chaîne "abc123".
Mid | Syntaxe : Mid(Texte, CarDébut, NbCars) Renvoie le texte commençant à la position indexée CarDébut de la chaîne alphanumérique, pour le nombre de caractères spécifié par NbCars. Exemple de la fonction Mid Si la cellule A2 contient la chaîne alphanumérique "ABC123", la fonction Mid(A2,2,2) renvoie la chaîne "C1".
Replace | Syntaxe : Replace(textesource, n1, n2, nouveautexte) Renvoie le texte source, modifié par le nouveau texte à la position indexée n1. Exemple de la fonction Replace Si la cellule A2 contient la chaîne alphanumérique "ABC123" et que la cellule A3 contient la chaîne "123", Replace(A2,0,3,A3) renvoie la chaîne "123123".
Droite | Syntaxe : Right(texte, n) Renvoie le nombre de caractères de droite (n) d’une chaîne de caractères « texte ». Exemple de la fonction Right Si la cellule A2 contient la chaîne "ABC123", Right(A2,2) renvoie la chaîne "23".
Strcspn | Syntaxe : Strcspn(textesource, listecarac) Renvoie l’index du premier caractère du texte source qui se trouve également dans listecarac. Si aucun caractère de texte source n’est présent dans la liste de caractères, la fonction renvoie la longueur du texte source. Remarque : sensible à la casse. Exemple de Strcspn Si la cellule A2 contient la chaîne "BLUE" et que la cellule A3 contient les caractères "RED", Strcspn(A2,A3) renvoie une valeur d’index de 3,000 parce que ’E’ est le premier caractère de textesource qui se trouve dans listecarac.
Stringf | Syntaxe : Stringf(Chaîne-format, [Texte ou valeur, ...]) Renvoie une chaîne de caractères utilisant une chaîne de format standard "C". Conseil : La fonction FormatString prend en charge la plupart des paramètres des chaînes de format. Utilisez la boîte de dialogue FormatString pour configurer automatiquement les paramètres dans In-Sight Explorer. Remarque : Le capteur de vision In-Sight 2000-110/120/120C est uniquement capable de renvoyer des données de type Succès/échec en sortie, et la valeur renvoyée est convertie en 0 ou 1. La chaîne de format entrée doit être écrite entre guillemets (« ). Les paramètres de format-chaîne respectent la casse. Lorsque vous utilisez la fonction Stringf, la barre oblique "\" sert à indiquer qu’un caractère de commande de format suit. Si la barre oblique n’est pas suivie par un caractère de commande ("n", "r" ou "t"), elle est ignorée. Pour afficher une seule barre oblique, vous devez en saisir deux (Exemple : Stringf("C:\\InSight2\\") = "C:\InSight2\"). Les caractères ASCII non affichables/codes de contrôle seront affichés sous la forme d’un symbole ou de texte de remplissage sans signification. Les paramètres de format-chaîne sont :
%c | Renvoie le caractère ASCII correspondant à une valeur entière. Lorsqu’une chaîne de caractères alphanumériques est passée à la fonction, elle renvoie le premier caractère. Exemple Stringf %c Si la cellule A2 contient la valeur entière 65,000, alors Stringf("%c",A2) renvoie le caractère "A", qui est le caractère correspondant au code ASCII 65. La fonction Stringf("Valeur = %c",A2) renvoie la chaîne de caractères "Valeur = A". Si la cellule A2 contient la chaîne "123ABC", Stringf("%c",A2) renvoie le caractère "1".
%d | Renvoie une chaîne contenant une Valeur entière. Exemples Stringf %d Si la cellule A2 contient la valeur à virgule flottante 123,456, Stringf("%d",A2) renvoie la chaîne numérique "123". La fonction Stringf("Value = %d",A2) renvoie la chaîne alphanumérique "Valeur = 123". Si la cellule A2 contient la chaîne "ABC123", Stringf("%d",A2) renvoie la chaîne numérique "65", c’est-à-dire le code ASCII du caractère "A".
%e | Renvoie une chaîne de caractères contenant une valeur en notation scientifique. Le nombre de postes décimaux peut être spécifié en insérant une virgule décimale (,) et un nombre entre les paramètres % et e. Exemples Stringf %e Si la cellule A2 contient la valeur à virgule flottante 123,456, Stringf("%e",A2) renvoie la chaîne numérique "1,234560e+02". La fonction Stringf("%.1e",A2) renvoie la chaîne numérique "1.2e+02", car un seul chiffre après le point décimal est spécifié.
%f | Renvoie une chaîne contenant une Valeur à virgule flottante. Le nombre de postes décimaux peut être spécifié en insérant une virgule décimale (,) et un nombre entre les paramètres % et f. Exemples Stringf %f Si la cellule A2 contient la valeur à virgule flottante 123,456, Stringf("%f",A2) renvoie la chaîne numérique "123,456001". La fonction Stringf("%.1f",A2) renvoie la chaîne numérique "123.5", car un seul chiffre après la virgule est spécifié.
%H | Renvoie une chaîne contenant le nom d’hôte spécifique au capteur In-Sight. Exemple Stringf %H Si une cellule contient la fonction Stringf("Nom d’hôte : %H") sur un système In-Sight portant le nom d’hôte "is3k010203", la fonction renvoie la chaîne alphanumérique "Nom d’hôte : is3k010203".
%I | Renvoie une chaîne contenant l’adresse IP spécifique au capteur In-Sight. Exemple Stringf %I Si une cellule contient la fonction Stringf("Adresse IP : %I") sur un capteur In-Sight avec l’adresse IP "198.232.26.1", la fonction renvoie la chaîne alphanumérique "Adresse IP : 198.232.26.1".
%M | Renvoie une chaîne contenant l’adresse MAC spécifique au capteur In-Sight. L’adresse MAC est une adresse de matériel qui identifie un nœud spécifique dans un réseau. Chaque système de vision In-Sight a une adresse MAC unique qui lui est attribuée et qui ne peut être modifiée. Par exemple, 00-d0-24-01-02-03. Pour repérer l’adresse MAC d’un système de vision In-Sight, consultez l’étiquette du numéro de série présente sur le système de vision. Vous pouvez également ouvrir la boîte de dialogue À propos d’In-Sight Explorer. Exemple Stringf %M Si une cellule contient la fonction Stringf("Adresse MAC : %M") sur un capteur In-Sight dont l’adresse MAC est "00-d0-24-01-02-03", la fonction renvoie la chaîne alphanumérique "Adresse MAC : 00:d0:24:01:02:03".
%N | Renvoie une chaîne contenant le numéro de série spécifique du capteur In-Sight. Exemple Stringf %N Si une cellule contient la fonction Stringf("Numéro de série : %N") sur un capteur In-Sight dont le numéro de série est "Z01020304", la fonction renvoie la chaîne alphanumérique "Numéro de série : Z01020304".
%o | Renvoie une chaîne contenant la valeur octale pour un entier ou le premier caractère d’une chaîne alphanumérique. Exemples de Stringf %o Si la cellule A2 contient la valeur entière 123,000, Stringf("%o",A2) renvoie la chaîne numérique "173", la valeur octale de l’entier 123. Si la cellule A2 contient la chaîne "ABC123", Stringf("%o",A2) renvoie la chaîne numérique "101", la valeur octale du caractère "A".
%s | Renvoie une chaîne avec des caractères alphanumériques attachés. Exemples de Stringf %s Si la cellule A2 contient la chaîne "ABC", Stringf("%s123",A2) renvoie la chaîne alphanumérique "ABC123". Si la cellule A2 contient la chaîne numérique "123", Stringf("%s.450",A2) renvoie la chaîne numérique "123.450".
%T | Renvoie une chaîne avec le type de modèle spécifique du capteur In-Sight. Exemple de Stringf %T Si une cellule contient la fonction Stringf("Type de modèle : %T") sur un capteur In-Sight 5400, la fonction renvoie la chaîne alphanumérique "Type de modèle : 5400".
%u | Renvoie une chaîne de caractères contenant une valeur entière non signée. Exemples de Stringf %u Si la cellule A2 contient la valeur à virgule flottante 123,456, Stringf("%u",A2) renvoie la chaîne numérique "123". La fonction Stringf("Valeur = %u",A2) renvoie la chaîne alphanumérique "Valeur = 123". Si la cellule A2 contient la chaîne "ABC123", Stringf("%u",A2) renvoie la chaîne numérique "65", le code ASCII du caractère "A".
%V | Renvoie une chaîne contenant la version spécifique du micrologiciel du capteur In-Sight. Exemple de Stringf %V Si une cellule contient la fonction Stringf("Version du micrologiciel : %V") sur un capteur In-Sight qui exécute la version 3.40.01 du micrologiciel, la fonction renvoie la chaîne alphanumérique "Version du micrologiciel : 3.40.01 (475)".
%x ou %X | Renvoie une chaîne contenant la valeur hexadécimale pour un entier ou le premier caractère d’une chaîne alphanumérique. Exemples de Stringf %x Si la cellule A2 contient l’entier 123,000, Stringf("%x",A2) renvoie la chaîne "7b", la valeur hexadécimale de l’entier 123. Si la cellule A2 contient la chaîne "ABC123", Stringf("%x",A2) renvoie la chaîne numérique "41", la valeur hexadécimale du caractère "A".
Les paramètres de chaîne de format suivants sont principalement utilisés pour la mise en forme du texte. Par exemple, la mise en forme du texte d’un message électronique dans la fonction WriteSMTP :
\x## | Insère le caractère ASCII spécifié par le nombre hexadécimal ## dans le texte. Exemple de Stringf \x## Si la cellule A2 contient Stringf("\x02123\x1bABC\x03456"), alors la cellule affichera : ("<STX>123<ESC>ABC<ETX>456 ").
\n | Insère un saut de ligne dans le texte. Ce paramètre est généralement utilisé en conjonction avec \r (retour chariot).
\r | Insère un retour chariot dans le texte. Ce paramètre est généralement utilisé en conjonction avec \n (saut de ligne).
\t | Insère une tabulation dans le texte.
Strspn | Syntaxe : Strspn(textesource, listecarac) Renvoie l’index du premier caractère du texte source qui ne se trouve pas dans ListeCar. Si tous les caractères du texte source sont présents dans la liste de caractères, la fonction renvoie la longueur du texte source. Remarque : sensible à la casse. Exemple de Strspn Si la cellule A2 contient la chaîne de caractères "RED" et la cellule A3 contient les caractères "GREEN", Strspn(A2,A3) renvoie une valeur d’index (à partir de zéro) de 2,000, car "D" est le premier caractère de textesource qui ne se trouve pas dans listecarac.
Strtol | Syntaxe : Strtol(EntierTexte) Convertit les caractères numériques (décimaux, hexadécimaux et octaux) situés au début d’une chaîne alphanumérique en nombre entier. Les caractères hexadécimaux doivent commencer par 0x, et les caractères octaux par 0. Exemples de Strtol Décimaux : Si la cellule A2 contient la chaîne de texte "123ABC", la fonction Strtol(A2) renvoie la valeur entière 123,000. Hexadécimaux : Si la cellule A2 contient la chaîne de texte "0x123", Strtol(A2) renvoie la valeur entière 291,000. "0x12AB" = 4 779,000, puisque "A" et "B" sont des caractères hexadécimaux. "0x12GB" = 18,000, puisque "G" n’est pas un caractère hexadécimal. Octaux : Si la cellule A2 contient la chaîne de texte "0123ABC", Strtol(A2) renvoie la valeur entière 83,000.
Substitute | Syntaxe : Substitute(textesource, ancientexte, nouveautexte, [Instance]) Renvoie une chaîne de texte construite en substituant le nouveau texte pour chaque occurrence de l’ancien texte dans le texte source. Si un index d’Instance en option est spécifié, seule cette instance du texte sera remplacée. Exemple de la fonction Substitute Si la cellule A2 contient la chaîne de caractères "ABC123123", la cellule A3 contient la chaîne "123" et la cellule A4 contient la chaîne "abc", puis Substitute(A2,A3,A4,1) remplace la seconde instance de "123" dans le nouveau texte et renvoie la chaîne "ABC123abc".
Token | Syntaxe : Token(texte, caraclimite, n) Renvoie le texte situé à l’index d’Instance spécifié (occurrence) d’une chaîne délimitée. Le délimiteur elt2 doit être inscrit entre guillemets (") dans la fonction. Exemple de Token Si la cellule A2 contient la chaîne délimitée par virgules "A,B,C,1,2,3", Token(A2,",",2) renvoie "C", car C est à l’index 2 dans le texte.
Trim | Syntaxe : Trim(Text) Renvoie le texte débarrassé des espaces à gauche et de fin, ce qui laisse un espace unique entre les mots (le cas échéant). Tous les caractères de commande (retour chariot, saut de ligne, etc.) sont également retirés. Exemple de la fonction Trim Si la cellule A2 contient la chaîne " ABC 123 ", Trim(A2) renvoie la chaîne "ABC 123".
Upper | Syntaxe : Upper(Text) Renvoie le texte converti en majuscules. Exemple de la fonction Upper Si la cellule A2 contient la chaîne alphanumérique "abc123", la fonction Upper(A2) renvoie la chaîne "ABC123".
Value | Syntaxe : Value(NumericText) Renvoie la valeur de virgule flottante du texte numérique. Tous les caractères non-numériques qui suivent sont ignorés. Exemple de Value Si la cellule A2 contient la chaîne numérique "123,4", la fonction Valeur(A2) renvoie la valeur à virgule flottante 123,400. Remarque : Une cellule In-Sight vous permet d’entrer une valeur numérique de 7 chiffres maximum. Si la fonction Value fait référence à un texte numérique comportant plus de 8 chiffres, sa valeur risque d’être inexacte en raison des limitations du type de données à virgule flottante. Par exemple : A2 = '68456668 A3 = Value(A2) Dans ce cas, la fonction renvoie 68456672.000.
Fonctions Vision Data Access (VDA) | AutoLearnClassify | GetClassLabel | Syntaxe : GetClassLabel (Structure, [Index], [Modèle]) Pour utiliser cette fonction, ajoutez des classes, puis ajoutez des images à chacune des classes. Remarque : Veillez à utiliser le mot-clé « Acquis(e)(s) » pour spécifier l’image actuelle. GetClassLabel renvoie la chaîne de caractères associée à chaque classe.
GetModelHealth | Syntaxe : GetModelHealth(Structure) Pour utiliser cette fonction, ajoutez des classes, puis ajoutez des images à chacune des classes. Remarque : Veillez à utiliser le mot-clé « Acquis(e)(s) » pour spécifier l’image actuelle. GetModelHealth renvoie un nombre (0 à 100) représentant l’intégrité du modèle, qui représente la probabilité que le modèle soit correct.
GetNClasses | Syntaxe : GetNClasses(Structure) Pour utiliser cette fonction, ajoutez des classes, puis ajoutez des images à chacune des classes. Remarque : Veillez à utiliser le mot-clé « Acquis(e)(s) » pour spécifier l’image actuelle. GetNClasses renvoie le nombre de classes.
GetNImages | Syntaxe : GetNImages(Structure, [Index], [Modèle]) Pour utiliser cette fonction, ajoutez des classes, puis ajoutez des images à chacune des classes. Remarque : Veillez à utiliser le mot-clé « Acquis(e)(s) » pour spécifier l’image actuelle. GetNImages renvoie le nombre d’images dans chaque classe.
Blobs | GetAngle | Syntaxe : GetAngle(Blob, Index) Renvoie l’angle du centre de gravité d’un objet blob, par rapport au centre de la région d’intérêt (ROI), qui définit la zone de l’image à inspecter. Le centre de gravité d’un objet blob représente son point d’équilibre. Si une feuille d’un matériau uniforme est découpée sous la forme prise par cet objet blob, le point d’équilibre physique de ce blob est ce qu’on appelle le centre de gravité. Remarquez que le centre de gravité d’un objet blob ne se trouve pas systématiquement à l’intérieur du blob. Par exemple, supposons que la région noire représentée dans l’image suivante est un blob identifié par la fonction ExtractBlobs. Le point rouge représente le centre de gravité du blob. Les coordonnées x et y du centre de gravité sont renvoyées respectivement par les fonctions d’accès aux données de vision GetX et GetY.
GetArea | Syntaxe : GetArea(Blob, Index) Renvoie la surface (en pixels) d’un blob. La surface du blob est calculée en comptant le nombre de pixels inclus dans le blob. Par exemple, prenons le blob représenté (en vue agrandie) sur l’image suivante : En comptant les pixels, nous pouvons voir que la surface de ce blob est de 8 pixels.
GetHeight | Syntaxe : GetHeight(Blobs, Index) Renvoie la hauteur du blob indexé.
CircleFit | GetDistance | Syntaxe : GetDistance(CircleFit, Index) Renvoie la distance entre le point indexé et le cercle. Si la valeur est négative, le point est à l’intérieur du cercle. Si le point indexé est non valide, un #ERR est renvoyé.
GetMaxDist | Syntaxe : GetMaxDist(CircleFit) Renvoie la distance entre le cercle et le point le plus éloigné du cercle. Si la valeur est négative, le point est à l’intérieur du cercle.
GetMaxDistIndex | Syntaxe : GetMaxDistIndex(CircleFit) Renvoie l’index du point le plus éloigné du cercle.
GetNPointsUsed | Syntaxe : GetNPointsUsed(CircleFit) Renvoie le nombre de points utilisés pour ajuster le cercle.
GetRadius | Syntaxe : GetRadius(CircleFit) Renvoie le rayon du cercle.
GetSigma | Syntaxe : GetSigma(CircleFit) Renvoie la racine carrée de la somme des carrés des distances entre les points et le cercle, divisée par le nombre de points.
Stockage de données datées | GetCount | Syntaxe : GetCount(Delay) Renvoie la valeur Count d’une structure Delay.
GetErrorCount | Syntaxe : GetErrorCount(Compte) Renvoie le nombre incrémentiel d’erreurs à partir d’une structure Count. Le compteur est incrémenté lorsque la valeur renvoyée est inférieure à zéro.
GetFailCount | Syntaxe : GetFailCount(Compte) Renvoie le compte incrémentiel d’échecs à partir d’une structure Count. Le compteur est incrémenté lorsque la valeur renvoyée est égale à zéro.
GetPassCount | Syntaxe : GetPassCount(Compte) Renvoie le compte incrémentiel de réussites/succès à partir d’une structure Count. Le compteur est incrémenté lorsque la valeur renvoyée est supérieure à zéro.
GetTotalCount | Syntaxe : GetTotalCount(Compte) Renvoie le nombre total de succès, d’échecs et d’erreurs à partir d’une structure Count.
Couleur | GetActiveMatchClrColorName | Syntaxe : GetActiveMatchClrColorName(Couleurs, Index) Renvoie le nom de la couleur active indexée pour une fonction MatchColor.
GetBlue | Syntaxe : GetBlue(Couleurs) Renvoie la composante bleue de la couleur moyenne dans la région d’intérêt (ROI) pour une fonction MatchColor.
GetColorLibraryName | Syntaxe : GetColorLibraryName(Structure de couleur) Fonctionne avec TrainExtractColor, TrainMatchColor, ExtractColor et MatchColor. Pour les fonctions TrainExtractColor et TrainMatchColor, renvoie le nom de la bibliothèque de couleurs stockée par la fonction. Pour les fonctions ExtractColor et MatchColor, renvoie le nom de la fonction d’apprentissage Train référencée (par exemple, TrainExtractColor ou TrainMatchColor, respectivement).
GetConfidenceScore | Syntaxe : GetConfidenceScore(Couleurs) Renvoie le score de confiance de l’inspection actuelle pour une fonction MatchColor. Le score de confiance = ( s1 * (M - s2) - s2 * (M - s1)) / ( (M - s2) + (M - s1)) ; où s1 est le meilleur score, s2 est le deuxième meilleur score, M est une constante égale à 1,01. Plus le score de confiance est élevé, plus il est probable que la meilleure correspondance a été sélectionnée.
GetGreen | Syntaxe : GetGreen(Couleurs) Renvoie la composante verte de la couleur moyenne dans la ROI pour une fonction MatchColor.
GetHue | Syntaxe : GetHue(Couleurs) Renvoie la composante de teinte de la couleur moyenne dans la ROI pour une fonction MatchColor.
GetIntensity | Syntaxe : GetIntensity(Couleurs) Renvoie la composante d’intensité de la couleur moyenne dans la ROI pour une fonction MatchColor.
GetMatchClrColorByRank | Syntaxe : GetMatchClrColorByRank(Couleurs, Rang) Renvoie l’index de la couleur qui correspond au rang (0 à n-1) pour une fonction MatchColor. La couleur de rang 0 possède le score le plus élevé.
GetMatchClrColorState | Syntaxe : GetMatchClrColorState(Couleurs, NomCouleur) Renvoie l’état de la couleur spécifiée pour une fonction MatchColor.
GetMatchClrDistByIndex | Syntaxe : GetMatchClrDistByIndex(Couleurs, Index) Renvoie la distance de la couleur indexée pour une fonction MatchColor.
GetMatchClrDistByName | Syntaxe : GetMatchClrDistByName(Couleurs, Nom) Renvoie la distance de la couleur nommée pour une fonction MatchColor.
GetMatchClrScoreByIndex | Syntaxe : GetMatchClrScoreByIndex(Couleurs, Index) Renvoie le score de la couleur indexée pour une fonction MatchColor.
GetMatchClrScoreByName | Syntaxe : GetMatchClrScoreByName(Couleurs, Nom) Renvoie le score de la couleur nommée pour une fonction MatchColor.
GetNActiveMatchClrColors | Syntaxe : GetNActiveMatchClrColors(MatchColorLib) Renvoie le nombre de couleurs référencées qui sont actives dans la fonction MatchColor référencée.
GetNTrainMatchClrColors | Syntaxe : GetNTrainMatchClrColors(MatchColorLib) Renvoie le nombre de couleurs stockées par la fonction TrainMatchColor.
GetRed | Syntaxe : GetRed(Couleurs) Renvoie la composante rouge de la couleur moyenne dans la ROI pour une fonction MatchColor.
GetSaturation | Syntaxe : GetSaturation(Couleurs) Renvoie la composante de saturation de la couleur moyenne dans la ROI pour une fonction MatchColor.
GetTrainMatchClrColorName | Syntaxe : GetTrainMatchClrColorName(MatchColorLib, Index) Renvoie le nom de la couleur stockée indexée pour une fonction MatchColor.
SetMatchClrColorState | Syntaxe : SetMatchClrColorState(Couleurs, Activer, NomCouleur1, [NomCouleur2,...]) Renvoie le nombre de couleurs activées ou désactivées pour une fonction MatchColor. L’état des cellules de cette fonction est désactivé lorsqu’elle est insérée pour la première fois dans la feuille de calcul ; elle doit être activée conditionnellement par une fonction Button.
Contrôles | GetString | Syntaxe : GetString(ListBox) Renvoie la chaîne de caractères. Si une cellule contenant la fonction ListBox est référencée, la chaîne de caractères qui est actuellement sélectionnée dans la liste est renvoyée.
Dist | GetDistance | Syntaxe : GetDistance(Dist) Renvoie la valeur de la distance.
GetErrorCode | Syntaxe : GetErrorCode(Structure) GetErrorCode est une fonction d’accès aux données de vision qui renvoie un code de diagnostic pour la plupart des structures et fonctions. Remarque : Si aucun code d’erreur n’est disponible pour #ERR, GetErrorCode renvoie -1.
GetErrorString | Syntaxe : GetErrorString(Structure) GetErrorString est une fonction de Résultats de vision qui renvoie des informations de diagnostic de la plupart des structures et fonctions.
GetValue | Syntaxe : GetValue(Structure,[Index],[Couleur]) Où la structure est une référence à une cellule contenant une structure de données ColorHist, Delay ou Hist. Index spécifie éventuellement le fichier depuis lequel compter les valeurs d’histrogramme (ColorHist et Hist uniquement). En option, couleur détermine la composante de couleur utilisée pour extraire les données d’histogramme (ColorHist uniquement). GetValue est une fonction de Résultats de vision qui renvoie des informations sur les structures suivantes : ColorHist. Delay. Hist
Entrée/sortie | GetClock | Syntaxe : GetClock(Heure, Chaîne de format, [Local/GMT]) Renvoie la date et l’heure actuelles sous la forme d’une chaîne de caractères construite depuis une chaîne de format standard de la bibliothèque "C" à partir d’une structure de données Time, qui est renvoyée par la fonction Now.
Chaîne de format | Détermine le format d’affichage de la date et de l’heure. La chaîne de format par défaut est : mois/jour/année heure:minute:seconde, ce qui est représenté par : %m/%d/%Y %H:%M:%S Les variables suivantes sont autorisées :
%m | mois
%d | jour
%Y | année
%H | heure
%M | minute
%S | seconde
%3N | milliseconde
%6N | microseconde
%9N | nanoseconde
Local/GMT | 0 = Local avec heure d’été (par défaut) 1 = GMT (UTC) 2 = Local avec heure standard
Inspecter la transition | GetWidth | Syntaxe : GetWidth(InspectEdgeWidth, Index du caliper) Renvoie la valeur de la largeur du bord dans le caliper indexé ; renvoie 0 si aucun bord n’est trouvé dans le caliper indexé.
Linefit | GetChi2 | Syntaxe : GetChi2(LineFit) Renvoie la somme des carrés des distances entre les points et la ligne.
GetDistance | Syntaxe : GetDistance(LineFit, Index) Renvoie la distance entre le point indexé et la ligne.
GetMaxDist | Syntaxe : GetMaxDist(LineFit) Renvoie le point le plus éloigné de la ligne.
GetMaxDistIndex | Syntaxe : GetMaxDistIndex(LineFit) Renvoie l’index du point le plus éloigné de la ligne.
GetNPointUsed | Syntaxe : GetNPointUsed(LineFit) Renvoie le nombre de points utilisés pour calculer la ligne.
GetX | Syntaxe : GetX(Structure, [Index1], [Index2]) Renvoie une coordonnée X.
GetY | Syntaxe : GetY(Structure, [Index1], [Index2]) Renvoie une coordonnée Y.
Écriture de script | Get | Syntaxe : Get(Script/Get,Propriété d’objet et/ou Tableau,[Index de tableau]) Renvoie les propriétés des tableaux et/ou des objets générés par une fonction Script ou une autre fonction Get. Remarque : Cette fonction est disponible uniquement sur les systèmes de vision In-Sight exécutant le micrologiciel In-Sight 5.1.0 et versions ultérieures. #### Présentation La fonction Get permet d’accéder aux propriétés des objets renvoyés par une fonction Script. Elle requiert au minimum deux arguments : une référence à une fonction Script, ou une autre fonction Get qui renvoie un objet ou un tableau ; et soit une chaîne de caractères qui désigne la propriété d’un objet, soit un chemin séparé par des points vers la propriété d’un sous-objet. Un troisième argument en option peut être spécifié pour accéder à un index de tableau basé sur zéro, lorsqu’un tableau est référencé. La valeur renvoyée par la fonction Get est la valeur de la propriété (ou de l’élément de tableau indexé), et peut prendre l’un des types suivants : Un nombre Vrai (1) ou faux (0) Une chaîne de caractères Une structure de données binaires Une structure de données Blobs, Edges, Hist, IDMax ou Patterns. Un objet de forme. Une structure de données de type objet ou tableau Remarque : La fonction Get ne prend pas en charge le renvoi d’une valeur nulle ou non définie. #### Exemple d’appel de fonction Get Dans cet exemple, dans la cellule B3 une fonction Script possède une méthode d’exécution qui renvoie un objet :
    Tool.prototype.run = function(n) {
      this.updateStats(n);
      return {
        total: this._total;
    	stats: {
    	  avg: this._avg,
    	  range: {
    	    max: this._max,
    	    min: this._min
    	  },
    	  values: this._valueArray
    	}
       };
    };
Les fonctions Get suivantes renvoient des nombres simples (en supposant que les valeurs renvoyées sont numériques) : Get(B3, "total") Get(B3, "stats.avg") Get(B3, "stats.range.max") Get(B3, "stats.range.min") La fonction Get suivante renvoie le sous-objet "range", qui peut être transmis à une autre fonction Script ou Get : Get(B3, "stats.range") La fonction Get suivante renvoie l’élément 37 du tableau de valeurs : Get(B3, "stats.values", 37) #### Entrées
Paramètre | Description
--- | ---
Script/Get | Spécifie une référence à une fonction Script ou à une autre fonction Get qui renvoie une structure de données d’objet ou de tableau.
Propriété et/ou tableau d’objets | Spécifie une référence à la propriété d’une structure de données Object, soit sous la forme d’une chaîne de caractères (le nom de la propriété) ou d’un chemin d’accès séparé par des points vers la propriété d’un sous-objet ; ou d’une structure de données Array.
[Index du tableau] | Spécifie un argument facultatif pour l’index d’un tableau lorsqu’une structure de données tableau (Array) est référencée.
#### Sorties
Renvoie | La fonction renvoie la valeur de la propriété (ou de l’élément de tableau indexé), et peut renvoyer l’un des types suivants : Un nombre Vrai (1) ou faux (0) Une chaîne de caractères Une structure de données binaires Une structure de données Blobs, Edges, Hist, IDMax ou Patterns. Un objet de forme. Une structure de données de type objet ou tableau
Remarque : À partir d’une fonction Script, la fonction ne renvoie pas les éléments suivants : null, undefined ou pas d’instruction "return" (même traitement qu’un objet vide).
Statistiques | GetLatest | Syntaxe : GetLatest(Stats) Renvoie la valeur la plus récente utilisée pour calculer les statistiques.
GetMax | Syntaxe : GetMax(Stats) Renvoie la plus grande valeur utilisée pour calculer les statistiques.
GetMean | Syntaxe : GetMean(Stats) Renvoie la moyenne des valeurs.
GetMin | Syntaxe : GetMin(Stats) Renvoie la plus petite valeur utilisée pour calculer les statistiques.
GetErrorCount | Syntaxe : GetErrorCount(Stats) Renvoie le nombre total d’erreurs de la valeur référencée.
GetNumSamples | Syntaxe : GetNumSamples(Stats) Renvoie le nombre total d’échantillons utilisés pour les calculs.
GetRange | Syntaxe : GetRange(Stats) Renvoie la plage entre les valeurs minimum et maximum.
GetSDev | Syntaxe : GetSDev(Stats) Renvoie l’écart type des valeurs.
GetSum | Syntaxe : GetSum(Stats) Renvoie la somme des valeurs.
GetVariance | Syntaxe : GetVariance(Stats) Renvoie la variance des valeurs.
Structures Remarque : L’argument Structure des fonctions suivantes doit être une référence à la structure de données renvoyée par une fonction Annulus, Circle, Cross, Fixture, Line, Mask, Point ou Region. Les structures valides pour chacune des fonctions sont indiquées dans la description. | GetCurve | Syntaxe : GetCurve(Structure) Renvoie la valeur Courbure de la structure Region indexée.
GetNPoints | Syntaxe : GetNPoints(Structure) GetNPoints fonctionne avec les polygones et renvoie le nombre de points.
Timer | GetAllTime | Syntaxe : GetAllTime(Image) Renvoie la durée, en millisecondes, d’acquisition de l’image et d’exécution du projet, ou #ERR si la valeur d’entrée n’est pas valide. Remarque : Cet argument doit utiliser le mot-clé Acquis(e)(s), qui représente l’image acquise la plus récente. La valeur GetAllTime renvoyée ne comprend pas la durée d’exécution de la séquence vidéo du capteur. La fonction GetAllTime et la barre d’état calculent les durées de façon différente de la boîte de dialogue Journal. La boîte de dialogue Journal permet également d’élaborer des graphiques de résultats. Lorsque cette fonction est utilisée dans une formule, différentes valeurs sont renvoyées en fonction de l’emplacement de cette cellule. Par exemple, lorsque GetAllTime(A0) est égal à 80, 1*GetAllTime(A0) doit également être égal à 80. Cependant, si la cellule contenant 1*GetAllTime(A0) se trouve au début du projet, elle renvoie presque la même valeur que GetTime(A0), qui n’inclut pas la durée d’exécution des autres outils. Si 1*GetAllTime(A0) se trouve à la fin du projet, elle contient la durée d’exécution de la totalité du projet. Pour renvoyer la valeur correcte, créez une cellule distincte uniquement pour GetAllTime(A0) et utilisez une référence de cellule à celle-ci dans la formule. Par exemple, si vous créez un GetAllTime(A0) dans la cellule B2, 1*B2 renverra la valeur correcte, quel que soit l’emplacement de la cellule. Lorsque le paramètre Connexions maximales à l’interface utilisateur de la boîte de dialogue Paramètres IHM est R2GL2 sur 2 ou plus, la valeur GetAllTime renvoyée par les systèmes de vision utilisant le micrologiciel In-Sight 5.x.x est supérieure que celle des systèmes de vision utilisant le micrologiciel In-Sight 4.x.x. En plus de la durée d’exécution de l’image et du projet, la valeur GetAllTime renvoyée par les systèmes de vision exécutant le micrologiciel In-Sight 5.x.x comprend le temps de mise à jour des différentes vues, alors que sur les systèmes de vision exécutant le micrologiciel In-Sight 4.x.x cette valeur n’est pas incluse.
GetTime | Syntaxe : GetTime(Cellule1, [Cellule2, ...]) Renvoie la durée, en millisecondes, d’exécution d’une liste de cellules de longueur variable, ou #ERR si la valeur d’entrée n’est pas valide. Si plusieurs cellules sont sélectionnées, la somme de toutes les durées d’exécution est renvoyée.