Home

Sapera LT User`s Manual

1. Once images have been grabbed and transferred to host memory they can be processed by the CPU The Sapera Processing Library offers hundreds of optimized functions If you want to implement your own algorithm instead the wizard can insert source code that shows the steps involved in accessing the image data Application involves image display only Allow access to frame buffer check all that apply Generic access to frame buffer Use Sapera Processing Libraries Note Please have a valid Sapera Processing license installed on the computer before attempting to compile the code generated by the wizard Finish Cancel Help Sapera LT User s Manual Using Sapera LT e 29 Step 5 Displaying Images If you select the Enable graphics overlay option the wizard will write code that will attempt to use the display adapter s overlay hardware acceleration If it is not available then the overlay will be drawn by software for each displayed frame Event Notification For synchronization purposes you may register your functions called by Sapera LT at specific events like at the end of a frame s acquisition In this step you can select which events will trigger a Sapera LT Application Wizard written function to be called Note that some events may have been automatically selected depending on your answers in the previous steps of the wizard Sapera Imaging Library Step 5 of 5 LX Displaying Images Selectth
2. ALS V technology with vision DALSA e 7075 Place Robert Joncas Suite 142 e St Laurent Quebec HAM 2Z2 e Canada http www imaging com Sapera LT User s Manual Edition 6 00 part number OC SAPM USERO NOTICE 2004 2006 DALSA Corp 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 DALSA Corp 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 DALSA Corp 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 NT Windows 2000 and Windows XP are trademarks of Microsoft Corporation All other trademarks or intellectual property mentioned herein belong to their respective owners Printed on August 3 2006 Document Number OC SAPM USERO Printed in Canada Contents INTRODUCTION 1 OVERVIEW OF SAPERA LT MANUALS i I ABOUT THE MANUAL ieri eee receive rei ere 2 USING THE MANUA RE EN da kn pp noe oe 2 GETTING STARTED 3 ABOUT SAPERA LT ossi 3 SAPERA PRODUCTS 4 TN 4 MICROSOFT DIRECTSHOW SUPPORT erarorvrnrnrsrenannrrnnsnrsnennnnrrrnsnessensnnrrnnsnssnensnnrnrnsnssesnannrvnnsnssne
3. Wait 5000 printf Press any key to terminate n getch Release resources for all objects Success pTransfer Destroy success pView gt Destroy success pBuffer gt Destroy success pAcq gt Destroy Free all objects delete pTransfer delete pView delete pBuffer delete pAcq return 0 Modifying the Camera Features The following section describes how to modify camera features individually or by group Accessing Feature Information and Values The following example shows how features of the camera can be accessed Information such as type range and access mode can be retrieved for each supported feature The SapAcqDevice class also allows modifying the feature values by directly writing to the camera In some circumstances a set of feature values are tightly coupled together and must be written to the camera at the same time The next section shows how to proceed in such a case 52 Acquiring Images Sapera LT User s Manual void CameraCallback SapAcqDeviceCallbackInfo pInfo Callback Function BOOL status int eventCount int eventIndex char eventName 64 Retrieve count index and name of the received event status pInfo GetEventCount amp eventCount status pInfo gt GetEventIndex amp eventIndex status pInfo gt GetAcqDevice gt GetEventNameByIndex eventIndex eventName sizeof eventName Check for F
4. 2000 Windows XP Note Windows NT 4 0 and Embedded are no longer officially supported e One of the following C C language compilers Visual C version 6 0 Visual C NET 2003 Visual C 2005 Borland C Builder version 6 0 or later OR e One of the following environments that support ActiveX technology Visual Basic 6 0 Visual Studio NET 2003 Visual Studio 2005 Borland Delphi version 7 Hardware Requirements optional e One of several Sapera LT compatible devices frame grabber processing board or camera e Corresponding Sapera LT compatible device drivers Sapera LT User s Manual Getting Started e 5 Installation Procedure Note Before installing Sapera LT make certain that your current VGA display mode is set to display at least 256 colors Some Sapera LT features require DirectDraw which will not work with a smaller number of display colors The following steps describe how to install Sapera LT onto your hard drive l 2 Tes Insert the Sapera LT installation CD ROM 1n a CD ROM drive A CD Browser screen will appear automatically If not from Windows Explorer run the launch exe application located in the root directory of the Sapera LT CD Go to the Sapera LT Installation menu to begin Sapera LT installation Launch Sapera LT installation and follow the on screen instructions During the installation you will be prompted to enter the Sapera LT product key This key
5. If the amount of system memory exceeds four GB Sapera LT automatically uses TypeScatterGatherPhysical instead Virtual Buffers SapBuffer TypeVirtual Similar to TypeScatterGather except that the memory pages are not locked This allows allocation of very large buffers but they cannot be used as source or destination for transfer resources Offscreen Buffers SapBuffer TypeOffscreen Buffers are allocated in system memory SapView objects created using these buffers may use display adapter hardware to copy from the buffer to video memory System memory offscreen buffers may be created using any pixel format but calling the Sap View Show method will take longer to execute if the display hardware does not efficiently support its pixel format OffScreen Buffers in Video Memory SapBuffer TypeOffscreen Video Buffers are allocated in offscreen video memory SapView objects created using these buffers use display adapter hardware to perform a fast copy in video memory These buffers are typically used when a graphical element is reused for several consecutive frames without modification In this case it is more efficient to keep this element in video memory and use display hardware capabilities Overlay Buffers SapBuffer TypeOverlay 62 e Working with Buffers Sapera LT User s Manual Buffers are allocated in video memory Once you create SapView objects using these buffers and call their Show method one time the display adapter
6. Y and chroma C video inputs and outputs Often used interchangeably with S VHS which is technically incorrect Sync The basic piece of information which tells a video display TV or computer monitor where to put the picture Horizontal sync or HSYNC controls the left right dimension and vertical sync or VSYNC controls the top to bottom dimension Tearing A display artifact caused by the fact that the video display will read frame buffer memory asynchronously to the incoming video stream Tearing 1s non data destructive Video Input Conditioning VIC The act of modifying an analog video signal via bandwidth filtering or gain amplification Y C See S Video A common color space used in composite video color systems Y is the luma component while U and V are the color difference components 84 e Glossary of Terms Sapera LT User s Manual Index A About Sapera LT 3 acquisition device camera 51 acquisition parameters 19 ActiveX 5 7 15 17 31 39 ActiveX Controls 39 API 3 4 31 33 39 40 41 42 43 area scan 13 28 ASCII file 77 AVI 16 B Basic Classes 3 24 Board Specific Classes 3 Boolean 42 Borland C 5 Borland C Builder 14 Borland Delphi 5 17 Buffer Types 62 C C class library 3 CAB 3 CAM file 27 Camera file 19 CamExpert 4 12 27 28 capability definition 43 CCA 11 27 CCF 11 12 13 27 46 CD ROM 6 child buffer 61 code samples 14 colo
7. Builder These projects allow you to recompile all the examples in a batch The table below describes the different example programs FileLoadCPP Example This example shows how to load an image file from the disk into a Sapera buffer and then display it The buffer is created according to the image file properties One of several images monochrome RGB or YUV can be selected for loading This example uses the Sapera C API FileLoadMFC Example Same as the FileLoadCPP Example but additionally uses the Sapera GUI classes allowing file browser usage GrabCPP Example This example shows how to grab an image from a selected camera into a Sapera buffer and then display it The buffer is created according to the camera settings Any Sapera compatible frame grabber can be used This example uses the Sapera C API GrabMFC Example Same as GrabCPP but additionally uses the GUI Sapera classes to allow for board and camera selection using dialog boxes ColorSplit Example 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 14 e Using Sapera LT Sapera LT User s Manual Description of Demos Several demo programs are available with Sapera They are more complete applications than the supplied examples Th
8. Class The SapXferCallbackInfo class acts as a container for storing all arguments to callback functions for the SapTransfer class SapXferPair Class The SapXferPair class describes a pair of source and destination nodes for the SapTransfer class SapXferParams Class The SapXferParams class stores parameters needed by a transfer task managed by the SapTransfer class Sapera LT User s Manual Sapera LT Architecture e 37 38 e Sapera LT Architecture Sapera LT User s Manual Introducing the Sapera LT API The Three Sapera LT APIs Three different APIs are available under Sapera LT 1 Sapera classes based on C language 2 Sapera Standard API based on C language 3 Sapera ActiveX Controls language independent The following sections demonstrate Sapera For C and ActiveX API information consult the Sapera Basic Modules Reference Manual and the Sapera ActiveX Controls Programmer s Manual respectively Creating a Sapera Application See the Using Sapera chapter of the Sapera Programmer s Manual for a description of the steps needed for creating a Sapera application Sapera LT User s Manual Introducing the Sapera LT API e 39 Object initialization and cleanup Sapera objects that encapsulate management of Standard API resources are initialized and refreshed in a uniform way which consists of the following steps 1 Allocate memory for the object 2 Create the resources needed by the object through the Create m
9. Class The purpose of the SapBayer class is to support Bayer conversion on images acquired from a camera It supports this functionality both from the acquisition hardware if supported or from a software implementation SapBufferRoi Class The purpose of the SapBufferRoi class 1s to create a rectangular region of interest ROI inside an existing SapBuffer object The ROI has the same origin and dimensions for all buffer resources in the object SapBufferWithTrash Class The SapBufferWithTrash class creates an additional resource called the trash buffer used when transferring data in real time applications The trash buffer is an emergency buffer used when the data transfer is faster than a processing task performed on the buffers When processing is not fast enough to keep up with the incoming data 1mages are transferred temporarily into the trash buffer until stability is reestablished SapCounterCallbackInfo Class The SapCounterCallbackInfo class acts as a container for storing all arguments to callback functions for the SapCounterclass SapFlatField Class The purpose of the SapFlatField class is to perform flat field correction on images acquired from a camera or loaded from a disk It supports this functionality both from the acquisition hardware if supported or from a software implementation SapGioCallbackInfo Class The SapGioCallbackInfo class acts as a container for storing all arguments to callback functions for the
10. Step 5 Displaying Images ue 30 SAPERA LT ARCHITECTURE 31 APPLICATION ARCHITECTURE 5 e iectt ens obettr eese kostet nre 31 DEFINITION OF TERMS sense isse tl wotman naj ga lale ed a a ee l e paka kal kk RO pla W 32 DESCRIPTION OF SAPERATF CLASSES os irte reci aaa 33 INTRODUCING THE SAPERA LT API 39 THE THREE SAPERA LT APIS ra 39 CREATING A SABER AE APPLIC NTION ille 39 OBJECT INITIALIZATION AND CLEANUP cccccsssssesssecsssceteecsseceseeecaaeceseeecsaeceseeeceaeceeeeecsaeeeeeecsaeeeeneess 40 ERROR NN NET DENN MS 42 CAPABILITIES AND PARAMETERS i 43 ACQUIRING IMAGES 45 REQUIRED CLASSES kapo ka oo atm tito dau intera tessile ao ets na are 45 FRAME GRABBER ACQUISITION EXAMPLE cesses aa aoaeaoettesesetoooooooessesenooooooooeoenononooooooeonnonn 45 Steps to perform an acquisition essen eene nrenrere nennen nennen 45 MODIFYING THE FRAME GRABBER PARAMETERS eese nennen entren nennen nnne 48 USING AN INPUT LOOKUP TABLE enne enne en nennen en nennen terns ennt rsen rennen nennen nes 50 CAMERA ACQUISITION EXAMPLE iii 51 MODIFYING THE CAMERA FEATURES sote ka vote rettet ance saa iR rna komet kado PUR EE V a e 52 Accessing Feature Information and Values eese 52 Writing Feature Values by Group essent nennen 56 DISPLAYING IMAGES 57 REQUIRED CLASSES ian EUER 57 DISPLAY EXAMPLE LEEREN 57 DISPLAYING IN A WIN
11. an analog or digital camera Acquisition Demo C Sapera Demos ActiveX NET VsAcqDemo VsAcqDemo csproj This program demonstrates the basic acquisition functions included in the Sapera LT ActiveX controls It allows you to load an acquisition file and then acquire images either in continuous or in one shot mode Clicking the right mouse button over the image display area allows you to modify the acquisition control properties as well as loading and saving images The minimum requirements to run this demo are a Sapera compatible frame grabber and an analog or digital camera Sapera LT User s Manual Using Sapera LT e 17 Acquisition Demo Delphi 7 Sapera Demos ActiveX Delphi AcqDemo AcqDemo dpr This program demonstrates the basic acquisition functions included in the Sapera LT ActiveX controls It allows you to load an acquisition file and then acquire images either in continuous or in one shot mode Clicking the right mouse button over the image display area allows you to modify the acquisition control properties as well as loading and saving images The minimum requirements to run this demo are a Sapera compatible frame grabber and an analog or digital camera 18 e Using Sapera LT Sapera LT User s Manual Using the Flat Field Demo Program Start Programs DALSA Sapera LT DemoseFlat Field Demo Program file DALSA Coreco Sapera Demos Classes wc FlatFieldDemo Release VFlatfieldDemo exe Description This pro
12. and cover a wide range of camera manufacturers and models Sapera Library Step 2 of 5 xj Define Source of Input Image Select one option below to work with previously stored images or specify a frame grabber and camera configuration files to grab live images Work with saved images only Selected board Viper Quad 1 Selected device Viper Quad Single Channel 1 Selected Config file ENCoreco S aperaNCamFilesNUser T RS 170 12 27 MHz C Show the acquisition device selection dialog at program start C Provide control button for acquisition device selection at runtime Finish Cancel Help Sapera LT User s Manual Using Sapera LT e 27 Step 5 Fine Tuning the User Interface It is sometimes more convenient to set some acquisition parameters individually and directly from within the application rather than using CamExpert Sapera Classes define a few standard GUI dialog boxes that allow the user to change a selection of frequently used parameters The screen shot below shows the category list of parameters you can enable Sapera Imaging Library Step 3 of 5 EI Fine Tuning User Interface Selectthe control buttons to be displayed on the application window Other Acquisition control Video input conditionning brightness contrast etc IV Misc controls camera selector etc Iv About box GUI controls to let user load save ci files Iv Status bar r Camera control IV Area
13. as a Text File h or a Binary File cfn The font if saved as a text file can be included directly into your C C source code while the font saved as a binary file must always be loaded from the disk See the CorGraphicSetFont function and Graphic Font File Format description in the Sapera Basic Modules Reference Manual for more information about using fonts DALSA Diagnostic tool Overview The DALSA Diagnostic Tool is a troubleshooting aid for Sapera LT and device driver installations It can generate reports for all supported DALSA devices installed in the system It does not provide reports for old device driver releases This tool generates a system diagnostic report as an XML file This file can be sent to DALSA technical support when assistance is required 70 e Appendix B Other Tools Sapera LT User s Manual Diagnostic Tool Features e Supported by all new DALSA device drivers e Creates an XML diagnostic report file listing relevant files and system registry entries o Validity status after the diagnostic process for each item o Path where each file should be found o File name o File version if available o File creation date o Date of latest file modification o File size o File author company name o For registry keys path name and value e View information in XML file with Internet Explorer Usage Guide When the diagnostic tool is run the set of installed and supported DALSA device drivers is li
14. delete pBuffer delete pChildl delete pChild2 Sapera LT User s Manual Working with Buffers e 61 You may modify the origin and dimensions of the region of interest for a child buffer object before calling its Create method The following example demonstrates this concept left and right children and make their height the same as the parent pChildl 5SetRoi 320 0 320 480 pChild2 gt SetRoi 0 0 320 480 Buffer Types You may create a SapBuffer object using one of many predefined types This has an effect on how the actual buffer resources are allocated and on how the object may be used with other classes such as SapTransfer and SapView Contiguous Memory Buffers SapBuffer TypeContiguous Buffers are allocated in Sapera LT Contiguous Memory which is one large chunk of non pageable and non moveable memory reserved by Sapera LT at boot time Buffer data is thus contained in a single memory block not segmented These buffers may be used as source and destination for transfer resources Scatter Gather Memory Buffers SapBuffer TypeScatterGather Buffers are allocated in noncontiguous memory paged pool Pages are locked in physical memory so that a scatter gather list may be built This allows allocation of very large buffers to be used as source and destination for transfer resources The maximum amount of memory that may be allocated depends on available memory the operating system and the application s used
15. directories can also be merged into one single directory however any sub directories that the install directories Sapera LT User s Manual Appendix C Sapera LT Runtimes e 75 Disk1 Disk2 have within must remain unchanged Do not merge their content into the main install directory For example this directory tree E Sapera LT a Diski C HTML Help I Disk2 Disk3 when merged would become E Ce Sapera LT E Diski CJ HTML Help DALSA Installers Both Sapera LT and the driver installations share the same installer technology As a result the following discussion applies to both Note You must reboot after the installation of Sapera LT However to streamline the installation process you may install Sapera LT without rebooting the required device drivers and then reboot DALSA s installers can be started in two ways 1 Normal Mode This is the interactive mode provided by default It is initiated by invoking the setup exe program The installation proceeds normally as if it was started from Windows Explorer or the Windows command line 2 Silent Mode This mode requires no user interaction Any user input is provided through a response file Nothing is displayed by the installer Note During driver installation Windows Digital Signature and Logo Testing warnings can be safely ignored 76 e Appendix C Sapera LT Runtimes Sapera LT User s Manual Silent Mode Installation Silent Mode
16. functionality for managing a generic transfer process that is the action of transferring data from one source node to a destination node All the following classes are considered to be transfer nodes SapAcquisition SapBuffer SapCab SapDsp and SapPixPro SapView Class The SapView class includes the functionality to show the resources of a SapBuffer object in a window through a SapDisplay object An auto empty mechanism allows synchronization between Sap View and SapTransfer objects in order to show buffers in realtime without missing any data Sapera also includes classes that implement access either to a subset of the functionality of a Standard C API resource or to functionality taken from two or more Standard C API resources There are also some classes that are completely independent of this lower layer Data Classes SapData and its derived classes act as wrappers for low level Sapera LT data types where each class encapsulates one data element of a specific type They are used as method arguments or return values in various Sapera classes SapAcqCallbackInfo Class Sapera LT User s Manual Sapera LT Architecture e 35 The SapAcqCallbackInfo class acts as a container for storing all arguments to callback functions for the SapAcquisition class SapAcqDeviceCallbackInfo Class The SapAcqDeviceCallbackInfo class acts as a container for storing all arguments to callback functions for the SapAcqDevice class SapBayer
17. per video line by the number of active video lines describes the acquisition image resolution The binary size of each pixel for example 8 bits 15 bits 24 bits defines the number of gray levels or colors possible for each pixel Raster The pattern of lines traced by rectilinear scanning in display systems RGB Red Green Blue Commonly used to refer to a non composite video standard which uses these three colors in combination to generate a color video image RS 170 The original United States standard for black and white television Now commonly used to refer to monochrome analog video signals Scaling The act of changing the effective resolution of an image Sapera LT User s Manual Glossary of Terms e 83 SECAM Sequentiel Couleur avec M moire a TV standard similar to PAL in which the chroma is FM modulated and the R Y and B Y signals are transmitted line sequentially Used primarily in France and Russia as well as in several other French speaking and former Warsaw Pact countries Service Functionality derived from a particular software program For example network services may refer to programs that transmit data or provide conversion of data in a network Simple Parameter A parameter with a size less than or equal to a UINT32 Stride The memory distance between two pixels that are viewed as vertically adjacent in the image S Video Separate video also known as Y C video which supports separate luma
18. signal detected Aciquisiias Coral E el Filo Conte How AcquisninaDanass Load Costa iones ren Scan Une Stan Garsia plan By using Grab Demo you can now Control the acquisition using the Snap Grab Freeze and Abort buttons Load save images from to disks using the Load and Save buttons Dynamically adjust the acquisition parameters through the General Area scan Linescan and Composite buttons Reload the CCF file using the Load Config button this overwrites all the parameters modified in step 3 The Buffer button allows you to change the number of buffers used for internal cycling and the type of buffer used contiguous scatter gather off screen or overlay Sapera LT User s Manual Using Sapera LT e 13 Description of Examples Several example programs are available within Sapera They are essentially basic applications demonstrating simple tasks like grabbing an image and loading an image file from the disk The main purpose of the examples is to provide the user with code samples that can be easily extracted and integrated into an application All the examples are included in the following projects Sapera Examples Classes SapExamples dsw for Microsoft Visual C 6 0 Sapera Examples Classes SapExamples 2003 s1ln for Microsoft Visual C NET 2003 Sapera Examples Classes SapExamples 2005 sin for Microsoft Visual C 2005 Sapera Examples Classes SapExamples bpg for Borland C
19. success pBuffer gt Read 0 size dataBuf Release and free resources for SapBuffer object success pBuffer gt Destroy delete pBuffer Free the data buffer delete dataBuf Although this is faster than the previous method performance is still an issue because of the data copying operations involved 64 Working with Buffers Sapera LT User s Manual The fastest way to access buffer data is to obtain direct access through a pointer The GetAddress and ReleaseAddress methods initiate and end direct data access respectively The drawback of this method is that you need to know the buffer dimensions format and pitch in order to correctly access the data The following code illustrates this Allocate and create a 640x480 RGB 5 6 5 buffer object SapBuffer pBuffer new SapBuffer 1 640 480 SapFormatRGB565 SapBuffer BOOL success pBuffer Create Get the buffer pitch in bytes int pitch pBuffer gt GetPitch Get the buffer data address BYTE pData success pBuffer gt GetAddress amp pData Access the buffer data for int lineNum 0 lineNum 480 lineNum WORD pLine WORD pData lineNum pitch for pixelNum 0 pixelNum lt 640 pixelNum Process the current line End direct data access pointer will then be invalid success pBuffer gt ReleaseAddress pData Release and free resources for SapBuffer object success pBuffer gt
20. this demo are a Sapera compatible frame grabber and an analog or digital monochrome camera The supplied executable is built using Visual Studio NET 2003 plus the MFC library I O Demo Wapera Demos Classes Vc IODemo Released ODemo exe This program demonstrates the usage of General I O functionality included in Sapera It allows you to monitor the current state of the input and output pins and change their state between low and high polarity It also allows you to monitor interrupts on the input pins and to count the number of incoming interrupts The minimum requirements to run this demo are a Sapera compatible board with General I O capabilities The supplied executable is built using Visual Studio NET 2003 plus the MFC library 16 e Using Sapera LT Sapera LT User s Manual GigE Vision Camera Demo WSapera Demos Classes Ve GigeCameraDemo Release VGigeCameraDemo exe This program demonstrates how to acquire images from a DALSA GigE Vision camera The demo allows either to load a configuration file previously generated by CamExpert or to use the camera defaults The minimum requirement to run this demo is a Sapera compatible GigE Vision camera The supplied executable is built using Visual Studio NET 2003 using the MFC library Sapera LT also includes demos that use ActiveX controls A Visual Basic 6 0 project group Sapera Demos ActiveX Vb6NSapActiveXDemos vbg Visual Studio NET 2003 solution Sapera
21. to the section Using the CamExpert Tool on page 11 for a discussion on how to generate this file Resource parameters can also be accessed individually Once the acquisition module is initialized using the CCF file a compatible buffer may be created using settings taken directly from the acquisition Before initiating the actual transfer you must create a transfer object to link the acquisition and the buffer objects Furthermore when stopping a transfer you must call the SapTransfer Wait method to wait for the transfer process to terminate completely Transfer callback function is called each time a complete frame is transferred void XferCallback SapXferCallbackInfo pInfo Display the last transferred frame SapView pView SapView pInfo GetContext pView Show Example program main Allocate acquisition object SapAcquisition pAcq new SapAcquisition SapLocation X64 CL 1 0 MyCamera ccf Allocate buffer object taking settings directly from the acquisition SapBuffer pBuffer new SapBuffer 1 pAcq Allocate view object images will be displayed directly on the desktop SapView pView new SapView pBuffer SapHwndDesktop Allocate transfer object to link acquisition and buffer SapTransfer pTransfer new SapTransfer XferCallback pView pTransfer AddPair SapXferPair pAcq pBuffer Create resources for all objects BOOL success pAcq gt Creat
22. type Video type Flat Field n Moncheme x Number of lines to average Number of frames to average Number of lines to average Number of frames to average Maximum deviation from Maximum deviation from Vertical offset from top average pixel value Vertical offset from top average pixel value mesen p es Calibration index 7 Step 1 Acquire a black image We recommend to cover the camera lens with a lens cap Step 2 Acquire a white image We recommend an average pixel value around 204 levels 22 e Using Sapera LT Acquire Black Image Calibration index f Step 1 Acquire a black image We recommend to cover the camera lens with a lens cap Step 2 Acquire a white image We recommend an average pixel value around 204 levels Acquire Black Image Sapera LT User s Manual Setup Before Calibration First select the correction type to 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 Set the number of frames to average during each calibration step This should be set to more then one to avoid false data from random pixel noise The field for maximum deviation from average defaults to 25 of the gray level range captured 64 for 8 bit capture 256 for 10 bit capture and so forth This value sets the threshold for detecting static dead pixels both dark or l
23. value 10 status camera SetFeatureValue featureIndex value break Feature is a boolean case SapFeature TypeBool BOOL value status camera GetFeatureValue featureIndex amp value value value status camera SetFeatureValue featureIndex value break Other feature types Example 2 Access specific feature integer example Get feature object status camera GetFeatureInfo Gain amp feature Extract minimum maximum and increment values UINT32 min max inc status feature GetMin amp min status feature GetMax amp max status feature GetInc amp inc Read modify and write value UINT32 value status camera GetFeatureValue Gain amp value value 10 status camera SetFeatureValue Gain value Example 3 Access specific feature enumeration example Get feature object status camera GetFeatureInfo GainMode amp feature Get number of items in enumeration int enumCount status feature GetEnumCount amp enumCount int enumIndex enumValue char enumStr 64 for enumIndex 0 enumIndex enumCount enumIndex 54 e Acquiring Images Sapera LT User s Manual Get item string and value Status feature GetEnumString enumIndex enumStr sizeof enumStr status feature GetEnumValue enumIndex amp enumValue Read a value and get its associated string st
24. with Buffers Root and Child Buffers A buffer object is created in one of two ways either as a root SapBuffer object with no parent or as a child SapBufferRoi object with a parent The parent of the child may also be a child itself which allows you to build a buffer hierarchy with no restriction on the number of levels A SapBuffer object can have more than one child SapBufferRoi object A SapBufferRoi object shares the same memory space as its parent and it defines an adjustable rectangular region of interest A child may be used by acquisition to reduce bandwidth requirements or by a processing function in order to process a specific region The example below illustrates how to create a parent buffer with two children Note SapBufferRoi objects must be destroyed before their parent llocate and create a 640x480x8 buffer object Buffer pBuffer new SapBuffer 1 640 480 SapFormatMono8 L success pBuffer Create llocate and create a 320x240 child in the upper left corner BufferRoi pChildl new SapBufferRoi pBuffer 0 0 320 240 ccess pChildl gt Create Allocate and create a 320x240 child in the upper right corner pBufferRoi pChild2 new SapBufferRoi pBuffer 320 0 320 240 success pChild2 gt Create Use buffers Release resources for all objects success pBuffer gt Destroy success pChildl gt Destroy success pChild2 gt Destroy Free all objects
25. xml i Address Contact Online Technical Support Please email the cordiag outputdesc xml file for all of your technical support questions e Coreco X64 Device Driver 1 50 01 0321 Not found 0 valid 39 DALSA Coreco files DALSA Coreco files e Coreco Sapera LT 5 30 01 0585 DALSA Coreco files Not found 0 DALSA Coreco files Valid 1126 Eie Edt Mew Favortes Tob Hep i e Om O BAG D kras O S LU 38 Address E c coreco Sapera CorDiagtcordiag_outputdesc xml 7 m Coreco X64 Device Driver 1 50 0321 I e Coreco X64 Device Driver 1 50 01 0321 Registry Entry search results e Back to top Coreco X64 Device Driver 1 50 01 0321 Files diagnostic results 74 e Appendix B Other Tools Sapera LT User s Manual Status Path Name Version Creation date Last update date Size Author Valid lt PRODUCTDIR Bin X64 CL NOT SUPPORTED cfo 2005 08 09 20 23 19 2005 06 10 16 08 18 1110 valid lt PRODUCTDIR gt Bin X64 CL EM 16TAPS BINARIZE cfc 2005 08 09 20 23 19 2005 06 10 16 08 16 790 Valid lt PRODUCTDIR gt Bin X64 CL cfc 2005 08 09 20 23 19 2005 06 10 16 08 18 2121 valid lt PRODUCTDIR Bin X64 CL EM 4TAPS 16BITS cfc 2005 08 09 20 23 19 2005 06 10 16 08 16 765 Valid lt PRODUCTDIR gt Bin X64 CL 12BITS cfc 2005 08 09 20 23 19 20
26. 05 06 10 16 08 16 1029 Valid lt PRODUCTDIR Bin X64 CL 10 taps format 2 cfc 2005 08 09 20 23 19 2005 06 10 16 08 16 1511 Valid lt PRODUCTDIR gt Bin X64 CL 10 taps format 1 cfc 2005 08 09 20 23 19 2005 06 10 16 08 16 1808 Valid lt PRODUCTDIR Bin CorDeviceManager exe 2 3 0 0 2005 08 09 20 23 18 2005 06 28 16 50 22 188416 Coreco Imaging valid lt PRODUCTDIR Help X64 CLseries_User chm 2005 08 09 20 23 21 2004 03 12 19 30 00 1469283 Valid lt PRODUCTDIR gt Help X64 CLseries_User pdf 2005 08 09 20 23 19 2004 03 12 19 20 10 1075553 Valid lt WINDIR gt system32 Drivers CorX64 sys 1 50 1 321 2005 08 09 20 23 30 2005 06 28 17 10 08 128768 Coreco Imaging Valid lt WINDIR gt system32 CorX64L dil 1 50 1 321 2005 08 09 20 23 31 2005 06 28 17 10 12 254032 Coreco Imaging valid lt WINDIR gt system32 CorX64s dll l 1 50 1 321 2005 08 09 20 23 31 2005 06 28 17 10 16 l 3883098 Coreco Imaging w Appendix C Sapera LT Runtimes Introduction Once your application is ready to be delivered you may need to create a procedure that will install the appropriate component to the target system The following section details the tasks that your installation program needs to perform The appropriate device driver must be installed along with the installation of the Sapera LT runtimes This topic is further discussed in this section Installing Sapera LT Runtimes and Sapera LT Compatible Drivers The Sapera LT In
27. 2 e Sapera LT Architecture Sapera LT User s Manual Description of Sapera Classes Below is a diagram along with a brief description of the main Sapera classes that implement access to the Standard API module resources as well as their relationship to other classes Sapera Basic Classes By Subject General Classes n l l B l SapManager SapLocation Data Class l SapManCallbackinfo SapData l I Acquisition Classes SapDataXXX Frame Grabber Specific Camera Specific General SapAcquisition SapAcqDevice SapLut SapAcqCallbackinfo SapAcqDeviceCallbackinfo SapFlatField SapBayer SapFeature i 1 I l l I l l l I l l I l J li Buffer Classes Transfer Classes SapBuffer SapTransfer SapXferPair SapBufferWithTrash Specialized Transfer Classes SapXXXToYYY SapXferParams SapBufferRoi SapXferCallbackinfo SapXferNode Li i n Display amp Graphics Classes WO Classes Legacy Classes SapView SapCab SapPixPro il Ji SapViewCallbackInfo SapGioCallbackInfo SapDsp SapCounter p X SapDisplay SapBufferRemote Processing Classes SapGraphic SapPixProParams il danses Ses SapProcessing SapCounterCallbackinfo i fuscum cu ue DeL a das ia nta SapProCallbackInfo SapPerformance ll Sapera LT User s Manual Sapera LT Architecture e 33 SapAcquisit
28. 7 35 pixel replacement 16 PRNU 16 86 e Index R region of interest ROI 36 61 62 required classes for acquiring images 45 required classes for displaying images 57 response file 77 Runtime Installations 75 S SapAcqCallbackInfo Class 36 SapAcquisition Class 34 SapBayer Class 36 SapBuffer Class 34 SapBufferRoi Class 36 SapBufferWithTrash Class 36 SapCab Class 34 SapCounter Class 34 SapCounterCallbackInfo Class 36 SapDisplay Class 34 Sapera 4 0 24 Sapera Acquisition Parameters Reference Manual 1 11 Sapera ActiveX Controls 39 Sapera ActiveX Controls Programmer s Manual 1 39 Sapera Application Wizard 4 Sapera Basic Module Reference Manual 32 Sapera Basic Modules Reference Manual 39 43 48 49 70 Sapera CAB Programmer s Manual 34 Sapera compatible drivers 75 Sapera LT 4 12 Sapera LT ActiveX Controls Manual 17 Sapera LT Application Wizard 24 25 26 30 Sapera LT configuration program 9 12 Sapera LT Install Program 75 Sapera LT package 4 Sapera LT runtimes 4 75 Sapera LT servers 31 32 Sapera LT system servers 68 Sapera Pixel Processor Modules Programmer s Manual 1 Sapera Processing 4 Sapera Processing package 4 Sapera Processing Programmer s Manual 4 Sapera LT User s Manual Sapera Standard API 39 Sapera Standard C API 14 Sapera 15 Sapera Programmer s Manual 32 Sapera API 24 Sapera Classes 39 Sapera Programmer s
29. DOWS APPLICATION ci 58 WORKING WITH BUFFERS 61 ROOT AND CHILD BUFFERS eeeee ee eene ennemis ese ese ese ese ese ese ese esses ese ese esas esas Eent 61 BUFFER TYPES eies 62 READING AND WRITING A BUFFER erre 64 APPENDIX A SUPPORT 67 SUPPORTED OPERATING SYSTEMS iii 67 SUPPORTED DALSA DEVICES Lana 67 SYSTEM SUPPORT E 68 APPENDIX B OTHER TOOLS 69 DIRECTDRAW CAPABILITIES DETECTION TOOL eee eene enne eren nsn nsns nsns ee 69 FONT GENERATOR TOOL 3 heade eee a eee Eo Eee das sea cade sedans STRATI uen eie de aoa Roco 70 ii e Contents Sapera LT User s Manual DALSA DIAGNOSTIC TOOL emen eee e EEEE ene nenne enin eere ene ene nene nene nene nene eene nene neni 70 Quer A 70 Diagnostic TOOL Ecahires i tons iei ee beatae Ra dp eine pde asa e deed aecenas ZI Usage Guilde eio arse a Gide ea LP ean ko a kk ei 71 APPENDIX C SAPERA LT RUNTIMES 75 h 75 INSTALLING SAPERA LT RUNTIMES AND SAPERA LT COMPATIBLE DRIVERS eene 75 DN 76 Silent Mode Installation ii 77 DALSA CONTACT INFORMATION 79 SALES INFORMATION EEE NE 79 International CanadA eereeveeveveoooooeoeeoueuoooooqeoueoeeuooeoeoeoeeoneuooeoeoeoeeneenooeoooeooenneuooooeoeoeonesooeee 79 DAY ERR EC 79 TECHNICAL SUPPORT RT H
30. Demos ActiveX NET SapActiveXDemos sIn and Delphi 7 package solution Sapera Demos ActiveX Delphi NSapActiveXDemos bpg include all ActiveX demo projects The following describes the different Sapera LT ActiveX demo programs See the Sapera LT ActiveX Controls Manual for more information on the ActiveX controls Acquisition Demo Visual Basic 6 0 Wapera Demos ActiveX Vb6 AcqDemoMAcqDemo exe This program demonstrates the basic acquisition functions included in the Sapera LT ActiveX controls It allows you to load an acquisition file and then acquire images either in continuous or in one shot mode Clicking the right mouse button over the image display area allows you to modify the acquisition control properties as well as loading and saving images The minimum requirements to run this demo are a Sapera compatible frame grabber and an analog or digital camera The supplied executable is built using Visual Basic 6 Acquisition Demo VB NET Sapera Demos ActiveX NET VbAcqDemo VbAcqDemo vbproj This program demonstrates the basic acquisition functions included in the Sapera LT ActiveX controls It allows you to load an acquisition file and then acquire images either in continuous or in one shot mode Clicking the right mouse button over the image display area allows you to modify the acquisition control properties as well as loading and saving images The minimum requirements to run this demo are a Sapera compatible frame grabber and
31. Destroy delete pBuffer in offscreen video memory TypeOffscreenVideo For more information on buffer data access functionality see the Sapera Programmer s Manual Sapera LT User s Manual Working with Buffers e 65 66 e Working with Buffers Sapera LT User s Manual Appendix A Support Supported Operating Systems e Microsoft Windows 2000 e Windows XP Supported DALSA Devices This section lists the current set of DALSA devices supported under Sapera LT Consult the DALSA web site for product descriptions Consult the user s manual for each device for a detailed description of the supported features Frame Grabbers e Bandit II Series Bandit 3 Series PC2 Series Viper Series X64 Series Processing Boards e Anaconda Series Cameras e Genie Series Sapera LT User s Manual Appendix A Support e 67 System Support The Sapera LT system server represents Sapera LT functionality running on the Host processor when no DALSA device is present This section describes the resources available for this server Servers and Resources Servers Resources Name Description Type System System Display server Graphic File Buffer Lut View 68 e Appendix A Support Index Name 0 Default display 0 Default graphic N A N A N A N A Description Computer video card Computer processor N A N A N A N A Sapera LT User s Manual Appendix B Other Tools DirectDraw Capabilities Detec
32. Manual 15 24 43 41 48 49 56 57 59 65 SapFlatField Class 36 SapGio Class 35 SapGioCallbackInfo Class 36 SapGraphic Class 35 SapLocation Class 36 SapLut Class 35 SapManager Class 36 SapManCallbackInfo Class 37 SapPerformance Class 37 SapPixPro Class 35 SapPixProParams Class 37 SapProCallbackInfo Class 37 SapProcessing Class 37 SapTransfer Class 35 SapView Class 35 SapViewCallbackInfo Class 37 SapXferCallbackInfo Class 37 SapXferPair Class 37 SapXferParams Class 37 scatter gather 13 45 62 63 scatter gather memory buffers 62 serial port 10 shading correction 16 shaft encoder 29 Specialized Transfer Classes 37 Standard C API 32 static resources 32 supported DALSA devices 67 system memory 51 system server 10 T technical support 70 The Acquisition Programs C 17 Delphi 7 18 VB NET 17 Sapera LT User s Manual The Demo Programs Bayer Demo 16 Flat Field Demo 16 Grab Demo Dialog Box Interface 15 Grab Demo Multiple Document Interface 15 Grab Demo Single Document Interface 15 Sequential Grab Demo 16 The Example Programs FileLoadMFC 14 GrabMFC 14 transfer path 51 trash buffer 36 TWAIN 4 U US Sales Office 79 V VIC file 27 virtual buffers 62 Visual Basic 5 17 Visual C 5 58 Visual C NET 5 15 W web site 79 Website 73 Windows command line 76 Windows Explorer 6 76
33. SapGio class SapLocation Class The SapLocation class identifies a Sapera server resource pair SapManager Class The SapManager class includes methods for describing the Sapera resources present on the system It also includes error management capabilities SapManCallbackInfo Class 36 e Sapera LT Architecture Sapera LT User s Manual The SapManCallbackInfo class acts as a container for storing all arguments to callback functions for the SapManager class SapPerformance Class The SapPerformance class implements basic benchmarking functionality It is used by the SapProcessing Class to evaluate the time it takes to process one buffer You may also use it for your own benchmarking needs SapPixProParams Class The SapPixProParams class acts as a container for storing pixel processor parameters used by the SapPixPro class SapProcessing Class The SapProcessing class allows you implement your own processing through a derived class SapProCallbackInfo Class The SapProCallbackInfo class acts as a container for storing all arguments to callback functions for the SapProcessing class Specialized Transfer Classes The specialized transfer classes are a set of classes derived from SapTransfer that allow easy creation of the most commonly used transfer configurations SapViewCallbackInfo Class The SapViewCallbackInfo class acts as a container for storing all arguments to callback functions for the SapView class SapXferCallbackInfo
34. TP 80 GLOSSARY OF TERMS 81 INDEX 85 Sapera LT User s Manual Contents e iii iv e Contents Sapera LT User s Manual Introduction Overview of Sapera LT Manuals Sapera LT is supported by the following manuals in printed with one exception PDF and compiled HTML help formats Sapera LT User s Manual Introduces Sapera LT and provides a general overview of its usage as well as installation procedures Sapera Programmer s Manual Describes in detail all the Sapera Basic and GUI classes Sapera is based on the C language Sapera 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 This manual is not offered in printed format Sapera ActiveX Controls Programmer s Manual This manual explains how to program Sapera ActiveX controls Sapera Acquisition Parameters Reference Manual Describes the acquisition parameters and capabilities This manual complements the manuals that describe the different Sapera APIs C C Active X Sapera LT supports some hardware specific extensions also referred to as board specific modules The following manuals which are supplied with the corresponding hardware describe the hardware functionality and the supporting API Sapera CAB Programmer s Manual This manual introduces CAB DALSA Coreco Auxiliary Bus and explains how to implement i
35. Windows 2000 5 67 Windows XP 5 67 x XML file 70 71 Y YUV 63 Index e 87
36. and want to interface those libraries to a Sapera LT compatible device Sapera LT includes tools such as CamExpert and the Sapera LT Application Wizard to speed up application development Sapera Processing is DALSA s comprehensive C library for image processing and analysis Note Despite the similarity in product names these are two completely different products They are independent of one another yet they can be used together to implement a complete image acquisition display processing and analysis solution Refer to the Sapera Processing Programmer s Manual for a detailed description of Sapera Processing TWAIN Support Initially developed to provide a standard software interface to image scanners the TWAIN standard has evolved into the imaging industry The TWAIN standard is a generic software interface between an application and an imaging device Sapera LT runtimes provide TWAIN support that allows a user to control DALSA devices through the TWAIN interface without having to directly program any Sapera API Microsoft DirectShow Support Sapera LT runtimes include a Microsoft DirectShow compatible driver that allows any Sapera LT supported frame grabber to act as a DirectShow video source e Getting Started Sapera LT User s Manual Requirements Below is a list of the components required by Sapera LT Minimum System Requirements e PCI bus IBM PC or compatible with Pentium class or later processor e Windows
37. atus camera GetFeatureValue GainMode amp enumValue status feature GetEnumStringFromValue enumValue enumStr sizeof enumStr Write a value corresponding to known string status feature GetEnumValueFromString GainModeOnePush amp enumValue status camera SetFeatureValue GainMode enumValue Example 4 Access specific feature LUT example JET Select a LUT and retrieve its size and format UINT32 lutIndex 0 lutNEntries lutFormat status camera SetFeatureValue LUT Index lutIndex status camera GetFeatureValue LUT NEntries amp lutNEntries Status camera GetFeatureValue LUT Format amp lutFormat Create and generate a compatible software LUT SapLut lut lutNEntries lutFormat status lut Create status lut Reverse Write LUT values to camera Status camera SetFeatureValue LUT Values amp lut Example 5 Callback management Browse event list int numEvents status camera GetEventCount amp numEvents int eventIndex for eventIndex 0 eventIndex numEvents eventIndex char eventName 64 Status camera GetEventNameByIndex eventIndex eventName sizeof eventName Register event by name status camera RegisterCallback FeatureChanged CameraCallback NULL Modified a feature Will trigger callback function Status camera SetFeatureValue Gain 150 Unregister event by name Status camera U
38. ax 514 333 1388 USA DALSA Building 8 Floor 2 900 Middlesex Turnpike Billerica MA 01821 Tel 978 670 2000 Fax 978 670 2010 Sapera LT User s Manual http www imaging com info dalsa coreco com DALSA Contact Information e 79 Technical Support Any support question or request can be submitted via our web site Technical support form via our web page http www imaging com support Support requests for imaging product installations Support requests for imaging applications Camera support information http www imaging com camsearch Product literature and driver updates http www imaging com download When encountering hardware or software problems please have the following documents included in your support request The DALSA Diagnostic Tool XML report file The DALSA Log Viewer txt file The PCI Diagnostic PciDump txt file The DALSA Device Manager BoardInfo txt file Note all these tools are available from the Windows start menu shortcut Start Programs eDALSA Sapera LT Tools 80 e DALSA Contact Information Sapera LT User s Manual Glossary of Terms ADC Analog to digital converter Chroma The color portion of the composite NTSC or PAL video signal Luma is the black and white portion of the signal Often used interchangeably with Chrominance although this is technically incorrect CMYK A color model in which all colors are composed of varying intens
39. ay be subdivided as follows e Manager Classes provide image device management functionality e Hardware Independent Classes provide everything you need to acquire display and access images without worrying about specific hardware e Board Specific Classes provide the hardware specific support functions The Pixel Processor and the Coreco Auxiliary Bus CAB modules are examples of Sapera LT hardware specific extensions Additional documentation is provided with the related hardware products Hardware independent classes allow one application to control different DALSA devices through the same API It also guarantees seamless migration to any future DALSA hardware product supported by Sapera LT The modular architecture provides the user with high programming flexibility and readability The GUI classes include a set of Microsoft Foundation Classes MFC based dialog boxes designed to implement some of the most commonly used tasks for Sapera LT applications such as loading an acquisition configuration file They however do not constitute an official API Rather they are provided as is with source code so that you may modify them at your discretion Sapera LT User s Manual Getting Started e 3 Sapera Products Two different Sapera packages are available e SaperaLT e Sapera Processing Sapera LT includes everything you need to acquire and display images It is targeted at developers that have their own image processing libraries
40. cqDevice class Each feature supported by the SapAcqDevice class provides a set of capabilities such as name type access mode and so forth that can be obtained through the feature module SapGio Class The purpose of the SapGio class is to control a block of general inputs and outputs that is a group of I Os that may be read and or written all at once This class may be used together with SapCounter to associate event counting with the state of specific I O pins SapGraphic Class The SapGraphic class implements the drawing of graphic primitives and text strings It supports these operations either destructively on image data itself using the Standard API graphic module or in non destructive overlay over displayed images using Windows GDI functions SapLut Class The SapLut class implements lookup table management It is usually used together with the SapAcquisition and SapView classes to respectively manipulate acquisition and display lookup tables SapPixPro Class The SapPixPro class includes the functionality to manipulate resources on a pixel processor device that is a daughter card that plugs into certain DALSA boards The Pixel Processor is often used for applying simple pre processing to an image It is used by a SapTransfer object as an intermediate transfer node to allow data transfers from an acquisition resource to another transfer node such as SapBuffer or SapCab SapTransfer Class The SapTransfer class implements
41. e success pBuffer gt Create success pView gt Create success pTransfer gt Create 46 e Acquiring Images Sapera LT User s Manual Star Success printf getch Stop success success printf getch Rele success success success success Free delete delete delete delete return t a continuous transfer live grab pTransfer gt Grab Press any key to stop grab n 7 the transfer and wait timeout 5 seconds pTransfer gt Freeze pTransfer gt Wait 5000 Press any key to terminate n 7 ase resources for all objects pTransfer Destroy pView gt Destroy pBuffer gt Destroy pAcq Destroy all objects pTransfer pView pBuffer pAcq 0 For more details see the Sapera Programmer s Manual and the source code for the demos and examples included with Sapera LT Sapera LT User s Manual Acquiring Images e 47 Modifying the Frame Grabber Parameters Modifying Parameters Individually Acquisition parameters can be modified individually by using the SapAcquisition SetParameter method When a new parameter value is requested that value is verified against the current state of the acquisition module and the acquisition module capabilities If the modification request is denied because the parameter is dependent on other parameters then all the parameters in question must be modified by group Alloca
42. e option below to display image with graphics overlay The sample code shows how to display a circle and text on the live images M Enable graphics overlay Event Notification Select one ofthe following to see howto synchronize application with events like f Endiofafame e acquisition f End afafane Iv End otafra Back ext Cancel Help 30 e Using Sapera LT Sapera LT User s Manual Sapera LT Architecture Application Architecture Whichever API is used Sapera Standard C or ActiveX 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 DALSA device Sapera LT calls are routed to different servers via the Sapera LT messaging layer in a fashion completely independent to the underlying hardware User Application Sapera C 6 ActiveX Controls t Standard API C Host Server Messaging Layer Modules Sapera Board 1 Server Board 2 Server Board N Server Sapera EE Sapera Sapera Modules bou Modules MILAN Modules Sapera LT User s Manual Sapera LT Architecture e 31 Definition of Terms What is a server A Sapera LT server is an abstract representation of a physical device like a frame grabber a processing board a GigE camera or a desktop PC In general a DALSA board is a server Some processing boards howev
43. eatureChanged event if strcmp eventName FeatureChanged 0 Retrieve index and name of the feature that has changed int featureIndex char featureName 64 status pInfo GetFeatureIndex amp featureIndex status pInfo gt GetAcqDevice gt GetFeatureNameByIndex featureIndex featureName sizeof featureName Main Program main BOOL status Create a camera object SapAcqDevice camera Genie M640 1 status camera Create Get the number of features provided by the camera int featureCount status camera GetFeatureCount amp featureCount Create an empty feature object to receive information SapFeature feature Genie M640 1 status feature Create Ef Example 1 Browse through the feature list Lf int featureIndex for featureIndex 0 featureIndex featureCount featureIndex char featureName 64 SapFeature Type featureType Get information from current feature Get feature object status camera GetFeatureInfo featureIndex amp feature Extract name and type from object Sapera LT User s Manual Acquiring Images e 53 Status feature GetName featureName sizeof featureName Status feature GetType amp featureType Get set value from to current feature switch featureType Feature is a 64 bit integer case SapFeature TypeInt64 UINT64 value status camera GetFeatureValue featureIndex amp value
44. ed by m ViewWnd m pView new SapView m pBuffer m ViewWnd GetSafeHwnd success m pView Create Create image window object The m HorizontalScr and m VerticalScr arguments are MFC CscrollBar objects representing the scroll bars m plmageWnd new CImageWnd m pView amp m ViewWnd amp m HorizontalScr amp m VerticalScr this return TRUE 58 e Displaying Images Sapera LT User s Manual CSaperaAppDlg OnDestroy Release resources for all objects BOOL success m pView gt Destroy success m pBuffer Destroy Free all objects delete m pImagewnd delete m pView delete m pBuffer void CSaperaAppDlg OnPaint if IsIconic else Call the default handler to paint a background CDialog OnPaint Display last acquired image m plImageWnd OnPaint void CSaperaAppDlg OnSize UINT nType int cx int cy Call default handler CDialog OnSize nType cx cy Make appropriate adjustment in image window m plImageWnd OnSize void CSaperaAppDlg OnMove int x int y Call default handler CDialog OnMove x y Make appropriate adjustment in image window m pImageWnd gt OnMove For more details see the Sapera Programmer s Manual and the source code for the demos and examples included with Sapera LT Sapera LT User s Manual Displaying Images e 59 60 e Displaying Images Sapera LT User s Manual Working
45. er may contain several servers this is true when using multi processor boards A server allows Sapera LT applications to interact with the server s resources What is a static resource Resources attached to a physical device are called static resources For example a frame grabber can have an acquisition resource and a transfer resource These resources can be manipulated to control a physical device through a Sapera LT server What is a dynamic resource A dynamic resource is an abstract representation of data storage such as a buffer lookup table and so forth or links that connect the data storage to static resources Unlike static resources dynamic resources are not dependent on physical devices therefore users on a specified server can freely create dynamic resources What is a module A module is a set of functions used to access and or control a static or a dynamic resource The complete Sapera LT Standard C API is composed of a series of modules organized in a particular architecture See the Sapera Basic Modules Reference Manual for details Sapera encapsulates all of these concepts in a series of C classes that offer the following benefits compared to the Standard API e Easier server management e Consistent programming interface for static and dynamic resources e Grouping of modules inside one class whenever appropriate See the Sapera Programmer s Manual for a hierarchy chart of all the Sapera classes 3
46. ere are demos that cover both Sapera and the ActiveX controls The demos main purpose is to provide the user with a starting application that can be modified in order to become the user s end application A Visual Studio 6 0 workspace SSapera Demos Classes Ve SapDemos dsw and a Visual Studio NET 2003 solution Sapera Demos Classes Vc SapDemos_2003 sIn include all Sapera demo projects They allow you to recompile all the demos in a batch together with the Sapera GUI Classes The following describes the different Sapera demo programs See the Sapera Programmer s Manual for more information on the Sapera API Grab Demo Dialog Box Interface Wapera Demos Classes V c GrabDemo Release GrabDemo exe This program demonstrates the basic acquisition functions included in Sapera It allows you to acquire images either in continuous or in one shot mode while adjusting the acquisition parameters The minimum requirements to run this demo are a Sapera compatible frame grabber and an analog or digital camera The supplied executable is built using Visual Studio NET 2003 plus the MFC library Grab Demo Single Document Interface Sapera Demos Classes Vc GrabDemoSDI Release GrabDemoSDLexe This program demonstrates the basic acquisition functions included in Sapera It allows you to acquire images either in continuous or in one shot mode while adjusting the acquisition parameters The minimum requirements to run this dem
47. es for acquisition object SapAcquisition pAcq new SapAcquisition SapLocation X64 CL 1 0 MyCamera ccf BOOL success pAcq Create Try changing the cropping and scaling parameters success pAcq gt SetParameter CORACQ PRM CROP WIDTH 640 FALSE success pAcq gt SetParameter CORACQ PRM CROP HEIGTH 480 FALSE success pAcq gt SetParameter CORACQ PRM SCALE HORZ 640 FALSE success pAcq gt SetParameter CORACQ PRM SCALE VERT 480 TRUE Release resources for acquisition object and free it success pAcq gt Destroy delete pAcq For more details see the Sapera Programmer s Manual and the Sapera Basic Modules Reference Manual Sapera LT User s Manual Acquiring Images e 49 Using an Input Lookup Table When you call the Create method for a SapAcquisition object an internal lookup table object SapLut is automatically created inside the object if the acquisition hardware supports lookup tables You may then retrieve it using the SapAcquisition GetLut method manipulate it using the methods in the SapLut Class and reprogram it using the SapAcquisition ApplyLut method The internal SapLut object is automatically destroyed when you call the SapAcquisition Destroy method Allocate and create resources for acquisition object SapAcquisition pAcq new SapAcquisition SapLocation X64 CL 1 0 MyCamera ccf BOOL success pAcq Create Try changing the acquisition loo
48. esource is by accessing it element by element The ReadElement and WriteElement methods fulfill this purpose The following demonstrates how to access data in an 8 bit monochrome SapBuffer object Allocate and create a 640x480x8 buffer object SapBuffer pBuffer new SapBuffer 1 640 480 SapFormatMono8 BOOL success pBuffer gt Create Write a constant value in the buffer SapDataMono is a Sapera class that encapsulates a Standard API monochrome data type success pBuffer gt WriteElement 100 200 SapDataMono 128 Read back the value SapDataMono data Success pBuffer gt ReadElement 100 200 amp data Release and free resources for SapBuffer object success pBuffer gt Destroy delete pBuffer Accessing buffer data in this way is quite straightforward but unfortunately it considerably slows down access time Alternately you can access data by reading writing an array of elements with only one function call through the Read and Write methods Here is a sample of their usage Allocate and create a 640x480x8 buffer object SapBuffer pBuffer new SapBuffer 1 640 480 SapFormatMono8 BOOL success pBuffer gt Create Create an array large enough to hold all buffer data int size 640 480 sizeof BYTE BYTE dataBuf new BYTE size Fill array with some values Write array to buffer resource success pBuffer gt Write 0 size dataBuf Read back buffer data
49. ethod 3 Destroy the resources for the object through the Destroy method 4 Release the memory for the object There is more than one way to do this as shown next for SapBuffer class objects The usual way to create the object is through a pointer SapBuffer pBuffer new SapBuffer 1 512 512 if pBuffer gt Create Buffer object is correctly initialized Destroy the buffer resources after checking if it is still initialized through the operator BOOL for the SapBuffer class if pBuffer pBuffer gt Destroy Release the object memory delete pBuffer pBuffer NULL Create the object on the stack SapBuffer buffer 1 512 512 if buffer Create Buffer object is correctly initialized Destroy the buffer resources buffer Destroy The object memory is automatically released when it goes out of scope 40 e Introducing the Sapera LT API Sapera LT User s Manual Create the object from an existing object SapBuffer buffer 1 512 512 SapBuffer pBuffer new SapBuffer buffer pBuffer Create pBuffer Destroy Release the object memory delete pBuffer pBuffer NULL Sapera objects that do not encapsulate management of Standard API resources are correctly initialized as soon as their constructor has been called SapDataMono data 123 The object memory is automatically released when it goes out of scope Sa
50. g Started Sapera LT User s Manual Using Sapera LT Configuring Sapera LT The Sapera LT Configuration program SapConf exe allows you to see all the Sapera LT compatible devices present within your system together with their respective serial numbers It may also be used to adjust the amount of contiguous memory to be allocated at boot time After activating this program it displays all the servers related to the installed devices as shown in the figure below Ki Sapera Configuration Server List Index Name Serial Number 0 System None 1 Bandit IL1 51216002 2 Xp4 1 52146330 Contiguous Memory Used for allocating buffers Used for allocating messages Requested Requested 3 ES MBytes 3 ud MBytes Allocated Allocated 3 MBytes 3 MBytes Serial Ports Physical Port Serisi 0 on 54 1 Selected physical port is present Camera Link API port index 0 Sapera LT User s Manual Using Sapera LT e 9 The System entry represents the system server It corresponds to the host machine your computer and is the only server that should always be present The other servers correspond to the device s present within the system See Supported DALSA Devices on page 67 for a current list of Sapera LT supported devices Configuring Contiguous Memory The Contiguous Memory section lets you specify the total amount of contiguous memory to be reserved for allocating buffers and messages Note All Sapera LT demos and exam
51. get directory Select one of the detected products 72 e Appendix B Other Tools Sapera LT User s Manual Report File Directory Before running either validate options the report file name or directory can be changed from the default m DALSA Coreco Diagnostic Tool Products Installed Detected ENV NAME NAME FILE SAPERADIR Sapera LT sapera_inputdesc xml C Coreco Sapera X64DIR X64 Device Driver Corx64x_inputdesc xml CiCoreco x64 Diagnostic options Target directory DATSA Ci Coreco x64 CorX64x_outputdesc xml Ai CORECO Validate All Validate Display specific results About EXIT Sample Diagnostic XML file Important features of the diagnostic report are e Click Contact Online Technical Support to open a new Internet Explorer page that links to the Contact Technical Support page of the DALSA website Follow the steps to request support and attach the diagnostic XML file e Asummary lists the version numbers for installed products and gives separate counts for items with Valid and Not Found status e Click on any product name to jump directly to a detailed listing of this product Sapera LT User s Manual Appendix B Other Tools e 73 DALSA Coreco Diagnostic Tool File Edit View Favorites Tools Q sxx o x BG Pa deem e e S 3 RESA ALSA Coreco diagnostic tool search results Help C Coreco Sapera CorDiag cordiag_outputdesc
52. gram demonstrates Flat Field 2D Shading Correction or Flat Line processing 1D Shading Correction either performed by supporting DALSA hardware or performed on the host system via the Sapera library The program allows you to acquire a flat field or flat line reference image and then do real time correction either in continuous or single acquisition mode The program code may be extracted for use within your own application Remarks This demo is built using Visual C 6 0 using the MFC library It is based on Sapera C classes See the Sapera User s and Reference manuals for more information 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 Program Start and Server Selection Run the demo via the Windows start menu shortcut StartePrograms DALSA Sapera LT Demos Flat Field Demo The demo program first displays the acquisition configuration menu to select the board acquisition server and acquisition device If the selected board does not support onboard flat field processing a message 1s displayed see following figure stating that processing will be on t
53. he host system FlatFieldDemo x AN This acquisition device does not have hardware support for flat field correction This menu is also used to select the required camera configuration file for the connected camera For a more detailed description of the acquisition configuration menu see Acquiring with Grab Demo on page 12 Sapera camera files contain timing parameters and video conditioning parameters Sapera LT User s Manual Using Sapera LT e 19 Flat Field Demo Main Window The demo main window provides control buttons and a central area for displaying the grabbed image Developers can use the demo source code as a foundation to quickly create and test the desired imaging application psg ddp Mo passera signal detected 20 e Using Sapera LT Sapera LT User s Manual 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 The Flat Field Demo provides acquisition controls to confirm image capture Enable Before activating flat field or flat line correction follow the calibration procedure described in this section see Flat Field Calibration
54. ight Users will need to adjust this field to best isolate dead pixels from their imaging source When doing a single line calibration to apply to the captured frame use the two selection fields number of lines to average and vertical offset from top to select which video line will be used Calibration Setup the camera to capture a uniform black 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 pixel gray level spread and present the statistics If acceptable use the image as the black reference Setup the camera to acquire a uniform white image but not saturated white Even illumination on white paper can be used It is preferable to prepare for the white level calibration before the calibration procedure Click on Acquire White Image The flat field demo will grab a video frame analyze the pixel gray level spread and present the statistics If acceptable use the image as the white reference Test the calibration by enabling flat field correction during a live grab If necessary adjust the dead pixel detection threshold and repeat the calibration Save multiple versions of calibration data to compare for best imaging or for different imaging setups Sapera LT User s Manual Using Sapera LT e 23 Using the Application Wizard Step 1 Overview The Sapera LT Application Wi
55. ing NTSC and PAL Use CamExpert to generate a CCF file in which you have a camera for which there are currently no available CAM files Features e Supports all DALSA hardware currently supported by Sapera LT e Creates and modifies camera configuration CCF or CCA CVI files e Groups acquisition parameters into related categories for easier access to any specific parameter e Intelligent editing of video timings through a locking mechanism that allows explicit modification of some values and automatic recalculation of the remaining ones e Online operation mode that allows live acquisition of images as the parameters are specified and modified e Online context sensitive help system 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 DALSA hardware Sapera LT User s Manual Using Sapera LT e 11 Demos and Examples Several generic demos and examples come with Sapera A description is provided for each in this section Certain device driver installations provide other demos and examples that demonstrate the specific usages and capabilities of the device Refer to a specific device user s manual for further details Acquiring with Grab Demo The Sapera LT Grab Demo program allows you to grab and display a live image i
56. installation is recommended when integrating DALSA products into your software installation It provides a seamless installation with minimal effort Creating a response file The response file is an ASCII file that is similar in content to Windows INI files It can be generated automatically by the installer when invoked as follows setup r The installer will create a response file SETUP ISS in the Windows directory that will reflect the choices you have made during the installation Running a Silent Mode Installation The silent mode installation 1s started by invoking the installer as follows lt path1 gt setup s SMS fl lt path2 gt setup iss The F1 switch specifies the location of the response file Every file including setup exe that belongs to disk 1 of the installation disk set must be in the same directory If there is more than one disk you have two ways to organize your source disk Put all files into one directory 2 Store the content of each disk in a separate directory The directory should be named according to the following convention disk1 disk2 Sapera LT User s Manual Appendix C Sapera LT Runtimes e 77 78 e Appendix C Sapera LT Runtimes Sapera LT User s Manual DALSA Contact Information Sales Information Visit our web site Email International Canada DALSA 7075 Place Robert Joncas Suite 142 St Laurent Quebec Canada H4M 2Z2 Tel 514 333 1301 F
57. ion Class The SapAcquisition class includes the functionality to control an acquisition device on any DALSA board that supports an acquisition section for example X64 CL It is used as a source transfer node to allow data transfers from an acquisition resource to another transfer node such as SapBuffer SapCab SapDsp or SapPixPro It is used by the SapTransfer class SapAcqDevice Class The SapAcqDevice class includes the functionality to control an acquisition device on any DALSA camera for example Genie M640 It is used as a source transfer node to allow data transfers from an acquisition resource to another transfer node such as SapBuffer It is used by the SapTransfer class SapBuffer Class The SapBuffer class includes the functionality to manipulate an array of buffer resources A SapBuffer object can be used by a SapTransfer object as a destination transfer node to allow data transfers from a source node such as SapAcquisition SapDsp SapPixProcessor SapCab or another SapBuffer It may also be used as a source transfer node to allow transferring data to another SapBuffer or a SapCab A SapBuffer object can be displayed using the SapView class and processed using the SapProcessing class It may also be the destination of graphic drawing operations through the SapGraphic class SapCab Class The SapCab class includes the functionality to manipulate a CAB resource It may be used by a SapTransfer object as a destination transfe
58. is provided on the Sapera LT CD case the package box the manuals and on a separate sticker You can install the required board or camera drivers without rebooting the computer at this time however you must reboot the computer to finish the installation of Sapera Reinsert the Sapera LT CD or run the launch exe application again Go to the Hardware Device Drivers menu to install the required drivers for your installed Sapera LT supported hardware Reboot the computer when prompted to complete the software installation 6 o Getting Started Sapera LT User s Manual File Locations The table below lists the different file groups and locations Description Location Utility programs Sapera Bin Acquisition configuration files Sapera CamFiles and device specific subdirectories CamExpert utility Sapera CamExpert Sapera include files and GUI Sapera Classes classes source code ActiveX controls OCXs Sapera Components ActiveX Diagnostic tool Sapera CorDiag Demonstration programs Sapera Demos Example programs Sapera Examples Font files Sapera Fonts Help files Sapera Help Image files Sapera Images Header files Sapera Include Import libraries Sapera Lib Pixel processor high level library Sapera Pixpro source code Dynamic link libraries DLLs Windows system directory windows system32 Device driver files Windows driver directory windows system32 drivers Sapera LT User s Manual Getting Started e 7 8 e Gettin
59. ities of the primary subtractive colors Cyan Magenta Yellow and black This color model is often used in print processing Color Key Color keying is a method used to decide the source of a display pixel on the screen If the graphics pixel on the VGA screen has the pixel value of the color key then the corresponding pixel in the designated buffer will be displayed otherwise the VGA screen s pixel will be displayed Complex Parameter A parameter with a size greater than a UINT32 Composite Video A single signal that includes both color video and timing information NTSC and PAL are composite video standards while RGB is not Dead Pixel A defective pixel that remains unlit on an LCD screen monitor camera charge coupled device or CMOS sensor Decimation A process whereby pixels are dropped from digitized video waveforms for quick and easy image scaling If 100 pixels are produced by a waveform but only 50 are stored or used the video waveform has been decimated by a factor of 2 1 DLL Dynamic Link Library The supplied DLLs form the software interface between a Windows application and the DALSA hardware device Sapera LT User s Manual Glossary of Terms e 81 Element A data unit within the buffer which may or may not be a pixel Frame Buffer A large unit of memory used to hold the image for display onscreen Grayscale In image processing the range of available brightness levels displayed in shades of g
60. kup table using a custom mapping The GetLut method returns NULL if there is no acquisition LUT SapLut pLut pAcq gt GetLut Allocate working memory for the new lookup table data char pNewData new char pLut GetTotalSize Fill contents of data buffer Write new data to lookup table pLut Write 0 pNewData pLut gt GetTotalSize Program the acquisition hardware with the new LUT data pAcq gt ApplyLut Free working memory delete pNewData Release resources for acquisition object and free it success pAcq gt Destroy delete pAcq 50 e Acquiring Images Sapera LT User s Manual Camera Acquisition Example The camera acquisition example demonstrates how to grab a live image into a buffer allocated within system memory using the Genie M640 camera as an acquisition device Acquiring an image can be performed either by using the camera default settings feature values stored in the camera or by loading a configuration file The configuration file can be generated using CamExpert After the SapAcqDevice class is initialized with or without using a configuration file certain parameters are retrieved from it acquisition width height and format to create a compatible buffer Before starting the transfer you must create a transfer path between the SapAcqDevice class and the SapBuffer class using one of the SapTransfer s derived classes SapAcqDeviceToBuf in this case Furtherm
61. l 56 e Acquiring Images Sapera LT User s Manual Displaying Images Required Classes The following three Sapera classes are required to initiate a display process e SapDisplay Manages the actual resources on the hardware display device e SapBuffer Contains the data to display Several type options may be chosen when allocating the buffer to be compatible with the different display modes see Working with Buffers on page 61 for more information about these options e SapView Links the display to the buffer and synchronizes the display operations Display Example The example below illustrates how to display an image contained within a system buffer on the computer VGA card The buffer is transferred to the Windows Desktop using the DIB mode automatically detected by the SapView Class When using this mode a Windows Device Independent Bitmap DIB is first created before being sent to VGA memory Allocate and create a 640x480x8 buffer object SapBuffer pBuffer new SapBuffer 1 640 480 SapFormatMono8 BOOL success pBuffer Create Allocate and create view object images will be displayed directly on the desktop SapView pView new SapView pBuffer SapHwndDesktop success pView gt Create Display the image on the desktop pView Show Release resources for all objects success pView Destroy success pBuffer Destroy Free all objects delete pView delete pBuffer Fo
62. l capabilities and parameters and their possible values What is a Capability A capability as its name implies is a value or set of values that describe what a resource can do Capabilities are used to determine the possible valid values that can be applied to a resource s parameters They are read only A capability can be obtained from a resource by using the GetCapability method in the corresponding class See the Sapera Programmer s Manual for details What is a Parameter A parameter describes a current characteristic of a resource It can be read write or read only A parameter for a resource can be obtained or set by using the GetParameter and SetParameter methods in the corresponding class See the Sapera Programmer s Manual for details Sapera LT User s Manual Introducing the Sapera LT API e 43 44 e Introducing the Sapera LT API Sapera LT User s Manual Acquiring Images Required Classes You need three Sapera classes to initiate the acquisition process e SapAcquisition or SapAcqDevice Use the SapAcquisition class if you are using a frame grabber use the SapAcqDevice class if you are using a camera directly connected to your PC such as a GigE or DCAM camera e SapBuffer Used to store the acquired data Should be created using the SapBuffer TypeContiguous or SapBuffer TypeScatterGather buffer type to enable the transfer see Working with Buffers on page 61 for more information about contiguous memory and
63. le In order the retrieve this information call the SapManager GetLastStatus method as follows Get the latest error message char errorDescr 256 strcpy errorDescr SapManager GetLastStatus Get the latest error code See the Sapera Basic Modules Reference Manual for details SAPSTATUS lastError SapManager GetLastStatus amp lastError In addition the DALSA Log Viewer utility program included with Sapera LT provides an easy way to view error messages It includes a list box that stores these messages as soon as the errors happen Available options allow you to modify the different fields for display 42 e Introducing the Sapera LT API Sapera LT User s Manual During development it is recommended to start the Log Viewer before your application and then let it run so it can be referred to any time a detailed error description is required However errors are also stored by a low level service running in the background even if the utility is not running Therefore it is possible to run it only when a problem occurs with your application Capabilities and Parameters Sapera already includes all the functionality necessary for most Sapera LT applications However some features are only available in the Standard API Capabilities and parameters are of particular interest in this case Together they define a resource s ability and current state See the Sapera Basic Modules Reference Manual for a description of al
64. n 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 Acquisition Configui i on FA Loozton 1j Aeque Sene Acqurion Usace M ED ionem 7 Cere fF c ADELS Speco s specs an de il Isar Bruse Itec Uostguratontie aartr ber our 3a canoin pou mize man ist oni oet piy tn prezante our Lortiguminn tim You must select the Acquisition Server and the Acquisition Device The first one corresponds to the board you want to grab from the second represents the acquisition device on this board some boards may have more than one You must then select an acquisition configuration file CCF File compatible with your camera from the list of available files CamExpert must be used to generate CCF files for example external trigger cropping window and so forth Note No frame grabber was found within your system if this dialog box does not appear In such a case verify that the device driver corresponding to your frame grabber was correctly installed The Sapera LT Configuration Program gives you a list of boards present within your system This demo can work without a frame grabber It however only allows you to load the file from the disk Click OK to start the demo 12 e Using Sapera LT Sapera LT User s Manual Mi apera Grab Demo Ha camera
65. n analog or digital camera No shortcut to this demo is provided in the Start menu for Sapera LT However an executable built using Visual Studio NET 2003 and the MFC library is supplied under the Wapera Demos Classes Ve GrabDemoMDI directory Bayer Demo Wapera Demos Classes Ve BayerDemo Release BayerDemo exe This program demonstrates the Bayer conversion functionality included in Sapera 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 You may optionally apply Bayer filtering to acquired images The minimum requirements to run this demo are a Sapera compatible frame grabber and an analog or digital monochrome camera The supplied executable is built using Visual Studio NET 2003 plus the MFC library Flat field Demo Wapera Demos Classes VcVFlatFieldDemo Release FlatFieldDemo exe This program demonstrates the flat field correction functionality included in Sapera Flat Field Correction FFC includes Fixed Pattern Noise FPN Pixel Replacement Photo Response Non Uniformity PRNU and Shading Correction The demo allows you to acquire images either in continuous or in one shot mode while adjusting the acquisition parameters It includes interactive calibration of flat field gain and offset settings You may optionally apply flat field correction to acquired images The minimum requirements to run
66. ning method in which all the lines in the frame are scanned out sequentially Used in several different analog and digital video systems including Progressive Scan analog cameras digital video cameras and computer monitors 82 e Glossary of Terms Sapera LT User s Manual NTSC National Television Standards Committee Color TV standard used in used in North America Japan and in several other jurisdictions The interlaced video signal is composed of a total of 525 video lines at a frame rate of 30 Hz Paged Pool Memory Regions located in operating system s kernel space from which memory blocks can be allocated and deallocated dynamically A memory block allocated in the paged pool memory is segmented into several pages physically separated from each other A page is a contiguous block of memory limited in size for example Windows NT allocates pages of 4KB PAL Phase Alteration by Line Color TV standard used in most of Europe and in several other jurisdictions The interlaced video signal is composed of a total of 625 video lines at a frame rate of 25 Hz PCI Peripheral Component Interconnect The PCI local bus is a 32 bit high performance expansion bus intended for interconnecting add in boards controllers and processor memory systems Pixel A single picture element the smallest individual digital video component The number of pixels describes the number of digital samples taken of the analog video signal The number of pixels
67. nnne 4 Hem JRR casui etes vie a oye opi pap A y 5 Minimum System Requirements iii 3 Hardware Requirements optional esee eee retener eren 5 INSTALLATION PROCEDURE ecitinicteins terere I ak se b pa RR pe 6 EIE LOCATIONS nte sedisse mtt ee e n pat aa 7 USING SAPERA LT 9 CONFIGURING SAPERA L D e TT TTT diit ocean rF PNT a ke ke 9 Configuring Contiguous Memory 10 Configuring Frame Grabber Board Serial Ports 10 USING THE CAMEXPERT TOOL licia TE QU ane IT PEUUVOS 11 Additional Information Ji DEMOS AND EE 12 Acquiring With Grab Demo ici FE Description of Examples aia usd ak on enpo ask oupa i 14 Description of Demos oia ERIGI SEO INIRE RUNDE ia 15 USING THE FLAT FIELD DEMO eterne hne iraniani ESERE ke Canina 19 Program Start and Server Selection eese eee eene 19 Flat Field Demo Main Window iii 20 Using Flat Field Correction uisu etes ainaka la ECL pe BER IR Fees Bnd 21 Flat Field Calibrati n 4 scc d eee dana ausit eda d 22 USING THE APPLICATION WIZARD avi 4 ses poko end pd os desa pon Fee p tt SEEE ee Hr rientri ita 24 Step I Overview iii 24 Step 2 Define Source of Input Image iii 27 Sapera LT User s Manual Contents e i Step 3 Fine Tuning the User Interface ossein 28 Step 4 Processing IMAGES 02 side allea 29
68. nregisterCallback FeatureChanged Sapera LT User s Manual Acquiring Images e 55 Writing Feature Values by Group When a series of features are tightly coupled they are difficult to modify without following a specific order For example a region of interest ROI has four values OffsetX OffsetY Width and Height that are inter dependent and must be defined as a group To solve this problem the SapAcqDevice class allows you to temporarily set the feature values in an internal cache and then download the values to the camera at the same time The following code illustrates this process using an ROI example Set manual mode to update features success pAcq gt SetUpdateFeatureMode SapAcqDevice UpdateFeatureManual Set buffer left position in the internal cache only success pAcq gt SetFeatureValue OffsetX 50 Set buffer top position in the internal cache only success pAcq gt SetFeatureValue OffsetY 50 Set buffer width in the internal cache only success pAcq gt SetFeatureValue Width 300 Set buffer height in the internal cache only success pAcq gt SetFeatureValue Height 300 Write features to device by reading values from the internal cache success pAcq gt UpdateFeaturesToDevice Set back the automatic mode success pAcq gt SetUpdateFeatureMode SapAcqDevice UpdateFeatureAuto For more details see the Sapera Programmer s Manua
69. o are a Sapera compatible frame grabber and an analog or digital camera The supplied executable is built using Visual Studio NET 2003 plus the MFC library Grab Demo Multiple Document Interface Sapera Demos Classes Vc GrabDemoMDI Release GrabDemoMDL exe This program demonstrates the basic acquisition functions included in Sapera It allows you to acquire images either in continuous or in one shot mode while adjusting the acquisition parameters You can open multiple windows to simultaneously acquire and display images from separate cameras The minimum requirements to run this demo are a Sapera compatible frame grabber and an analog or digital camera No shortcut to this demo is provided in the Start menu for Sapera LT However an executable built using Visual Studio NET 2003 and the MFC library is supplied under the Sapera Demos Classes Vc GrabDemoMDI directory Sapera LT User s Manual Using Sapera LT e 15 Sequential Grab Demo Wapera Demos Classes Ve SeqGrabDemo Release SeqGrabDemo exe This program demonstrates how to grab a sequence of images into memory and then display them The program allows you to record several images and then load and save AVI files Each image is stored in its own buffer and can be reviewed A small number of images are allocated by default but they can be increased using the buffer options inside the demo The minimum requirements to run this demo are a Sapera compatible frame grabber and a
70. on page 22 To use real time flat field correction first click in the Enable box Then do image snaps or continuous live grab Save Click on the Save button to store files with the flat field gain and offset data gathered with the calibration procedure Files are saved as bmp images and can be named as required to reference the camera used Load Click on the Load button to retrieve files with the flat field gain and offset data gathered with the calibration procedure Sapera LT User s Manual Using Sapera LT e 21 Flat Field Calibration Calibration is the process of taking two reference images one of a black field one of a light gray field not saturated to generate correction data for images captured by the CCD Each pixel data is modified by the correction factor generated by the calibration process so that each pixel now has an identical response to the same illumination The calibration process for an area scan camera can be over the whole frame or a selected number of lines within the frame For line scan cameras the user simply selects the number of input lines to average The calibration control overview follows e Click the Calibrate button The calibration window opens as shown The first figure is the default for an area scan camera The second figure shows the user selecting a single line for calibration when using an area scan camera r Parameters Parameters Correction type Video type Correction
71. ore when requesting a transfer stop you must call SapTransfer Wait to wait for the transfer rocess to terminate completely Transfer callback function is called each time a complete frame is transferred LE void XferCallback SapXferCallbackInfo pInfo t Display the last transferred frame SapView pView SapView pInfo GetContext pView gt Show Example program main Allocate acquisition object SapAcqDevice pAcq new SapAcqDevice Genie M640 1 FALSE uses camera default settings new SapAcqDevice Genie M640 MyCamera ccf loads configuration file Allocate buffer object taking settings directly from the acquisition SapBuffer pBuffer new SapBuffer 1 pAcq Allocate view object to display in an internally created window SapView pView new SapView pBuffer HWND 1 Allocate transfer object to link acquisition and buffer SapAcqDeviceToBuf pTransfer new SapAcqDeviceToBuf pAcq pBuffer XferCallback pView Create resources for all objects BOOL success pAcq gt Create success pBuffer gt Create success pView gt Create success pTransfer Create Sapera LT User s Manual Acquiring Images e 51 Start a continuous transfer live grab success pTransfer gt Grab printf Press any key to stop grab n getch Stop the transfer and wait timeout 5 seconds success pTransfer gt Freeze success pTransfer
72. overlay hardware will keep updating the display with the buffer contents with no additional calls The pixel format of overlay buffers must be supported by the display hardware Typically overlay buffers support more pixel formats like YUV than offscreen buffers Also color keying is supported for overlays SapView Class determines the behavior of the overlay regarding key colors Dummy Buffers SapBuffer TypeDummy Dummy buffers do not have any data memory They may be used as placeholders by transfer resources when there is no physical data transfer Physical Memory Buffers SapBuffer Type Unmapped Buffers are allocated as a series of non contiguous chunks of physical memory You may not access their data until they have been mapped to virtual memory addresses using the SapBuffer GetAddress method This type of buffer is useful if the total amount of needed buffer data exceeds the amount of available virtual memory addresses 2 GB under Windows To avoid a shortage of virtual memory addresses use the SapBuffer ReleaseAddress method as soon as you are done accessing their data Note that you cannot acquire images into these buffers Physical Scatter Gather Memory Buffers SapBuffer TypeScatterGatherUnmapped These buffers are similar to TypePhysical except that you can acquire images into them Sapera LT User s Manual Working with Buffers e 63 Reading and Writing a Buffer The simplest way to read or write data to a buffer r
73. pera LT User s Manual Introducing the Sapera LT API e 41 Error Management Error reporting Most Sapera methods return a Boolean TRUE FALSE result to indicate success or failure However the actual errors conditions are still reported as soon as they happen using one of five predefined reporting modes e Error messages are sent to a popup window the default Error messages are sent to the DALSA Log Viewer Error messages are sent to the active debugger if any Error messages are generated internally Error messages are sent to the application through a callback function Use the SapManager SetDisplayStatusMode method to set the current reporting mode as follows Send error messages to the Log Viewer SapManager SetDisplayStatusMode SapManager StatusLog Send error messages to the debugger SapManager SetDisplayStatusMode SapManager StatusDebug Simply generate error messages SapManager SetDisplayStatusMode SapManager StatusCustom Send errors to application using a callback function SapManager SetDisplayStatusMode SapManager StatusCallback Restore default reporting mode SapManager SetDisplayStatusMode SapManager StatusNotify Monitoring Errors No matter which reporting mode is currently active it is always possible to retrieve the latest error message If the error happened when Sapera called a Standard API function then a related numeric code is also availab
74. ples do not use contiguous memory Therefore you should not modify these settings unless your application requires contiguous memory The Requested value displays what was requested The Allocated value displays the amount of contiguous memory that was allocated successfully The current value for buffers determines the total amount of contiguous memory reserved at boot time for the allocation of dynamic resources for example buffers lookup tables kernels Adjust this value according to the need of your application for contiguous memory The current value for messages determines the total amount of contiguous memory reserved at boot time for the allocation of messages This memory space is used to store arguments when a Sapera LT function is called Increase this value if you are using functions with large arguments such as arrays Configuring Frame Grabber Board Serial Ports Certain frame grabber boards provide an onboard serial port for direct camera control by the frame grabber Refer to the specific board user manual for information on how to configure and use it 10 e Using Sapera LT Sapera LT User s Manual Using the CamExpert Tool Overview Sapera LT applications need to load the appropriate acquisition configuration file before acquiring images from a camera The camera configuration file has the extension cef CamExpert provided with Sapera LT supplies sets of predefined camera files for the most common camera types includ
75. r keying 63 contiguous 13 Sapera LT User s Manual contiguous memory 10 45 62 contiguous memory buffers 62 CorXferWait 51 CVL 11 27 D DALSA installers normal mode 76 DALSA installers silent mode 76 77 DALSA Log Viewer 42 Data Classes 35 demonstration programs 7 10 12 15 47 59 Developer Installations 75 diagnostic tool 7 70 71 DIB 57 DirectDraw 69 DirectDraw Capabilities Detection Tool 69 DirectDraw M 6 DirectShow 4 dummy buffers 63 dynamic resource 32 E example programs 7 10 12 14 15 47 59 F fixed pattern noise FPN 16 flat field correction 16 Font Generator Tool 70 FPN 16 G GrabDemo 12 GUI Classes 3 14 24 58 H Hardware Independent Classes 3 high level C class library 3 I INI file 77 Index e 85 input lookup table 50 Installation Procedure 6 International Canada Sales Office 79 Internet 2 Internet Explorer 71 L linescan 13 29 low level service 43 M Manager Classes 3 master mode 28 MFC 3 15 16 24 58 Microsoft Visual C 14 Microsoft Visual Studio 15 module 32 N NTSC 11 O offscreen buffers 62 offScreen buffers in video memory 62 overlay 13 overlay buffers 63 P paged pool 62 PAL 11 parameter definition 43 parent buffer 61 PDF 2 Pentium 5 photo response non uniformity 16 physical memory buffers 63 physical scatter gather memory buffers 63 Pixel Processor 3
76. r more details see the Sapera Programmer s Manual Sapera LT User s Manual Displaying Images e 57 Displaying in a Windows Application The SapView Class includes the three methods OnPaint OnMove and OnSize When your Windows application is based on MFC you should call these from within the OnPaint OnMove and OnSize handlers in your application program This ensures that Sapera is aware about the changes to the display area However these methods often do not offer especially for scroll bars a sufficient level of management following changes to the display area So it is recommended that you use the methods with the same names in the CImageWnd Class instead Note that this class is part of the GUI classes Here is a partial listing of a dialog based Windows application using the Visual C s MFC library Declarations from class header file SapBuffer m pBuffer SapView m pView CImageWnd m ImageWnd End declarations from class header file CSaperaAppD1g CSaperaAppD1g m pBuffer NULL m pView NULL m pImageWnd NULL Other initialization BOOL CSaperaAppDlg OnInitDialog Call default handler CDialog OnInitDialog Other initialization Allocate and create a 640x480x8 buffer object m pBuffer new SapBuffer 1 640 480 SapFormatMono8 BOOL success m pBuffer gt Create Allocate and create view object images will be displayed in the MFC CWnd object identifi
77. r node to allow data transfer from a source node such as SapAcquisition SapBuffer SapDsp SapPixPro or another SapCab It may also be used as a source transfer node to allow data transfers to a SapBuffer or another SapCab For more information consult the Sapera CAB Programmer s Manual SapCounter Class The purpose of the SapCounter class is to count events These events can be external such as a user supplied signal or internal such as a hardware clock The counter may then be used as a reference to control events such as changing the state of a general I O at a specific time together with the SapGio class It may also be used to timestamp acquired images SapBuffer objects or to monitor the progression of an application by simply reading the counter value SapDisplay Class The SapDisplay class includes functionality to manipulate a display resource on the system display device your computer video card or any DALSA board supporting a display section There is at least one such resource for each display adapter VGA board in the system Note that SapView objects automatically manage an internal SapDisplay object for the default display resource However you must explicitly manage the object yourself if you need a display resource other than the default one SapFeature Class 34 e Sapera LT Architecture Sapera LT User s Manual The SapFeature class includes the functionality to retrieve the feature information from the SapA
78. ray In an 8 bit system the gray scale contains values from 0 to 255 Host Memory The Windows system s random access memory Typically refers to a frame buffer allocated in the computer system s memory Interlaced The standard television method of raster scanning in which the image is the product of two fields each of which is made up of the image s alternate lines that is one field is comprised of lines 1 3 5 and so forth and the other is comprised of lines 2 4 6 and so forth Keying Color The Windows color which is used as a switch to the frame buffer video Wherever the keying color is drawn it is replaced with video from the buffer Lookup Table LUT In image processing the segment of memory that stores values for point processes Input pixel values are those of the original image while output values are those altered by the chosen point process An input lookup table destructively modifies the stored image data whereas the output lookup table simply receives the stored data and modifies it for output only Luma The black and white portion of the composite NTSC or PAL video signal Chroma is the color portion of the signal Often used interchangeable with Luminance although this is technically incorrect Monochrome A video source with only one component usually meant to refer to a black and white composite signal A monochrome composite video source has no chroma information Noninterlaced Video scan
79. scan camera control Back Finish Cancel Help Below is a brief description of parameters that can be accessed via the different categories Video input conditioning e Brightness and contrast options e Hue and saturation options Miscellaneous controls e Camera selector e Digital input connect bit ordering e External trigger options Area scan camera control e Trigger reset integrate options e Master mode camera slave options 28 e Using Sapera LT Sapera LT User s Manual Linescan camera control e Line triggering options e Frame triggering options e Shaft encoder options e Linescan direction options Step 4 Processing Images If you do not intend to process images it 1s preferable to select Application involves image display only The application created by this wizard will attempt to transfer the images directly from the acquisition device to the video adapter in order to minimize CPU load If you choose to add support for image processing this wizard will add controls to the application for the user to enable disable image processing If the processing is enabled the processed images will be displayed otherwise the unprocessed images will be displayed If you select the Add GUI controls to let user set ROT option user controls will be added within the application along with the code needed to display the location of the ROI on the image Sapera Library Step 4 of 5 X Processing Images
80. scatter gather e SapTransfer Used to link the acquisition device to the buffer and to synchronize the acquisition operations Frame Grabber Acquisition Example Steps to perform an acquisition Specify the acquisition device and corresponding camera configuration file using the SapAcquisition class Create a buffer in memory to store the acquired image using the SapBuffer class Allocate a view object to display the image using the SapView class if required Allocate a transfer object to link the acquisition to the image buffer using the SapTransfer class A transfer callback function should be registered if images need to be processed and displayed while grabbing Allocate the resources for all objects acquisition view buffer and transfer using the respective Create function of the class used to create the objects Grab images using the SapTransfer class Destroy all created resources when grabbing is completed This sample code demonstrates how to grab a live image into a buffer allocated in system memory using the X64 CL board as an acquisition device See Appendix A Support on page 67 for a list of DALSA boards equipped with an acquisition section Sapera LT User s Manual Acquiring Images e 45 As shown in the example acquiring an image requires one file the CCF file to configure the acquisition hardware It defines both the characteristics of the camera and how it will be used with the acquisition hardware Refer
81. stallation Program automatically handles the task of copying files and making Windows Registry changes as dictated by your selection of Sapera LT full development or runtime components only and the selected device drivers When integrating Sapera LT and the Sapera LT device driver installations into your system DALSA suggests that the Sapera LT Install Program be invoked within your own software installation program The Sapera LT installation is supplied in two forms Developer and Runtime installations The Developer installation is accessible from the Sapera LT CD browser and contains all Sapera LT components demos tools documentation and the Sapera LT runtimes The Runtime version contains only the components required to execute your application It is recommended that you install the Runtime components only on systems not used for development You will find the Sapera LT installation in the Sapera LT Runtime directory on the Sapera LT CD Unlike the Sapera LT installation there is only one way to perform Sapera LT driver installations A driver installation contains the device driver the device s user s manual and in some cases some device specific demos Usually the installation files are contained in one directory for example Disk1 Sometimes however they are packaged in several directories Disk1 Disk2 In this case you may include the installation files on your CD using this same directory structure The subdivided
82. sted along with the current Sapera LT installation Four items are listed for each ENV NAME Environment variable name related to the product NAME Name of the product FILE XML reference file name installed with the product PATH Path where the XML reference file is installed You may generate a diagnostic report on either a single product or all installed products Validate All e Click Validate All to generate a diagnostic file xml extension containing an analysis of all listed products e At the end of diagnostic process click the Display Results button to view the diagnostic file Validate e Click Validate to generate a diagnostic file xml extension containing an analysis of the currently selected product e At the end of diagnostic process click the Display Results button to view the diagnostic file Sapera LT User s Manual Appendix B Other Tools e 71 m DALSA Coreco Diagnostic Tool Products Installed Detected ENY NAME Name Fne SAPERADIR Sapera LT sapera inputdesc xrml C Coreco Sapera X64DIR X64 Device Driver Corx64x_inputdesc xml C Coreco x64 Diagnostic options Target directory DATSA Select one of the detected products CORECO Validate All Display results falidate Display specific results About EXIT SAPERADIR Sapera LT sapera inputdesc xrml Cii CorecolSapera X64 Device Driver Corx64x_inputdesc xml CilCoreco x64 Diagnostic options Tar
83. t into a functional system It also describes the programming API Sapera Pixel Processor Modules Programmer s Manual This manual describes the Pixel Processor and its modules Sapera LT User s Manual Introduction e 1 About the Manual This manual exists in printed Windows Help and Adobe Acrobat PDF formats The Help and PDF formats make full use of hypertext cross references The PDF format offers links to the DALSA home page on the Internet located at http www imaging com which contains documents software updates demos errata utilities and more Using the Manual File names directories and Internet sites will be in bold text for example setup exe c windows http www imaging com Source code code examples and text that must be entered using the keyboard will be in typewriter style text for example PixelClock Menu and dialog actions will be indicated in bold text in the order of the instructions to be executed with each instruction separated by bullets For example going to the File menu and choosing Save would be written as FilesSave 2 e Introduction Sapera LT User s Manual Getting Started About Sapera LT Sapera LT is a high level C class library dedicated to image processing and machine vision The C library API Application Programming Interface is composed of two different groups of classes e Basic Classes e GUI Classes The Basic Classes constitute the core of the Sapera API They m
84. te and create resources for acquisition object SapAcquisition pAcq new SapAcquisition SapLocation X64 CL 1 0 MyCamera ccf BOOL success pAcq Create Try changing the sync source to Composite Sync success pAcq gt SetParameter CORACQ PRM SYNC CORACQ VAL SYNC COMP SYNC Release resources for acquisition object and free it success pAcq gt Destroy delete pAcq For more details see the Sapera Programmer s Manual and the Sapera Basic Modules Reference Manual Triggered Acquisition Example The following code sample demonstrates how to set individual parameters using the SapAcquisition class SetParameter function to perform a triggered acquisition area scan camera These parameters are set after creating your acquisition object and resources and before grabbing pAcq gt SetParameter CORACQ PRM EXT TRIGGER LEVEL CORACQ VAL LEVEL TTL pAcq gt SetParameter CORACQ PRM EXT TRIGGER ENABLE CORACQ VAL EXT TRIGGER ON pAcq gt SetParameter CORACQ PRM EXT TRIGGER DETECTION CORACQ VAL RISING EDGE 48 e Acquiring Images Sapera LT User s Manual Modifying Parameters by Group Acquisition parameters can be modified by groups using the optional updateNow parameter to the SapAcquisition SetParameter method When a new set of values is written all modified parameters are verified against the given state and capabilities of the acquisition object Allocate and create resourc
85. ter starting the Sapera LT Application Wizard and describes what the Sapera LT Application Wizard can essentially do Sapera Imaging Library Step 1 of 5 Sapera LT User s Manual Using Sapera LT e 25 Below is a typical user application interface obtained by using the Sapera LT Application Wizard MyApp OP File File Control 1 r Processing Enable Time ms Load Save a Processing ie Full image Ral Exit Acquisition Snap Grab presi a cq Options General Composite Area scan Line scan CAM VIC AMO 26 e Using Sapera LT Sapera LT User s Manual Step 2 Define Source of Input Image Location If the option Select an acquisition device installed in host computer is chosen not available in the stand alone version a dialog box is displayed for the user to chose the acquisition server and device immediately The acquisition server refers to the frame grabber for example Viper Quad 1 while the acquisition device is the name of the input device for example Single Channel 1 Acquisition Configuration CCF file Prior to release 5 0 of Sapera LT acquisition was configured using two files a CAM file with cca extension and a VIC file with cvi extension The two files have been combined into a single CCF file that you can generate using the CamExpert tool CamExpert uses a large database of CAM files that are distributed with Sapera LT
86. tion Tool Use the DirectDraw Capabilities Detection tool to determine what DirectDraw capabilities a VGA card supports The resulting information can be used to help determine the application View mode to be used To run this program select DALSA DirectDraw Capabilities Detection in the Tools folder of the Sapera LT menu Click on the button Start Test The program runs a series of tests to ascertain 1f your VGA card supports Overlay and Offscreen modes for the different display formats The following screen shot illustrates an example of the outcome of the test Direct Draw Capabilities Detection This test has been performed in this video Mode 1280x1024x32 Mode Oveda Capabilities MONOS RGB555 RGB565 RGB888 RGB8888 UYVY 8Bits UYVY 16Bits UYVY 24Bits UYVY 32Bits YUY2 8Bits YUY2 16Bits YUY2 24Bits Sapera LT User s Manual Appendix B Other Tools 69 Font Generator Tool The CorFont exe tool program included with Sapera LT provides an easy way to create new fonts that can then be used by the Graphic module n Coreco Font Generator ic xi Font Name Font Style Font Size Regular 22 Preview V SNE 0123456789 lt gt ABCDEFGHIJKLMNOPQRSTUVWXYZ N abcdefghi jklmnopgrstuvwxyz 0 You are allowed to modify the font attributes by clicking on the Font button The preview window shows you what the font will look like The font can then be saved
87. zard allows code generation for simple applications involving a single acquisition device for example Bandit II in a host computer It is called from within Microsoft Visual Studio 6 by selecting FilesNew and then selecting the Projects tab MET Files Projects Workspaces Other Documents Project name Sapera Libeaty ar Custom Appwieard Ti Utkiy Project I D Database Project BA vegaNet Apo wizand Locaboni KB DevSludo Addin Wizard 8 win32 Application fc Coreco S apara examples St Bi S Extended Stored Proc Wizard win22 Console Application 7 IC ASY NC App wizand 9 wn32 Dynemic Lirk Library A ICPCI Appwizard Se Wind Stalie Leary Creste new warkspaci IFC Apo wizand Addio cure workspace ae ISAPI Extension Wizard IT Denerdensy of 8 MFC App wizasd dl BA MFC App wizard exe K New Database Wizard B iw FC Comp Appwaad The Sapera LT Application Wizard generates dialog based MFC applications that use the Sapera classes introduced with Sapera 4 0 Sapera Basic Classes encapsulate all Sapera API calls They address basic imaging concepts that is acquisition display processing and buffers Sapera GUI Classes provide the user with MFC based dialog boxes commonly used in most imaging applications Refer to Sapera Programmer s Manual for information on the classes 24 e Using Sapera LT Sapera LT User s Manual The screen shot below is the first to appear af

Sapera LT User`s Manual

Contents

Download Pdf Manuals

Related Search

Related Contents