RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
525
innovators for industry
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
(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
) as well as indexed
subroutines in the unprotected list area (that were referenced via
).
• 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
32
–1).
• If
Index
> 1023, then
sub_call
will, already during loading, be replaced by a
(
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
must be used instead.
RTC
®
4
RTC
®
5 new command
References
,
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
(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
.
RTC
®
4
RTC
®
5 new command
References
,