Scanlab RTC 5 PC Interface Board Installation And Operation Manual page 285

Ctrl Command get_table_para
Function returns the value of the specified parameter from a currently loaded correction table
Call
TablePara = get_table_para( TableNo, ParaNo )
Parameters
TableNo
ParaNo
Result Parameter value as a 64-bit IEEE floating point value (see
Comments • The parameter values can be read out via get_table_para from a currently loaded
correction table and via
directly incorporated into a user program (see
• If the parameters TableNo and ParaNo are out of range, then the return value will be 0
(get_last_error
• If no correction table with the specified number has been loaded, then the parameter's
value is undefined.
® ®
RTC 4 RTC 5 new command
Version info Last change (with version DLL 533, OUT 534): the TableNo parameter's value range has
been increased to [0...4]
Ctrl Command get_text_table_pointer
Function returns the absolute start address of an indexed text string.
Call
TextTablePointer = get_text_table_pointer( Index )
Parameter
Index
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 unprotected memory area depends on whether
the text string was loaded into the protected memory area or an unprotected subrou-
tine was only subsequently referenced.
• If Index > 41 or if no text string was referenced with the specified index, then the
command will return the value "–1" (e.g. 2
• This command is useful for checking if a text string has already been defined or for
calling an indexed text string via an absolute memory address as if it were a non-
indexed subroutine, e.g. for conditional execution with list_call_cond. Be aware,
though, that a subsequent
address. And you should ensure that get_text_table_pointer doesn't return "–1";
otherwise the
® ®
RTC 4 RTC 5 new command
References get_char_pointer,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
Number of the currently loaded correction table as an unsigned 32-bit value,
valid values: [1...4]
Number of the parameter as an unsigned 32-bit value,
valid values: 0-15 (meaning: see
get_head_para
return code: RTC5_PARAM_ERROR).
(load_correction_file
Index of the indexed text string as an unsigned 32-bit value;
allowed range: [0 ... 41]
save_disk/load_disk
list_call_cond command will be ignored.
get_sub_pointer
page 124)
page 124)
from an assigned correction table and thus
page 124).
lets you load up to 4 correction files)
32
–1).
might alter the absolute memory
285