40
Camera Operation & Features
Document No.: 04646-01
PixeLINK PL-A780
MACHINE VISION CAMERA
SYSTEM GUIDE
Copyright © 2004 PixeLINK
All Rights Reserved
5.2 Non IIDC Features Accessible with the PixeLINK API
The following features are specific to the PL-A780 camera series. To access them, you will
need the PixeLINK Software Development Kit (PL-SDK-VERSION-4.1).
The PixeLINK API defines two functions that allow access to camera specific features. These
are PxLCameraRead and PxLCameraWrite. They can be used with the PL-A78X to turn on
or off flat field correction and determine what gain the camera was calibrated at.
5.2.1 Flat Field Correction
Flat Field Correction (FFC) applies a gain and offset correction per pixel to correct for
illumination and sensor irregularities. A factory calibration is performed and stored in the
camera memory. It is possible to perform FFC calibration in the field using a software tool
available with the CD that ships with –KIT and –DEV product bundles or from the PixeLINK
web site. Look for downloads associated with the PL-A781 or PL-A782 products. See
Section 1on page 1 for more information.
The data to transmit for flat field correction has in the following format:
struct
{
ULONG CommandCode;
ULONG FfcOn;
// 1 = On, 0 = OFF
FLOAT FfcCalibrationGain; // Gain at which FFC was
// calibrated in dB
};
To turn flat field correction off or on, set FfcOn to 0 or 1 and CommandCode to
0x00008002.
To read the flat field correction settings set CommandCode to 0x00008001.