Scanlab RTC 5 PC Interface Board, Инструкция по установке и эксплуатации

Страница: 285 / 622

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
285
innovators for industry
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
Number of the currently loaded correction table as an unsigned 32-bit value,
valid values: [1…4]
ParaNo
Number of the parameter as an unsigned 32-bit value,
valid values: 0-15 (meaning: see
page 124 )
Result Parameter value as a 64-bit IEEE floating point value (see page 124 )
Comments • The parameter values can be read out via get_table_para from a currently loaded
correction table and via get_head_para from an assigned correction table and thus
directly incorporated into a user program (see page 124 ).
• If the parameters
TableNo
and
ParaNo
are out of range, then the return value will be 0
( get_last_error return code:
RTC5_PARAM_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] ( load_correction_file lets you load up to 4 correction files)
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
Index of the indexed text string as an unsigned 32-bit value;
allowed 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 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
32
–1).
• 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 save_disk / load_disk might alter the absolute memory
address. And you should ensure that get_text_table_pointer doesn’t return “–1”;
otherwise the list_call_cond command will be ignored.
RTC
®
4

RTC
®
5 new command
References get_char_pointer , get_sub_pointer