set_spyset_spySetSpySetSpyset_spy (Operator)

Name

set_spyset_spySetSpySetSpyset_spy — Steuern des HALCON Debugging Tools.

Signatur

Beschreibung

set_spyset_spySetSpySetSpySetSpyset_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")SetSpy("mode","on")set_spy("mode","on"),

ausgeschaltet mittels

set_spy(::'mode','off':)set_spy("mode","off")SetSpy("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""mode" und 'on'"on""on""on""on""on".

Die folgenden Überwachungsmodi (ClassClassClassClassclassValclass) können über ValueValueValueValuevaluevalue gesteuert werden:

ClassClassClassClassclassValclass = 'operator'"operator""operator""operator""operator""operator"

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

ValueValueValueValuevaluevalue: 'on'"on""on""on""on""on" oder 'off'"off""off""off""off""off".

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

ClassClassClassClassclassValclass = 'input_control'"input_control""input_control""input_control""input_control""input_control"

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

ValueValueValueValuevaluevalue: 'on'"on""on""on""on""on" oder 'off'"off""off""off""off""off".

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

ClassClassClassClassclassValclass = 'output_control'"output_control""output_control""output_control""output_control""output_control"

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

ValueValueValueValuevaluevalue: 'on'"on""on""on""on""on" oder 'off'"off""off""off""off""off".

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

ClassClassClassClassclassValclass = 'db'"db""db""db""db""db"

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

ValueValueValueValuevaluevalue: 'on'"on""on""on""on""on" oder 'off'"off""off""off""off""off".

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

ClassClassClassClassclassValclass = 'parameter_values'"parameter_values""parameter_values""parameter_values""parameter_values""parameter_values"

Ergänzung zu 'input_control'"input_control""input_control""input_control""input_control""input_control" und 'output_control'"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).

ValueValueValueValuevaluevalue: Tupellänge (integer)

Standardwert: 4

ClassClassClassClassclassValclass = 'time'"time""time""time""time""time"

Rechenzeit für die Ausführung des Operators

ValueValueValueValuevaluevalue: 'on'"on""on""on""on""on" oder 'off'"off""off""off""off""off".

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

ClassClassClassClassclassValclass = 'log_file'"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.

ValueValueValueValuevaluevalue: ein File Handle (siehe open_fileopen_fileOpenFileOpenFileOpenFileopen_file).

ClassClassClassClassclassValclass = 'internal'"internal""internal""internal""internal""internal"

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

ValueValueValueValuevaluevalue: 'on'"on""on""on""on""on" oder 'off'"off""off""off""off""off".

Standardwert: 'off'"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_spySetSpySetSpySetSpyset_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_dbResetObjDbResetObjDbResetObjDbreset_obj_db

Siehe auch

get_spyget_spyGetSpyGetSpyGetSpyget_spy, query_spyquery_spyQuerySpyQuerySpyQuerySpyquery_spy

Modul

Foundation