Related Manuals for Teledyne Sapera LT 8.10
Summary of Contents for Teledyne Sapera LT 8.10
- Page 1 ™ Sapera LT 8.10 Getting Started Manual For GigE Vision Cameras sensors | cameras | frame grabbers | processors | software | vision solutions P/N: OC-SAPM-INTR0 www.teledynedalsa.com...
- Page 2 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.
-
Page 3: Table Of Contents
DALSA G ......16 SING APERA WITH A ELEDYNE ISION EVICE Sapera LT Classes For GigE Vision Device Applications ......16 Connecting a Teledyne DALSA GigE Vision Camera ........17 ..........18 SING APERA WITH ARTY AMERAS ................19 SING THE... - Page 4 JPEG Decompression Statistics ............... 45 Image Statistics ................... 45 Camera Information ................46 Message Area ..................46 ..............46 AMERA IRMWARE PDATE XAMPLE APPENDIX: FILE LOCATIONS CONTACT INFORMATION ..................48 ALES NFORMATION ..................48 ECHNICAL UPPORT 4 • Contents Sapera LT Getting Started Manual...
-
Page 5: Sapera Lt With Gige Vision Cameras
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. -
Page 6: Introduction To Sapera Lt
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 3 party GigE cameras, a license must be purchased to activate the Sapera Network Imaging Package;... -
Page 7: Escriptions
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 Provides a general overview of the Sapera LT APIs Started Manual For with frame grabbers, possible hardware Frame Grabbers configurations, and a quick overview of Sapera programming. -
Page 8: Ystems
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 •... -
Page 9: Types
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. -
Page 10: Upgrading Previous Versions Of Sapera Lt
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 >... - Page 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. Sapera LT Getting Started Manual Introduction to Sapera LT • 11...
-
Page 12: Application Architecture
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. -
Page 13: Library Architecture
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. -
Page 14: Configuration Files
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. -
Page 15: Quick Start Guide
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;... -
Page 16: Using Sapera Lt With A Teledyne Dalsa Gige Vision Device
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;... -
Page 17: Connecting A Teledyne Dalsa Gige Vision Camera
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... -
Page 18: Tool
Note: When using a Sapera LT application with 3 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. -
Page 19: Using The Camexpert Tool
• 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 •... - Page 20 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. 20 • Quick Start Guide Sapera LT Getting Started Manual...
-
Page 21: Sapera Lt Utilities
To launch the Sapera Monitor use the Start•All Programs•Teledyne DALSA•Sapera LT•Tools•Sapera Monitor menu shortcut. Note: older driver versions of Teledyne DALSA devices may not support Sapera Monitor. Check the Teledyne DALSA website for updated drivers for your device that support Sapera Monitor. - Page 22 Statistic Tab Clicking on the Statistic tab displays various real-time acquisition statistics, such as the Frame Rate. Note that different devices can support different statistics and not all devices support all statistics. In addition, these real-time acquisition statistics are not included in generated reports. Thus, depending on the selected device, the Statistics tab may not be available.
-
Page 23: Sapera Monitor Menu Commands
Sapera Monitor Menu Commands The Sapera Monitor menu provides access to File, View, and Event Control commands. File Menu Commands The File•Generate Report command generates a text file report that includes all event settings and messages included in the current Output Messages pane. The File•Clear Log Information command clears the current Output Messages pane. - Page 24 Event Control Menu Commands The Event Control•Enable and Disable commands enable or disable the currently selected event in Event table. The Event Control•Reset event count command returns the event counter to zero for the currently selected event in Event table. Alert Settings You can specify the alert options for each available event using the Alert Settings command, available through the Event Control menu or by right-clicking on the selected event.
-
Page 25: Using Sapera Monitor
When an alert is generated , the Alert icon is displayed in the Alert column of the event. An alert message, in red, also appears in the Output Messages Settings pane. Message Settings You can specify the events to enable message logging and the number of events required to generate a log message using the Message Settings command, available through the Event Control menu or by right-clicking on the selected event.. -
Page 26: Sapera Log Viewer
The Sapera Log Viewer utility program included with Sapera LT provides an easy way to view error and other types of messages generated by Sapera LT applications and Teledyne DALSA hardware, such as cameras and frame grabbers. Typically, the Sapera Log Viewer application is used by technical support to troubleshoot software and hardware problems. -
Page 27: Network Configuration Tool
Easily Configure the NIC as a DHCP server for connected GigE Vision cameras. Refer to the Teledyne DALSA Network Imaging module manual for more detailed information on using this tool. As shown below, the Network Configuration tool can quickly verify and modify the network configuration of the imaging system. -
Page 28: Demos And Examples
Demos and Examples Several generic demos and examples are available for both Sapera ++ and Sapera .NET. Complete source code is provided for projects in Microsoft Visual Studio 2005 to 2013. Source code for Sapera LT ++ based demos and examples can now be compiled as Unicode instead of ANSI. -
Page 29: Gig E-V Ision Amera Emo
GigEBayerDemo This program demonstrates the Bayer conversion functionality included in Sapera LT with a Teledyne DALSA GigE Vision™ camera. It allows you to acquire images either in continuous or in one-shot mode, while adjusting the acquisition parameters. It includes interactive control of Bayer conversion parameters. - Page 30 GigEFlatFieldDemo This program demonstrates how to use the flat field correction function included in Sapera LT ++ with a Teledyne DALSA GigE Vision™ camera. Flat Field Correction (FFC) includes Fixed Pattern Noise (FPN), Pixel Replacement, Photo Response Non Uniformity (PRNU), and Shading Correction.
-
Page 31: G Eneric S Apera Lt E Xamples
Generic Sapera LT Examples The following compiled console examples and source code is available: Example Name Description ColorSplit Shows how to split and merge color images into single monochrome components. An RGB image is loaded, split into three monochrome components, then a simple processing is applied to the three components before they are merged back to RGB as output. - Page 32 Acquiring with GigE-Vision Camera Demo The Sapera LT GigE-Vision Camera Demo program allows you to grab and display a live image in a host buffer. It can accommodate any Sapera-compatible board with any camera. This demo is a good starting point to verify that your camera and frame grabber are properly installed. The following dialog box appears when starting Grab Demo: You must select the Acquisition Server and the Acquisition Device.
- Page 33 Click OK to start the demo. By using GigE-Vision Camera Demo you can now: Control the acquisition using the Snap, Grab, and Freeze buttons. • Load/save images from/to disks using the Load and Save buttons. • Reload the CCF file using the Load Config button (this overwrites all the parameters •...
-
Page 34: Demo
Using the GigE Sequential Grab Demo The sequential grab demo allows you to grab a sequence of images and save them as a .AVI file. The user can set the number of images in the sequence. For high frame rate applications, the number of frames that generate transfer events can be increased to reduce the CPU overhead. - Page 35 The demo also displays the timestamps generated by the camera and saved in the image buffer. These timestamps can be analyzed to ensure that no images are lost. In addition, clicking the camera timestamp Reset button provides an easy way to calculate the round trip required for a function to be sent to the camera and the response received, providing a means to evaluate the network speed.
-
Page 36: Rab
Using the GigE Metadata Demo For GigE cameras that support metadata, the GigE Metadata Demo allows you to select the metadata to generate for images and save this metadata to file. It also includes the same functionality as the GigE Sequential Grab Demo, such as camera acquisition timestamps. 36 •... - Page 37 To activate the metadata functionality, use the Enable Metadata checkbox and select the required metadata. Sapera LT Getting Started Manual Demos and Examples • 37...
-
Page 38: Flat Field Demo Main Window
Using the GigE-Vision Flat Field Demo Flat Field Correction is the process of eliminating small gain differences between pixels in a CCD array. When calibrated flat field correction is applied to the image, the CCD exposed to a uniformly lighted field will have no gray level differences between pixels. The Flat Field demo automatically functions both with hardware supporting flat field processing or performs the processing via the Sapera library on the host system processor. -
Page 39: Set Up Dark And Bright Acquisitions With The Histogram Tool
Set up Dark and Bright Acquisitions with the Histogram Tool Before performing calibration, verify acquisition with a live grab. Also at this time make preparations to grab a flat light gray level image, required for the calibration, such as a clean evenly lighted white wall or non-glossy paper with the lens slightly out of focus. -
Page 40: Verify A Dark Acquisition
Verify a Dark Acquisition Close the camera lens iris and cover the lens with a lens cap. Using CamExpert, click on the grab button and then the histogram button. The following figure shows a typical histogram for a Genie grabbing a very dark image. Important: In this example, the average pixel value for the frame is close to black. -
Page 41: Verify A Bright Acquisition
Verify a Bright Acquisition Aim the camera at a diffused light source or evenly lit white wall with no shadows falling on it. Using CamExpert, click on the grab button and then the histogram button. Use the lens iris to adjust for a bright gray approximately around a pixel value of 200 (for 8-bit pixels). -
Page 42: Using Flat Field Correction
Using Flat Field Correction The demo has typical file and acquisition controls as previously described for the Grab Demo. What is different is the Flat Field Correction control section which has three buttons and a check box. Follow the procedure described below to setup and use flat field correction. Verify camera acquisition First ensure that the camera is functioning and that the acquisition board is capturing live images. -
Page 43: Setup Before Calibration
Setup Before Calibration First select the Correction Type as flat field or single flat line. Note that when using a line- • scan camera, only flat line calibration is available. Video type will default to the acquisition type defined in the loaded camera file. •... -
Page 44: Calibration Procedure
Calibration Procedure • Setup the camera to capture a uniform dark image. Black paper with no illumination and the camera lens’ iris closed to minimum can provide such a black image. Click on Acquire Black Image. The flat field demo will grab a video frame, analyze the •... -
Page 45: Sapera Camera Compression Demo
Sapera Camera Compression Demo The compression demo works with cameras with onboard image compression such as the Genie TS with JPEG firmware (model dependent). The demo allows activating the camera’s compression function and decompresses the image stream to display on the host system monitor. The demo program’s decompression features are highlighted in the image below. -
Page 46: Camera Information
Camera Firmware Update Example For Teledyne DALSA GigE cameras that support GenICam file access, the camera firmware update example demonstrates how to implement camera firmware updates and validation at the application level. This can be useful to ensure that cameras are equipped with the required firmware version certified for your system. -
Page 47: Appendix: File Locations
Sapera\Examples Source code for console based demo applications Sapera\Examples\Binaries Executable files for console based demo applications Sapera\GenICam_2_4 GenICam CLProtocol run-time support for Teledyne DALSA CameraLink cameras Sapera\Help On-line documentation (Compiled HTML and PDF formats) Sapera\Help\VisualStudio Integrated C++ and .NET help for Visual Studio 2005,... -
Page 48: Contact Information
Note, the Sapera Log Viewer and PCI Diagnostic tools are available from the Windows start menu shortcut Start•All Programs•Teledyne DALSA•Sapera LT. The Device Manager utility is available as part of the driver installation for your Teledyne DALSA device and is available from the Windows start menu shortcut Start•All Programs•Teledyne DALSA•<Device Name>•Device Manager.