Coaxlink Programmer's Guide
Euresys::EGrabber
#include <EGrabber.h>
void
configure() {
Euresys::EGenTL gentl;
Euresys::EGrabber<> grabber(gentl);
grabber.runScript(
"config.js"
);
}
int
main() {
try
{
configure();
}
catch
(
const
std::exception &e) {
std::cout <<
"error: "
<< e.what() << std::endl;
}
}
and the configuration script is:
var
grabber = grabbers[0];
var
FPS = 150;
// camera configuration
grabber.RemotePort.set(
"TriggerMode"
,
"On"
);
grabber.RemotePort.set(
"TriggerSource"
,
"CXPin"
);
grabber.RemotePort.set(
"ExposureMode"
,
"TriggerWidth"
);
// frame grabber configuration
grabber.DevicePort.set(
"CameraControlMethod"
,
"RG"
);
grabber.DevicePort.set(
"CycleTriggerSource"
,
"Immediate"
);
grabber.DevicePort.set(
"CycleTargetPeriod"
, 1e6 / FPS);
Using a script file has several advantages:
• The configuration can be changed without recompiling the application. This allows shorter development cycles,
and makes it possible to update the configuration in the lab or in the field.
• The configuration script can be loaded by the GenICam Browser and the command-line
gentl
tool. This makes is
possible to validate the configuration outside of the user application.
• The configuration script can easily be shared by several applications written in different programming languages:
C++, C#, VB.NET...
• The full power of
Euresys GenApi scripts
is available.
Events
Background
Coaxlink cards generate different kinds of events:
•
New buffer
events: events indicating that a
buffer
has been filled by a
data stream
.
•
Data stream
events: events related to a
data stream
and its frame store.
•
Camera and illumination controller
events: events related to the real-time control (performed by a
device
) of a
camera and its illumination devices.
•
I/O toolbox
events: events (coming from the
interface
) related to digital I/O lines and other I/O tools.
•
CoaXPress interface
events: events (also coming from the
interface
) related to the CoaXPress interface.
New buffer
events are standard in GenTL. They occur when a buffer is filled by the frame grabber. Information attached
to
new buffer
events include the handle of the buffer and a timestamp.
The other types of events are restricted to Coaxlink and can be viewed as categories of specific events. For example,
in the
CIC
category of events, we have:
•
CameraTriggerRisingEdge
(start of camera trigger)
16
