:Revision=15
:html
<<
128.117
Debug-Object|Debug
--
The IP-Object Debug enables the output of interpreter step values in special notification windows or in a debug log file.
>>

<<
128.117.2
Procedures of the Debug-Object|Procedures
--
>>

<<
128.117.2.1
Debug.Info|Info
--
<!DEF>
procedure <!TW>DEBUG.INFO (.Value : string|real|vector|stringvector [; .Value : string|real|vector|stringvector [...]]);
<!TXT>
Consecutive output of values in a small Debug-Info-Window (on the right, behind the test step data).

Values can be of type <!RW>Real, <!RW>String, <!RW>Vector or <!RW>StringVector. There is a space between the values.

The display of this window can be disabled in the basic setup. If the window is disabled, then the command is ignored.

<!TXT>

Example
<!CODE>
step
 // This command shows information in the debug info window.
 Debug.INFO('Debug Info', 1);
 System.SetValue(0);
end.
<!TXT>

>>

<<
128.117.2.2
Debug.Show|Show
!128.154.9
--
<!DEF>
procedure <!TW>DEBUG.SHOW (rColor : real; .Value : string|real|vector|stringvector [; .Value : string|real|vector|stringvector [...]]);
<!TXT>
Consecutive output of values in the large Debug-window. This window can be seen only in step-by-step mode.

Values can be of type <!RW>Real, <!RW>String, <!RW>Vector or <!RW>StringVector. Between each value there is a space.

<!PW>rColor determines the color of the output

<!TXT>

Example
<!CODE>
step
 // This command writes into the large debug window in the StepByStep Mode.
 Debug.SHOW(1, 'This Information would be written in blue into the large debud window in the StepByStep mode.');
 Debug.SHOW(4, 'This Information would be written in red into the large debud window in the StepByStep mode.');
 System.SetValue(0);
end.
<!TXT>

>>
<<
128.117.2.3
Debug.Log|Log
--
<!DEF>
procedure <!TW>DEBUG.LOG (.Value : string|real|vector|stringvector [; .Value : string|real|vector|stringvector [...]]);
<!TXT>
Output of values in a line of the file IPDebug.Log.

Values can be of type <!RW>Real, <!RW>String, <!RW>Vector or <!RW>StringVector. Between each value there is a space.

<!TXT>

Example
<!CODE>
step
 // This command writes into the debug logging file.
 Debug.LOG('This information would be written into the debug logging file.');
 System.SetValue(0);
end.
<!TXT>

>>

<<
128.117.2.4
Debug.DUTInfo|DUTInfo
!128.154.9
--
<!DEF>
procedure <!TW>DEBUG.DUTINFO (rColor : real; .Value : string|real|vector|stringvector [; .Value : string|real|vector|stringvector [...]]);
<!TXT>
Consecutive output of values in the test item field (Attention: very narrow!). This function could only used in the single simultaneous mode.

Values can be of type <!RW>Real, <!RW>String, <!RW>Vector or <!RW>StringVector. Between each value there is a space.

 <!PW>rColor determines the color of the output.

<!TXT>

Example
<!CODE>
step
 // This command shows a short info in the test item field.
 Debug.DUTINFO(2,'Short Info');
 System.SetValue(0);
end.
<!TXT>

>>

<<
128.117.2.5
Debug.Debug|Debug
--
<!DEF>
procedure <!TW>Debug.Debug;
<!TXT>
Breaks the execution of the step and opens the interpreter debugger - works like a hard coded breakpoint.

Should be used only for testing purposes. This command should not be used on production machines.

<!TXT>

Example
<!CODE>
step
 Debug.SHOW(1,'This command would be executed directly.');
 // This command stops the test sequence and starts dthe debugger.
 Debug.Debug;
 Debug.SHOW(1,'This commans would be executed after a commnad from the debugger.');
 System.SetValue(0);
end.
<!TXT>

>>

