Baumer-GAPI Viewer v1.7 User's Guide for Baumer
Contents
1. Flip Y Flip XY Flip None 3 4 1 3 Menu Camera Image View ely Figure 9 gt Menu Camera Save Configuration File Here a copy of the configuration file xml of a Gigabit Ethernet camera can be stored to the PC 3 4 2 Image View Here the last recorded image is diplayed Thereby the settings done in Feature Control are employed 3 4 3 Feature Control By selecting a feature button in this area an associated parameter list is opened The availability and or the status of a particular feature is indicated by several icons Icon Status This feature is enabled This feature is disabled This feature is not supported by the software This feature is not supported by the hardware Q b be Depending on an other feature this one is temporary locked Feedback error on feature Some of the features are camera specific Therefore the features are labeled within this document Label Description _G This feature is available on Gigabit Ethernet cameras CL This feature is available on CameraLink cameras FW This feature is available on FireWire cameras _S This feature is available on special cameras only2. 3 5 BGAPI Options Some of the options features are interface specific Therefore the features are labeled Label Description LG This feature is available on Gigabit Ethernet E This feature is available on CameraLink cameras EW This feature is available on FireWire 3 5 1 System zech BGAPI Options Tab System Interface Selector Information GVS Driver Model Force IP Interfaces Control Monitor 2 3 4 5 6 Command 7 8 9 Feature Status E ei OC 0 0O amp 10 System Callbacks 11 Close Button 3 5 1 1 Interface Selector Te G Ew Here the respective interface for which the options should be processed can be se lected BGAPICameraLink BGAPIs_DEVICETYPE_COMMONPCI_CAMERALINK BGAPICameraLink BGAPIA DEYICETYPE COMMONPCI CAMERALINE BGAP Firewire BAIS DEVICE TYPE_COMMONPCIOHCT BGAPIGigE EGAP DEVICETYPE_COMMONPCL NIC 30 3 5 1 2 Information In this area several information on the selected interface are displayed 3 5 1 3 GVS Driver Model This drop down menu offers the possibility of driver selection Here either the Baumer Filter Driver of the standard socket driver can be set GYS Driver Model FILTER SOCKET FILTER T Notice Baumer recommends the employment of the Baumer Filter Driver which increases the performance
3. The menu bar contains three menus Image View and Camera 3 4 1 1 Menu Image View Camera SAVE Figure 6 gt GA Strg C Transformation settings Menu Image This menu provides the possibilities of saving images menu item Save and copying image content to the clipboard menu item Copy as well as image transformation op tions Transformation Control ar Transformation Control image transtormaion settings Ce Transformation before image capture only possible in normal mode Select target pixel format Pistype MONOS C Transformation after image capture Figure 7 gt No image transformation Transformation control window of the Baumer GAPI Viewer Transformation Setting Transformation before image capture Transformation after image capture No image transformation 10 These settings are controls for pixel transformation For further information please see Baumer GAPI SDK v1 x Programmer s Guide Description After the creation of an empty image object container the destination pixel format for this container is set The transformation occures within the image buffer Regardless to the adjusted destiantion format the Baumer GAPI viewer will display the record ed image in a presentable format like mono or RGB After the image acquisition the image data gets copied and transformed Regardless to the adj
4. Baumer oT set T p Gigabit Ethernet cameras in hardware release 2 1 mn oO TI Dueto the fact that the currently recorded image is stored within max the camera and its transmission starts with a predefined delay pev o complete images can be transmitted to the PC at once With this feature you can set the delay in ticks 27 SE 7 28 User s Guide Page 45 Programmer s Guide Page 28 3 4 3 45 Trigger kal Enabled Trigger Source HAR DWAR s OFF SOFTWARE HARDWARE 1 COMMAND T AIGGER ALL Trigger Activation RISINGEDGE FALLINGEDGE RISINGEDGE Trigger Delay set Software Trigger 3 4 3 46 User Set User s Guide Por Page 51 Select user set BGAFI_USERSET_FACTORY BGAPI_USERSET_1 BGAPI_USERSET_2 BGAPI_USERSET 3 Select default user set BGAPILUSERSET_FACTC EGAPI USERSET FACTORY BGAPLUSERSET_1 BGAPILUSERSET_2 BGAPILUSERSET_3 CL G FW mmm an This feature offers the possibility to switch the camera to the trigger mode Once Trigger is enabled the trigger source as well as the state of the trigger signal on which the camera should react is adjust able The button Do it provides the possibility of sending a software trigger to the camera The COMMANDTRIGGER is available on Gigabit Ethernet cameras only TriggerActivation is only selectable on trigger source HARDWARE 1 CL G Ip gea Here several po
5. Baumer GAPI library C code bypasses both C API and the C API 2 1 3 Framework A Framework represents a software platform which provides a runtime environment an API and several services to the programmer It is required for example when program ming in C or VB NET 2 2 Gerneral System Requirements Single camera system Multi camera system Minimum Recommended Minimum Recommended CPU Intel Pentium 4 or comparable Intel Core Duo comparable processor processor Clock 2 5 GHz gt 2 5 GHz 2 5 GHz 3 GHz RAM 1024 MB 2048 MB 2048 MB gt 2048 MB Operating Microsoft Windows XP incl Service Pack 2 or higher system Microsoft Windows XP x64 incl Service Pack 2 or higher OS Microsoft Windows Vista 32 64 bit systems Microsoft Windows 7 32 64 bit systems Linux 32 64 bit systems from Kernel 2 6 xx Graphics recommended resolution 1280 x 1024 color depth at least 16 bit Framework Windows OS NET Framework 2 0 or higher optional Linux OS Mono 1 2 4 or higher 2 3 Installation The Baumer GAPI Viewer is part of the installation package Baumer GAPI The installation procedure on Microsoft Windows is described in Baumer GAPI SDK Installation Guide for Gigabit Ethernet for Gigabit Ethernet systems or rather in Baumer GAPI SDK Installation Guide for FireWire for FireWire systems Figure 1 gt Main window of the Baumer GAPI Viewer 3 Baumer GAPI Viewer 3 1 Central Idea The B
6. behaviour of the camera is controlled e Enabling the checkbox Start image acquisition direct after init means the camera is started immediatly after the camera window is opened Disabling this checkbox means the image acquisition needs to be started manually 3 5 3 Trace BGAPI Options Tab Trace Programmer s Guide DE Page 55 7 Trace Support Interface Selection Create Trace Object Trace Output Trace Mask 2 3 4 5 Enable Trace 6 7 8 Trace Output Options 9 Trace Level 10 Reserved for future functions 3 5 3 1 Trace Support Currently there is only one option here BGAPI_ TRACESUPPORT_ GLOBAL which will trace events from all involved interfaces and cameras For future versions it is intended to offer the possibility of tracing for single devices 3 5 3 2 Interface Selection Here for every available interface the tracing options can be adjusted separately 33 34 3 5 3 3 Create Trace Object By enabling this checkbox a trace object will be created Creating a trace object does not mean tracing is started you will have to enable trace and set at least one option in every box of this dialog to start tracing 3 5 3 4 Enable Trace Once this checkbox is ac
7. blue and the red circle and by en tering the coordinates 3 4 3 4 BrightnessCorrection BrightnessCorection Enabled Disabled Enabled UCL G FW a amm On Binning Mode an aggregation of charge carriers takes place This may cause an overload and therefore an overexposed im age For prevention of this effect the Brightness Correction was introduces This feature is available on Binning Mode only 3 4 3 5 Camera Information Cameralnformation LCL G IW gea Here several information on the employed camera such as se rial number model name and firmware version are provided User s Guide DE vi User s Guide DE Page 39 ra Programmer s Guide Page 22 15 3 4 3 6 Cooler By this feature the integrated cooler can be enabled or dis Enable abled Enable 3 4 3 7 Counter control LG mm mm With this feature you can choose countable Events The count values of these Events are readable and writable COUNTER_1 lt Configuration _ When the set value is 0 then the maximum number of count Value able events is 2 1 4294967295 GE If you specify a value then the counter counts up to that value P and stops Then a GigE event is triggered Counter1 2End Ever Gutes and the status of the counter changes from ACTIVE to the OFF readable status COMPLETED Event Activation RISINGEDGE Reset Source OFF Reset Activatio
8. CEEDED needs to be ON cL G J Fw alem Here several test patterns stored within the camera can be se lected and displayed within the image view These patterns serve as a test tool for correct data transmission between camera and PC 3 4 3 42 Timer control CL G FW E HHB User s Guid cL 6 Fw am sm DE sers Guide o Timers were introduced for advanced control of internal camera signals TIMER Delay in microsec For example the using of a timer allows you to control the flash b Ise signal in that way that the illumination does not start synchro nized to the sensor exposure but a predefined interval earlier Duration in microsec _ _ _ _ Timer Trigger Source OFF Timer Trigger Activation RISINGEDGE 3 4 3 43 Timestamp G J C DE User s Guide Page 57 Here the current timestamp of the camera can be requested gt EES Update Timestamp provides two options d Oh 00m 00s 004ms 584us The current timestamp can be requested and displayed once Update Timestamp or The current timestamp can be updates permanently in a D permanent ioo i me user defined interval Reset Timestamp The timestamp can also be reset here 3 4 3 44 Transmission Delay G j JCI User s Guide eae ee a Sa Page 60 An Possibility for packet sorting in multi camera operation is the 4 so called Transmission Delay which was introduced to
9. Camera min takes images at full frame rate with max out external trigger 18 3 4 3 16 Gain CL G J Fw Gn Por Programmer s Guide Here the amplification factor can be adjusted via entry or slider gt eae p 3 4 3 17 Gamma CL G S User s Guide i i PDF Page 36 Here the corretion factor y for the gamma correction can be set gt Thereby y is adjustable from 0 001 to 2 min Bo iman LookUpTable Hardware needs to be enabled to activate this feature 3 4 3 18 HeartBeatTimeout G am en This feature provides the possibility of setting the heartbeat DE Programmer s Guide cycle Page 67 W Enabled 3000 J m Thereby the cycle duration heartbeat timeout can be adjusted rain from 500 msec to 2 billion msec max 4294967295 3 4 3 19 ImageFormat Ca G FW E C DE SE S 32 Here the adjustment of the image format takes place Programmer s Guide 7 Page 23 Full Frame HQ z Within the drop down menu all available image formats of the Formatld 7 employed camera are displayed Width 1624 Height 1236 Offsets Offset ScaleF actors U U ScaleF actory 19 3 4 3 20 I O s CL G am om This feature offers the possibility of configuring the digital in and outputs of the camera K 22E E For an input the debouncing times L and L High CAN Line Selector be adjusted in usec The line can be inverted SE For an outp
10. E This feature is available on monochrom cameras um This feature is available on color cameras The camera functions are described more detailed in the following documents Baumer TXG User s Guide for Gigabit Ethernet cameras referenced as User s Guide Baumer GAPI SDK Programmer s Guide referenced as Programmer s Guide 3 4 3 1 Basic API cL J G pu mea Here the access to the features of the Basic API is possible These features are necessary in special cases only 14 3 4 3 2 AsynchReset G J Fw m gem On asynchronous reset the camera is stopped immediatly Thus the current image is not read out completely and will be upcast Afterwards the camera continues with the next image 3 4 3 3 AutoExposure 4 AutoE xposure Processing unit SOFTWARE Automatic Mode OFF e Brightness in X L HOI et 0 top O right 2048 gt gt gt gt bottom hoss oo Minimum Exposure o Maximum Exposure 000000 Current Exposure 4000 ps UCL G J Fvv mmn ammm By this feature Baumer FireWire cameras provide the possibil ity to set the exposure time internal automatically With the other cameras the exposure time is calculated with external software BGAPI Viewer Once the feature is enabled a desired brightness level mea sured in grayscales 0 255 and adjustable in can be adjusted for a target area ROI The ROI is adjustable by the
11. INE C BGAP Firewire BGAPI_DEVICETYPE_COMMONPCI_OHCI lt Figure 3 BGAPIGIgE BG4PI_DEVICETYPE_COMMONPC NIC Gigabit Ethernet cam C TX lt G023 0003794507 era found After selecting a camera the camera window please see section 3 4 will be opened 3 3 2 2 Options Here several options regarding to the interface and the camera can be adjusted Further information on the options window will be given in section 3 5 This only makes sense after initialization 3 3 3 Menu The only item here is Info which causes the display of the Baumer GAPI version 3 4 Camera Window The camera window Fig 4 is fielded in five areas Menu Bar 1 Image View 2 Feature Control 3 Statistics 4 and Status Bar 5 lt Figure 4 Framing of the camera window which are described in the following paragraphs gt 1xG03 0003794507 SEE Image View Camera gt I O s WE Baumer E LookUpT able Hardware LookUpTableGamma Messages PacketDelay fol PacketSize PartialScan PixelF ormat lt Camera Statistic Recived Frames Good 7290 Recived Frames Corrupted 0 Lost Frames 0 Resend Requests 1 Resend Packets 1 Lost Packets 0 Bandwidth 86 MBit s lt Figure 5 HwCounter 244520 Cam fps 31 Er Draw fps 23 32 Dropped 237234 Od 2h Screenshot of the cam era window 3 4 1 Menu Bar
12. Slll le pes aag Rr agg i E AY o od a a a a a a o _ o a Stat AA AAS A SCC rra rana pira 2332 Dropped User s Guide tor Baumer GAPI Test Tool Table of Contents Mes ode Te d Le EE 5 2 UE GET GK RE 5 2 1 Baumer GAPI Stack Components eee e e eee 5 2 1 1 Hardware Specific COMPONGIMNGS ER 5 2 1 2 ie Ee 6 2 13 F VOW OPK EEN 6 2 2 Gerneral System Heourements E 7 Z MNS EAA ON EE 7 3 Baumer GAPI Viewer EEN 8 341 Cental dea EE 8 32 Programi STAI EE 8 3 3 Main WIndOW ee 8 3 3 1 Menu e ele te E 8 3 32 Menu Se 8 NET E 9 34 Camera lee e 9 34 1 Menu E 10 354 2 E e 14 3 4 3 Freet eege gege Eege ge 14 34 74 re rn E 29 34 5 SAUS T T 29 Ja BOARAFFOPUON E 30 SEN WEE a A seem ot eee A E E AE E A A E A POE 30 Sun Ee EE 33 3 5 3 Trace 33 Figure 1 gt The Baumer GAPI stack Baumer GAPI Viewer Customer Operating C module Baumer GAPI C API rt Image processing Color Baumer GAPI Library Image Library lL management Algorithms V N2 J Gs CLallserial dll Serial Communication TCP IP Baumer Filter Driver Framegrabber API i Baumer optional vendorspecific i Driver X oS ed Hardware l ES e j i Configuration Hardware Driver Files Driver X ird S
13. aumer GAPI Viewer was developed as a complex example program with open source code The tool is written in the programming language C and serves as a refer ence project for the interaction of C Microsoft s NET Framework and or Mono and Baumer s API 3 2 Program Start The Baumer GAPI Viewer is started by Start All Programs Baumer Baumer Gapi Development Kit Baumer Gapi Viewer xx 3 3 Main Window Afterward the main window Fig 1 appears CO BGAPI Viewer Application System 7 gt to Baumer BGAFI am Baumer Here you will find a menubar with three menus which are described more detailed within the next paragraphs 3 3 1 Menu Application By selecting the menu item Exit the tool can be aborted 3 3 2 Menu System This menu contains two items Initialize and Options 3 3 2 1 Initialize By selecting this item the tool scans for available interface plug ins Found interfaces will be displayed Fig 2 1 xx stands for 32 or 64 which means 32 64 bit with respect to the employed OS BGAPICameraLink BGAPI_DEVICETYPE_COMMONPCICAMERALINE CU BGAPI Firewire BGAPI_DEVICETyPE_COMMONPCI_OHCI CU BGAPIGigE BGAPIe_DEVICETYPE_COMMONPCI_NIC lt Figure 2 Available Baumer GAPI interface plug ins Once one of these interfaces is selected the software scans for available cameras and displays them below the interface Fig 3 BGAPICameraLink BGAPI_DEVICETYPE_COMMONPCICAMERAL
14. feature display Afterwards the LUT needs to be updated via Update button 3 4 3 23 LookUpTable Gamma FW a d LookUpTableGiamma This feature realizes a gamma correction for the three color v Enabled color cand Geh red C geen CH blue red options 7 8 bit 7 10 bit s 12 bit C positiv 4 negativ Gei gamma i a J curve from hle 3 4 3 24 Multicast Multicast Image Multicast kal Enabled Multicast IF 29710 lp 126 Message Multicast O Enabled Multicast IP 23235 0 0 channels red green and blue and conduces to image data vi sualization Once this feature is enabled the possibility of optimizing every single color channel is offered Thereby the following options exist The fineness of the LUT and therefore the image quality is controlled by its size 8 10 or 12 bit whereat 12 bit causes the best quality The image can be displayed either as positive or negative pattern or by employment of a specific gamma correction factor 099 Multicasting offers the possibility to send data packets to more than one destination address without multiplying bandwidth between camera and Multicast device e g Router or Switch Image Multicast set the IP for the images Message Multicast set the IP adress for the messages You must stop the camera before using this feature 21 User s Guide Por Page 58 7 User s Guide DE Page 41 7 User s Gu
15. i Send Command In the upper part the signal type Command ID and the target group of cameras Group Key and Group Mask can be defined Enabling Acknowledge means predefined cameras should send response on incom ing Action Commands This predefinition is done by entering the IP addresses of the desired cameras to the designated field followed by clicking the Add button 3 5 1 6 Interfaces This feature offers the possibility to shorten the search for Gigabit Ethernet cameras by excluding specific interface cards Interfaces Available 169 254 1 1 interfaces 172 20 20 51 IPAddress of 0 oO o 0 Add Interfaces to Bal ignore Update available and ignored list In the upper part of this feature control all on the PC side available interface cards are listed with their IP address By clicking on one of these IP addresses this will be added to ignore list automatically 3 5 1 7 System callbacks This feature offers the possibility to choss which events will be shown in the message window System Callbacks PRP Thread Receive Actions PnP Thread Plug and Play Events e g connecting of a camera Receiver Action Action Commando e g group key 32 3 5 1 8 Feature Status Here several information whether a feature is supported or not are stated 3 5 2 Cameras BGAPI Options 1 Tab Cameras 2 2 Display Options By this feature the start
16. ide DE Page 52 E 22 3 4 3 25 Messages G gea Here several messages of the asynchronous message chan nel which is despribed in the GigE Vision standard can be BGAPI_MES j EEROR selected for event signaling EVENTLOST LINEGRISIN On occuring selected event a message window will pop up to LINEOFALLI gt j ye16 5 Inform about this fact LINE1FALLI EXPOSURE EXPOSURE FRAMESTA FRAMEEND TRIGGERRE TRIGGERG TRIGGERS Outputs from l0 Control 3 4 3 26 Offset cL JG FN sm en Here the analog offset blacklevel can be adjusted H emm min E 3 4 3 27 PacketDelay LG am m By this feature the so called inter packet gap measured in ticks on S ticks can be adjusted Thereby one tick equals 4 Bytes of data 3 4 3 28 PacketSize LG J Fw gea Here the size of data packages measured in bytes is adjust ER able via entry or slider a For the adjustment of this feature the camera needs to be stopped mir bat mas 1504 prew 1202 On FireWire this feature is avail next 1204 able for DCAM cameras only 3 4 3 29 PartialScan cL J _G J FW m mmm e E a This feature offers the possibility of defining a so called Region P Page 23 G Enabled of interest ROI Once the feature is enabled the coordinates of the start respec g zet l ee c tively end point of the ROI can be adjusted by the
17. item results an 1 1 display of the re corde images Zoom factor 100 By this menu item the zoom functions are en abled 11 12 Menu item Center Fit to Window FullScreen Zoom In Zoom Out Description This option causes the displayed image 1 1 to be centered within the Image View Selecting this item results in an adaptation of the im age to the Image View This item activates the full screen mode Notice Full screen mode can be left by pressing the Esc key By this item the displayed image can be scaled up This function requires Stretch to be activated By this item the dis played image can be scaled down This function requires Stretch to be activated Result Submenu SmoothingMode InterpolationMode Flip Image Menu item Description Result AntiAliasDefault HighQuality HighSpeed None Bicubic Bilinear Default High HighQualityBicubic HighQualityBilinear NET specific functions Low NearestNeighbor Flip X
18. ivated This protocol family controls the data transfer between networked devices API stands for Application Programming Interface An API is a software interface between two programs usually between operating system and an application Linux and FireWire For the moment Linux is Supported only by Baumer FireWire cam eras of the FWX series Baumer GAP I v1 5 is tested with Linux Mono 1 2 4 Windows NET 2 0 In default versions both control and stream data pass through the TCP IP stack and for transfer to the Baumer interface plug in in this case the GigE Vision plug in This plug in provides interface specific preprocessing of Baumer GAPI commands The GigE Vision plug in ensures a package structure in accordance with the GigE Vision standard With Baumer Filter Driver only on Windows operating systems the option of separating stream data from network and control data is available In fact this allows network and control data to continue to pass through the TCP IP stack but stream data are transferred directly to the GigE Vision plug in Use of the Baumer Filter Driver increases your sys tem s performance and is therefore recommended 2 1 1 3 FireWire As with Gigabit Ethernet you also need the applicable hardware to work with Baumer FireWire cameras Standard Windows operating systems require an OHCI Open Host Controller Interface driver Beca
19. n RISINGEDGE Information CounterState ACTIVE Counter alue U CounterD uration Countervaluedtheset 0 permanent 100 3 4 3 8 DataAccess Programmer s Guide LCL G Fw C PDF Page 33 gt Here some parameters for the buffer management can be ad justed NORMALINTERN NORMALIN TERM QUEUEDINTERM number of internal buffer Notice 10 This feature is only available when set the camera is stopped 16 3 4 3 9 DefectpixelCorrection CL J G C DE User s Guide Page 42 During the lifecycle of a camera hot or cold pixels can develop gt F Enabled In order to correct this pixels the so called defect pixel map or list was introduced to Baumer cameras Defect pixel map index x Y Enabled A By this list Baumer offers the possibility to implicate additional pixels to the correction procedure O zl OD On fo G R gt CN The coordinates reference to Full Update defect pixel map Frame Format 3 4 3 10 Device Clock CL G sm am The speed Mhz to readout the sensor can be configured by using this feature SENSOR Frequency By reducing the clock you can prevent buffer overflows reduce A t power consumption and can use longer cables The offered speed are dependet from the connected camera 3 4 3 11 Exposure G J Fw 9 amn Here the exposure time can be adjusted via entr
20. nt Kit SDK with numerous detailed program examples as well as help files and the Baumer GAPI Viewer for evaluation of all camera functions 2 1 Baumer GAPI Stack Components 2 1 1 Hardware Specific Components Because the Baumer GAPI supports several hardware interfaces which need to be han dled in different ways there are some interface specific components integrated into the Baumer GAPI SDK to keep it generic 2 1 1 1 CameraLink The CameraLink interface was especially developed for cameras in machine vision ap plications and provides high transfer rates and low latency Depending on the configura tion Base Medium or Full the transfer rate adds up to 625 MBytes sec Base max 24 Bit per Clock e Medium max 48 Bit per Clock e Full max 64 Bit per Clock Cameras of the Baumer SXC series are equipped with a CameraLink Base interface Cameras of the Baumer HXC series are equipped with a CameraLink Full interface 2 1 1 2 Gigabit Ethernet Working with Baumer Gigabit Ethernet cameras requires the installation of appropriate hardware and a network interface card NIC which support GigE on your PC Baumer recommends the employment of NICs with an Intel chipset The hardware is delivered with a hardware driver which is required in order to establish communications between hardware and software After the hardware and its driver have been installed the TCP IP stack which also covers the necessary UDP is act
21. o L o Hardware 1 Introduction The GAPI Viewer part of the generic application programming interface from Baumer is the perfect evaluation tool for all Baumer cameras It allows you to investigate the exten sive functionality within our innovative cameras Regardless if you consider GigE Vision or FireWire as your application interface the Baumer GAPI Viewer will provide you an easy to use graphical user interface to test you specific camera features 2 Baumer GAPI SDK Baumer GAPI stands for Baumer Generic Application Programming Interface With this API Baumer provides an interface for an optimal integration and control of Baumer Gigabit Ethernet GigE and Baumer FireWire IEEE1394 cameras This software interface thus permits the option of switching to other camera models or interfaces It also allows the simultaneous operation of Baumer cameras with a Gigabit Ethernet and FireWire interface This GAPI supports both Windows XP and Vista and Linux operating systems in 32bit as well as in 64bit It provides interfaces to several programming languages as C C and to the NET Framework on Windows Mono on Linux operating systems respec tively which enables the use of other languages such as C or VB NET The software package includes a setup tool the Software Developme
22. of your system 3 5 1 4 Force IP E F 2E User s Guide e i i Page 55 This feature offers the possibility of forcing a valid IP address to the camera gt Force lP MAC Adresse hex og oo oo oo oo ao ce IP Adresse jo fo fo fo 2 Subnet Mask jo fo fo o Default Router jo fo fo fo Execute 4 O Force IP procedure a First please fill in the MAC address of the camera to the designated field 1 The MAC address is denoted in hex on the type plate on the bottom side of the device b Next please enter a desired IP address and subnet mask which are valid for your network to the designated fields 2 and 3 If there is no persistent IP defined for your NIC Baumer recommends to enter a IP from LLA range like IP 169 254 x x subnet mask 255 255 0 0 c Afterwards please enter the IP address of your default router 4 In case of LLA please leave this fiels at 0 0 0 0 as is default d Once these entries are done click Execute 5 to force the data to the camera The parameters are now written temporary to the device The camera is now reachable and you can accomplish IPConfiguration The camera may not be de energized during the Force IP process 31 3 5 1 5 Command This feature offers the possibility of sending Action Commands to several devices Command Command ID TRIGGER Group Key Group Mask Acknowledge T Enabled IPAdessof 0 o fo o Add Responder Clear f
23. on on camera and or image are provided Camera information Image information Number of good frames Image status Number of corrupted frames Number of resend requests Number of lost frames Number of resend packets Number of resend requests Number of lost packets Number of resend packets Number of packets in total Number of lost packets Software counter Bandwidth in MBit sec Hardware counter 3 4 5 Status Bar The status bar Fig 10 at the bottom of the camera window gives some information on the camera SwCounter 109542 Software Counter HwCounter 1125001 Camfps 31 50 Draw fps 23 44 Dropped 1015470 14 0h 35m 25s 180ms 782us81 Ens lt Figure 10 Status bar of the Baum er GAPI Viewer Hardware Counter Camera Frame Rate Viewer Frame Rate Dropped Images Timestamp 29 Information Description Software Counter Number of images received by the software since the camera was started Adjustable via frame counter feature see Section 3 4 3 11 Hardware Counter Number of images aquired by the camera Adjustable via frame counter feature see Section 3 4 3 11 Camera Frame Rate Current frame rate of the camera frames per second fps Viewer Frame Rate Current frame rate of the Viewer frames per second fps The Baumer GAPI Viewer is able to display up to 24 fps Dropped Images Number of images which were not processed by the Baumer GAPI Viewer Timestamp Timestamp of current displayed image
24. rtening of the readout time 3 4 3 33 Readout Mode CLJ G m am This feature refers to the timings of image acquisition Here the SEQUENTIAL operation mode can be switched between overlapped and se quential read out SEQUENTIAL 3 4 3 34 Reset CCL J G J Fw m a Reset By processing this feature the camera will be reset to factory settings On Gigabit Ehternet cameras please stop the camera befor reset 24 3 4 3 35 Sequencer CL JG mm A sequencer is used for the automated control of series of im ages using different sets of parameters lw Enable Once tree el Here you can make the settings for the sequencer Add Set Loops over sequence F Repeats of current set 1 ES Frames per trigger 1 Exposure Sequencer Outputs 11 O2 O3 E PDF User s Guide Page 53 E 3 4 3 36 Sensor Digitization Taps CL G m am Sensor Digitization Taps This feature depends on the sensor of the employed camera EIGHT z Here you can set the number of readout channels of the sen sor More channels increase the speed framerate but more channels generate a higher power Use only the maximum required number of channels 3 4 3 37 ShutterMode FW L User s Guide f Pee PDF Page 25 This feature refers to the timings of image acquisition Here the gt EGAPL SHUTTER SEQU gt operation mode can be swi
25. sliders R 1620 Top R 1235 a Right 1624 set 4 1624 Bottom set 1 1236 3 4 3 30 PixelFormat cL 6 Fw am m gt ren 7 f i i e Programmer s Guide Z PikelFormat By this feature the pixelformat depending on the current set im S Page 24 age format can be selected Monog Color False Below the drop down menu several information on the pixel for ImageByteSize 2007264 mat are displayed Pinelbits H Pixel tes 1 PizelF ormat 17307505 In hex 01080001 DataLength 2007526 DataLengthMax 4014800 The pixel format depends on the DataLengthMin 4 employed image format 23 3 4 3 31 PWM controller Special cameras of Baumer s TXG series are equipped with a so called PWM pulse width modulation controller for lighting control Thereby a PWM controller can be selected via drop down menu In Frequency the output frequency in Hz is adjustable via entry or slider Duty Cycle Duty Cycle means the duty factor of pulses in percent and is also adjustable via direct entry or slider as well as the percent Over Power Threshold age for the Over Power Threshold s Last but not least the PWM controller can be enabled Puri Enable lw Enabled 3 4 3 32 Readout FW 9 899 This feature depends on the sensor of the employed camera BGAPI_READOUT_SINGL On Dual two halves are read out simultaneously which results BGAPILREADOUT SINGLE EGAR BEADOLUT DUAL in a sho
26. ssibilities regarding to user sets are offered s Loading a user set causes a specific behaviour of the camera Loading of BGAPI_USERSET_FACTORY will reset the camera Storing of the current camera configuration to a selected user set Selection of a default user set and therefore specification of a specific start behaviour of the camera Factory settings can not be overwritten On Gigabit Ethernet please stop the camera before using this feature 3 4 3 47 Whitebalance CL J G FW C 2E User s r Sg Once this feature is enabled it provides two possibilities of color gt W Enabled correction White Balance ROI G t One Push White Balance via White Balance ROI Here the white balance is processed by employment of white 7 d balance factors which are determined for a particular area Top ROI of the image This ROI is adjustable via direct entry to J gt the fields Left Top Right and Bottom or by usage of D the sliders e User specific Color Adjustment via White Balance Factors 1 Here the correction factor for each color can be adjusted Batz user specific re 1 White Balance Factors 1 Fed 2 425537 En SS i S Blue On Gigabit Ethernet cameras the white bal ance ROI is full frame or the ROI of partial E scan 3 4 4 Statistics These data rely on GigE specific features and are not available on FireWire Here several informati
27. tched between overlapped and se quential 3 4 3 38 Start I E l ES Sa DE Programmer s Guide Here the camera image acquisition can be started or stopped gt p 25 3 4 3 39 SystemCommand User s Guide DE Page 69 4 SystemCommand 26 Action Command o Group key Di Group mask 0x0 Set Device Rey gt Set CL G mama Here the behaviour of the camera on a so called Action Com mand can be adjusted Therefore the ID of the expected command can be definded as well as a group key and the group mask The interface side adjustment possibilities are stated in section 3 5 1 5 of this document 3 4 3 40 Temperature BGAPI_TEMPERATURE Current Temperature r permanent 100 ms Critical Temperabhse s min 3 4 3 41 TestPattern TestPattern v Enabled Select T estpathern BGAPI_TESTPATTERN_ BGAPI_TESTPATTERN HOR BGAPI_TESTPATTERN_VER BGAPI_TESTPATTERN_VER BGAPI_TESTPATTERN_ HOR BGAPI_TESTPATTEARN INTE cee Rea JC For cameras with integrated temperature sensor the current tem perature at the camera board can be measured and displayed by this feature This can occure manually via the Update button or in a pre defined permanent interval On exceedance of a defined Critical Temperature the camera informs about this fact within an appearing message window For a warning of overtemperature TEMPERATUREEX
28. tivated tracing is enabled for the selected items within the boxes of this dialog 3 5 3 5 Trace Output Here the output of the trace object can be controlled Therefore the following options are available File The content of the trace object will be stored in a file on the PC Debugger The content of the trace object will be directed to an external debugger Callback The content of the trace object will be displayed in a message window 3 5 3 6 Trace Mask By this checkboxes the content of the trace object is adjustable 3 5 3 7 Trace Output Options Here several information can be added to the traced events Timestamp The timestamp of the event is logged and displayed Timestamp Diff The interval from the last traced event to the current one is displayed Prefix not used New line Linebreak is added to every output line Level Here the levelfiltering see 3 5 3 8 can be enabled 3 5 3 8 Trace Level By this checkboxes the levelfiltering can be adjusted 35 EVLSEOLL ZZA UE AuUeuuas UL paud 891ou jnoyjim abueuo oj afans paajueuenb jou Jajjew paud 10 Aoeinooe yng payoauo Ains uaaq sey ejep jesiuuyopar Phone 49 0 3528 4386 0 Fax 49 0 3528 4386 86 E O O L E 5 Q g E E O S gol o E D O D oOo gt m a Q C O EA D Y B off O v lt w YW LO Bel o D st GI E HS c o O UI o D oO CO
29. use Microsoft OHCI possesses a bug to handle FireWire b at a transfer rate of 800 Mbit sec Baumer needed to develop its own OHCI driver to fix this and other bugs Therefore the Baumer OHCI driver is recommended in order to provide the best possible Baumer camera operation On Linux the 800Mbit sec bug does not exist so the standard OHCI which is integrated in the kernel can be used The Baumer 1394 driver is approved for optimal communication between software and FireWire devices Analogous to the GigE Vision plug in the 1394 plug in provides an interface specific preprocessing of the commands of Baumer GAPI 2 1 2 Baumer GAPI Modules The Baumer GAPI is partitioned into several modules Depending on your chosen pro gramming language either more or fewer of these may be used 2 1 2 1 Baumer GAPI Library As previously stated Baumer GAPI supports several programming languages to cre ate an application Therefore the Baumer GAPI Library represents a uniform API for the cross interface camera control Here global camera control functions are defined 2 1 2 2 Image Library This library includes several functions for image processing and image editing 2 1 2 3 Programming Languages As shown in Figure 1 the implementation of C C and C is realized hierarchically This means that the C API resorts directly to the Baumer GAPI library Code in C re sorts to the Baumer GAPI library via C API When accessing the
30. usted destination format the Baumer GAPI viewer will display the record ed image in a presentable format like mono or RGB Here a display of the buffer content occures one on one as raw data This may cause irritating effects to the user l i dn i i DI Vi Wee D i U 1 WM lt m i d 3 4 1 2 Menu View Image WES camera w Drawlmage w Show Image Show Header e Normal Strech Center Fit to Window FullScreen SmoothingMode K InterpolationMiode K Flip Image K lt Figure 8 L Menu View This menu provides several functions for manipulation of the shown image Menu item Draw Image Show Image Show Header Normal Strech Description Result If this item is selected This can be tested in free running mode every recorded image is set by default Let the camera run and drawn look to a moving target Deselecting this menu item will result in a freeze image Here the image display can be switched on and off This item enables the dis play of header informa tion beside the image ss uh nen 00000002 00000000 40000000 00007cad 00000008 000000c0 00000000 00000000 00000000 00000002 00000000 40000000 00007cad 00000008 000000c0 00 00000000 9a8a7aba This function requires Nor cot mal to be activated Selecting this
31. ut the respective signal source can be selected Line 0 INPUT Debouncer Low High Further you can set the update time for the O Status In 44fo Line Inverter Inverted Source 2E SE KC 43 46 i N User Output r 012 Update IO e status permanent 100 J ms Info Available Us b ID Status mask U Outputs from IO Control getLines OF 10 s 6 Curr U 3 4 3 21 IPConfiguration Gm mm By this feature the camera can be switched from LLA start be Persistent IP Configuration aviour to DHCP or Persistent IP LY Enables Procedure IPAdresse o Jo JO JO a Enable the desired mechanism of connection establishment Subnet Mask O o jo 0 On persistent IP please enter the desired parameters User s Guide Gateway jo JO 0 Jo Confirm the settings by clicking the Set button Por B Aft ioulati f f thi t th d L Page 57 er manipu a ion of any of this parameters the camera needs DHCP Configuration TO be deenergized Z Enabled Please close the Baumer GAPI Viewer before deenergizing the cam SEENEN era to prevent long latency 20 3 4 3 22 LookUpTable Hardware cL G J m em By this feature the internal Look Up Table can be loaded and Look Up Table LUMINANCE lw Enabled Set LUT Val Index o e Value o e Set enabled Further more individual values can be set Therefore the spe cific value needs to be defined and set within the area Set LUT Value at the bottom of the
32. y or slider Exposure Mode ves e mE Exposure Time Ka d eg The values are given in usec For EES the choose of a Exposure Mode you next must be enable the Trigger 3 4 3 12 Flash User s Guide Page 35 Programmer s Guide Page 26 S J FW DE User s Guide Page 44 By this feature the flash output can be controlled d kl Enabled Flash Actiyvabon STATEHIGH Y STATEHIGH Notice STATELO FlashActivation relates to the incom ing trigger signal 17 3 4 3 13 Flip Image CL G IW 4 Ela news Here you can flip the image in the camera BGAPI_FLIPTYPE_NONE Notice BGAPI FLIPTYPE NONE a AGAR FLIPTYPE 3 With the function in the menu bar BGAPI_FLIPTYPE_Y BGAPIFLIPTYPE er View Flip image you only rotate the view in the viewer 3 4 3 14 FrameCounter Gol a gea Here the possibility of predefining a value for the software coun ter as well as for the hardware counter at any time is given DW Counter Hw Counter D Value 0 means a reset of the respective counter set Software Counter 1 min D prev nent Hardware Counter CUI min max 4294967295 prey next CH CH CH cn 3 4 3 15 FramesPerSeconds ELT G J Fw am amm By this feature the frame rate of the camera can be predefined Discrete Continuous H _ H Special value 0 Freerun
Download Pdf Manuals
Related Search