Initialization And Program Start-Up; Dll Call; Importing Commands; Pascal - Scanlab RTC 5 PC Interface Board Installation And Operation Manual

6.2 Initialization and Program
Start-Up
®
To use the RTC 5's commands and functions in a user
program:
®
• The RTC 5 must be fully installed – this includes
®
the RTC 5's hardware, driver and software (see
"Installation And Start-Up", page
• The desired DLL (Win32- or Win64-based) must
be called by the user program (see
page 62)
• The DLL's functions and procedures must be
initialized in the user program (see
Commands", page 62)
At the beginning of each user program, commands
must be called:
• that initialize the DLL for the calling user program
and assigns access rights for the installed RTC
boards (see "Initializing the DLL and Board
Management", page 64)
• that place the installed RTC
desired default state (see
page 65).
Only afterward can the user program load its
®
command lists into the RTC
processing.
These steps are described individually in the
following sections and summarized via a simple
example program in the last section of this
subchapter (see page 67).

6.2.1 DLL Call

If a user program is to use the DLL's commands and
functions, then the desired DLL (Win32- or Win64-
based) must be made available (as described in
"Installation And Start-Up", page
the user program.
The DLL calling convention is stdcall. The structure
alignment is 4 byte (for Win32) or 8 byte (for Win64).
®
RTC 5 PC Interface Board
Rev. 1.9 e
6 Developing User Applications
56)
"DLL Call",
"Importing
®
5
®
5 boards into the
"Start of Operation",
5's list memory and start
56) and called by

6.2.2 Importing Commands

To facilitate importing the commands of the DLL into
a C, C++, C# or Pascal application, the RTC
software package contains corresponding utility files.
The following sections describe how to use these files
in your particular software environment
Caution!
• Some of the commands included in the utility
files can only be used with the appropriate
optional hardware configuration of the RTC
also see chapter 2.3 "Optional Functionality",
page 27.
Make sure to use only the commands supported
by your version of the RTC
descriptions of the individual commands in
chapter 10.
The command get_rtc_version (page 277)
provides information about the options
currently installed on your RTC

Pascal

Use the file RTC5Import.pas as a unit and call the
®
RTC 5 commands you need, like
goto_xy(1000, 2500);
for performing a jump to location 1000, 2500.
(1) Other than with implicit linking under C/C++, the way to
proceed doesn't depend on which DLL is used (Win32- or
Win64-based). Nevertheless, you must always comply with the
formats and value ranges of data types used in RTC
commands (see page 226).
®
5
(1)
.
®
5 –
®
5. Refer to the
®
5 board.
®
5
62