# Vision Data Access functions IDMax

Cette rubrique répertorie les Vision Data Access functions qui renvoient des valeurs provenant d’une structure Vision Data Access functions IDMax.

Remarque : Toutes les valeurs renvoyées proviennent d’une structure IDMax référencée, insérée dans la feuille de calcul au moment de la création de la fonction ReadIDMax. L’Index, en option, peut faire référence à une chaîne indexée du tableau de résultats de la fonction ReadIDMax.

Fonction | Description
--- | ---
GetAngle(IDMax,[Index]) | Renvoie l’angle d’un symbole. Remarque : La case Vérifier dans ReadIDMax doit être cochée.
GetCodeName(IDMax,[Index]) | Renvoie le nom du type de code. Il s’agit du même nom de code que celui affiché dans la Feuille de propriétés ReadIDMax.
GetCodeType(IDMax,[Index]) | Renvoie le type de code.
Type de code | Nom de code correspondant
--- | ---
1 | Code 128
0 | Code 39
3/4 | UPC/EAN
11 | Code 93
12 | Codabar
128 | Data Matrix
129 | Code QR
132 | PDF 417
GetColor(IDMax,[Index]) | Renvoie la valeur (0 = noir, 1 = blanc) de la couleur de premier plan pour un symbole Data Matrix, QR Code ou PDF 417.
GetDecoded(Structure,Index) | Indique si le code indexé par ID est détecté. Renvoie 0,0 que le code est introuvable, ou 1,0 s’il a été trouvé.
GetErrorCode(IDMax,[Index]) | Renvoie un code d’erreur pour chaque chaîne d’informations en cas d’échec de la fonction. Remarque : Les chaînes d’erreur sont insérées dans la feuille de calcul à l’aide de la fonction GetErrorString.
Code de diagnostic | Chaîne d’informations correspondante
--- | ---
00010000 | Erreur de traitement vision.
00010001 | Mémoire image invalide.
00010001 | La région d’entrée est trop petite.
00010002 | La région d’entrée sort des frontières de l’image.
00019000 | Erreur de traitement vision IDMax.
04010000 | Erreur ReadCompositeCode.
04010001 | Impossible de détecter les informations du code 2D.
04010002 | Trop de composantes 2D invalides dans les données image.
04010003 | Impossible de détecter la version du code 2D.
04010004 | Impossible de compléter les informations manquantes du code 2D.
04010005 | Détection de données image invalides dans la zone de lecture.
04010006 | La zone de lecture sort des frontières de l’image.
04010007 | Impossible de détecter les informations du code 1D.
04010008 | Trop de composantes 1D invalides dans les données image.
04010009 | Aucun symbole composite valide n’a été trouvé. Remarque : Pour tous les autres symboles, 04020001 est renvoyé.
04010010 | Trop d’erreurs de codes pour corriger.
04010011 | Echec de la correction d’erreur.
04010012 | Les codes 1D et 2D peuvent être décodés séparément, mais ne sont pas corrélés.
04010013 | Le calcul automatique du seuil de contrast n’a pas fonctionné.
04010014 | La sensibilité au contraste exède la plage autorisée.
04010015 | Les paramètres de lecture dépassent la valeur autorisée.
04020000 | Erreur ReadIDMax.
04020001 | Aucun code valide trouvé.
04020002 | Impossible de lire le code.
GetErrorString(IDMax,[Index]) | Renvoie des informations de diagnostic en cas d’échec du décodage du symbole. Remarque : La fonction d’accès aux données de vision GetErrorString peut être utilisée pour extraire la liste d’erreurs suivante de la structure de données renvoyée par une fonction ReadIDMax. Erreur système. Mémoire d’empilement insuffisante. Erreur de traitement vision. Mémoire tampon d’image non valide. Taille de région non valide. La région dépasse les limites de l’image. Erreur ReadIDMax. Erreur ReadIDCode. Impossible de détecter les modèles d’adresse de ligne. Limite de mémoire des modèles d’adresse de ligne (RAP) dépassée. Impossible de détecter la version du symbole CC-A. Impossible de remplir les points RAP manquants. Ligne de balayage non valide détectée. La zone de lecture sort des frontières de l’image. Impossible de détecter les modèles de demi-valeur. Limite de mémoire de demi-valeur dépassée. Aucun code valide trouvé. Trop d’erreurs de codes pour corriger. Echec de la correction d’erreur Reed Solomon. Le calcul automatique du seuil de contrast n’a pas fonctionné. La sensibilité au contraste exède la plage autorisée.
GetFormat(IDMax,[Index]) | Renvoie la valeur représentant le format d’un symbole 2D à la fonction ReadIDMax. Consultez la rubrique Valeurs GetFormat.
GetFound(IDMax, Index) | Indique si le code indexé par ID est détecté ; 0.0 pour introuvable ou 1.0 pour détecté.
GetGridCols(IDMax,[Index]) | Renvoie le nombre de colonnes contenues dans un symbole 2D.
GetGridRows(IDMax,[Index]) | Renvoie le nombre de lignes contenues dans un symbole 2D.
GetGrowth(IDMax,[Index]) | Renvoie le résultat du test de taille d’impression d’un symbole 2D. Les grossissements de l’impression dans les dimensions horizontales et verticales sont calculés indépendamment et le score le plus faible est renvoyé. Ce test indique si les cellules du symbole varient en taille. Par exemple, il n’est pas rare que certaines méthodes de marquage provoquent un agrandissement des cellules, ce qui les déplace du côté gauche du symbole vers le côté droit. Un symbole de haute qualité présente peu ou pas de changement de taille. Le test de changement de taille est souvent lié directement au test de non-uniformité, car cette non-uniformité provoque des symboles de proportion incorrecte. Grade A (4.0) ≥ -0,50 et ≤ 0,50 Grade B (3.0) ≥ -0,70 et ≤ 0,70 Grade C (2.0) ≥ -0,85 et ≤ 0,85 Grade D (1.0) ≥ -1,00 et ≤ 1,00 Grade F (0.0) < -1,00 ou > 1,00 Remarque : La case Vérifier dans ReadIDMax doit être cochée.
GetHeight(IDMax,[Index]) | Renvoie la hauteur du symbole. Remarque : La case Vérifier dans ReadIDMax doit être cochée.
GetLearned(IDMax,[Index]) | Renvoie « 1 » si le modèle du symbole a été entraîné avec succès et « 0 » si le modèle n’est pas entraîné. Index = 0 pour DataMatrix, 1 pour QR, 2 pour 1D. Index valide uniquement lorsqu’il est utilisé avec ReadIDMax.
GetLearnedGridCol(IDMax,[Index]) | Renvoie le nombre de colonnes dans un d’un symbole QR Code ou Data Matrix appris.
GetLearnedGridRow(IDMax,[Index]) | Renvoie le nombre de lignes dans un d’un symbole QR Code ou Data Matrix appris.
GetLearnedSymbology(IDMax) | Renvoie une chaîne contenant la symbologie 1D actuellement apprise dans ReadIDMax.
GetMirror(IDMax,[Index]) | Renvoie l’état de Miroir (0 = pas de miroir, 1 = miroir) du symbole Data Matrix ou QR Code.
GetModuleSize(IDMax,[Index]) | Renvoie la taille du module 2D.
GetNumResults(IDMax) | Renvoie le nombre de résultats trouvés et décodés.
GetRawStream(IDMax,[Index]) | Renvoie le flux de données non décodé du symbole lu d’un symbole Code 128.
GetResolution(IDMax,[Index]) | Pour les symboles 2D, la taille moyenne, en pixels, des cellules est renvoyée. Bien qu’il ne s’agisse pas d’un test de vérification de qualité à proprement parler, la Résolution mesure la taille moyenne en pixels d’un élément (ou cellule) dans un symbole. Chaque type de symbole possède une spécification de Résolution minimale : Matrice de données : 4 pixels par élément Code QR : 4 pixels par élément PDF 417 : 3 pixels par élément
GetString(IDMax,[Index]) | Renvoie la chaîne du résultat indexé, ou du résultat 0, si [Index] n’est pas fourni. Remarque : Si la chaîne contient NULL (0x00), la fonction remplace automatiquement le caractère par « <NUL> ».
GetStringIDMax(IDMax,TranslationMode,[Index]) | Renvoie la chaîne du résultat indexé, en fonction du mode de transposition sélectionné (0, 1 ou 2 ; par défaut = 0) , qui indique comment la fonction traite les caractères ASCII non affichables. Lorsque le mode de transposition est défini sur 0, la fonction remplace le caractère ASCII 0x00 par<NUL>. Lorsque le mode de transposition est défini sur 1, la fonction traduit tous les caractères ASCII non affichables (0-31, 127-255), à l’aide du tableau suivant :
0x00 | "<NUL>"
0x01 | "<SOH>"
0x02 | "<STX>"
0x03 | "<ETX>"
0x04 | "<EOT>"
0x05 | "<ENQ>"
0x06 | "<ACK>"
0x07 | "<BEL>"
0x08 | "<BS>"
0x09 | "<HT>"
0x0a | "<LF>"
0x0b | "<VT>"
0x0c | "<FF>"
0x0d | "<CR>"
0x0e | "<SO>"
0x0f | "<SI>"
0x10 | "<DLE>"
0x11 | "<DC1>"
0x12 | "<DC2>"
0x13 | "<DC3>"
0x14 | "<DC4>"
0x15 | "<NAK>"
0x16 | "<SYN>"
0x17 | "<ETB>"
0x18 | "<CAN>"
0x19 | "<EM>"
0x1a | "<SUB>"
0x1b | "<ESC>"
0x1c | "<FS>"
0x1d | "<GS>"
0x1e | "<RS>"
0x1f | "<US>"
0x7f | "<DEL>"
Remarque : Les caractères ASCII non affichables qui ne sont pas répertoriés dans le tableau sont traduits par « <X> », avec X étant leur valeur décimale.
Lorsque le mode de transposition est défini sur 2, la fonction traduit tous les caractères ASCII non affichables, à l’exception de CR (0x0d) et de LF (0x0a).
GetSymbologyIdentifier(IDMax,[Index]) | Renvoie le type du symbole, sous la forme d’un code à trois caractères, basé sur la spécification ISO 15424.
GetWidth(IDMax,[Index]) | Renvoie la largeur du symbole. Remarque : La case Vérifier dans ReadIDMax doit être cochée.
GetX(IDMax, [Index1], [Index2]) | Renvoie une abscisse (x). Pour ReadIDMax, Index2 spécifie le coin du symbole.
GetY(Structure, [Index1], [Index2]) | Renvoie une ordonnée (y). Pour ReadIDMax, Index2 spécifie le coin du symbole.
SetSymbolMinStringLength(IDMax,Symbiologie,LongMin) | Définit la longueur de chaîne minimale de la symbologie spécifiée pour la structure IDMax référencée.
IDMax | ReadIDMax(Image, Repère, Région, ...) Lit, et vérifie en option, des chaînes de caractères alphanumériques contenues dans des codes barres et symbologies 1D et 2D. Renvoie une structure IDCode affichant les caractères lus.
Symbologie | La symbologie spécifiée [uniquement Interleaved 2 of 5(73)]
LongMin | Longueur minimale de la chaîne, entier, max = 80.