# IDMax Vision Data Access functions

Dieses Thema führt die Vision Data Access functions auf, die Werte aus einer IDMax Vision Data Access functions-Struktur zurückgeben.

Hinweis: Alle zurückgegebene Werte stammen aus einer referenzierten IDMax-Datenstruktur, die bei der Erstellung der ReadIDMax-Funktion in die Tabelle eingefügt wird. Der optionale Index kann eine indizierte Zeichenfolge aus der ReadIDMax-Funktion Ergebnistabelle referenzieren.

Funktion | Beschreibung
--- | ---
GetAngle(IDMax,[Index]) | Gibt den Winkel eines Symbols zurück. Hinweis: Das Kontrollkästchen „Bewertung“ in ReadIDMax muss aktiviert sein.
GetCodeName(IDMax,[Index]) | Gibt den Namen des Codetyps zurück. Das ist der selbe Codename, der im Eigenschaftsblatt von ReadIDMax angezeigt wird.
GetCodeType(IDMax,[Index]) | Gibt den Codetyp zurück.
Codetyp | Entsprechender Codename
--- | ---
1 | Code 128
0 | Code 39
3/4 | UPC/EAN
11 | Code 93
12 | Codabar
128 | Datenmatrix
129 | QR-Code
132 | PDF417
GetColor(IDMax,[Index]) | Gibt den Wert (0 = schwarz, 1 = weiß) der Vordergrundfarbe für ein Datenmatrix-, QR-Code- oder PDF417-Symbol zurück.
GetDecoded(Struktur,Index) | Gibt zurück, ob das indizierte ID-Symbol gefunden wurde. Gibt 0.0 für „Nicht gefunden“ oder 1.0 für „Gefunden“ aus.
GetErrorCode(IDMax,[Index]) | Gibt für jede Informationszeichenfolge einen Fehlercode zurück, wenn die Funktion einen Fehler meldet. Hinweis: Fehlerzeichenfolgen werden mithilfe der GetErrorString-Funktion in die Tabelle eingefügt.
Diagnosecode | Entsprechende Informationszeichenfolge
--- | ---
00010000 | Bildverarbeitungsfehler.
00010001 | Unzulässiger Bildspeicher.
00010001 | Eingabebereich ist zu klein.
00010002 | Eingabebereich geht über das Bild hinaus.
00019000 | IDMax-Bildverarbeitungsfehler.
04010000 | ReadCompositeCode-Fehler.
04010001 | Kann keine 2D-Komponenten Adressmuster erkennen.
04010002 | Zu viele ungültige 2D-Komponenten-Bilddaten.
04010003 | Kann die Symbolversion der 2D-Komponente nicht erkennen.
04010004 | Kann die fehlenden 2D-Komponenten-Adressmuster nicht ersetzen.
04010005 | Scanzeile hat ungültige Bilddaten gefunden.
04010006 | Scanzeile geht über die Bildbegrenzung hinaus.
04010007 | Kann keine 1D-Komponenten Startmuster erkennen.
04010008 | Zu viele ungültige 1D-Komponenten Bilddaten.
04010009 | Keine gültigen Composite-Symbole gefunden. Hinweis: Für alle anderen Symbole wird 04020001 zurückgegeben.
04010010 | Zu viele Fehler im Symbol, Korrektur nicht möglich.
04010011 | Fehlerkorrektur ist fehlgeschlagen.
04010012 | 1D und 2D sind dekodierbar, gehören aber nicht zusammen.
04010013 | Automatische Berechnung des Kontrastschwellenwerts fehlgeschlagen.
04010014 | Kontrastempfindlichkeit ist außerhalb des zulässigen Bereichs.
04010015 | Scanparameter liegt außerhalb des gültigen Bereichs.
04020000 | Fehler bei ReadIDMax.
04020001 | Keine gültigen Symbole gefunden.
04020002 | Symbol konnte nicht decodiert werden.
GetErrorString(IDMax,[Index]) | Gibt Diagnose-Information zurück, wenn das Dekodieren des Symbols fehlschlägt. Hinweis: Die Vision-Datenzugriffsfunktion „GetErrorString“ kann zum Extrahieren der folgenden Liste mit Fehlern aus einer der von der ReadIDMax-Funktion zurückgegebenen Datenstrukturen verwendet werden. Systemfehler. Nicht genügend dynamischer Speicher. Bildverarbeitungsfehler. Ungültiger Bild-Zwischenspeicher. Ungültige Bereichsgröße. Bereich geht über die Bildbegrenzung hinaus. Fehler bei ReadIDMax. Fehler bei ReadIDCode. Kann keine Zeilenadressmuster erkennen. Speichergrenze für Zeilenadressmuster (RAP) überschritten. Kann CC-A-Symbolversion nicht erkennen. Kann die fehlenden RAP-Punkte nicht einfügen. Ungültige Scanzeile erkannt. Scanzeile geht über die Bildbegrenzung hinaus. Kann keine Halbwert-Muster erkennen. Halbwert-Speicherbegrenzung überschritten. Keine gültigen Symbole gefunden. Zu viele Fehler im Symbol, Korrektur nicht möglich. Reed Solomon-Fehlerkorrektur ist fehlgeschlagen. Automatische Berechnung des Kontrastschwellenwerts fehlgeschlagen. Kontrastempfindlichkeit ist außerhalb des zulässigen Bereichs.
GetFormat(IDMax,[Index]) | Gibt den Wert zurück, der das Format eines 2D-Smbols in der ReadIDMax-Funktion darstellt. Weitere Informationen finden Sie unter dem Thema GetFormat-Werte.
GetFound(IDMax, Index) | Gibt zurück, ob das indexierte ID-Symbol gefunden wurde: 0.0 für „Nicht gefunden“ oder 1.0 für „Gefunden“.
GetGridCols(IDMax,[Index]) | Gibt die Anzahl der in einem 2D-Symbol gefundenen Spalten zurück.
GetGridRows(IDMax,[Index]) | Gibt die Anzahl der in einem 2D-Symbol gefundenen Zeilen zurück.
GetGrowth(IDMax,[Index]) | Gibt das Ergebnis des 2D-Symboldruck-Strichbreitentests für ein 2D-Symbol zurück. Die horizontalen und vertikalen Strichbreiten werden unabhängig voneinander berechnet und der niedrigste Wert wird zurückgegeben. Dieser Test zeigt an, ob die Zellen im Symbol in der Größe variieren. Zum Beispiel ist es bei bestimmten Markierungsmethoden nicht ungewöhnlich, dass die Größe der Zellen sich erhöht und zwar von der linken Seite des Symbols zur rechten Seite. Ein Symbol von hoher Qualität weist wenig oder keine druckbedingten Veränderungen der Strichbreite auf. Das Ergebnis des Strichbreitentests werden oft mit Testergebnissen für Ungleichförmigkeit verknüpft, um Symbole mit falschen Proportionen zu vermeiden. Grad A (4.0) ≥ -0.50 and ≤ 0.50 Grad B (3.0) ≥ -0.70 and ≤ 0.70 Grad C (2.0) ≥ -.85 and ≤ 0.85 Grad D (1.0) ≥ -1.00 and ≤ 1.00 Grad F (0.0) < -1.00 or > 1.00 Hinweis: Das Kontrollkästchen „Bewertung“ in ReadIDMax muss aktiviert sein.
GetHeight(IDMax,[Index]) | Gibt die Höhe des Symbols zurück. Hinweis: Das Kontrollkästchen „Bewertung“ in ReadIDMax muss aktiviert sein.
GetLearned(IDMax,[Index]) | Gibt '1' zurück, falls das Modell des Symbols erfolgreich eingelernt wurde, und '0' zurück, wenn das Modell nicht eingelernt wurde. Index = 0 für DataMatrix, 1 für QR, 2 für 1D. Index nur gültig bei Verwendung mit ReadIDMax.
GetLearnedGridCol(IDMax,[Index]) | Gibt die Anzahl der Spalten in einem erlernten QR-Code oder Datenmatrixsymbol zurück.
GetLearnedGridRow(IDMax,[Index]) | Gibt die Anzahl der Zeilen in einem erlernten QR-Code oder Datenmatrixsymbol zurück.
GetLearnedSymbology(IDMax) | Gibt eine Zeichenfolge mit der 1D-Symbologie zurück, die derzeit in ReadIDMax trainiert wurde.
GetMirror(IDMax,[Index]) | Gibt den gespiegelten Status (0 = Nicht gespiegelt, 1 = Gespiegelt) eines Datenmatrix- oder QR-Code-Symbols zurück.
GetModuleSize(IDMax,[Index]) | Gibt die Größe des 2D-Moduls zurück.
GetNumResults(IDMax) | Gibt die Anzahl der gefundenen und dekodierten Ergebnisse an.
GetRawStream(IDMax,[Index]) | Gibt den undekodierten Datenstrom von einem gelesenen Symbol eines Code-128-Symbols zurück.
GetResolution(IDMax,[Index]) | Bei 2D-Symbolen wird die durchschnittliche Größe der Zellen in Pixel zurückgegeben. Obwohl spezifisch keine Qualitätsüberprüfung, misst die Auflösung die durchschnittliche Größe in Pixel eines Elements (oder einer Zelle) in einem Symbol. Für jeden Symboltyp ist eine minimale Auflösung spizifiziert: DataMatrix: 4 Pixel pro Element QR-Code: 4 Pixel pro Element PDF417: 3 Pixel pro Element
GetString(IDMax,[Index]) | Gibt die Zeichenfolge aus dem indizierten Ergebnis bzw. Ergebnis 0 zurück, wenn [Index] nicht angegeben wurde. Hinweis: Wenn die Zeichenfolge NULL (0x00) enthält, ersetzt die Funktion das Zeichen automatisch durch „<NUL>“.
GetStringIDMax(IDMax,Übersetzungsmodus,[Index]) | Gibt die Zeichenfolge aus dem indizierten Ergebnis zurück, auf Basis des ausgewählten Übersetzungsmodus (0, 1 oder 2; Standard = 0), der bestimmt, wie die Funktion nicht druckbare ASCII-Zeichen verarbeiten soll. Wenn der Übersetzungsmodus auf 0 eingestellt ist, ersetzt die Funktion das ASCII-Zeichen 0x00 durch „<NUL>“. Wenn der Übersetzungsmodus auf 1 eingestellt ist, werden die nicht druckbaren ASCII-Zeichen (0-31, 127-255) anhand der folgenden Tabelle übersetzt:
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 | „<ETX>“
0x18 | „<CAN>“
0x19 | „<EM>“
0x1a | „<SUB>“
0x1b | „<ESC>“
0x1c | „<FS>“
0x1d | „<GS>“
0x1e | „<RS>“
0x1f | „<US>“
0x7f | „<DEL>“
Hinweis: Nicht druckbare ASCII-Zeichen, die in der Tabelle nicht aufgeführt sind, werden als „<X>“, wobei X der Dezimalwert ist.
Wenn Übersetzungsmodus auf 2 eingestellt ist, wird die Funktion alle nicht druckbaren ASCII-Zeichen übersetzen, außer CR (0x0d) und LF (0x0a).
GetSymbologyIdentifier(IDMax,[Index]) | Gibt den Typ des Symbols als drei Zeichen langer Code auf Basis der ISO-Spezifikation 15424 zurück.
GetWidth(IDMax,[Index]) | Gibt die Breite des Symbols zurück. Hinweis: Das Kontrollkästchen „Bewertung“ in ReadIDMax muss aktiviert sein.
GetX(IDMax, [Index1], [Index2]) | Gibt eine x-Koordinate zurück. Bei ReadIDMax gibt Index2 die Symbolecke an.
GetY(Struktur, [Index1], [Index2]) | Gibt eine y-Koordinate zurück. Bei ReadIDMax gibt Index2 die Symbolecke an.
SetSymbolMinStringLength(IDMax,Symbology,MinLength) | Legt die Mindestzeichenfolgenlänge der angegebenen Symbologie für die referenzierte IDMax-Struktur fest.
IDMax | ReadIDMax(Bild, Vorrichtung, Bereich, ...) Liest und überprüft optional alphanumerische Zeichenfolgen in 1D- und 2D-Barcodes und -Symbologien. Gibt eine IDCode-Struktur mit der decodierten Zeichenfolge zurück.
Symbologie | Die angegebene Symbologie [unterstützt nur Interleaved 2 von 5(73)]
MinLength | Minimale Zeichenfolgenlänge Ganzzahl, Maximum = 80.