Teledyne Sapera LT 8.10 Parts list manual

Sapera LT™8.10
Getting Started Manual
For GigE Vision Cameras
P/N: OC-SAPM-INTR0
www.teledynedalsa.com
sensors | cameras | frame grabbers | processors | software | vision solutions

NOTICE
© 1998-2016 Teledyne DALSA, Inc. All rights reserved.
This document may not be reproduced nor transmitted in any form or by any means, either
electronic or mechanical, without the express written permission of TELEDYNE DALSA. Every effort
is made to ensure the information in this manual is accurate and reliable. Use of the products
described herein is understood to be at the user’s risk. TELEDYNE DALSA assumes no liability
whatsoever for the use of the products detailed in this document and reserves the right to make
changes in specifications at any time and without notice.
Microsoft® is a registered trademark; Windows®, Windows® XP, Windows® Vista, Windows® 7,
Windows® 8 are trademarks of Microsoft Corporation.
All other trademarks or intellectual property mentioned herein belongs to their respective owners.
Printed on January 6, 2016
Document Number: OC-SAPM-INTR0
Printed in Canada
About This Manual
This manual exists in Windows Help, and Adobe Acrobat® (PDF) formats (printed manuals are
available as special orders). The Help and PDF formats make full use of hypertext cross-references.
The Teledyne DALSA home page on the Internet, located at
http://www.teledynedalsa.com/imaging, contains documents, software updates, demos, errata,
utilities, and more.
About Teledyne DALSA
Teledyne DALSA is an international high performance semiconductor and electronics company that
designs, develops, manufactures, and markets digital imaging products and solutions, in addition
to providing wafer foundry services.
Teledyne DALSA Digital Imaging offers the widest range of machine vision components in the
world. From industry-leading image sensors through powerful and sophisticated cameras, frame
grabbers, vision processors and software to easy-to-use vision appliances and custom vision
modules.

Sapera LT Getting Started Manual
Contents •3
Contents
SAPERA LT WITH GIGE VISION CAMERAS 5
Supported Industry Standard...................................................................5
INTRODUCTION TO SAPERA LT 6
SAPERA LT LICENSING......................................................................................6
THE SAPERA LT APIS.......................................................................................6
SAPERA TOOLS AND UTILITIES ............................................................................6
SAPERA LT MANUAL DESCRIPTIONS ......................................................................7
SUPPORTED OPERATING SYSTEMS ........................................................................8
SUPPORTED SAPERA LT DEVELOPMENT ENVIRONMENTS ...............................................8
INSTALLATION TYPES .......................................................................................9
Upgrading Previous Versions of Sapera LT...............................................10
START MENU SHORTCUTS................................................................................10
SAPERA LT ARCHITECTURE OVERVIEW .................................................................12
Application Architecture ........................................................................12
Library Architecture..............................................................................13
Configuration Files................................................................................14
QUICK START GUIDE 15
USING SAPERA LT WITH A TELEDYNE DALSA GIGEVISION DEVICE ..............................16
Sapera LT Classes For GigE Vision Device Applications..............................16
Connecting a Teledyne DALSA GigE Vision Camera...................................17
USING SAPERA LT WITH 3RD PARTY GIGECAMERAS .................................................18
USING THE CAMEXPERT TOOL ...........................................................................19
SAPERA LT UTILITIES 21
SAPERA MONITOR .........................................................................................21
The Sapera Monitor Window ..................................................................21
Sapera Monitor Menu Commands ...........................................................23
Using Sapera Monitor............................................................................25
SAPERA LOG VIEWER .....................................................................................26
NETWORK CONFIGURATION TOOL.......................................................................27
DEMOS AND EXAMPLES 28
DEMO SOURCE CODE .....................................................................................28
EXAMPLE SOURCE CODE..................................................................................28
DEMOS AND EXAMPLES FOR GIGEVISION DEVICES..................................................29
GENERIC SAPERA LT EXAMPLES.........................................................................31
ACQUIRING WITH GIGE-VISION CAMERA DEMO ......................................................32
USING THE GIGESEQUENTIAL GRAB DEMO...........................................................34
USING THE GIGEMETADATA DEMO.....................................................................36
USING THE GIGE-VISION FLAT FIELD DEMO..........................................................38
Flat Field Demo Main Window ................................................................38
Set up Dark and Bright Acquisitions with the Histogram Tool .....................39
Verify a Dark Acquisition .......................................................................40
Verify a Bright Acquisition .....................................................................41
Using Flat Field Correction.....................................................................42
Flat Field Calibration.............................................................................42
Setup Before Calibration .......................................................................43
Calibration Procedure............................................................................44
SAPERA CAMERA COMPRESSION DEMO.................................................................45
Enable JPEG ........................................................................................45

4•Contents
Sapera LT Getting Started Manual
JPEG Decompression Statistics...............................................................45
Image Statistics...................................................................................45
Camera Information .............................................................................46
Message Area ......................................................................................46
CAMERA FIRMWARE UPDATE EXAMPLE..................................................................46
APPENDIX: FILE LOCATIONS 47
CONTACT INFORMATION 48
SALES INFORMATION......................................................................................48
TECHNICAL SUPPORT......................................................................................48

Sapera LT Getting Started Manual
Sapera LT with GigE Vision Cameras •5
Sapera LT with GigE Vision
Cameras
GigE Vision® cameras provide image acquisition using standard Gigabit Ethernet network adapters
and Ethernet cables without the need for frame grabber hardware, and are suitable for a variety of
applications. The GigE Vision standard provides a user friendly common interface to control camera
functionality across platforms. GigE Vision cameras use an XML file, stored on the device, to
describe the camera features, which are standardized. These features are then exposed through
the Sapera API.
All cameras that are GigE Vision compliant use the same feature names (established by the
Standard Feature Naming Convention (SNFC)) to control the camera, though manufacturers can
use camera specific features that are not part of this standard.
The Sapera LT SDK includes the Network Imaging package which provides support for cameras
that use the GigE Vision standard. The GigE Vision Module software provides all components
required to control GigE Vision devices.
GigE Vision cameras require a Gigabit Network Interface adapter. Refer to the camera
documentation for more information.
Supported Industry Standard
GigE Vision cameras that are compliant with the GigE Vision 1.0
specification which defines the communication interface protocol used by
any GigE Vision device. The device description and capabilities are
contained in an XML file. For more information see:
http://www.machinevisiononline.org/public/articles/index.cfm?cat=167

6•Introduction to Sapera LT
Sapera LT Getting Started Manual
Introduction to Sapera LT
Sapera™ LT is a software API for controlling image acquisition devices such as cameras. Sapera LT
libraries support Teledyne DALSA cameras and frame grabbers as well as hundreds of 3rd party
camera models across all common interfaces formats like GigE Vision®, Camera Link®, as well as
emerging new image acquisition standards such as CLHS.
If your application requires image processing or GPU optimization, Sapera Essential, a full-
featured image processing library, is available as a separate software package. For more
information see www.teledynedalsa.com/imaging/products/software/.
The Sapera LT Getting Started Manual provides an introduction to the Sapera LT API and is
designed to help programmer's with installation, and quickly perform hardware setup and
validation.
Sapera LT Licensing
Sapera LT is available free of charge, both SDK and runtime versions, when used with Teledyne
DALSA frame grabber or camera products. However, if Sapera LT is used with 3rd party GigE
cameras, a license must be purchased to activate the Sapera Network Imaging Package; refer to
the section Using Sapera LT with 3rd Party GigE Cameras.
The Sapera LT APIs
Sapera LT includes everything you need to acquire and display images, using one of its 3
application programming interfaces (API):
•Sapera LT++ classes (based on C++ language)
•Sapera LT .NET classes (based on .NET languages)
•Sapera LT Standard API (based on C language)
It is targeted at developers that have their own image processing libraries and want to interface
those libraries to a Sapera LT compatible device. Sapera LT includes tools such as CamExpert to
speed up application development.
Hardware independent classes allow one application to control different Teledyne DALSA devices
through the same API. It also guarantees seamless migration to any future Teledyne DALSA
hardware product supported by Sapera LT.
If you are using Sapera LT with a GigE Vision camera, the Sapera Network Imaging Package is also
provided to communicate with and control devices using the GigE Vision protocol.
Sapera Tools and Utilities
The Sapera LT SDK and runtime installations include the following a set of tools and utilities:
•CamExpert: acquisition and device configuration, including image display
•Sapera Monitor: real-time event viewing of applications.
•Sapera Log Viewer: error and other message log for applications and hardware
•Network Configuration Tool: network configuration

Sapera LT Getting Started Manual
Introduction to Sapera LT •7
Sapera LT Manual Descriptions
Sapera LT is supported by the following manuals in PDF, and compiled HTML help formats.
API/Topic
Title
Description
General Sapera LT Getting
Started Manual For
Frame Grabbers
Provides a general overview of the Sapera LT APIs
with frame grabbers, possible hardware
configurations, and a quick overview of Sapera
programming.
General Sapera LT User’s Manual Introduces Sapera LT ++ API and Sapera .NET API
programming procedures, including sample code for
typical operations in C++, C# and VB .NET.
GigE Vision GigE Vision Module
User’s Manual
Describes the GigE Vision Host Control features and
overview of available GigE demos.
GigE Vision Network Imaging User’s
Manual
Network setup and optimization guide for GigE Vision
cameras as well as troubleshooting guidelines.
.NET Sapera LT .NET
Programmer’s Manual Provides a complete reference of the Sapera .NET Framework for Visual Studio. Sapera .NET reflects the
underlying low-level Sapera LT architecture.
C++ Sapera LT ++
Programmer’s Manual
Provides a complete reference of all the Sapera LT ++
classes. Sapera LT ++ is based on the C++ language.
C++ Sapera LT GUI Classes
Reference Manual Describes the C++ GUI (graphical user interface) helper classes used to create common application
dialogs. These classes are used in the Sapera demo
programs and are provided to help users with
applications that require a GUI.
C++ Sapera LT Legacy
Classes Reference
Manual
Describes the obsolete C++ classes that continue to
be supported but have been replaced or retired.
C Sapera LT Acquisition
Parameters Reference
Manual
Describes the Sapera LT low level acquisition
parameters and capabilities (based on the C
language).
C Sapera LT Basic Modules
Reference Manual Lists in detail the Sapera LT low-level module functions as well as data definitions, file formats, and
macros (based on the C language).

8•Introduction to Sapera LT
Sapera LT Getting Started Manual
Supported Operating Systems
•Windows XP® (32-bit and 64-bit)
•Windows 7® (32-bit and 64-bit)
•Windows 8® (32-bit and 64-bit)
•Windows 8.1® (32-bit and 64-bit)
•Windows 10® (32-bit and 64-bit)
(Note: Windows NT 4.0, Windows 2000 and Windows Vista are no longer supported.)
Supported Sapera LT Development Environments
•PCI-bus IBM PC or compatible with Pentium class or later processor
•C/C++ and .NET language compilers, for both 32-bit and 64-bit development:
•Microsoft Visual Studio 2005 (with Service Pack 1)
•Microsoft Visual Studio 2008 (with Service Pack 1)
•Microsoft Visual Studio 2010
•Microsoft Visual Studio 2012
•Microsoft Visual Studio 2013
For 32-bit development:
•Borland C++Builder XE(versions XE1 to XE5)
If you are using Visual Studio 2005 or 2008 to develop Sapera LT applications, then you should have
the latest Service Pack plus all security patches installed. You can check if these are installed through
the Help->About menu item in Visual Studio.

Sapera LT Getting Started Manual
Introduction to Sapera LT •9
Installation Types
When installing Sapera LT, you are provided with a choice of different setup types, each with its
own dedicated installation program.
The full SDK (software development kit) installation provides access to all available Sapera LT
functions, tools, and utilities, such as CamExpert, for 32 or 64-bit application development, and
optionally the GigE Vision module (if required).
Installation Type
Notes
Sapera LT Full SDK Full installation of the software development kit, including all
tools and utilities. Installation options allow you to install
components for frame grabbers only, for GigE Vision cameras
(includes the Sapera Network Imaging Package) only, or all
components.
Sapera LT Runtime
(32 or 64-bit)
Runtime installation for application deployment, including all
tools and utilities, and optionally the GigE Vision module (if
required).
Sapera LT Runtime WoW64
(32-bit application for 64-bit OS)
CamExpert
Installation of CamExpert only (includes GigE Vision module).
CamExpert WoW
(32-bit application for 64-bit OS)
Sapera LT Camera SDK Installation of Sapera LT Camera SDK for Gen CP CameraLink
cameras. Feature control only.
Sapera LT Camera SDK Runtime Runtime installation for application deployment of Sapera LT
Camera SDK for GenCP CameraLink cameras. Feature control
only.
These executable files are available for download directly from the Teledyne DALSA website:
http://teledynedalsa.com/imaging/support/downloads/sdks/
Warning: The Sapera LT GigE Vision driver is not supported under WoW64 runtime environments.
Alternatively, a Sapera Vision Software disk is also available. Use the Sapera Vision Software
installation disk autorun program and select the Software Installation option, and follow the
instructions. The software disk also allows you to select any Teledyne DALSA frame grabber drivers
or GigE camera software to install.
Note: The Sapera LT Camera SDK is also available for use when using Teledyne DALSA Camera Link
cameras with third party frame grabbers only. It is provided as part of the Teledyne DALSA camera
installation.

10 •Introduction to Sapera LT
Sapera LT Getting Started Manual
Upgrading Previous Versions of Sapera LT
Sapera LT 7.30 and Higher
When upgrading from Sapera LT version 7.30 or higher, uninstalling is not required; proceed
directly to installation of Sapera LT 8.10
Sapera LT 7.20 and Lower
Before installing Sapera LT 8.10, uninstall Sapera LT from the Windows Control Panel > Programs
and Features.
Start Menu Shortcuts
For Windows 7, Start Menu shortcuts for Sapera LT are available under All Programs > Teledyne
DALSA > Sapera LT and >Sapera Network Imaging Package.
The following screenshots display the menus for the full Sapera LT SDK.

Sapera LT Getting Started Manual
Introduction to Sapera LT •11
For Windows 8, shortcuts are presented as tiles on the desktop through the Apps menu.
See Appendix: File Locations for a complete description of directory contents.

12 •Introduction to Sapera LT
Sapera LT Getting Started Manual
Sapera LT Architecture Overview
The following section describes application architecture, related terms, and illustrates Sapera LT’s
library architecture.
Application Architecture
Whichever API is used (Sapera LT ++, Sapera LT .NET, or Standard C), the Sapera LT modular
architecture allows applications to be distributed on different Sapera LT servers. Each server can
run either on the host computer or on a Teledyne DALSA device. Sapera LT calls are routed to
different servers via the Sapera LT messaging layer in a fashion completely independent of the
underlying hardware.
What is a server?
A Sapera Server is an abstract representation of a physical device like a frame grabber, a camera,
or a desktop PC. In general, a Teledyne DALSA board is a server. Some processing boards,
however, may contain several servers; this is true when using multi-processor boards.
A server allows Sapera applications to interact with the server’s resources.

Sapera LT Getting Started Manual
Introduction to Sapera LT •13
Library Architecture
The typical machine vision application requires configuration of acquisition resources, image
capture and transfer to memory buffers. These image buffers can then be processed or displayed,
analyzed, with results determining subsequent processes. Events can also be monitored to trigger
appropriate responses. The Sapera LT library architecture is organized around these basic machine
vision functional blocks.
Vision applications developed with Sapera LT are typically programmed in either the Sapera LT++
API (Application Programming Interface) or the Sapera LT .NET API. In general, both APIs use
similar classes and naming conventions.
Sapera LT Standard C API is available for programmers who prefer working with the underlying
Sapera LT C layer or who are maintaining legacy code. It provides access most of the same
functionality as the higher level, object oriented programming C++ and .NET APIs (for example, it
does not support flat field calibration and software correction). For more information refer to the
Sapera LT Basic Modules Reference Manual and the Sapera LT Acquisition Parameters Reference
Manual.
The following block diagram, while not exhaustive of all the classes available in Sapera LT,
illustrates the major functional blocks with the corresponding classes.
Classes for
feature-based devices
(GigE Vision | GenCP CL)
(hardware control)
Image Display
(Optional)
SapDisplay
Or use your own
display mechanism
(for example DirectX)
Classes for controlling
image buffer display
SapView
Image
Image
SapFlatField
SapColorConversion
SapLut
SapProcessing
(user-defined
processing algorithms)
Image
Classes for image
processing
Image Acquistion
Image
Class for image
buffer resources
Class for controlling
image acquisition
and transfer
SapTransfer SapBufferSapAcqDevice
Acquisition Configuration
SapFeature
Software Processing
(Optional)
For the complete reference to the Sapera LT APIs refer to the Sapera LT ++ Programmer’s
Manual or Sapera LT.NET Programmer’s Manual.
In addition, the Sapera LT User’s Manual provides explanations and multiple code snippets, in
both C++ and .NET languages, for typical application operations.
It is always recommended to use the source code provided with the demos and examples
as both a learning tool and a starting point for your applications. For a complete list and
description of the demos and examples for GigE cameras included with Sapera LT see
Demos and Examples.

14 •Introduction to Sapera LT
Sapera LT Getting Started Manual
Configuration Files
Most GigE cameras support saving a user-defined set of parameter settings that can be loaded
instead of the factory defaults on power-up.
If the camera supports file access, the feature parameter settings can be downloaded from the
camera and saved to a file. This file can then be uploaded to a camera to use these feature settings
and saved as a user set. This can be useful if you want to use the same settings for multiple
cameras.
If the camera does not support file access Sapera LT applications can load an acquisition
configuration file before acquiring images from a camera. The camera configuration file has the
extension .ccf.
Use CamExpert to generate a .ccf file for cameras with parameters as required by your imaging
project.
The SapAcqDevice constructor, for GeniCam-compliant cameras, have prototypes that use .ccf
files. For cameras, if no .ccf file is available, the camera default parameters are used.

Sapera LT Getting Started Manual
Quick Start Guide •15
Quick Start Guide
For Teledyne DALSA GigE Vision cameras, during installation, choose either the option to install
Sapera LT for GigE Vision cameras and the Sapera Network Imaging Package or All acquisition
components.
Note that if you try to install Sapera LT from a network location you will not be able to
install the Sapera Network Imaging Package; copy the installation executable locally.
Currently, Sapera LT supports GenICam GenCP CL and GigE Vision standards (including all
mandatory feature requirements).

16 •Quick Start Guide
Sapera LT Getting Started Manual
Using Sapera LT with a Teledyne DALSA GigE Vision Device
Sapera LT Classes For GigE Vision Device Applications
The following diagram represents a typical application flow showing the Sapera LT object types
associated with each component or stage.
GigE Vision cameras require a Gigabit network connection on the host computer which is not used
on a corporate network; refer to the Sapera Network Imaging Package documentation for
installation requirements.

Sapera LT Getting Started Manual
Quick Start Guide •17
Connecting a Teledyne DALSA GigE Vision Camera
To configure a Teledyne DALSA GigE Vision Camera:
1. Refer to the camera user’s manual and the Sapera GigE Vision User’s Manual.
2. Connect the camera to the GigE network card;.
3. After the device has been detected. Click the icon on the system tray for more device
information.
The Teledyne DALSA GigE Vision Device Status dialog displays information about all
connected devices.
4. Start the CamExpert application, select the camera to configure, and modify the camera
parameter settings as required, and test the image acquisition by clicking the Grab button.

18 •Quick Start Guide
Sapera LT Getting Started Manual
Using Sapera LT with 3rd Party GigE Cameras
If you are using the Sapera LT SDK with 3rd party GigE cameras only, a valid Sapera Processing
license is required to activate the Teledyne DALSA GigE Vision Module. The Sapera License
Manager Tool must be installed with Sapera LT to activate this license.
Note: When using a Sapera LT application with 3rd party GigE Vision cameras without Sapera
Processing or a Teledyne DALSA GigE Vision connected on the same system, a license is required to
unlock the Sapera LT GigE Vision Module.
For more information, contact your Teledyne DALSA sales representative.
To install the Sapera License Manager tool during the Sapera LT installation use the command line
switch “-slm”. The command line switch is required as the option is not available during standard
installations.
For example, in the command terminal, use the following command:
SaperaLTSDKSetup.exe –slm
The Sapera License Manager executable file is available in the following directory:
<Install Directory>Program Files\Teledyne DALSA\Sapera License Manager\Bin\SvsLMgr.exe
The Sapera License Manager application can also be launched from the Windows Start menu:
Start > All Programs > Teledyne DALSA > Sapera License Manager > Sapera License
Manager
For more information on the Sapera License Manager tool, refer to the online help system available
with the tool.

Sapera LT Getting Started Manual
Quick Start Guide •19
Using the CamExpert Tool
The CamExpert application uses various panels to simplify choosing and configuring camera files or
acquisition parameters for the installed devices. Features include:
•Supports all Teledyne DALSA hardware currently supported by Sapera LT.
•Creates and modifies camera configuration (.ccf files.
•Supports Teledyne DALSA GigE Vision cameras such as the Genie series by presenting the
camera Features controls as defined by the camera’s XML file.
•Groups acquisition parameters into related categories for easier access to any specific
parameter.
•Intelligent editing of video timings through a locking mechanism that allows explicit
modification of some values and automatic recalculation of the remaining ones.
•Live acquisition display window which allows immediate verification of timing or control
parameters without the need to run a separate acquisition program
Device
Selector
Configuration
menu
Detection
Commands
Parameters
Output
Message tab
Display
Window
Camera Link
Serial
Command
tab
Video Status
bar
•Device Selector: The Device menu allows you to view and select from any installed Sapera
acquisition device. After a device is selected, CamExpert only presents acquisition parameters
applicable to that device.
The Configuration menu allows selecting any camera file that is included with the Sapera
installation. Only camera files supported by the selected acquisition device are displayed. When
there is more than one acquisition server, such as monochrome and RGB, selecting an
inappropriate camera file will produce a message prompting you to select the correct acquisition
server.
The Detection command buttons allow you to detect cameras that comply with the GenICam
GenCP protocol or Teledyne DALSA cameras that use the three letter protocol. Clicking the
Settings button allows you to set the camera detection communication settings.

20 •Quick Start Guide
Sapera LT Getting Started Manual
•Parameters panel: Allows viewing or changing all acquisition parameters supported by the
acquisition device. CamExpert displays parameters only if those parameters are supported by
the installed device. This avoids confusion by eliminating parameter choices when they do not
apply to the hardware in use.
•Display panel: Provides a live or single frame acquisition display. Frame buffer parameters are
shown in an information bar above the image window. The Display pane includes CamExpert
control buttons. These are:
Acquisition control button:
Click once to start live grab, click again to stop.
Single frame grab:
Click to acquire one frame from device.
Software trigger button:
With the I/O control parameters set to Trigger Enabled / Software Trigger type, click to
send a single software trigger command.
CamExpert display controls:
(these do not modify the frame buffer data)
Stretch image to fit, set image display to original size, or zoom the image to any size
and ratio.
Histogram / Profile tool:
Select to view a histogram or line/column profile during live acquisition.
•Output Messages Panel: Displays messages from CamExpert or the device driver.
•Camera Serial Link Command tab: Use this to send ASCII commands from CamExpert to
Teledyne DALSA CameraLink cameras.
•Video Signal Status bar: Located on the lower right of the CamExpert window, color coded
camera signal status information is displayed. These are in green for valid signals detected, and
in red for missing or incorrect signals. Video status items may differ with different devices.
Additional Information
For additional information about Sapera acquisition parameters, refer to the Sapera Acquisition
Parameters Reference Manual.
See either the corresponding device user’s manual or search within this manual for limitations
applicable to specific Teledyne DALSA hardware.