Balluff MATRIX VISION mvHYPERION Series Technical Manual Download Page 85

1.14 Use Cases

81

Figure 8: Click 'Cancel' to stop recording

1.14.2.3

Recording Using The API

Please refer to the example on how to record a video stream using mvIMPACT Acquire C++ API:

Continuous

-

CaptureFFmpeg.cpp

or have a look at the

VideoStream

class.

MATRIX VISION GmbH

Summary of Contents for MATRIX VISION mvHYPERION Series

Page 1: ...mvHYPERION Series Technical Manual English Version 2 00 ...

Page 2: ......

Page 3: ...installation 11 1 7 2 Windows 11 1 7 2 1 System Requirements 11 1 7 2 2 Software installation 12 1 7 3 Linux 16 1 7 3 1 System Requirements 16 1 7 3 2 Installing the mvIMPACT Acquire driver 17 1 7 4 Connecting a camera 21 1 7 5 Settings behavior during startup 21 1 8 Technical Data 23 1 8 1 mvHYPERION CLx 23 1 8 1 1 Block diagrams 23 1 8 1 2 Connectors 24 1 8 1 3 Components 32 1 8 1 4 Device Featu...

Page 4: ...r DirectShow usage 48 1 12 3 1 Registering devices 48 1 12 3 2 Renaming devices 50 1 12 3 3 Using regsvr32 51 1 13 Glossary 52 1 14 Use Cases 53 1 14 1 Working with line scan cameras 53 1 14 1 1 Pass through of digital input signals 53 1 14 1 2 Working with pulse start events 54 1 14 1 3 Working with an rotary encoder 55 1 14 1 4 Working with a Basler Sprint line scan color camera 59 1 14 1 5 Work...

Page 5: ...r and where to find the necessary information in the manual It will also explain or link to the concepts behind the driver and the image acquisition Furthermore it shows you how to get start programming own applications 1 1 2 2 Basics 1 1 2 2 1 Driver concept The driver supplied with the MATRIX VISION product represents the port between the programmer and the hardware The driver concept of MATRIX ...

Page 6: ...espace mvIMPACT_NET acquire of mvIMPACT_NET dll which is why the latter one should only be used for backward compatibility but NOT when developing a new application 6 Part of Micro Manager 1 1 2 2 2 NeuroCheck support A couple of devices are supported by NeuroCheck However between Neuro Check 5 x and NeuroCheck 6 x there has been a breaking change in the internal interfaces Therefore also the list...

Page 7: ...from Cognex The installation order does not matter After the driver package and VisionPro has been installed the next time VisionPro is started it will allow selecting the mvIMPACT Acquire device No additional steps are needed MATRIX VISION devices that also comply with the GigE Vision or USB3 Vision standard don t need any software at all but can also use VisionPro s built in GigE Vision or USB3 ...

Page 8: ... of the acquisition concept please have a look at How the capture process works in the mvIMPACT_Acquire_API manual matching the programming language you are working with 1 1 2 4 Installation To install the frame grabber properly you have to follow these steps Please follow the links for detailed descriptions Windows Please check the system requirements p 11 Please install the software and driver p...

Page 9: ...text images and graphical content are protected by copyright and other laws which protect intellectual property It is not permitted to copy or modify them for trade use or transfer They may not be used on websites Windows XP Windows Vista Windows 7 8 10 are trademarks of Microsoft Corp Linux is a trademark of Linus Torvalds Jetson is a registered trademark of NVIDIA Corporation NVIDIA and Jetson a...

Page 10: ...are and attention has been taken in preparing this manual In view of our policy of continuous product improvement however we can accept no liability for completeness and correctness of the information contained in this manual We make every effort to provide you with a flawless product In the context of the applicable statutory regulations we shall accept no liability for direct damage indirect dam...

Page 11: ...touch components on the printed circuit board with your hands or with conductive devices 1 5 1 European Union Declaration of Conformity statement The mvHYPERION CLx is in conformity with all applicable essential requirements necessary for CE marking It corresponds to the EU EMC guideline 2004 108 EC based on the following harmonized standards Electromagnetic compatibility EMC Interference emmision...

Page 12: ...8 MATRIX VISION GmbH ...

Page 13: ...ON frame grabber series for PCI Express offers image processing with fast cameras using maximum capture bandwidth up to 1 G B s Depending on the model type the frame grabbers are suitable for high end machine vision applications with CameraLink cameras as well as broadcasting or surveillance solutions MATRIX VISION GmbH ...

Page 14: ...sh The mvHYPERION series is suitable for following application areas Figure 2 Application areas 1 6 1 What s inside and accessories Due to the varying fields of application the mvHYPERION series is shipped without accessories The package contents mvHYPERION frame grabber Accessories for the mvHYPERION CLx frame grabbers MATRIX VISION GmbH ...

Page 15: ... does not fit easily pull it back out and try again Fasten the board s bracket at the back of the computer using the screws you saved from the shield Put the cover back on the computer and reconnect the peripheral devices Start the computer Warning According to the construction if you want to connect or disconnect a PoCL p 52 camera please be sure that the PC or the mvHYPERION frame grabber is swi...

Page 16: ...tion Support Download Hardware After the Hardware installation p 11 the boot sequence shows Found New Hardware and starts the Windows Hardware Wizard Closed this windows and insert the mvIMPACT CD ROM or DVD ROM into your drive and select Driver installation and the needed mvIMPACT Acquire driver e g mvTITAN mvGAMMA Figure 1 Start window After the click on the needed driver the installation proces...

Page 17: ...2 mvHYPERION installer Start window Select the folder where you want to install the software Figure 3 mvHYPERION installer Select folder Select the features which you want to install Following features exist MATRIX VISION GmbH ...

Page 18: ...mming Additionally you can choose the examples which installs the sources of wxPropView mvIPConfigure and various small examples The project files shipped with the examples have been generated with Visual Studio 2013 However projects and make files for other compilers can be generated using CMake fairly easy See CMake section in the C manual for additional details Documentation This will install t...

Page 19: ...iles to Windows Then Windows shows a message to signal that this driver is not checked through Microsoft This is only an attempt to make insecure and it is recommended to ignore it Press Continue Anyway and finish the driver installation Figure 6 mvHYPERION installer Windows logo testing MATRIX VISION GmbH ...

Page 20: ... complete After this you have to restart the system Afterwards you can acquire images with the frame grabber Simply start the application wxPropView p 42 wxPropView exe See also wxPropView p 42 1 7 3 Linux 1 7 3 1 System Requirements Kernel requirements Kernel 2 6 x Software requirements MATRIX VISION GmbH ...

Page 21: ...he SuSE version of wxWidgets has been compiled with ODBC support and the RPM does not contain a dependency to automatically install ODBC For this reason you must also install the unixODBC devel RPM OpenSuSE 10 1 uses the udev system so a separate hotplug installation is not needed Hardware requirements PC with PCI Express Single lane Note The driver contains libraries for Linux x86 32 bit or Linux...

Page 22: ...arguments both of which are optional 1 target directory name 2 version The target directory name specifies where to place the driver If the directory does not yet exist it will be created The path can be either absolute or relative i e the name may but need not start with Note This directory is only used for the files that are run time required The files required at compile time are always install...

Page 23: ... work with SuSE 10 x as well as with Ubuntu 6 06 or newer with up to date Gentoo or Fedora FC5 b After installing the access libraries you will see something like the following directory structure in your directory dates and file sizes will differ from the list below drwxr xr x 10 root root 4096 Jan 5 15 08 drwxr xr x 23 root root 4096 Jan 4 16 33 drwxr xr x 3 root root 4096 Jan 5 15 08 DriverBase...

Page 24: ...nfigure itself so that the mvHYPERION kernel module can be built You should see the following message at the end of the compile block To install the mvHYPERION kernel module now make sure that you are root and type make install If you are not already logged in as the root user you must now use su to change users and type make install On an Ubuntu system you might try sudo make install The kernel m...

Page 25: ...or J3 to power the camera Make sure that you do not mix up the channels For this please have a look at chapter Technical Data p 23 where to find the specific connectors Afterwards start wxPropView p 42 and choose the Generic camera definition Now press the Live button at this point you should see something from the camera Then create a new camera definition Finally export the new camera definition...

Page 26: ...ndows the driver will not look for a matching XML file during start up automatically as the native storage location for settings is the Windows Registry This must be loaded explicitly by the user by using the appropriate API function offered by the SDK However under Linux XML files are the only setting formats understood by the driver framework thus here the driver will also look for them at start...

Page 27: ...thout the need to have special inside information One version of the tool will always be delivered in source so it can be used as a reference to find out how to get the desired information from the device driver 1 8 Technical Data 1 8 1 mvHYPERION CLx 1 8 1 1 Block diagrams The following block diagrams show schematically how the different mvHYPERION CLx are designed Figure 1 mvHYPERION CLb block d...

Page 28: ... cameras provide software to parameterize the camera If this software abides by the specification it will access our serial interface driver automatically Note For Linux there is no CameraLink specified library Therefore we ship CameraLink compliant library libclserMV so which can be found in the lib directory Figure 3 mvHYPERION CLe Figure 4 mvHYPERION CLf 1 8 1 2 1 Status LEDs Figure 5 Rev 1 x L...

Page 29: ...strobe power connector Camera 1 trigger sync strobe power connector Camera 1 trigger sync strobe power connector J4 Camera 2 trigger sync strobe power connector Camera 2 trigger sync strobe power connector Additional con nector with trigger sync strobe power 1 8 1 2 2 Use of J1 J4 1 8 1 2 3 Pinning J1 J2 CL configuration Figure 7 Mini CameraLink connector female Pin J1 J2 used as BASE used as MEDI...

Page 30: ... Output 9 Not used 100 Ohm ter minated Z2 Input 9 4 CC2 Output 9 Not used 100 Ohm ter minated Z2 Input 9 16 CC3 Output 10 Not used 100 Ohm ter minated Zclk Input 10 3 CC3 Output 10 Not used 100 Ohm ter minated Zclk Input 10 15 CC4 Output 11 Not used 100 Ohm ter minated Z3 Input 11 2 CC4 Output 11 Not used 100 Ohm ter minated Z3 Input 11 13 Internal shield Ground Internal shield Ground Internal shi...

Page 31: ...for 8 pin Binder series 711 711 Binder ordering no 99 0479 100 08 99 0479 102 08 Detailed information http www binder connector de 1 8 1 2 6 Pinning J5 Power supply floppy You can connect a free power supply cable for floppy drives on connector J5 to increase the available current on the power supply pins on J3 and J4 to 2A Pin Signal 1 12 V 2 Ground 3 Ground 4 Not connected 1 8 1 2 7 Pinning J6 i...

Page 32: ...oard Attention Without an additional card with corresponding snubbers these signals must not conducted mvHYPERION CLb CLe CLm CLf Switch S1 Flash memory Position Comment Def Case of need FPGA version is loaded write protected User FPGA version which can be updated is loaded Switch S2 Switch between TTL 5V and PLC 24V as well as Trigger and Sync on connector J3 Position Comment Trigger 1 Sync 2 on ...

Page 33: ...1 8 Technical Data 29 Figure 10 Trigger In mvHYPERION CLx MATRIX VISION GmbH ...

Page 34: ...age which causes an inactive signal VIL min 30V VIL min minimum input voltage which causes an active signal Ii max 20mA li max maximum input current PLC compatible threshold additionally external protective circuit of Z diodes necessary VIH max 37V VIH max maximum input voltage which causes an active signal VIH min 15V VIH min minimum input voltage which causes an active signal VIL max 13V VIL max...

Page 35: ...n of C pin 2 tr max 5us rise on time tf max 2ms fall off time HW rev 1 xx tf max 20us fall off time HW rev 2 00 The output is not protected against overvoltage overload and polarity reversal 1 8 1 2 10 Digital I Os J6 VIH max min 3 9V 2 0V VIH max permissible input voltage which causes an active signal VIL max min 0 8V 0 3V VIL max permissible input voltage which causes an inactive signal Iin max ...

Page 36: ...Bus PCI Express x1 PCI Express x4 Continuous data rate Max 200 MB s Max 620 MB s Peak data rate Max 250 MB s Max 1 GB s Payload size Up to 512 Bytes Up to 256 Bytes Digital in and out puts Trigger In 1 differential opto isolated 5 to 24V 2 differential opto isolated 5 to 24V Strobe Out 1 differential opto isolated max 30V 100mA 2 differential opto isolated max 30V 100mA Sync In 1 differential opto...

Page 37: ...ons Length 147 mm 155 mm Width 95 mm 111 5 mm 1 8 1 4 Device Feature And Property Lists 1 8 1 4 1 mvHYPERION CLm 1 8 2 mvHYPERION 32R16 1 8 2 1 Block diagram The following block diagram shows schematically how the mvHYPERION 32R16 is designed Figure 13 mvHYPERION 32R16 block diagram MATRIX VISION GmbH ...

Page 38: ...ction state Green No problem with connection 2 FPGA state Green FPGA is loaded 1 8 2 2 1 Status LEDs 1 8 2 2 2 Pinning J1 68 pol connector Figure 15 J1 Pin Signal Note Pin Signal Note 1 Power 5V 35 GND G 2 VIDEO_15 36 GND G 3 VIDEO30 Not used 37 GND G 4 VIDEO_14 38 GND G MATRIX VISION GmbH ...

Page 39: ... Not used 55 GND G 22 VIDEO_5 56 GND G 23 VIDEO20 Not used 57 GND G 24 VIDEO_4 58 GND G 25 VIDEO19 Not used 59 GND G 26 VIDEO_3 60 GND G 27 VIDEO18 Not used 61 GND G 28 VIDEO_2 62 GND G 29 VIDEO17 Not used 63 GND G 30 VIDEO_1 64 GND G 31 VIDEO16 Not used 65 GND G 32 VIDEO_0 66 GND G 33 RS 485 TXP 67 RS 485 TXN 34 RS 485 RXP 68 RS 485 RXN Manufacturer of the connector Nexus Part No 32040168R 1 8 2 ...

Page 40: ...MB s Peak data rate Max 1 GB s Payload size Up to 256 Bytes Current consumption PCIe 3 3V 5W PCIe 12V 4W Environmental conditions Ambient temperature 0 up to 45 C Storage temperature 20 up to 70 C Humidity 10 up to 90 non condensing Dimensions Length 170 mm Width 111 1 mm 1 8 3 mvHYPERION HD SDI 1 8 3 1 Block diagram The following block diagram shows schematically how the mvHYPERION HD SDI is desi...

Page 41: ...I 2 block diagram 1 8 3 2 Connectors Figure 17 mvHYPERION HD SDI 2 Connector usage mvHYPERION HD SDI 2 J1 Camera 1 3G HD SDI signal J2 Camera 2 3G HD SDI signal 1 8 3 2 1 Use of J1 J2 1 8 3 2 2 Pinning J5 15 pol D SUB HD connector MATRIX VISION GmbH ...

Page 42: ... 485 TRX IN OUT RS485 13 C HSync Out OUT TTL push pull 14 VSync Out OUT TTL push pull 15 RS 485 TRX IN OUT RS485 1 8 3 2 3 Pinning J6 internal digital I Os Figure 19 J6 Pin Signal Signal direction Level 1 NC 2 Ground GND 3 SCL IN OUT LVTTL 4 Ground GND 5 SDA IN OUT LVTTL 6 Ground GND 7 5V power supply OUT 5V DC 8 3 3V power supply OUT 3 3V DC 12 9 GPIN3 0 IN LVTTL 3 3V input not 5V tolerant 16 13 ...

Page 43: ...ltage Digital signals pins 9 16 are LVTTL signals and not 5V tolerant Failure to take this into account may result in the destruction of the board Attention Without an additional card with corresponding snubbers these signals must not conducted 1 8 3 3 Components mvHYPERION HD SDI 2 supported signal formats MATRIX VISION GmbH ...

Page 44: ... 274 S M PTE ST 292 1 Y U V4 2 2 2x10 Bit 1 1080p 50 59 94 60 S M PTE ST 425 Level A S M PTE ST 424 1 Y U V4 2 2 2x10 Bit Only chan nel 0 sup ported Firmware ver sion 86 re quired 2 720p 23 98 24 25 29 97 30 50 59 94 60 S M PTE ST 296 S M PTE ST 292 1 Y U V4 2 2 2x10 Bit 2 1080i psf 50 59 94 60 S M PTE ST 274 S M PTE ST 292 1 Y U V4 2 2 2x10 Bit The host sys tem puts the two fields to gether to on...

Page 45: ... M PTE ST 425 Level A S M PTE ST 424 1 Raw 12 Bit Firmware ver sion 86 re quired 1 1080p 50 59 94 60 S M PTE ST 425 Level A S M PTE ST 424 1 Raw 2k Only chan nel 0 sup ported Firmware ver sion 86 re quired 1 1080p 50 100 59 94 119 88 60 120 S M PTE ST 425 Level A S M PTE ST 424 1 Raw 2in1 2 frames in one dou ble im age height Only chan nel 0 sup ported Firmware ver sion 86 re quired 2 720p 23 98 2...

Page 46: ...ensing Dimensions Length 155 mm Width 111 1 mm 1 9 GUI tools 1 9 1 Introduction MATRIX VISION provides several convenient tools with graphical user interface to set up and work with their devices Please find a short list and description below 1 9 2 wxPropView With wxPropView it is possible to acquire images to configure the device and to display and modify the device properties 1 9 3 mvDeviceConfi...

Page 47: ...ork issues 1 9 5 mvGigEConfigure With mvGigEConfigure it is possible to install remove or configure the MATRIX VISION GigE Vision capture filter driver See also For further information about the tools please follow the link to the separate manual describing the GUI tools in great detail on our website https www matrix vision com manuals MATRIX VISION GmbH ...

Page 48: ...aitClocks Time in us Wait a defined time Jump HRTC program address Jump to any step of the program TriggerSet Frame ID Set internal trigger signal to sensor controller TriggerReset Reset internal trigger signal to sensor controller ExposeSet Set internal expose signal to sensor controller ExposeReset Reset internal expose signal to sensor controller FrameNrReset Reset internal sensor frame counter...

Page 49: ...ameraSettingsFrameGrabber triggerSource writeS HRTCtrl_0 CameraSettingsFrameGrabber triggerActivation writeS dtmOnFallingEdge When working with wxPropView p 42 this are the properties to modify in order to activate the evaluation of the HRTC program Figure 1 wxPropView Setting up the HRTC usage Following trigger modes can be used with HRTC OnLowLevel OnHighLevel OnFallingEdge OnRisingEdge OnHighEx...

Page 50: ... found on the MATRIX VISION website mvIMPACT Acquire C API mvIMPACT Acquire C API mvIMPACT Acquire Java API mvIMPACT Acquire NET API mvIMPACT Acquire Python API Compiled versions CHM format might already be installed on your system These manuals contain chapters on how to link and build applications using mvIMPACT Acquire how the log output for mvIMPACT Acquire devices is configured and how it wor...

Page 51: ...trol 1 12 1 2 IAMDroppedFrames 1 12 1 3 IAMStreamConfig 1 12 1 4 IAMVideoProcAmp 1 12 1 5 IKsPropertySet The DirectShow_acquire supports the IKsPropertySet Interface For further information please refer to the Microsoft DirectX 9 0 Programmer s Reference Supported property set GUID s AMPROPERTY_PIN_CATEGORY DIRECT_SHOW_ACQUIRE_PROPERTYSET 1 12 1 6 ISpecifyPropertyPages 1 12 2 Logging The DirectSho...

Page 52: ...version of the VLC Media Player Virtual Dub etc you have to register devices with the 32 bit version of mvDeviceConfigure C Program Files MATRIX VISION mvIMPACT Acquire bin the 64 bit version resides in C Program Files MATRIX VISION mvIMPACT Acquire bin x64 1 12 3 1 Registering devices To register all devices currently recognized by the mvIMPACT Acquire driver stack for access with DirectShow the ...

Page 53: ...eConfigure Register All Devices 3 After a successful registration the column Registered For DirectShow will display yes for every device and the devices will be registered with a default DirectShow friendly name which is displayed in the DirectShow Friendly Name column mvDeviceConfigure All Devices Registered For DirectShow Access MATRIX VISION GmbH ...

Page 54: ... needs to be started with elevated rights 2 right click on the device to rename and select Set DirectShow Friendly Name mvDeviceConfigure Set DirectShow Friendly Name 3 Then a dialog will appear Please enter the new name and confirm it with OK mvDeviceConfigure Dialog For New Name MATRIX VISION GmbH ...

Page 55: ...ntly recognized by the mvIMPACT Acquire driver stack with auto assigned names the Windows tool regsvr32 can be used from an elevated command shell The following command line options are available and can be passed during the silent registration EXAMPLES Register ALL devices that are recognized by mvIMPACT Acquire this will only register devices which have drivers installed without any user interac...

Page 56: ...deo images Horizontal sync The portion of the analog signal which specifies the line end of the video signal Host Here the PC Interlaced Interlacing method conforming to the television standard this method involves acquiring two fields in succession all odd lines all even lines and combining them to create a frame The result is greatly reduced flicker during on screen display Interrupt Interrupt s...

Page 57: ...ith line scan cameras There are several use cases concerning line scan camera Camera synchronization issues Pass through of digital input signals p 53 Working with pulse start events p 54 Working with an rotary encoder p 55 Working with a Basler Sprint line scan color camera p 59 Trigger issues Working with trigger events p 66 Synchronous acquisition with different camera settings p 72 1 14 1 1 Pa...

Page 58: ...rates signals at the digital outputs which can be defined by the user Currently you can use the HRTC in three ways Periodical repeat of the pulse sequence parameters frequency of the pulse sequence Hz Single run through parameters digital input or on board signal which starts the pulse sequence initially DigitalSignal falling or rising edge of the digital input TriggerMoment The following sample s...

Page 59: ...rotary encoder p 55 1 14 1 3 Working with an rotary encoder In many applications including industrial controls robotics etc an rotary encoder or incremental encoder is used which is an electro mechanical device that converts the angular position of a shaft or axle to an analog or digital code making it an angle transducer During the rotation of the axis an rotary encoder generates a so called Gray...

Page 60: ...ray code signal at the output of the two data lines As described in Working with pulse start events p 54 the mvHYPERION features two HRTC s PulseStart Configuration0 and PulseStartConfiguration1 which also features a Rotary Decoder p 55 MATRIX VISION GmbH ...

Page 61: ...A p 57 DigitalSignalB p 57 PulseMultiplication p 57 Direction p 58 Mode p 58 int Reset p 59 1 14 1 3 1 DigitalSignalA The first data line of the rotary encoder 1 14 1 3 2 DigitalSignalB The second data line of the rotary encoder 1 14 1 3 3 PulseMultiplication It is possible to multiply the pulse sequence The difference is shown in the following figure MATRIX VISION GmbH ...

Page 62: ...on is not relevant InhibitBackward The direction of rotation is relevant This means if the direction is changed the edges will be ignored InhibitBackwardUntilLastPos The direction of rotation is relevant and the edge changes are counted This means if the direction is changed the edges will be counted counter initial value is 0 If the direction changes again the counter will be decremented until 0 ...

Page 63: ...et the counter which is saved in InhibitBackwardUntil LastPos p 58 1 14 1 4 Working with a Basler Sprint line scan color camera 1 14 1 4 1 Introduction Basler s Sprint line scan color camera uses a two line sensor with a Bayer Mosaic filter mask To use the demosaic algorithm correctly you have to set the BayerParity There are 4 possibilities for the BayerParity Red green Green red Blue green Green...

Page 64: ... to keep in mind that an image acquisition will start after a start trigger signal e g a light barrier and a valid FrameValid signal The mvHYPERION frame grabbers are suitable for these applications Figure 1 Triggered acquisition with area scan cameras Note As you can see in Figure 1 there are trigger delays possible up to an almost complete frame The trigger start condition TriggerActivation can ...

Page 65: ...wing sections show how you have to set the mvHYPERION according to the different modes 1 14 1 4 2 RawLineAcquisition Mode In this mode the camera sends the color lines alternately For more details about this mode please have a look at the camera s manual MATRIX VISION GmbH ...

Page 66: ...th line scanStartCondition the mvHYPERION runs in a mode which waits for a FrameValid signal when the image starts All further FrameSync signals are ignored This mode is required with Basler s sprint cameras The camera line synchronization in this sample is a FallingEdge at Sync In Afterwards using PulseStart Configuration0 a FallingEdge SinglePulse signal is generated at digital out CC1 MATRIX VI...

Page 67: ...e called Enhanced Raw Line Acquisition Mode It provides a raw green pixel value for each point of an imaged object and in addition either a raw red or a raw blue pixel value for more details please have a look at the camera s manual In sum you can say that this is a double exposure of the same line For this you will need a pulse multiplication MATRIX VISION GmbH ...

Page 68: ...View Settings Height H Format BayerPacked BayerParity ScanMode line scanStartCondition It only makes sense to reproduce this application using a rotary encoder p 55 The application could look like this MATRIX VISION GmbH ...

Page 69: ...65 Figure 6 Conveyor belt with rotary decoder The camera line synchronization in this sample is the trigger signal of a rotary encoder Afterwards two SinglePulse signals are sent via digital out CC1 MATRIX VISION GmbH ...

Page 70: ...ery second third etc from the rotary encoder is used 1 14 1 5 Working with trigger events One or many trigger s can be used to control start of an acquisition of a frame of an acquisition or each line of a frame for line scan devices It can also be used to control the exposure duration at the beginning of a frame MATRIX VISION GmbH ...

Page 71: ...e modes will be described on the basis of a trigger event on J3 Please open Setting Base Camera TriggerControls where you can manage the mentioned trigger events 1 14 1 5 1 FrameStart In this mode a frame is captured after a trigger event which can be specified by the user in TriggerActivation Figure 2 shows a falling edge The TriggerMode has to be On and the correct TriggerSource has to be specif...

Page 72: ... define a trigger delay via TriggerDelayAbs_us or TriggerDelayLines which only makes sense using line scan cameras Figure 3 wxPropView Possible trigger sources Figure 4 wxPropView Possible trigger activations MATRIX VISION GmbH ...

Page 73: ...ode you have two signal definitions With the appearance of the stop event the image acquisition will be stopped line synchronously and the amount of acquired lines will be available as result or image information Figure 7 shows an example definition where the FrameStart is on a rising edge of J3 and FrameStop is on a falling edge of J4 Figure 6 FrameStart and FrameStop MATRIX VISION GmbH ...

Page 74: ...If a trigger event happens during an acquisition the acquisition will be stopped line synchronously even if all requested lines of the previous image have not been acquired completely The amount of lines will be available as result or image information You have to select the same parameters using the same event in FrameStart and FrameStop to activate this mode Figure 8 Trigger restart MATRIX VISIO...

Page 75: ...t you can shift for example the FrameStart 1 14 1 5 3 AcquisitionStart Some cameras like line scan cameras send FrameValid or LineValid as a signal for FrameStart Anyway it is necessary to have the possibility to set the start of the acquisition This can be done using AcquisitionStart Figure 10 wxPropView AcquisitionStart MATRIX VISION GmbH ...

Page 76: ...Acquire SDK GUI Applications manual It is also possible to control the synchronous acquisition with the frame grabber s HRTC p 45 For this you have 1 to set the TriggerSource Setting of both capture settings to e g HRTCtrl_0 and select the Trigger Activation e g FallingEdge This means that the FrameStart will start after a falling edge from the HRTC Figure 1 wxPropView TriggerSource 2 Then you hav...

Page 77: ...troller Figure 3 wxPropView Digital I O HardwareRealTimeController HRTC program The HRTC program consist of 5 steps a Wait for an Off signal at the digital input in this sample at position 9 which is DigIn0 Figure 4 b Wait for an On signal at the digital input in this sample at position 9 which is DigIn0 Figure 4 MATRIX VISION GmbH ...

Page 78: ... Digital I O HardwareRealTimeController c Then a pulse signal is set to On at the TriggerController in this sample at position 9 which is shown in the help window d Afterwards the pulse signal is Off again MATRIX VISION GmbH ...

Page 79: ...iew Digital I O HardwareRealTimeController e Finally the program jumps back to step 0 4 Now if you have a rotary encoder and you have connected the signal A to the Sync In you can bypass this signal for example to CC1 MATRIX VISION GmbH ...

Page 80: ...TCtrl_0 the TriggerMode to On and the TriggerActivation set to FallingEdge as shown in Figure 2 for the Base setting both cameras will capture an image at the same time 1 14 2 Using Video Stream Recording With the FFmpeg libraries it is possible to record an mvIMPACT Acquire image stream into a compressed video stream Since 2 39 0 MATRIX VISION GmbH ...

Page 81: ...tps ffmpeg org download html and download the dynamic libraries of FFmpeg ver sion 4 x according to your operating system e g ffmpeg 20200809 6e951d0 win64 shared zip 2 Extract the zip file under MVIMPACT_ACQUIRE_DIR Toolkits 3 Rename the file to ffmpeg 4 2 2 win64 shared 64 bit ffmpeg 4 2 2 win32 shared 32 bit OR set an environ ment variable e g MVIMPACT_ACQUIRE_FFMPEG_DIR which points to the fol...

Page 82: ...78 Figure 1 Set up pixel format in ImageDestination 2 Start Setup Video Stream Recording MATRIX VISION GmbH ...

Page 83: ...Set up video stream recording 3 Click Yes to create a video file for the compressed stream choose the desired codec and the compression quality Figure 3 Setup Video Stream Recording Figure 4 Name the video file MATRIX VISION GmbH ...

Page 84: ...video codec Figure 6 Choose the video compression quality 4 Click Acquire to start streaming Figure 7 Click Acquire to start streaming 5 Open Setup Video Stream Recording and click Cancel to stop recording MATRIX VISION GmbH ...

Page 85: ...Cancel to stop recording 1 14 2 3 Recording Using The API Please refer to the example on how to record a video stream using mvIMPACT Acquire C API Continuous CaptureFFmpeg cpp or have a look at the VideoStream class MATRIX VISION GmbH ...

Page 86: ...en when the gain is applied Figure 1 shows the working principle of the GainOffsetKnee filter Figure 1 The GainOffsetKnee filter working principle The GainOffsetKnee filter is one of the image processing methods performed on the host It allows you to adjust The overall offset i e overall black level of an image The individual gain per color channel The individual offset i e individual black level ...

Page 87: ...ew 2 Once the GainOffsetKnee filter is activated the configuration field will be displayed see Figure 3 As an example the current RGB image is shown in Figure 4 and its histogram in Figure 5 Figure 3 The configuration field for the GainOffsetKnee filter MATRIX VISION GmbH ...

Page 88: ...he image whereas a negative offset reduces it To visualize the effect an offset of 5 is given as an example which means that the overall black level of the image will be increased by 5 of the max pixel value i e 255 in this example As a result the overall black level in the current histogram see Figure 8 has been increase by 12 75 which is 5 x 255 comparing to the original histogram see Figure 5 M...

Page 89: ...1 14 Use Cases 85 Figure 6 Assign overall master offset to the image Figure 7 The image with 5 overall offset MATRIX VISION GmbH ...

Page 90: ...l green channel and blue channel respectively For Bayer images channel 0 3 are used For more description please refer to Figure 3 As an example a gain of 1 0625dB is applied to the red channel As shown in Figure 10 and Figure 11 the grey level of the red channel is increased while the other two channels remain the same Figure 9 Assign individual gain to the red channel MATRIX VISION GmbH ...

Page 91: ...d using the channel specific Offset_pc Analogous to GainOffset KneeMasterOffset_pc a positive offset increases the black level of the channel whereas a negative offset reduces it To visualize the effect an offset of 5 is given as an example in the red channel The histogram see Figure 14 shows therefore a 12 75 which is 5 x 255 offset increase in the red channel MATRIX VISION GmbH ...

Page 92: ...88 Figure 12 Assign individual offset to the red channel Figure 13 The image with 5 offset in the red channel MATRIX VISION GmbH ...

Page 93: ...ramming language you are working with the names of classes namespaces and proper ties might vary slightly For C please refer to the GainOffsetKneeChannelParameters class and the Image Processing class for some guidance for other languages when searching for the offset or knee properties similar things can be found MATRIX VISION GmbH ...

Page 94: ...90 MATRIX VISION GmbH ...

Reviews: