set_spyset_spySetSpySetSpyset_spy (Operator)

Name

set_spyset_spySetSpySetSpyset_spy — Steuern des HALCON Debugging Tools.

Signatur

Beschreibung

set_spyset_spySetSpySetSpyset_spy ist das HALCON Debugging Tool. Es erlaubt die flexible Überwachung der Ein- und Ausgabedaten von HALCON-Operatoren - sowohl graphisch als auch textuell. Aktiviert wird die Datenkontrolle mittels

set_spy(::'mode','on':)set_spy("mode","on")SetSpy("mode","on")SetSpy("mode","on")set_spy("mode","on"),

ausgeschaltet mittels

set_spy(::'mode','off':)set_spy("mode","off")SetSpy("mode","off")SetSpy("mode","off")set_spy("mode","off").

Außerdem kann das Debugging Tool mit der Environmentvariable HALCONSPY aktiviert werden: Wenn diese Variable definiert ist, entspricht das dem Aufruf mit 'mode'"mode""mode""mode""mode" und 'on'"on""on""on""on".

Die folgenden Überwachungsmodi (ClassClassClassclassValclass) können über ValueValueValuevaluevalue gesteuert werden:

ClassClassClassclassValclass = 'operator'"operator""operator""operator""operator"

Bei Aufruf einer Routine werden deren Name und die Namen ihrer Parameter (in TRIAS Notation) ausgegeben.

ValueValueValuevaluevalue: 'on'"on""on""on""on" oder 'off'"off""off""off""off".

Standardwert: 'off'"off""off""off""off".

ClassClassClassclassValclass = 'input_control'"input_control""input_control""input_control""input_control"

Bei Aufruf einer Routine werden die Namen und Werte der Eingabesteuerparameter ausgegeben.

ValueValueValuevaluevalue: 'on'"on""on""on""on" oder 'off'"off""off""off""off".

Standardwert: 'off'"off""off""off""off".

ClassClassClassclassValclass = 'output_control'"output_control""output_control""output_control""output_control"

Bei Aufruf einer Routine werden die Namen und Werte der Ausgabesteuerparameter ausgegeben.

ValueValueValuevaluevalue: 'on'"on""on""on""on" oder 'off'"off""off""off""off".

Standardwert: 'off'"off""off""off""off".

ClassClassClassclassValclass = 'db'"db""db""db""db"

Informationen über die 4 Relationen in der HALCON-Datenbank. Dies ist insbesondere bei der Suche nach vergessenen clear_objclear_objClearObjClearObjclear_obj zu suchen.

ValueValueValuevaluevalue: 'on'"on""on""on""on" oder 'off'"off""off""off""off".

Standardwert: 'off'"off""off""off""off".

ClassClassClassclassValclass = 'parameter_values'"parameter_values""parameter_values""parameter_values""parameter_values"

Ergänzung zu 'input_control'"input_control""input_control""input_control""input_control" und 'output_control'"output_control""output_control""output_control""output_control": Gibt an, wie viele Werte pro Parameter maximal ausgegeben werden sollen (maximale Tupellänge für Ausgabe).

ValueValueValuevaluevalue: Tupellänge (integer)

Standardwert: 4

ClassClassClassclassValclass = 'time'"time""time""time""time"

Rechenzeit für die Ausführung des Operators

ValueValueValuevaluevalue: 'on'"on""on""on""on" oder 'off'"off""off""off""off".

Standardwert: 'off'"off""off""off""off".

ClassClassClassclassValclass = 'log_file'"log_file""log_file""log_file""log_file"

Umleitung der Textausgabe von spy in ein File, das mit open_file geöffnet wurde.

ValueValueValuevaluevalue: ein File Handle (siehe open_fileopen_fileOpenFileOpenFileopen_file).

ClassClassClassclassValclass = 'error'"error""error""error""error"

Ist 'error'"error""error""error""error" eingeschaltet, gibt spy beim Auftreten eines internen Fehlers die Prozeduren (Datei/Zeilennummer) aus, bei denen der Fehler auftritt.

ValueValueValuevaluevalue: 'on'"on""on""on""on" oder 'off'"off""off""off""off".

Standardwert: 'off'"off""off""off""off".

ClassClassClassclassValclass = 'internal'"internal""internal""internal""internal"

Ist 'internal'"internal""internal""internal""internal" eingeschaltet, gibt spy vor dem Aufruf eines internen HALCON-Operators den Prozedurname mit ihren Parametern (Datei/Zeilennummer) aus.

ValueValueValuevaluevalue: 'on'"on""on""on""on" oder 'off'"off""off""off""off".

Standardwert: 'off'"off""off""off""off".

Jede Ausgabe beginnt mit dem thread handle, gefolgt von einem globalen Zähler, welcher die Reihenfolge der Ausgaben markiert. In multi-threaded Anwendungen kann mit dieser Information die Ausgabe einzelnen User Threads zugeordnet und der chronologische Ablauf rekonstruiert werden.

Achtung

Unter Windows funktioniert die Ausgabe auf stdout nur in Konsolenapplikationen.

Ausführungsinformationen

• Multithreading-Typ: exclusive (läuft parallel nur zu unabhängigen Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Beispiel (C)

/* init spy: Setting of the wished control modi */
set_spy("mode","on");
set_spy("operator","on");
set_spy("input_control","on");
set_spy("output_control","on");
/* calling of program section, that will be examined */
set_spy("mode","off");  

Ergebnis

set_spyset_spySetSpySetSpyset_spy liefert den Wert 2 ( H_MSG_TRUE) , falls die Parameter korrekt sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

reset_obj_dbreset_obj_dbResetObjDbResetObjDbreset_obj_db

Siehe auch

get_spyget_spyGetSpyGetSpyget_spy, query_spyquery_spyQuerySpyQuerySpyquery_spy

Modul

Foundation