
GigE+Ethernet_ZK.indd • Page 15
Kieler Str. 212, 22525 Hamburg, Germany
• Tel: +49 40 85 39 97-0 • Fax: +49 40 85 39 97-79 • [email protected] • www.SuKHamburg.com15
11-2014 E
SDK for GigE line scan cameras
Initializing the camera
Allocate memory in the user area
Release memory
Set pointer to user buffer
struct sk_interface
*
Examples from the class library containing more than 60 ways to
control a
GigE line scan camera
Csk – Base class
Communication structure for the driver
::Camera
::AllocBuffer
::FreeBuffer
::SetUserBufferPtr
::SetIntegrationTime
::SetLineFrequency
::SetSyncMode
::SetGain
::SetOffset
Set integration time (ms)
Set line frequency (kHz)
Set synchronization mode
Set camera gain
Set camera offset
Name of current camera
Number of current camera pixels
Current line frequency in kHz
Pointer to data set in user memory
::GetCamType
::GetPixWidth
::GetLineFrequency
::GetUserBufferPtr
::LineScanView
::AreaScanView
CskInit: Csk – Initializing class
CskCtrl: Csk – Control class
::SingleLineScan
::AreaScan
::ContinuousGrab
::GetImage
::StopContinuousGrab
Get a single line scan
Acquire a 2D scan
Start continuous grab
Get single image from a continuous grab
Stop continuous grab
CskRecord: Csk – Acquisition class
CskView: Csk – View class
Display a line scan signal
Display an area scan
CskInfo: Csk – class
The SK91GigE-WIN software package includes
everything needed for a rapid setup of the GigE
camera, the configuration tool
SKGigEconfig, as
well as the software development kit (SDK) with
DLLs and class libraries for de ve lopment of
application software. The Windows 7 (x64, x86)
/ Vista (x64, x86) and XP operating systems are
supported.
The
SkLineScan
®
program recog nizes the
connected line scan cameras automatically
and organizes the camera IDs according to
the increasing values of their individual MAC
addresses
1
.
The oscillos cope display
2
of the line scan
signal, with zoom function
3
, is an important tool for
aligning the optical sys-
tem. Controls for integra-
tion time, gain and offset
allow the online configu-
ration of the camera.
2-dimensional area scans
can easily be performed
using the
SkLineScan
®
program
4
. Simply spe-
cify the number of line
scans to be integrated
into the scan to produce a
desired area scan.
The zoom function allows
the magnification of inte-
resting areas
5
and full
or partial images can be
stored as bitmaps.
For color line scan came-
ras, a white balance cor-
rection is necessary and
the shading correction
procedure described on
this page provides this
capability.
The various synchroni-
zation procedures allow
images to be acquired
either stepwise per line
(
LineSync) or per area
(
FrameSync) using an ex-
ternal trigger, according
to the particular require-
ments of the customer or
the image aquisition ap-
plication.
GigE SK7500GTO
2
3
4
5
Flow of camera image acquisition
1
1
2
3
4
5
6
Start-up and status window of the SkLineScan program
Oscilloscope display of a line scan signal
Zooming to a region of interest (yellow) in the line scan signal
Area Scan using the line scan camera SK6288GKOC-L
Zooming to a particular area of interest
Shading Correction function in the SkLineScan program
Software SK91GigE-WIN, SkLineScan Program
Shading Correction with the SkLineScan program
Shading correction is a procedure used for compensating for the potential sources of variation
in the signal, whether caused by lens vignetting or variations in pixel sensitivity or illumination.
A reference signal for the shading correction is obtained by taking an image of a plain white
surface, so that each individual pixel can be compensated for algorithmically to provide a
maximum overall intensity, depending on the scale (e.g. 4095 for a 12-bit resolution), and
producing an idealized flat signal.
The shading correction
reference values are stored
in the designated shading
correction memory (SCM)
in the camera for future use.
The persistent writing of
the SCM into the camera
memory uses the
GEN<i>CAM command
SkSaveScmToFlash from
the custom feature table.
Shading correction for
color line scan cameras
uses the white balance
method (see
6
).
6
The dialog window for Shading Correction in the
SkLineScan program.
New Reference: Acquisition of a new shading
correction reference set and its storage in the
SCM
Scans: Number of lines for the reference values to
be determined
Minimum: Only the minimum pixel value is used
for scaling
SaveSCM to Flash: Pesistent storage of the
shading correction reference values in the flash
memory of the camera
Save/Load: The shading correction reference
values are written to or read from a file
Create the base class object
pSk = new Csk
Initialize camera
pSkInit = new CskInit, pSkInit->Camera(CamID)
Take control for acquisition of objects
pSkCtrl= new CskCtrl, pSkRecord= new CskRecord
Enter illumination time
pSkCtrl->SetExposureTime((CamID, ms)
Image acquisition
Start acquisition
pSkRecord->ContinuousGrab(CamID, lines)
pSkRecord->WaitForNextImage
ImageProcessing(pSkInfo->GetImagePtr)
Stop acquisition
End
SK91GigE-WIN Order Code
Commentaires sur ces manuels