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

Undelayed sub_call
Short
List Command
Function causes an unconditional jump to an indexed subroutine.
Call
sub_call( Index )
Parameter
Index
Comments • The sub_call command reads the indexed subroutine's starting address from the
internal management table based on the supplied index and then calls the command
list_call
• The sub_call command starts indexed subroutines in protected memory (that were
loaded and/or referenced via load_sub,
subroutines in the unprotected list area (that were referenced via
copy_dst_src).
• If no subroutine is referenced for the supplied index, then the jump will be suppressed
and execution will continue at the command located after the calling position. In some
circumstances, a
get_sub_pointer( Index ) can be used to determine whether a subroutine has been
referenced for a particular index. If no subroutine has been referenced, this command
returns the value "–1" (d.h. 2
• If Index > 1023, then sub_call will, already during loading, be replaced by a
(get_last_error
• Absolute vector and arc commands will execute absolutely after being called with
sub_call. If the subroutine needs to execute at various locations within the image field,
then either the subroutine can only contain relative mark, arc or jump commands or
sub_call_abs
® ®
RTC 4 RTC 5 new command
References list_call, sub_call_abs,
Undelayed sub_call_abs
Short
List Command
Function causes an unconditional jump to an indexed subroutine. In the called subroutine, any
absolute vector and arc commands will receive an offset (based on the current coordinates
at the time of the call)
Call
sub_call_abs( Index )
Parameter
Index
Comments • The sub_call_abs command reads the indexed subroutine's starting address from the
internal management table based on the supplied index and then calls the command
list_call_abs
subroutine.
• If the called subroutine contains no absolute commands, then there is no difference
between sub_call_abs and sub_call.
® ®
RTC 4 RTC 5 new command
References sub_call,
®
RTC 5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
Index of the called indexed subroutine as an unsigned 32-bit value;
allowed range: [0 ... 1023]
(also see the comments there), which then triggers the jump to the subroutine.
list_nop might be executed.
32
–1).
return code RTC5_PARAM_ERROR).
must be used instead.
sub_call_cond
Index of the called indexed subroutine as an unsigned 32-bit value;
allowed range: [0 ... 1023]
(also see the comments there), which then triggers the jump to the
sub_call_abs_cond
load_disk or copy_dst_src) as well as indexed
set_sub_pointer or
list_nop
525