Scanlab RTC 4, Installation And Operation Manual

Page: 88 / 136

RTC
®
4 PC Interface Board
Rev. 1.3 e
10 Commands And Functions
88
innovators for industry
Ctrl Command get_wait_status
Function returns the wait state of the RTC
®
4
Result wait state as an unsigned 16-bit value
Integration Pascal:
function get_wait_status: word;
C:
unsigned short get_wait_status(void);
Basic:
function get_wait_status()%
Comments • If processing has stopped at a wait marker, the command get_wait_status returns the
number of this marker. See set_wait (page 118) .
• If no wait marker was reached, the command get_wait_status returns zero.
• Processing of the list can be resumed by calling the command release_wait .
References set_wait , release_wait
Ctrl Command get_waveform
Function transfers to the PC the data that was measured and stored onto the RTC
®
4 via set_trigger
Parameters
channel
measurement channel (1 or 2); specified as an unsigned 16-bit value
stop
number of measured values [1..32768] to transfer; specified as an unsigned
16-bit value (values of measurement positions 1..stop will be transferred)
memptr
unsigned 16-bit pointer to a location in the PC’s memory to where the
measured values should be transferred
Integration Pascal:
procedure get_waveform(channel, stop: word; memptr: pint);
C:
void get_waveform(unsigned short channel, unsigned short stop, signed
short *memptr);
Basic:
sub get_waveform (ByVal channel As Integer, ByVal stop As Integer,
ByVal memptr As Integer)
References set_trigger
Ctrl Command get_xy_pos
Function returns the current scanner set position
Result
xpos, ypos
current output position in bits as signed 16-bit values
Integration Pascal:
procedure get_xy_pos(var xpos, ypos: smallint);
C:
void get_xy_pos(short *xpos, short *ypos);
Basic:
sub get_xy_pos(xpos%, ypos%)
Comments • The command returns the current output position
(before the image field correction is applied).
• If an image transformation was defined with the commands set_matrix / set_offset ,
the actual output coordinates are generally not equal to the original input coordinates.