Scanlab RTC 5 PC Interface Board - get_auto_cal; get_char_pointer

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
260
innovators for industry
Ctrl Command get_auto_cal
Function returns the attached scan system’s type of ASC hardware previously detected via auto_cal.
Call
ASCtype = get_auto_cal()
Result ASC hardware type as an unsigned 32-bit value
Comments • If the ASC hardware type was previously detected via auto_cal, then get_auto_cal will
return the same value as auto_cal( Command = 4) – see comments there.
• If the ASC hardware type was not previously detected via auto_cal, then get_auto_cal
will return the value 255 (initialized value).
RTC
®
4  RTC
®
5 new command
Version info Available beginning with version DLL 520, OUT 519
References auto_cal
Ctrl Command get_char_pointer
Function returns the absolute start address of an indexed character.
Call
CharPointer = get_char_pointer( Char )
Parameter Char Index of the indexed character as an unsigned 32-bit value;
allowed range: [0 … 1023]
Result Absolute start address as an unsigned 32-bit value
Comments • The get_char_pointer command reads from the internal management table the start
address of the indexed character with the specified index. Whether the read address
resides in a protected or the unprotected memory area depends on whether the char-
acter was loaded into the protected memory area or an unprotected subroutine was
only subsequently referenced.
•If
Index > 1023 or if no character was referenced with the specified index, then the
command returns the value “–1” (e.g. 2
32
–1).
• This command is useful for checking if a character has already been defined or for
calling an indexed character 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_char_pointer doesn’t return “–1”; otherwise the list_call_cond
command will be ignored.
RTC
®
4  RTC
®
5 new command
References get_sub_pointer, get_text_table_pointer