Scanlab RTC6 PCIe Board - Get_Text_Table_Pointer; Get_Time

RTC6 boards
Doc. Rev. 1.0.21 en-US
10 RTC6 Commands
435
innovators for industry
Ctrl Command get_text_table_pointer
Function Returns the absolute start address of an indexed text string.
Call TextTablePointer = get_text_table_pointer( Index )
Parameters Index Index of the indexed text string.
As an unsigned 32-bit value.
Allowed value range: [0…41].
Result Absolute start address.
As an unsigned 32-bit value.
Comments • The get_text_table_pointer command reads from the internal management table the
start address of the indexed text string with the specified index. Whether the read
address resides in a protected or the protected RTC6 List Memory area “List 3” depends
on whether the text string has been loaded into the protected RTC6 List Memory area
“List 3” or an unprotected subroutine has been only subsequently referenced.
• If Index > 41 or if no text string has been referenced with the specified index, then
get_text_table_pointer returns the value “–1” (for example, 2
32
–1).
• This command is useful for checking if a text string has already been defined or for
calling an indexed text string by an absolute memory address as if it were a non-
indexed subroutine, for example, for conditional execution with list_call_cond. Be
aware, though, that a subsequent save_disk/load_disk might alter the absolute
memory address. And you should ensure that get_text_table_pointer does not return
“–1”; otherwise list_call_cond is ignored.
RTC4RTC6 New command.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References get_char_pointer, get_sub_pointer
Ctrl Command get_time
Function Returns the RTC6 Timer value (without resetting it to zero). It has been stored during the
most recent call of save_and_restart_timer.
Call TimerValue = get_time()
Result RTC6 Timer value. In seconds.
As a 64-bit IEEE floating point value.
Comments • See save_and_restart_timer.
• The number of elapsed list-command clock cycles since the reset to zero can be queried
by get_lap_time.
RTC4RTC6 Unchanged functionality.
RTC5RTC6 Unchanged functionality.
Version info Available as of DLL 600, OUT 600, RBF 600.
References get_lap_time, save_and_restart_timer