RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
525
Undelayed
Short
List Command
sub_call
Function causes an unconditional jump to an indexed subroutine.
Call
sub_call( Index )
Parameter
Index
Index of the called indexed subroutine as an unsigned 32-bit value;
allowed range: [0 … 1023]
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 (also see the comments there), which then triggers the jump to the subroutine.
•The sub_call command starts indexed subroutines in protected memory (that were
loaded and/or referenced via load_sub, load_disk or copy_dst_src) as well as indexed
subroutines in the unprotected list area (that were referenced via set_sub_pointer or
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 list_nop might be executed.
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
32
–1).
•If
Index
> 1023, then sub_call will, already during loading, be replaced by a list_nop
(get_last_error return code
RTC5_PARAM_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 must be used instead.
RTC
®
4
RTC
®
5 new command
References list_call, sub_call_abs, sub_call_cond
Undelayed
Short
List Command
sub_call_abs
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
Index of the called indexed subroutine as an unsigned 32-bit value;
allowed range: [0 … 1023]
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 (also see the comments there), which then triggers the jump to the
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, sub_call_abs_cond
To Next Page
Loading...
