Here is a short summary about all books of the mvBlueCOUGAR manual: • The manual starts with technical data of the mvBlueCOUGAR like sensors as well as a quick start chapter. Furthermore, it describes the advanced features (p. 90) of the mvBlueCOUGAR-X. Afterwards, you will find the different books: •...
1.2.2 Basics 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 VISION provides a standardized programming interface to all image processing products (excluding mvBlueLYNX) made by MATRIX VISION GmbH.
Page 19
For NeuroCheck 6.1 the following devices are supported: Device Additional software needed mvTITAN-G1 mvIMPACT Acquire driver for mvTITAN/mvGAMMA de- vices mvTITAN-CL mvIMPACT Acquire driver for mvTITAN/mvGAMMA de- vices mvGAMMA-CL mvIMPACT Acquire driver for mvTITAN/mvGAMMA de- vices mvHYPERION-CLb mvIMPACT Acquire driver for mvHYPERION devices MATRIX VISION GmbH...
Page 20
Acquire device. No additional steps are needed. MATRIX VISION devices that also comply with the GigE Vision standard don't need any software at all, but can also use VisionPro's built-in GigE Vision support.
Page 21
USB3 Vision (p. 232) compliant device. • Developers either can use the generic GenICam (p. 220) properties or the "mvIMPACT Acquire" properties when working with a MATRIX VISION device (devices from other vendors can be operated with the "GenI Cam" interface only).
"mvIMPACT Acquire" interface references. Additionally, please have a look at the example programs. Several basic examples are available. The separate mvIMPACT Acquire manuals • "mvIMPACT_Acquire_API_CPP_manual.chm", • "mvIMPACT_Acquire_API_C_manual.chm", and • "mvIMPACT_Acquire_API_NET_manual.chm" are available as downloads from our website http://www.matrix-vision.com MATRIX VISION GmbH...
MATRIX VISION website. MATRIX VISION cannot guarantee that the data is free of errors or is accurate and complete and, therefore, as- sumes no liability for loss or damage of any kind incurred directly or indirectly through the use of the information of this document.
3 Legal notice 3.1 Introduction The firmware running on mvBlueCOUGAR-X, mvBlueCOUGAR-XD and mvBlueFOX3 devices make use of a couple of third party software packages that come with various licenses. This section is meant to list all these packages and to give credit to those whose code helped in the creation of this software.
Page 25
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. MATRIX VISION GmbH...
01. December 2016 V4.23 Added use case Using the Smart Firmware: 2.15.544.0 FrameRecall feature (p. 255). 26. October 2016 V4.22 Updated sensor characteristics. 23. August 2017 V4.21 Added mv Defective Pixel Correc- Firmware: 2.12.406.0 tion Control (p. 184). MATRIX VISION GmbH...
Page 27
Updated chapter Introducing multi- casting (p. 373). 11. February 2016 V4.14 Changed storage and turn-off time of Characteristics of the digital in- puts (p. 77) (mvBlueCOUGAR-X- POE-I). 22. January 2016 V4.13 Added sensor mvBlueCOUGAR- Xx04i (3.2 Mpix [2064 x 1544]) (p.
Page 28
[2752 x 2208]) (p. 495). 26. February 2015 V3.43 Added note in I cannot use mv BlueCOUGAR-XD (p. 201) and I cannot initialize 4 Tap sensor mvBlueCOUGAR-XDs (p. 202) . Moved Optimizing the bandwidth (p. 299) to Use Cases. MATRIX VISION GmbH...
Page 29
V3.26 Updated data of mvBlueCOUGA R-XD specific CCD sensors (p. 95) and added -XD126a (p. 495), -X D129a (p. 515), and "-XD1212". 25. March 2014 V3.25 Added use case Correcting image errors of a sensor (p. 268). MATRIX VISION GmbH...
Page 30
Updated trigger modes of the sen- sors. Updated figure 1 in Standard model (-xx1x) (p. 64). Added declaration of conformity (p. 28) of mvBlueCOUGAR-X-POE-I. 10 Feb. 2014 V3.18 Updated length of mvBlueCOUGAR- XD Standard model (-xx1x) (p. 79). 30 Jan. 2014 V3.17...
Page 31
Added declaration of conformity 22. October 2013 V3.02 (p. 28) of mvBlueCOUGAR-XD. 17. October 2013 V3.01 mvBlueCOUGAR-X without hous- ing (p. 65) is an order option (-xx9x). 15. October 2013 V3.00 Added Webcasts (p. 24) links. Added chapter Bit-shifting an im- age (p.
Page 32
Added information about image er- ror counts and disabling CPU sleep states: Setting up the camera (p. 57), How to disable CPU sleep states a.k.a. C states ( Windows 8) (p. 156), and There are image er- ror counts (p. 200). MATRIX VISION GmbH...
Page 33
Added use case Adjusting sensor -x02d (-1012d) (p. 342). 18. July 2012 V1.16 Added use case Creating a de- bouncing filter at the inputs (p. 331). 12. July 2012 V1.15 Added use case Creating user set entries (p. 357). MATRIX VISION GmbH...
Page 34
Added new sensor mvBlueCO UGAR-X[D]x04 (2.2 Mpix [2048 x 1088]) (p. 597) Changed length of mvBlueCOU GAR-XD (p. 79) Added description about the line scan mode of sensor mvBlueC OUGAR-Xx02e (1.3 Mpix [1280 x 1024]) (p. 578). MATRIX VISION GmbH...
Page 35
Updated data of sensors mvBlue COUGAR-Xx05 (5 Mpix [2592 x 1944]) (p. 608) 17. February 2012 V1.0b31 Renewed chapter wxPropView (p. 109) 09. January 2012 V1.0b30 Added mvBlueCOUGAR-XD chapter Technical data (p. 64) and Introduction (p. 35) MATRIX VISION GmbH...
Page 36
Added chapter "Porting applica- 18. January 2011 V1.0b17 tions written with the Generic in- terface layout to use the GenICam interface layout" Setting up multiple display sup- port and/or work with several cap- ture settings in parallel (p. 125) MATRIX VISION GmbH...
Page 37
(p. 64) and updated the Digital Input figure 28. May 2010 V1.0b3 Added example Single CaptureMasterSlave 27. Apr. 2010 V1.0b2 Added chapter Saving user set- tings in the non-volatile flash memory (p. 140), which shows how to work with user sets MATRIX VISION GmbH...
Page 38
19. Apr. 2010 V1.0b Added new example Continuous CaptureDirectX 15. Apr. 2010 V1.0b Updated mvBlueCOUGAR-X techni- cal documentation 24. Mar. 2010 Updated Sensor overview (p. 93) (Frame rate calculator of -x20a, - x20b, -x22, -x23, -x00w) 15. Mar. 2010 Updated What's inside and acces- sories (p.
In the context of the applicable statutory regulations, we shall accept no liability for direct damage, indirect damage or third-party damage resulting from the acquisition or operation of a MATRIX VISION product. Our liability for intent and gross negligence is unaffected. In any case, the extend of our liability shall be limited to the purchase price.
• We cannot and do not take any responsibility for the damage caused to you or to any other equipment connected to the mvBlueCOUGAR-X . Similarly, warranty will be void, if a damage is caused by not following the manual.
• Clean case with dry soft cloth. Use neutral detergent liquid if needed; wipe the cover with dry cloth. • Do not use benzene, thinner, alcohol, liquid cleaner or spray-type cleaner. • If dust or other debris is located between the CCD and optical filter, consult dealer for cleaning by an optical technician. MATRIX VISION GmbH...
• Rotate the C-mount ring and lens forward or backwards on its thread until the object is in sharp focus. Note Be careful that the lens remains seated in the C-mount. • Once focus is achieved, tighten the lock nut ring, then tighten the two locking screws of the lock ring without applying excessive torque. MATRIX VISION GmbH...
And since each installation is different, MATRIX VISION cannot supply a strictly required procedure for proper heat dissipation. Instead, we provide the following general guidelines: In all cases, 1.
Page 44
CE marking. It corresponds to the EU EMC guideline 2014/30/EU based on the following harmonized standards Electromagnetic compatibility (EMC) • Interference emmision EN 61000-6-3 / 2007 • Interference emmision EN 61000-6-4 / 2007 for mvBlueCOUGAR-X PoE (p. 229) version • Interference immunity EN 61000-6-2 / 2005 EN 61000-6-3 / 2007 requires an I/O cable with an retrofittable ferrite to be...
CONTENTS Class B Class A (mvBlueCOUGAR-X PoE (p. 229) and POE-I version) This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a residential environment.
The mvBlueCOUGAR-X is also available without housing. 7.1 Order code nomenclature 7.1.1 mvBlueCOUGAR-X The mvBlueCOUGAR-X nomenclature scheme is as follows: mvBlueCOUGAR-X - A B C - D - (1) (2) (3) (4) E - A: Sensor model 120a: 0.3 Mpix, 640 x 480, 1/3", CCD 120b: 0.3 Mpix, 640 x 480,...
5: UV transmissive 9: None - (3): Case 1: Color blue (standard) 2: Color black, no logo, no label MATRIX VISION 3: Color blue, no logo, no label MATRIX VISION 4: IP67 long version (+10mm) 9: None - (4): Misc...
Due to the varying fields of application the mvBlueCOUGAR is shipped without accessories. The package contents: • mvBlueCOUGAR • mvIMPACT CD-ROM or DVD-ROM (e.g. CD2008B) with mvIMPACT SDK (image processing tools), drivers (mvIMPACT Acquire, MATRIX VISION's standard hardware interface), example applications and manuals MATRIX VISION GmbH...
Page 53
Shielded connection, M12 male connector to prepared wires, UL/CSA, drag chain, length up to 20m MV-X I/O-BOX IO-Box to connect and test a mvBlueCOUGAR-X camera, to loop the camera into an existing system, and to mix both connection variants selectively...
Cameras - your interface - your product - Downloads" 8.1.1.1 Hardware MATRIX VISION successfully tested several network interface cards (p. 227), which are summarized in the fol- lowing document: http://www.matrix-vision.com/tl_files/mv11/support/Manuals/mv BlueCOUGAR-X_-_Recommended_NICs_en.pdf 8.1.1.2 Additional hardware requirements for mvBlueCOUGAR-XD The mvBlueCOUGAR-XD is a high-performance camera containing latest top-notch technology which requires •...
By double clicking on "mvGenTL_Acquire-x86-n.n.n.msi" (for 32-bit systems) or "mvGenTL_Acquire-x86_64- n.n.n.msi" (for 64-bit systems), the installer will start automatically: Figure 1: Driver installation - start window 1. Now, follow the instructions of installation program and use default settings: Figure 2: Driver installation - select installation folder MATRIX VISION GmbH...
Page 56
Figure 3: Driver installation - select features 2. The installation will start and copies the data. At the end, MATRIX VISION's GigE Vision capture filter driver will be installed. This however requires the system to be rebooted, thus the installer will ask the user to reboot...
Page 57
In this case, the installer will copy the update file "mvBlueCOUGAR-[MODELNAME]_Update.fpg" into the MA TRIX VISION driver installation directory: [Path: e.g. C: Program Files ]MATRIX VISION mvIMPACT acquire FirmwareUpdates mvBlueCOUGAR Afterwards, you can use mvDeviceConfigure (p. 149) to update the firmware. The latest firmware image is avail- able on the web - please check for updates.
M TU (p. 226) or packet size, as otherwise the first component not supporting the packet size will silently discard all packets, that are larger than the component can handle. MATRIX VISION GmbH...
1500. Here, values between 4k and 12k make sense, whereas some network controllers only allow maximum of 9k which is enough for sensors up to 4 megapixels. Figure 9: Setting "Jumbo Packet" using an Intel PRO/1000 network interface 5. Is the NIC (p. 227) parameter "Interrupt Moderation" switched on? MATRIX VISION GmbH...
Page 60
7. Is the amount of the "Receive Descriptors" (RxDesc) of the NIC (p. 227) set to the maximum (generally 2048)? This amount depends on the MTU (p. 226). You can get a feeling about values with following formula: MATRIX VISION GmbH...
Page 61
"Interrupt Throttling". Interrupt throttling enables the NIC (p. 227) to combine packets thus lowering the amount of interrupts. The "Receive Descriptors" a.k.a. "Receive Buffers" (Intel PRO/1000 network interface) can be found under "Performance Options": Figure 12: "Performance Options" MATRIX VISION GmbH...
For this, open the driver settings of the network controller via the "Device Manager" of Windows: 1. Open the tab "Teaming" and 2. create a new team. Figure 14: Create an aggregation group MATRIX VISION GmbH...
Page 63
Figure 15: Enter an aggregation group name 5. Select the two interfaces which where used for the mvBlueCOUGAR-XD. Figure 16: Select the used interfaces 6. Finally, select the connection type "Static Link Aggregation". Figure 17: Select the connection type MATRIX VISION GmbH...
Before installation of GigE environment on a Linux system (e.g. Ubuntu 8.04 or SuSE 10.3), the system has to provide at least following packages: • libwxbase3.0-0 • libwxbase3.0-dev • libwxgtk3.0-0 • libwxgtk3.0-dev • wx3.0-headers • build-essential (meta package) • libgtk2.0-dev • gcc 4.1 environment or newer MATRIX VISION GmbH...
2. Copy the install script and the hardware driver to the workspace directory (e.g. from a driver CD or from the website): ~/workspace$ cp /media/cdrom/drv/Linux/install_mvGenTL_Acquire.sh / . && cp /media/cdrom/drv/Linux/mvGenTL_Acquire-x86-2.3.2.tgz -t ./ 3. Run the install script: ~/workspace$ ./install_mvGenTL_Acquire.sh MATRIX VISION GmbH...
Page 66
. However, you do not always have to start the tool from this folder. The installer script has created symbolic links so that it is enough to type in wxPropView throughout the system to start wxPropView (p. 109). MATRIX VISION GmbH...
(that includes every switch, router and other network component, that is installed in between the device and the system receiving the packets) must support the MTU (p. 226) or packet size, as otherwise the first component not supporting the packet size will silently discard all packets, that are larger than the component can handle. MATRIX VISION GmbH...
Furthermore, it is assumed that the • Class C subnet 192.168.10.1 is used for bonding, that the • receive buffers value was raised (p. 53), and • Intel network interface controller (NIC) is used and the Intel e1000e Kernel module is available. MATRIX VISION GmbH...
Page 69
6. Finally, you have to restart the Linux networking services: sudo /etc/init.d/networking restart Now, you can check if you can ping the mvBlueCOUGAR-XD via the bonding. MATRIX VISION GmbH...
Please have a look at LLA (p. 224) in the Glossary (p. 220) when using Linux and LLA (p. 224). Warning If you are using a static IP address, please be sure that this IP address • does exist • is not used by anyone else in the same network • is a valid one MATRIX VISION GmbH...
"Serial No". After clicking "Use" the program connects to the mvBlueCOUGAR . With "Acquire" you can see live images from the camera. Note The current IP address can be found in the "Device" properties under "DeviceIPAddress". MATRIX VISION GmbH...
• to update firmware or • to upload a GenICam (p. 220) XML file or • to disable CPU sleep states (p. 156). For further information about the programs, please follow the link to the detailed description. MATRIX VISION GmbH...
(system-wide) scope. Under Windows this e.g. will access either the HKEY_CURRE NT_USER or (in the second step) the HKEY_LOCAL_MACHINE branch in the Registry. MATRIX VISION GmbH...
find out how to get the desired information from the device driver. 8.4 Relationship between driver, firmware, FPGA file and user settings To operate a GenICam (p. 220) based device like mvBlueCOUGAR-X apart from the physical hardware itself 2 pieces of software are needed: •...
Page 75
C (color) or G (grey) thus e.g. mvBlueCOUGAR-S123 C_Update.fpg • mvBlueCOUGAR-X_Update.mvu for devices belonging to the mvBlueCOUGAR-X family • mvBlueLYNX-M7_Update.tgz for devices belonging to the mvBlueLYNX-M7 family Only during a firmware update the firmware file that has been selected from the file system of the host system will be downloaded permanently into the device's non-volatile memory.
Page 76
The FPGA file is a part of the firmware and cannot be updated independently thus reading its version just provides some additional information. Using wxPropView (p. 109) the same information is available as indicated by the following figure: MATRIX VISION GmbH...
Page 77
User Sets are bound to major GenICam (p. 220) XML file releases, thus these settings will be lost whenever a firmware contains a different major version of a devices GenICam (p. 220) XML file MATRIX VISION GmbH...
Page 78
Both methods can be used to pre-configure a device. Using the first method, the state of the features will travel with the physical device, using the mvIMPACT Acquire settings, feature states can be copied from host to host as a file. MATRIX VISION GmbH...
CONTENTS 9 Technical data 9.1 mvBlueCOUGAR-X 9.1.1 Dimensions 9.1.1.1 Standard model (-xx1x) Figure 1: Connectors mvBlueCOUGAR-X mvBlueCOUGAR-X Size of body (w x h x l) 39.8 x 39.8 x Y+5 mm Length CMOSIS sensors Remaining sensors 32 mm 30 mm...
Page 80
9.1 mvBlueCOUGAR-X 9.1.1.2 Model without housing (-xx9x) Figure 2: mvBlueCOUGAR-X CCD without housing MATRIX VISION GmbH...
Page 81
CONTENTS Figure 3: mvBlueCOUGAR-X CCD with lens holder without housing MATRIX VISION GmbH...
9.1.1.3 Tripod adapter Figure 5: Dimensional drawing of tripod adapter 9.1.2 Connectors 9.1.2.1 Circular connector male Figure 6: 12-pin (male; top view), digital I/O, power; orientation mvBlueCOUGAR-X Pin. Signal (Standard version) Signal (-POE (p. 229) option, not Digital I/O color code of power available for all products) supply MV-DC1201 BCSX IO;...
Page 83
Connector (camera side): SAMWOO SNH-10-12 (RPCB) or equivalent Plug (matching cable plug): Hirose HR10A-10P-12S (01) or equivalent 9.1.2.1.1 Pinning of cable KS-BCX-HR12 Pin. CON 1 mvBlueCOUGAR-X / -XD Signal CON 2 cutted cable Color GND (Power) black +12V to +24V brown DigOut3 12V to 24V (wxPropView (p.
Page 84
Inputs with highest tolerance against interferences. High level +11 to +24V Low level 0 to +8V Threshold 10V +- 1V (Low – High / High – Low) 16mA Figure 9: DigIn mvBlueCOUGAR-X (PLC option) 9.1.2.3 Characteristics of the digital outputs MATRIX VISION GmbH...
Page 85
Each output has a short circuit protection between 1 A and 1.7 A (generally 1.3 A). So if you combine two outputs with one load, the short circuit protection can have an effect. Figure 11: DigOut mvBlueCOUGAR-X Features - undervoltage detection...
Page 86
Sat. at (0.2) 2.4 mA Notes Figure 13: DigOut mvBlueCOUGAR-X with example circuit (-POE (p. 229) option) Features Measurement conditions : V = 24 V; -25 °C 125 °C, R = 48 Ohm 9.1.2.4 Example circuit 1: High-side switch uses power supply of the camera...
Page 87
flows compared to the total time. If the current always flows, "P = U I" will be the determining factor. If the current only flows a hundredth of time (duty cycle 1%), a resistor with a hundredth of power will be enough. MATRIX VISION GmbH...
Page 88
9.1.2.6 Example circuit 3: Control motorized lens with mvBlueCOUGAR-X It is possible to control a motorized lens using the mvBlueCOUGAR-X. However, an external micro relay is neces- sary which changes the polarity of the lens slider when triggered by the camera's digital output. The following figure...
Green light on Yellow blink on 100Mb transmission Green light off Yellow blink on 9.1.3 Signal LED The mvBlueCOUGAR-X features a RGB LED. There are following states: 9.1.3.1 Typical start sequence (LLA) See also LLA (p. 55) State LED color...
Yellow on Streaming on Green on Error Red on 9.2 mvBlueCOUGAR-X-POE-I 9.2.1 Dimensions 9.2.1.1 Power over Ethernet model (-POE-I) Figure 18: mvBlueCOUGAR-X-POE-I For sizes X and Y please have a look at: Standard model (-xx1x) (p. 64) MATRIX VISION GmbH...
- All inputs (DigIn1..DigIn4 and GND Opto-coupler) are galvanically isolated from the camera electronics. • The digital inputs have the same characteristics as the inputs of mvBlueCOUGAR-X with PLC option. • The digital outputs have the same characteristics as the outputs of the standard mvBlueCOUGAR-X.
Page 92
Inputs with highest tolerance against interferences. High level +11 to +24V Low level 0 to +8V Threshold 10V +- 1V (Low – High / High – Low) 16mA Figure 21: DigIn mvBlueCOUGAR-X-POE-I 9.2.2.3 Characteristics of the digital outputs MATRIX VISION GmbH...
Page 93
Each output has a short circuit protection between 1 A and 1.7 A (generally 1.3 A). So if you combine two outputs with one load, the short circuit protection can have an effect. Figure 23: DigOut mvBlueCOUGAR-X POE-I Features - undervoltage detection...
The Ethernet signals are galvanically isolated from the camera electronics. 9.3 mvBlueCOUGAR-XD 9.3.1 Dimensions 9.3.1.1 Standard model (-xx1x) Figure 25: Connectors mvBlueCOUGAR-XD mvBlueCOUGAR-XD Size of body (w x h x l) 50 x 50 x 32 mm MATRIX VISION GmbH...
RS232_RX RS232_RX pink pink RS232_TX RS232_TX blue blue +24V_HSD (12..24 V +24V_OPT (12..24 V supply for the outputs) supply for the outputs) Opto DigIn1 (line5) Opto DigIn1 (line5) black black DigOut1 (line1) Opto DigOut1 (line1) violet violet MATRIX VISION GmbH...
Page 96
Iris- black Channel4+ Optional fourth channel light blue Channel4- orange Ground violet Connector (camera side): SAMWOO SN-10-12 (RPCB) or equivalent Plug (matching cable plug): Hirose HR10A-10P-12P (01) or equivalent 9.3.2.3 Characteristics of the digital inputs MATRIX VISION GmbH...
Page 97
= 16mA Turn-Off time Standard Notes High level +3 to +24V Low level 0 to +0.3V Threshold 2.5V +- 0.5V (Low – High / High – Low) Figure 29: DigIn mvBlueCOUGAR-XD 9.3.2.4 Characteristics of the digital outputs MATRIX VISION GmbH...
Page 98
Each output has a short circuit protection between 1 A and 1.7 A (generally 1.3 A). So if you combine two outputs with one load, the short circuit protection can have an effect. Figure 31: DigOut mvBlueCOUGAR-XD (same as mvBlueCOUGAR-X) Features...
Page 99
flows compared to the total time. If the current always flows, "P = U I" will be the determining factor. If the current only flows a hundredth of time (duty cycle 1%), a resistor with a hundredth of power will be enough. MATRIX VISION GmbH...
Page 100
The Ethernet signals are galvanically isolated from the camera electronics and camera housing. 9.3.2.8 RJ45 LED states States LED1 LED2 Power on Green light on Yellow light on 1Gb transmission Green light on Yellow blink on 100Mb transmission Green light off Yellow blink on MATRIX VISION GmbH...
FPGA loaded White on Self-test running Green on Waiting for Ethernet connection White blink LLA (auto IP) Green blink LLA got Green on Waiting for client Blue on 9.3.3.2 Typical start sequence (DHCP) See also DHCP (p. 55) MATRIX VISION GmbH...
Bright Green Waiting for client Blue on 9.3.3.4 General behavior State LED color Starting wxPropView (p. 109) Connected, streaming off Yellow on Streaming on Green on Error Red on 9.4 mvBlueCOUGAR-3X 9.4.1 Dimensions Figure 36: Connectors mvBlueCOUGAR-3X MATRIX VISION GmbH...
Page 103
CONTENTS Size of body (w x h x l) 39.8 x 39.8 x 50.5 mm 9.4.1.1 Connectors The 3-head-model uses the same back panel as the standard mvBlueCOUGAR-X. Two version are available for the 3-head-model: Standard POE-I Please have a look at chapter connectors of the standard model (p. 67) for the characteristics of the standard connectors or at chapter connectors of the POE-I model (p.
9.5 Summary of components 9.4.2 Model specific features In contrast to the standard mvBlueCOUGAR-X model: Features mvBlueCOUGAR-3Xxxx -G/-C Environment Ambient Temperature Operation 0..40 deg C / 30 to 80% RH Power supply 3..6 W according to the used sensor 9.5 Summary of components...
100 us. Figure 1: Block diagram gray scale sensors Figure 2: Block diagram color sensors 10.2 CCD sensors The CCD sensors are highly programmable imaging modules which will, for example, enable the following type of applications MATRIX VISION GmbH...
Page 109
(p. 163) ADC (on sensor board) reso- lution [bit] Programmable analog gain and offset Frame in- tegrating progres- sive scan sensor terlaced prob- lems!) High res- olution High color repro- ductivity (for color version) MATRIX VISION GmbH...
(p. 406) (p. 416) (p. 427) (p. 436) (p. 447) (p. 476) (p. 466) 10.2.1 mvBlueCOUGAR-XD specific CCD sensors The CCD sensors are highly programmable imaging modules which will, for example, enable the following type of applications MATRIX VISION GmbH...
Page 111
High color reproductiv- ity (for color version) dark current Continuous variable- speed shut- Overlapped mode (p. 228) Low smear Excellent antiblooming characteris- tics Programmable integration time from usec to sec. Trigger (HW / X / X MATRIX VISION GmbH...
(p. 525) 10.2.2 Negative gain The mvBlueCOUGAR-X cameras use a minimum needed basic gain for typical sensor output signals to get near the maximum ADC (p. 220) (analog-to-digital converter) saturation limit (Figure 3). This guarantees a higher sensitivity. However, to take advantage of the whole ADC (p. 220) range of the sensor, you can use "negative gain". Together with enough illumination, you can get a better signal-to-noise ratio given that this setting will affect the analog signal before it is processed by the ADC (p.
10.3 mvBlueCOUGAR-X specific CMOS sensors Linescan mode High color repro- ductivity (for color version) Programmable readout timing with free capture windows and partial scan Many trig- ger modes (free- running, software- triggered, hardware- triggered) Flash con- trol out- put, syn-...
Page 116
10.3 mvBlueCOUGAR-X specific CMOS sensors Rolling shutter Global shutter Trigger X / X X / X X / X X / X X / X X / X X / X X / X X / X X / X...
For further information about image errors of image sensors, please have a look at the practical report on our website: https://www.matrix-vision.com/tl_files/mv11/Glossary/art_image _errors_sensors_en.pdf 10.4 Output sequence of color sensors (RGB Bayer) Figure 4: Output sequence of RAW data MATRIX VISION GmbH...
The parameter PixelFormat in the ImageFormatControl (p. 162) lists all the supported image formats of the spe- cific camera model. In wxPropView (p. 109) you can find the PixelFormat parameter in "Setting - Base - Camera - GenICam - Image Format Control - Pixel Format". MATRIX VISION GmbH...
Page 121
For more details about the image formats, please have a look at the enums TImageDestination PixelFormat (C++) TImageBufferPixelFormat (C++) in the mvIMPACT Acquire API manuals An example application about the pixel formats called ContinuousAllFormats is also available. MATRIX VISION GmbH...
11.2 Cold mirror filter 11 Filters MATRIX VISION offers several filters for the mvBlueCOUGAR camera. The hot mirror filter (p. 107) is part of the standard delivery condition. 11.1 Hot mirror filter The hot mirror filter has great transmission in the visible spectrum and blocks out a significant portion of the IR energy.
It is also possible to choose a glass filter with following characteristics: Technical data Glass thickness 1.0 mm Material Borofloat without coating ground with protection chamfer Surface quality polished on both sides P4 Surface irregularity 5/3x0.06 on both sides MATRIX VISION GmbH...
12.1 wxPropView wxPropView (p. 109) is an interactive GUI tool to acquire images and to configure the device and to display and modify the device properties of MATRIX VISION GmbH hardware. After the installation you can find wxPropView (p. 109) •...
The Quick Setup Wizard is a tiny and powerful single window configuration tool to optimize the image quality automatically or to set the most important parameters, which affect the image quality, in an easy way manually: Figure 2: Quick Setup Wizard started MATRIX VISION GmbH...
Page 126
12.1.1.1.1 Changing the Presets There are 3 presets: • Gray • Color • Factory Factory can be used as a fall back to quickly skip or remove all presets and load the factory default settings. MATRIX VISION GmbH...
Page 127
Quick Setup Wizard allows zooming into the image by right clicking in the image area and unchecking "Fit To Screen" mode. Use the mouse wheel to zoom in or out. Check "Fit To Screen" mode, if you want the complete camera image to be sized in the window screen size. MATRIX VISION GmbH...
Page 128
(to work with wxPropView (p. 109) using the menu) • "Upper Tool Bar" (to select and initialize a device, acquire images, play a recorder sequence) • "Left Tool Bar" (to hide and show parts of the GUI) MATRIX VISION GmbH...
Page 129
Once you have selected the device of your choice from the drop down menu click on the "Use" button to open it. When the device has been opened successfully, the remaining buttons of the dialog will be enabled: MATRIX VISION GmbH...
Page 130
12.1 wxPropView Note Following screenshots are representative and where made using a mvBlueCOUGAR-X camera as the captur- ing device. For color sensors, it is recommended to perform a white balance (p. 137) calibration before acquiring images. This will improve the quality of the resulting images significantly.
Page 131
If you switched on the request info overlay (righ-click on the display area and select the entry to activate this feature), these information will be displayed on the image, too. With the timestamp you can see the interval of the single frames in microseconds. MATRIX VISION GmbH...
Page 132
Modified properties (even if the value is the same as the default) will be displayed in black. Figure 6:wxPropView - Storing settings MATRIX VISION GmbH...
Page 133
). Properties with no streamable attribute set, will be silently ignored when saving, which specification means they will not be saved in the XML file. For MATRIX VISION GenICam cameras, starting with firmware version 1.6.414 the streamable attribute is set for all the necessary properties.
Page 134
• right click on the name of the property and • select "Restore Default". To restore the default value for a complete list (which might include sub-lists) • right click on the name of a list and MATRIX VISION GmbH...
Page 135
If supported by the property, the user might increase or decrease the number of values stored by right clicking on the PARENT grid element. If the property allows the modification the pop up menu will contain additional entries now: Figure 9:wxPropView - A resizable property MATRIX VISION GmbH...
Page 136
If supported by the property, this can also be achieved by right clicking on the PARENT grid element. If the property allows this modification the pop up menu will again contain additional entries: Figure 11:wxPropView - Setting multiple property values MATRIX VISION GmbH...
Page 137
In this sample the entries 0 to 255 of the property will be assigned the value range of 0 to 255. This will result in the following values AFTER applying the values: Figure 13:wxPropView - After applying the value range to a property MATRIX VISION GmbH...
Page 138
CSV style thus can be pasted directly into tools like Open Office™ or Microsoft® Office™. Just • right-click on the specific analysis grid when in numerical display mode and • select "Copy grid to clipboard" from the pop up menu. MATRIX VISION GmbH...
Page 139
When the file name has been generated using the image storage function offered by wxPropView (p. 109), the file name will be passed and the extracted information will automatically be set in the dialog thus the user simply needs to confirm this information is correct. MATRIX VISION GmbH...
Page 140
This will result in 1 display in horizontal direction and 2 in vertical direction. Since mvIMPACT Acquire 2.18.1 Is is also possible to change the amount of display at runtime via "Settings - Image Displays - Configure Image Display Count": MATRIX VISION GmbH...
Page 141
• "Working with settings" chapter of the "mvIMPACT Acquire API" manuals. Creating a capture setting is done via "Capture - Capture Settings - Create Capture Setting". Figure 18:wxPropView - Create capture setting 2. Then, the user is asked for the name of the new setting. MATRIX VISION GmbH...
Page 142
Figure 20:wxPropView - Create capture setting - Choosing base Afterwards, in this example we end up having 2 capture settings: • a "Base" setting, which is always available • a "NewSetting1", which has been derived from "Base". MATRIX VISION GmbH...
Page 143
Now, to set up wxPropView (p. 109) to display all images taken using capture setting "Base" in one display and all image taken using capture setting "NewSetting1" in another display the capture settings need to be assigned to image displays via "Capture - Capture Settings - Assign To Display(s)". MATRIX VISION GmbH...
Page 144
The minimum number of requests needed is 2 times the amount of images displays. The number of requests used by the driver can be set up in the drivers property tree: MATRIX VISION GmbH...
Page 145
Finally, wxPropView (p. 109) must be configured in order to use all available capture settings in a round-robin scheme. This can be done by setting the capture setting usage mode to "Automatic" via "Capture - Capture Settings - Usage Mode": MATRIX VISION GmbH...
Page 146
When only one setting shall be used at a given time, this can be achieved by setting the capture setting usage mode back to "Manual" via "Capture - Capture Settings - Usage Mode". Then the setting that shall be used can be manually selected in the request control list: MATRIX VISION GmbH...
Page 147
(p. 109) shows snapped or live images in the display area of the GUI. The area, however, shows the most significant bits (msb) of the image in the 8 bit display. The following image shows how a mid-grey 12 bit pixel of an image is displayed with 8 bit. Additionally, two shifts are shown. MATRIX VISION GmbH...
Page 148
View". While the first (default) view will display the device drivers feature tree in a way that might be suitable for most users of a GUI application it might present the features in a slightly different order as they actually are implemented MATRIX VISION GmbH...
Page 149
Figure 29:Developers View 12.1.1.12 Accessing log files Since mvIMPACT Acquire 2.11.9 Using Windows, it is possible to access the log files generated by MATRIX VISION via the Help menu. Sending us the log files will speed up support cases. MATRIX VISION GmbH...
The mvIMPACT Acquire (p. 226) interface internally uses the GenICam (p. 220) runtime libs, so that it can be con- sidered as an user application written with the GenICam (p. 220) interface. This behavior has several advantages: • The mvBlueCOUGAR can be used like any other mvIMPACT Acquire (p. 226) device. MATRIX VISION GmbH...
Page 151
• When an application shall be able to work with every MATRIX VISION device and every GigE Vision (p. 222) and GenICam (p. 220) compliant device both approaches make sense however a mixture between the 2 worlds can't be avoided.
Page 152
Standard Feature Naming Convention of GenICam properties (p. 229) 12.1.2.2 White balance of a camera device (color version) Start the wxPropView (p. 109) and initialize the device by clicking "Use" and start a "Continuous" acquisition. Figure 33: wxPropView - Starting window MATRIX VISION GmbH...
Page 153
The "White Balance Control" can be found in "Setting - Base - Camera - GenICam - Analog Control - Balance White Auto". Just select "Continuous" and you will get a white balanced image. Figure 34: wxPropView - Selecting WhiteBalance profile MATRIX VISION GmbH...
Page 154
Some devices might also offer an event notification if a certain digital input changed its state. This event can then be enabled • via the "EventSelector" in "Setting - Base - Camera - GenICam - Event Control". MATRIX VISION GmbH...
Page 155
12.1.2.5 Saving user settings in the non-volatile flash memory The mvBlueCOUGAR-X camera offers the possibility, to save up to 4 user sets in the camera's flash memory directly. This means that all camera specific settings you've adjusted via wxPropView (p. 109) can be saved in a non-volatile memory.
Example (will start the live acquisition): live=1 12.1.3.1 Sample (Windows) wxPropView.exe d= * fulltree=1 qsw=0 This will start the first available device, will hide the Quick Setup Wizard, and will display the complete property tree. MATRIX VISION GmbH...
(p. 142) will install the driver and adds a service to your Gigabit Ethernet interface auto- matically. After installation of the capture filter, you will see you network devices and the connected devices: Figure 38: mvGigEConfigure displays connected devices MATRIX VISION GmbH...
2. Click on the "Remove driver" button. mvGigEConfigure (p. 142) will remove the driver automatically. 12.2.3 Command-line options mvGigEConfigure offers a couple of command-line options to allow driver installation without the need of user interaction. The available command-line options are Parameter Description MATRIX VISION GmbH...
Page 159
So e.g. to automatically install the filter driver and terminate the application afterwards without any additional messages display to the user the following command line is needed: mvGigEConfigure.exe install quit This will install the filter driver, but will disable it on all the adapters and then will terminate automatically MATRIX VISION GmbH...
• use DHCP (p. 220) to obtain an IP address LLA must always be enabled thus this control will never become modifyable in this GUI application. Every GigE Vision™ compliant device must use the following IP protocol selection algorithm: Figure 40: IP protocol selection sequence MATRIX VISION GmbH...
2. Select the device you want to configure from the list on left side of the tool. 3. Click on the "Configure" button. Now every feature that is supported by the device and that can be modified will become enabled. MATRIX VISION GmbH...
Page 162
It is also possible to assign a temporary IP address to a certain device with a known MAC address via the "Action" menu item. 1. Select the "Action" menu item and click on "Manually Assign Temporary IPv4 Address". MATRIX VISION GmbH...
12.3.2 Recover a misconfigured GigE Vision device Because of the activated setting "Use Advanced Device Discovery", by default, misconfigured GigE Vision™ compliant devices will be listed within mvIPConfigure (p. 145) even if the IP address does not match the local network. MATRIX VISION GmbH...
Just select the device and configure it as described in the chapter above (p. 146). 12.4 mvDeviceConfigure mvDeviceConfigure (p. 149) is an interactive GUI tool to configure MATRIX VISION devices. It shows all connected devices. With mvDeviceConfigure (p. 149) it is possible e.g.
So after installing the device driver and connecting the devices setting up these IDs might be a good idea. To set the ID please start the mvDeviceConfigure (p. 149) tool. You will see the following window: MATRIX VISION GmbH...
Page 166
12.4.1.1 Step 1: Device selection Select the device you want to set up. Select the menu item Action and click on Set ID. Note It is also possible to select the action with a right click on the device. MATRIX VISION GmbH...
With the mvDeviceConfigure (p. 149) tool it is also possible to update the firmware. In the device list, new firmware versions, if available, will be marked in blue. To update the firmware on a MATRIX VISION device, the following steps are necessary: 12.4.2.1 Step 1: Device selection Select the device you want to set up.
Page 168
12.4.2.2 Step 2: Start firmware update • You have to close applications using the device and click Figure 50: mvDeviceConfigure - Close all applications • You have to select the update file – mvBlueCOUGAR-S: mvBlueCOUGAR-S[MODELNAME]_Update.fpg – mvBlueCOUGAR-P: mvBlueCOUGAR-P_Update.tgz – mvBlueCOUGAR-X: mvBlueCOUGAR-X[MODELNAME]_Update.mvu MATRIX VISION GmbH...
Page 169
IP settings etc.) on the other hand will not be affected. UserSet settings may or may not be lost, depending on whether the "Persistent UserSet Settings" parameter is set (this issue will be covered later in this chapter). • Confirm the firmware update. Figure 52: mvDeviceConfigure - Confirm update MATRIX VISION GmbH...
The firmware update takes several minutes and during this time the application will not respond! 12.4.3 Preserving UserSet settings when updating the Firmware For devices that are capable of storing UserSet settings on the device itself (mvBlueCOUGAR-X/XD, mvBlueF OX3, etc.) these settings will by default be preserved during firmware updates since mvIMPACT Acquire 2.9.1.
Page 171
With Windows XP it is only possible to disable the C2 and C3 states. With Windows Vista / 7 all C states (1,2, and 3) will be disabled. Warning Please be sure you know what you do! To turn off the processor's sleep states will lead to a higher power consumption of your system. MATRIX VISION GmbH...
Page 172
Note With Windows Vista or newer mvDeviceConfigure must be started from a command shell with administrator privileges in order to modify the processors sleep states. MATRIX VISION GmbH...
12.4.5.1 Sample (Windows) mvDeviceConfigure ufw=BF000666 This will update the firmware of a mvBlueFOX with the serial number BF000666. mvDeviceConfigure update_fw=BF * This will update the firmware of ALL mvBlueFOX devices in the current system. mvDeviceConfigure update_fw=mvBlueFOX-2 * lf=output.txt quit MATRIX VISION GmbH...
Page 174
This will update the firmware of 2 mvBlueFOX cameras. mvDeviceConfigure ipv4_mask=169.254. * ;192.168.100 * update_fw=GX * This will update the firmware of all mvBlueCOUGAR-X devices with a valid IPv4 address that starts with '169.254.' or '192.168.100.'. MATRIX VISION GmbH...
As you can see, there are some controls with and without the prefix "mv". • "mv" prefix features are unique non-standard features developed by MATRIX VISION. • Without "mv" are standard features as known from the Standard Feature Naming Convention of GenICam properties (p.
Device temperature. etc. related to the device and its sensor. Additionally, MATRIX VISION offers two temperature sensors and for this special features • device temperature upper limit (mvDeviceTemperatureUpperLimit) • device temperature lower limit (mvDeviceTemperatureLowerLimit) • device temperature limit hysteresis (mvDeviceTemperatureLimitHysteresis) The use case Working with the temperature sensors (p.
MATRIX VISON offers two special types: • mvBayerRaw (the Bayer mosaic raw image) • mvFFCImage (the flat-field correction image (p. 277)) Additionally, MATRIX VISION offers numerous additional features like: • mvMultiAreaMode which can be used to define multiple AOIs (Areas of Interests) in one image.
+/-0.005 fps at 200 fps. This is achieved using frames with a length difference of up to 1 us. Please check in the sensor summary (p. 93) if this fea- ture exists for the requested sen- sor. MATRIX VISION GmbH...
Page 179
ExposureMode is Timed. etc. related to the image acquisition, including the triggering mode. Additionally, MATRIX VISION offers numerous additional features like: • mvShutterMode which selects the shutter mode of the CMOS sensors like rolling shutter or global shutter. • mvDefectivePixelEnable which activates the sensor's defective pixel correction.
Page 180
AutoControl AOI used for Auto Gain Control(AGC), Auto Exposure Control(AEC) and Auto White Balance(AWB). • mvAcquisitionMemoryMode MATRIX VISION offers three additional acquisition modes which use the internal memory of the mvBlueC OUGAR-X: – mvRecord (p. 238) which is used to store frames in memory.
Exposure Auto 13.5 Counter And Timer Control The "Counter And Timer Control" is a powerful feature which MATRIX VISION customers already know under the name Hardware Real-Time Controller (HRTC). mvBlueCOUGAR-X provides: • 4 counters for counting events or external signals (compare number of triggers vs. number of frames; over- trigger) and •...
Selects which Black Level is con- trolled by the various Black Level features. BalanceWhiteAuto balanceWhiteAuto Controls the mode for automatic white balancing between the color channels. Gamma gamma Controls the gamma correction of pixel intensity. etc. MATRIX VISION GmbH...
CONTENTS related to the video signal conditioning in the analog domain. Additionally, MATRIX VISION offers: • "mv Balance White Auto" functions and • "mv Gain Auto" functions. In wxPropView (p. 109) just select in "Gain Auto" (AGC) "Continuous". Afterwards, you have the possibility to set...
Represents the value of the se- lected Gain factor or Offset inside the Transformation matrix. ColorTransformationValueSelector colorTransformationValueSelector Selects the Gain factor or Offset of the Transformation matrix to ac- cess in the selected Color Transfor- mation module. MATRIX VISION GmbH...
Starts the Calibration of the Flat Field Correction. related to control the devices Flat Field Correction parameters. The use case Flat-Field Correction (p. 277) shows how this control can be used. 13.10 Event Control The "Event Control" contains features like MATRIX VISION GmbH...
13.11 Chunk Data Control The "Chunk Data Control" contains features like Feature name (acc. to SFNC Property name (acc. to mvIMPA Description (p. 229)) CT Acquire (p. 226)) ChunkDataControl chunkDataControl Category that contains the Chunk Data control features. MATRIX VISION GmbH...
Executes the operation selected by Selector][FileOperationSelector] FileOperationSelector on the se- lected file. FileOpenMode[FileSelector] fileOpenMode Selects the access mode in which a file is opened in the device. FileAccessBuffer fileAccessBuffer Defines the intermediate access buffer that allows the exchange. etc. MATRIX VISION GmbH...
Input or Output a signal. UserOutputSelector fileOperationExecute Selects which bit of the User Out- put register will be set by User OutputValue. etc. related to the control of the general input and output pins of the device. Additionally, MATRIX VISION offers: MATRIX VISION GmbH...
This saves (approx. 5%) CPU load, works on the fly in the FPGA of camera, is less noisy and there are no missing codes after Gamma stretching. Three read-only registers describe the LUT that is selected using the LUTSelector register: MATRIX VISION GmbH...
13.15 LUT Control 13.15.1 mvLUTType There are two different types of LUTs available in MATRIX VISION cameras: Direct LUTs define a mapping for each possible input value, for example a 12 - 10 bit direct LUT has 2 12 entries and each entry has 10 bit. Interpolated LUTs do not define a mapping for every possible input value, instead the user defines an output value for equidistant...
It is recommended to apply all the image related settings to the camera, before the first frame of this sequence is captured. The sequencer sets can be loaded and saved by selecting them using SequencerSetSelector. The Execution of the sequencer is completely controlled by the device. (quoted from the GenICam SFNC 2.3 MATRIX VISION GmbH...
Note that the name used in the enumeration must match ex- actly the device's feature name. SequencerFeature sequencerFeatureEnable Enables the selected feature and Enable[SequencerFeature make it active in all the sequencer Selector] sets. MATRIX VISION GmbH...
Page 196
SequencerSetStart sequencerSetStart Sets the initial/start sequencer set, which is the first set used within a sequencer. SequencerPath sequencerPathSelector Selects to which branching path Selector[SequencerSetSelector] further path settings apply. SequencerSetNext sequencerSetNext Select the next sequencer set. MATRIX VISION GmbH...
Page 197
CONTENTS SequencerTriggerSource sequencerTriggerSource Specifies the internal signal or physical input line to use as the sequencer trigger source. Value supported by MATRIX VISION devices are: • Off: Disables the sequencer trigger. • ExposureEnd: Starts with the reception of the Expo- sure End.
Page 198
The sequence is configured by a list of parameters sets. Note At the moment, the Sequencer Mode is only available for MATRIX VISION cameras with CCD sensors and Sony's CMOS sensors. The following features are currently available for using them inside the sequencer control: •...
Saves the defective pixels to the device non volatile memory. related to control the devices Defective Pixel data. See also Correcting image errors of a sensor (p. 271) 13.18 Transport Layer Control The "Transport Layer Control" contains features like MATRIX VISION GmbH...
Transport Layer Control. In this section MATRIX VISION provides a bandwidth control feature (p. 300). You have to select "mv Gev SCBW Control" in the GevStreamChannelSelector. A new property with the same name will appear. Here you can set the maximum bandwidth in KBps.
Enables the frame averaging en- gine. mvFrameAverageSlope The slope in full range of register. related to the frame averaging engine. The use case Reducing noise by frame averaging (p. 296) shows in detail how this feature works. MATRIX VISION GmbH...
Second HDR Exposure in ppm. related to the control of the device High Dynamic Range parameters. The use cases Adjusting sensor -x00w (p. 339) and Adjusting sensor -x02d (-1012d) (p. 342) show the principle of the HDR. MATRIX VISION GmbH...
The description for the mvIMPACT Acquire SDK for C developers is available as a separate file: mvIMPACT_ Acquire_API_C_manual.chm which is • either part of the installed package or • online from https://www.matrix-vision.com Here an online version of the documentation is available as well. MATRIX VISION GmbH...
The description for the mvIMPACT Acquire SDK for C++ developers is available as a separate file: mvIMPACT_ Acquire_API_CPP_manual.chm which is • either part of the installed package or • online from https://www.matrix-vision.com Here an online version of the documentation is available as well. MATRIX VISION GmbH...
The description for the mvIMPACT Acquire SDK for .NET developers is available as a separate file: mvIMPACT _Acquire_API_NET_manual.chm which is • either part of the installed package or • online from https://www.matrix-vision.com Here an online version of the documentation is available as well. MATRIX VISION GmbH...
The command shell your are calling the compilation script from depending on the version of Windows you are working with and the folder you have installed the mvIMPACT Acquire package to might require elevated rights thus you might need to start the command shell with the Run as administrator option. MATRIX VISION GmbH...
# For systems with NO mvDisplay library support #import ctypes #import Image #import numpy devMgr = acquire.DeviceManager() i in range(devMgr.deviceCount()): pDev = devMgr.getDevice(i) print("[" + str(i) + "]: " + pDev.serial.read() + "(" + pDev.product.read() + ", " + pDev.family.read() MATRIX VISION GmbH...
Page 208
(" + str(requestNr) + ", " + ImpactAcquireException. getErrorCodeAsString(requestNr) + ")") manuallyStopAcquisitionIfNeeded(pDev, fi) raw_input("Press Enter to continue...") Note The above code uses the Python 3 style print. Because of the line from __future__ import print_function MATRIX VISION GmbH...
Page 209
CONTENTS This will also work with Python versions starting with version 2.6. For smaller versions of Python the code needs to be changed! MATRIX VISION GmbH...
18.1.6 ISpecifyPropertyPages 18.2 Logging The DirectShow_acquire logging procedure is equal to the logging of the MATRIX VISION products which uses mvIMPACT Acquire. The log output itself is based on XML. If you want more information about the logging please have a look at the Logging chapter of the respective "mvI MPACT Acquire API"...
. I.e. if you have installed the 32 bit version of the VLC Media Player, Virtual Dub, etc., you have to register the MV device with the 32 bit version of mvDeviceConfigure (p. 149) ("C:\Program Files\MATRIX VISION\mvI MPACT Acquire\bin") ! 18.3.1 Registering devices...
Page 212
18.3 Registering and renaming devices for DirectShow usage Figure 2: mvDeviceConfigure - 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. MATRIX VISION GmbH...
2. Now, select the device you want to rename, click the right mouse button and select "Set DirectShow friendly name": Figure 4: mvDeviceConfigure - set DirectShow friendly name 3. Then, a dialog will appear. Please enter the new name and confirm it with "OK". MATRIX VISION GmbH...
The following command line options are available an 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). regsvr32 <path> DirectShow_acquire.ax /s MATRIX VISION GmbH...
This time is enough to cause image error counts! With mvDeviceConfigure you can disable the CPU sleep states on Windows (p. 156) systems. A description for Linux users is in the pipeline. MATRIX VISION GmbH...
If you use the workaround to use Dual-GigE cameras (p. 201) (1) and click on "Initialize Image Acquisition" (2), Figure 8: VisionPro - Initialize Image Acquisition ... you can get following error message: Figure 9: VisionPro - Error message MATRIX VISION GmbH...
Page 218
4. In order that these settings are using during the start, you can save them in "Setting - Base - Camera - GenICam - UserSetControl" Choose a UserSet, e.g. "UserSet1" (1), 5. save the UserSet by clicking on "int UserSetSave()" (2), and 6. select the UserSet in "UserSetDefault" (3). MATRIX VISION GmbH...
Page 219
CONTENTS Figure 11: wxPropView - Setting UserSet 7. Afterwards it is possible to initialize the mvBlueCOUGAR-XD by clicking on "Initialize Image Acquisition": MATRIX VISION GmbH...
Page 220
19.5 Cognex VisionPro Figure 12: VisionPro - Initializing the mvBlueCOUGAR-XD 8. By clicking on the camera icon (top left), you should see a live image. Perhaps you have to adapt the acquisition parameters: Figure 13: VisionPro - Live image MATRIX VISION GmbH...
files is different in Windows and Linux: 19.8.1 Windows Since mvIMPACT Acquire driver version 2.11.9 you can access the log files in Windows using wxPropView (p. 109). The way to do this is described in Accessing log files (p. 134). MATRIX VISION GmbH...
Configure (p. 142), the NDIS filter driver will freeze and the process cannot be killed even with task manager. After a restart, mvGigEConfigure (p. 142) will show the filter driver status correctly however. Also when connecting a debugger the situation as described here: https://social.msdn.microsoft.com/ Forums/windowsdesktop/en-US/0735c73e-6d2e-49ab-a947-e10fe8137ac3/ndis-driver-freezes-dur can be observed. MATRIX VISION GmbH...
Therefore before resizing a property check if the new size might ex- ceeds this maximum value by calling the appropriate MATRIX VISION GmbH function.[-2005]...
Page 225
-2017 PROPHANDLING_PROP A too large value has been One or more of the values _VAL_TOO_LARGE passed. the caller tried to write to the property are larger than the max. allowed value for this property.[-2017] MATRIX VISION GmbH...
Page 226
A invalid input parameter In most cases this might be ID_INPUT_PARAMETER has been passed to a func- a unassigned pointer, where tion of this module. a valid pointer to a user de- fined storage location was expected.[-2029] MATRIX VISION GmbH...
Page 227
In this case trying to set the prop- erties value to 'blabla7bla' would cause this error.[- 2038] -2099 PROPHANDLING_LAST Defines the last valid error [-2099] _VALID_ERROR_CODE code value for the property module. MATRIX VISION GmbH...
Page 228
-2107 DMR_DEV_REQUEST_C A request object couldn't be The creation of a request ob- REATION_FAILED created. ject failed. This might e.g. happen, if the system runs extremely low on memory.[- 2107] MATRIX VISION GmbH...
Page 229
The creation of a setting This can either happen, _FAILED failed. when a setting with the same name as the one the user tried to create already ex- ists or if the system can't al- locate memory for the new setting.[-2114] MATRIX VISION GmbH...
Page 230
'state' prop- erty should be checked to find out if the device is still present or not. [-2119] -2120 DEV_UNSUPPORTED_P The user tried to get/set a [-2120] ARAMETER parameter, which is not sup- ported by this device. MATRIX VISION GmbH...
Page 231
-2132 DMR_CAMERA_DESCRI A function call was associ- One possible reason might PTION_INVALID ated with a camera descrip- be, that the camera descrip- tion, that is invalid. tion has been deleted(driver closed?).[-2132] MATRIX VISION GmbH...
Page 232
2137] -2138 DEV_REQUEST_BUFFE A request has been config- [-2138] R_INVALID ured to use a user supplied buffer, but the buffer pointer associated with the request is invalid. MATRIX VISION GmbH...
Page 233
AOI.A scan stan- dard has been selected, that is not supported by this device.An invalid scan rate has been selected..This error code will be returned by frame grabbers only.[- 2142] MATRIX VISION GmbH...
Page 234
[-2145] GINE_BUSY user application attempts to start the acquisition engine at a time, where it is already running. -2199 DMR_LAST_VALID_ERR Defines the last valid error [-2199] OR_CODE code value for device and device manager related er- rors. MATRIX VISION GmbH...
20 Glossary Analog-to-digital converter (A/D converter). Application programming interface (API). The standard API for MATRIX VISION products is called mvIMPACT_Acquire (p. 226). Configurable monolithic application including shell and other useful BusyBox command line tools - often called the "swiss army knife" for embedded systems.
Page 236
20 Glossary The term Gigabit Ethernet (defined by the Gigabit Ethernet (GigE) IEEE 802.3-2008 standard) represents various technologies for transmitting Ethernet frames at a rate of a gigabit per second (1,000,000,000 bits per second). MATRIX VISION GmbH...
Page 237
For further information please have a look at https://en.wikipedia.org/wiki/GigE_ Vision The MATRIX VISION GigE Vision capture filter driver as well as the socket based acquisition driver and all MATRIX VISION GigE Vision compli- ant devices support resending thus lost data can be detected and in most cases reconstructed.
Page 238
Please have a look at the project homepage http://handhelds.org/moin/moin.cgi/Ipkg and the more sophisticated documentation http://buffalo.nas-central.org/index.php "Overview _of_the_ipkg_package_management_system" MATRIX VISION distributes all non-firmware, i.e. optional software as ipk packages. JFFS2 is a file system which supports wear levelling. JFFS2 See also Sources about the JFFS file system: •...
Page 239
With Linux you have to add LLA as an additional interface. By default, you can find one interface in Connections: (This description uses "Gnome Network Manager", however using KDE should be similar) In Wired, you can add interfaces via Add: MATRIX VISION GmbH...
Page 240
After saving, you will find both connections in the summary: Now, you can select the wished connection using the left mouse button in the "Network Manager" menu. In the LLA case it is just the new created connection: MATRIX VISION GmbH...
Page 241
This driver supplied with MATRIX VISION products represents mvIMPACT Acquire the port between the programmer and the hardware. The driver concept of MATRIX VISION provides a standardized programming interface to all image processing products (excluding standard mvBlueLYNX) made by MATRIX VISION GmbH.
Page 242
files over LAN. Given that you need a NFS server are uncommon on Windows, this protocol best fits for Linux-Linux connections. Network interface card - synonym for network controller. Recommended network interface cards: https://www.matrix-vision.com/tl_ files/mv11/support/ Manuals/mvBlueCOUGAR-X_-_ Recommended_NICs_en.pdf MATRIX VISION GmbH...
Page 243
In overlapping mode, the exposure starts the exposure time earlier during readout. Note In overlapped trigger mode, you have to keep in mind the following formula interval between two trigger events >= (readout time - exposure time) MATRIX VISION GmbH...
Page 244
Command-line shells provide a command-line interface (CLI) to the operating system. The primary purpose of the shell is to invoke or "launch" another program; however, shells frequently have additional capabilities such as viewing the contents of directories. MATRIX VISION GmbH...
Page 245
1. Start e.g. Konqueror or Explorer. 2. Enter in the address line (e.g.): smb://192.168.19.123 or smb://mvBlueCOUGAR-SDK (Linux) //192.168.19.123 or mvBlueCOUGAR-SDK (Windows) 3. Enter user: mvbc 4. Enter password: mvbc 5. All available folders and devices will be shown. MATRIX VISION GmbH...
Page 246
2. Configure Session (IP address of mvBlueCOUGAR). 3. Configure Connection (user login root in Data) and click Open. A console will open, where you have to enter "root" as password. After- wards, you will be connected to the mvBlueCOUGAR. MATRIX VISION GmbH...
Page 247
VMWare is a virtual machine used for developing software for mvBlueC VMware OUGAR-P. See also http://www.vmware.com wxWidgets is a cross-platform GUI library. It can be used from wxWidgets languages such as C++, Python, Perl, and C#/.NET. See also http://www.wxwidgets.org MATRIX VISION GmbH...
files must be repeated for each interface layout. Once the device has been opened the code generator can be accessed by navigating to "System Settings CodeGeneration" Figure 1: wxPropView - Code Generation section MATRIX VISION GmbH...
Page 249
Once a file name has been selected the code generator can be invoked by executing the "int GenerateCode()" method: Figure 2: wxPropView - GenerateCode() method The result of the code generator run will be written into the "LastResult" property afterwards: MATRIX VISION GmbH...
// XML file may not be compatible thus different interface files should be created here // all code will reside in this inner namespace // namespace MATRIX_VISION_mvBlueIntelligentDevice_1 // namespace DeviceSpecific // namespace acquire // namespace mvIMPACT MATRIX VISION GmbH...
When working with a using statement the same code can be written like this as well: //----------------------------------------------------------------------------- void fn( Device * pDev ) //----------------------------------------------------------------------------- TransportLayer tl(pDev); if( tl.gevTimestampControlLatchReset.isValid() ) tl.gevTimestampControlLatchReset.call(); 21.2 Introducing acquisition / recording possibilities There are several use cases concerning the acquisition / recording possibilities of the camera: MATRIX VISION GmbH...
The following figure shows, how to set the scenario shown in Figure 1 with wxPropView (p. 109) Figure 2: wxPropView - Setting acquisition of a number of images started by an external signal A rising edge at line 4 will start the acquisition of 20 images. MATRIX VISION GmbH...
Acquisition Memory Max Frame Count (p. 163) can be increased by reducing the image height. 21.2.3 Recording sequences with pre-trigger 21.2.3.1 What is pre-trigger? With pre-trigger it is possible to record frames before and after a trigger event. MATRIX VISION GmbH...
Page 254
The camera will output the number of pre-trigger frames as fast as possible followed by the frames in live mode as fast as possible until the frame rate is in sync: Figure 2: wxPropView - recorded / output images MATRIX VISION GmbH...
The sets are activated by a user-defined trigger source and event. Note At the moment, the Sequencer Mode is only available for MATRIX VISION cameras with CCD sensors and Sony's CMOS sensors. The following features are currently available for using them inside the sequencer control: •...
Page 256
• Frame 9: 50000 us • Frame 10: 1000 us • Frame 11: 5000 us • Frame 12: 10000 us • ... So the actual sequence that will be executed on the device later on will be like this MATRIX VISION GmbH...
Page 257
However, wxPropView offers a wizard (p. 247) to define an acquisition sequence in a much easier way. 1. First, switch into the "Configuration Mode": "Sequencer Configuration Mode" = "On". Only then the se- quencer on a device can be configured. MATRIX VISION GmbH...
Page 258
= "CounterDuration" and "Sequencer Feature Enable" = "1". 4. Then, each sequencer set must be selected by the "Sequencer Set Selector" (orange box, figure 3): " Sequencer Set Selector" = "0". Figure 3: wxPropView - Sequencer set 0 MATRIX VISION GmbH...
Page 259
"Sequencer Set Next" = "0". This will close the loop of sequencer sets by jumping from here back to the first one. "Sequencer Trigger Source" = "Counter1End". 11. Set the "Exposure Time" (red box, figure 4): "Exposure Time" = "50000". MATRIX VISION GmbH...
Page 260
21.2 Introducing acquisition / recording possibilities Figure 4: wxPropView - Sequencer set 4 12. Set the "Counter Duration" in "Counter And Timer Control" (red box, figure 5): "Counter Duration" = "5". Figure 5: wxPropView - "Sequencer Mode" = "On" MATRIX VISION GmbH...
Page 261
14. Leave the "Configuration Mode" (red box, figure 4: "Sequencer Configuration Mode" = "Off". 15. Activate the "Sequencer Mode" (red box, figure 4): "Sequencer Mode" = "On". Figure 6: wxPropView - "Sequencer Mode" = "On" Note The "Sequencer Mode" will overwrite the current device settings. MATRIX VISION GmbH...
Page 262
Figure 7: wxPropView - Info Plot shows the exposure times 21.2.4.3 Using the Sequencer Control wizard Since mvIMPACT Acquire 2.18.0 wxPropView (p. 109) offers a wizard for the Sequencer Control (p. 179) usage: Figure 8: wxPropView - Wizard button MATRIX VISION GmbH...
Once activated, the "mv Multi Area Mode" allows you, depending on the sensor, to define up to eight AOIs (mvArea0 to mvArea7) in one image. There are several parameters in combination with the AOIs which are illustrated in the following figure: MATRIX VISION GmbH...
Page 264
4. Now, select the area a.k.a. AOI you want to create via "mv Area Selector", e.g. "mvArea3" and 5. set the parameters "mv Area Width", "mv Area Height", "mv Area Offset X", and "mv Area Offset Y" to your needs. 6. Activate the area a.k.a. AOI by checking the box of "mv Area Enable". MATRIX VISION GmbH...
Page 265
(p. 109) offers a wizard for the Multi AOI usage: Figure 3: wxPropView - Wizard menu The wizard can be used to get a comfortable overview about the settings of the AOIs and to create and set the AOIs in a much easier way: MATRIX VISION GmbH...
If you want to acquire a number of images at sensor's maximum frame rate while at the same time the image transfer should be at a lower frame rate, you can use the internal memory of the mvBlueCOUGAR-X . Figure 1: Principle of burst mode buffering of images Note The maximum buffer size can be found in "Setting -...
Page 268
2. Set bandwidth control to the desired MByte/s out value in "Setting - Base - Camera - GenICam - Transport Layer Control - Gev Stream Channel Selector - mv Gev SCBW Control". Figure 4: wxPropView - Setting the bandwidth using "mvGevSCBW" MATRIX VISION GmbH...
Page 269
Acquisition Frame Rate Limit Mode" set to mvDeviceMaxSensorThroughput , the there won't be hardly any gap between these images. As shown in figure 5, "FrameBurstStart" can be trigger by a software trigger, too. Figure 5: wxPropView - Setting the frame burst mode triggered by software MATRIX VISION GmbH...
So far, the entire data amount has to transferred to the host PC whereby the packetizer in the camera split the data packages and distributed them to the two Gigabit Ethernet lines. On the host PC, the data was merged again, shrank, and this AOI was possibly processed (Figure 1). Figure 1: Data handling so far MATRIX VISION GmbH...
Page 271
You or your software decides on the host PC which AOI should be sent to the host PC (Figure Figure 2: SmartFrameRecall working method This approach allows • higher bandwidths, • less CPU load and power consumption, • higher frame rates, and • less complex cablings. Figure 3: Connection advantages in combination with SmartFrameRecall MATRIX VISION GmbH...
Page 272
E.g. setting decimation to 16, a normal image will only consume 16 16 thus 1/256th of the bandwidth: GenICam::ImageFormatControl ifc( pDev ); ifc.decimationHorizontal.write( 16 ); ifc.decimationVertical.write( 16 ); • Analyze the images of the reduced data stream. • If necessary, request the desired image in full resolution: MATRIX VISION GmbH...
You find the sample's description in the online manual of the mvIMPACT Acquire API .NET: https ://www.matrix-vision.com/manuals/SDK_NET/SmartFrameRecall_8cs-example. html 21.2.8 Using VLC Media Player With the DirectShow Interface (p. 195) MATRIX VISION devices become a (acquisition) video device for the VLC Media Player. MATRIX VISION GmbH...
Page 274
• Windows 7, 32 bit or 64 bit • up-do-date VLC Media Player, 32 bit or 64 bit (here: version 2.0.6) • up-do-date MATRIX VISION driver, 32 bit or 64 bit (here: version 2.5.6) Note Using Windows 10: We tested the VLC Media Player with versions smaller than 2.2.0 successfully.
Page 275
I.e. if you have installed the 32 bit version of the VLC Media Player, you have to register the MV device with the 32 bit version of mvDeviceConfigure (p. 149) ("C:\Program Files\MATRIX VISION\mvIMPACT Acquire\bin") 1. Connect the MV device to the host device directly or via GigE switch using an Ethernet cable.
• sensor description of line scan mode (-x02e) (p. 580) • sensor description of line scan mode (-x02eGE) (p. 587) • sensor description of line scan mode (-x04e) (p. 593) 21.2.9.1 System requirements • mvBlueCOUGAR-X – "firmware version" at least "1.6.32.0" • mvBlueFOX3 – "firmware version" at least "1.6.139.0"...
Page 277
With regards to the external trigger signals provided by an incremental encoder (p. 312), there are two possible scenarios: 1. A conveyor belt runs continuously and so does the incremental encoder (p. 312), or - like in a reverse vending machine, MATRIX VISION GmbH...
Page 278
In the first scenario you can use the standard settings of the MATRIX VISION devices. Please have a look at the sample Sample 2: Triggered line scan acquisition with a specified number of image blocks and pausing trigger signals (p.
Page 279
Image Format Control Exposure Time (in microsec- Acquisition Control 250.000 onds) Trigger Mode Acquisition Control Trigger Source Line4 Acquisition Control ImageRequestTimeout_ms 0 ms This is necessary otherwise (in milliseconds) there will be error counts and no frames are created. MATRIX VISION GmbH...
Page 280
This section will provide you with some information you have to keep in mind while working with pausing triggers and specified number of image blocks. First of all, using mvBlueCOUGAR-X or mvBlueCOUGAR-XD it is necessary to disable the heartbeat of the GigE Vision control protocol (GVCP) ( "Gev GVCP Heartbeat Disable = 1"...
21.2.10 Working with Event Control The mvBlueCOUGAR-X camera generates Event notifications. An Event is a message that is sent to the host application to notify it of the occurrence of an internal event. With "Setting - Base -...
Page 282
GenICam - Event Control - Event Exposure End Data - Event Exposure End Frame ID", 2. right-click on the property, and 3. click on "Attach Callback". Figure 1: wxPropView - "Attach Callback" to Event Exposure End Frame ID MATRIX VISION GmbH...
Due to random process deviations, technical limitations of the sensors, etc. there are different reasons that image sensors have image errors. MATRIX VISION provides several procedures to correct these errors, by default these are host-based calculations. However, the mvBlueCOUGAR-X, for example, also supports a camera-based Flat- Field Correction, which saves dozens of % CPU load and lowers latency.
Page 284
2. cold pixel (in standard light conditions) which indicates pixels that produce a lower read out code than average when the sensor is exposed (e.g. caused by dust particles on the sensor) MATRIX VISION GmbH...
Page 285
4. To activate the correction, choose one of the neighbor replace methods: "Replace 3x1 average" "Replace 3x3 median" 5. Save the settings including the correction data via "Action - Capture Settings - Save Active Device Settings" (Settings can be saved in the Windows registry or in a file) MATRIX VISION GmbH...
Page 286
Repeating the defective pixel corrections will accumulate the correction data which leads to a higher value in "DefectivePixelsFound" . If you want to reset the correction data or repeat the correction process you have to set the (Filter-) "Mode = Reset Calibration Data" MATRIX VISION GmbH...
Page 287
(via right-click on the "DefectivePixelOffset" and select "Append Value" or "Delete Last Value"). Second, with the function • int mvDefectivePixelReadFromDevice( void ) • int mvDefectivePixelWriteToDevice( void ) you can exchange the data from the filter with the camera and vice versa MATRIX VISION GmbH...
Page 288
Just right-click on mvDefectivePixelWriteToDevice and click on "Execute" to write the data to the camera (and hand over the data to the mv Defective Pixel Correction Control (p. 184)). To permanently store the data inside the cameras non-volatile memory afterwards mvDefectivePixelDataSave must be called as well! MATRIX VISION GmbH...
Page 289
The dark current correction is a pixel wise correction where the dark current correction image removes the dark current from the original image. To get a better result it is necessary to snap the original and the dark current images with the same exposure time and temperature. MATRIX VISION GmbH...
Page 290
"Action - Capture Settings - Save Active Device Settings" (Settings can be saved in the Windows registry or in a file) The filter snaps a number of images and averages the dark current images to one correction image. MATRIX VISION GmbH...
Page 291
CONTENTS Note After having re-started the camera you have to reload the capture settings vice versa. Figure 3: Image corrections (screenshot mvBlueFOX): OffsetAutoCalibration = Off MATRIX VISION GmbH...
Page 292
Between flat-field correction and the future application you must not change the optic. To reduce errors while doing the flat-field correction, a saturation between 50 % and 75 % of the flat-field in the histogram is convenient. MATRIX VISION GmbH...
Page 293
After having re-started the camera you have to reload the capture settings vice versa. The filter snaps a number of images (according to the value of the CalibrationImageCount , e.g. ) and averages the flat-field images to one correction image. MATRIX VISION GmbH...
Page 294
4. Finally, you have to activate the correction: Set the "mv Flat-Field Correction Enable = 1" Depending on the sensor, this need some time, because the data is stored in the internal flash memory (yellow LED lights up). Figure 7: wxPropView - settings Example MATRIX VISION GmbH...
The block diagram of the camera (p. 93) shows where the different settings can be found in the data flow of the image data. To show the different color behaviors, we take a color chart as a starting point: MATRIX VISION GmbH...
Page 298
Figure 2: SingleFrame snap without color optimization Figure 3: Corresponding histogram of the horizontal white to black profile As you can see, • saturation is missing, • white is more light gray, • black is more dark gray, • etc. MATRIX VISION GmbH...
Page 299
First of all, a Gamma correction (Luminance) can be performed to change the image in a way how humans perceive light and color. For this, you can change either • the exposure time, • the aperture or • the gain. MATRIX VISION GmbH...
Page 300
LUT Control - LUT Selector". 2. Afterwards, click on "Wizard" to start the LUT Control wizard tool. The wizard will load the data from the camera. Figure 5: Selected LUT Selector and click on wizard will start wizard tool MATRIX VISION GmbH...
Page 301
Figure 7: Gamma Parameter Setup 5. Then, click on "Copy to..." and select "All" and 6. and click on "Enable All". 7. Finally, click on Synchronize and play the settings back to the device (via "Cache - Device"). MATRIX VISION GmbH...
Page 302
21.3 Improving the acquisition / image quality Figure 8: Synchronize After gamma correction, the image will look like this: Figure 9: After gamma correction Figure 10: Corresponding histogram after gamma correction MATRIX VISION GmbH...
Page 303
Base - Camera - GenICam - Analog Control - Balance Ratio Selector" ("Balance White Auto" has to be "Off"): 1. Just select "Blue" and 2. adjust the "Balance Ratio" value until the blue line reaches the green one. MATRIX VISION GmbH...
Page 304
21.3 Improving the acquisition / image quality Figure 12: Optimizing white balance 3. Repeat this for "Red". After optimizing white balance, the image will look like this: MATRIX VISION GmbH...
Page 305
Still, black is more a darker gray. To optimize the contrast you can use "Setting - Base - Camera - GenICam Analog Control - Black Level Selector": 1. Select "DigitalAll" and 2. adjust the "Black Level" value until black seems to be black. MATRIX VISION GmbH...
Page 306
21.3 Improving the acquisition / image quality Figure 15: Back level adjustment The image will look like this now: MATRIX VISION GmbH...
Page 307
Still saturation is missing. To change this, the "Color Transformation Control" can be used ("Setting - Base - Camera - GenICam - Color Transformation Control"): 1. Click on "Color Transformation Enable" and 2. click on "Wizard" to start the saturation via "Color Transformation Control" wizard tool (since firmware version 1.4.57). MATRIX VISION GmbH...
Page 308
21.3 Improving the acquisition / image quality Figure 18: Selected Color Transformation Enable and click on wizard will start wizard tool 3. Now, you can adjust the saturation e.g. "1.1". Figure 19: Saturation Via Color Transformation Control dialog 4. Afterwards, click on "Enable". MATRIX VISION GmbH...
Page 309
Host Processing". The wizard will take the settings of the "Host Color Correction Controls" and will save it in the device. 9. Finally, click on "Apply". After the saturation, the image will look like this: Figure 20: After adapting saturation Figure 21: Corresponding histogram after adapting saturation MATRIX VISION GmbH...
Page 310
As mentioned above, you can change the saturation and the color correction matrices via ("Setting - Base ImageProcessing - ColorTwist"). Here, the changes will affect the 8 bit image data and the processing needs the CPU of the host system: Figure 22: ColorTwist dialog Figure 23: Input and output color correction matrix MATRIX VISION GmbH...
This can be used to • reduce the noise in an image and • compensate motion in an image. MATRIX VISION implemented two versions of the frame averaging: • "mvNTo1" and • "mvDynamic". The modes are FPGA functions which will not need any CPU of the host system. However, these modes are only available for the •...
Page 312
This mode uses an adaptive recursive filter with an average slope. The slope sets the amount of new image versus averaged image in relation to the gray scale variation of the pixel. With it, static noise can be removed at full bit depth and full frame rate: MATRIX VISION GmbH...
Page 313
Frame Average Control" and 5. select "mv Frame Average Mode = mvDynamic". 6. Set the slope, e.g. 5000: "mv Frame Average Slope = 5000". 7. Activate frame averaging by setting "mv Frame Average Enable = 1". MATRIX VISION GmbH...
Some additional bandwidth is needed by the communication protocol and some other non GigE Vision related network traffic. Apart from that not every network controller can cope with a full 1 GBit/s stream of data, thus "real" results may vary. MATRIX VISION GmbH...
Page 315
Figure 2: wxPropView - Setting bandwidth size In contrast to this smart bandwidth control mechanism of mvBlueCOUGAR-X cameras, with other cameras you have to know and optimize the Inter-Packet Delay of the camera to avoid congestion in the switch (the loss of packages is an indicator of congestion).
The reason for this behavior is that you can set more parameters like "mv Exposure Auto Delay Images" in contrast to "mvDevice". However, as mentioned above it is recommended to use a timer based trigger when using auto expose together with continuous acquisition. MATRIX VISION GmbH...
Page 317
21.3.5.2 Example of using a timer for external trigger Figure 2 shows how to generate a 25 Hz signal, which triggers the camera: • "Setting - Base - Camera - GenICam - Counter & Timer Control - Timer Selector - Timer 1": MATRIX VISION GmbH...
Page 318
40000 us • "Setting - Base - Camera - GenICam - Acquisition Control - Trigger Selector - FrameStart": – "Trigger Mode" = "On" – "Trigger Source" = "Timer1End" Figure 2: wxPropView - 25 Hz timer for external trigger MATRIX VISION GmbH...
Binning will lighten the image at the expense of the resolution. This is a neat solution for applications with low light and low noise. The following results were achieved with the mvBlueFOX3-2124G, however, binning is also available with the mv BlueCOUGAR-X camera family. MATRIX VISION GmbH...
Figure 1: Tap areas in 4-Tap mode (left) and 2-Tap mode (right) Each Tap has its own gain control and for this reason each image area could behave differently. The following image shows an uncalibrated image where you can see the four different Tap areas of the sensor: MATRIX VISION GmbH...
Page 322
1. Open wxPropView (p. 109) and 2. open the Analog Control (p. 167) ("Setting - Base - Camera - GenICam - Analog Control"). 3. Now, you can adapt the Gain of each Tap ("AnalogTap1", "AnalogTap2", "AnalogTap3", "AnalogTap4"): MATRIX VISION GmbH...
Page 323
CONTENTS Figure 3: wxPropView - Setting the gain of each Tap area (you will find the exposure time under acquisition control) In our example the calibrated image would look like this: MATRIX VISION GmbH...
• mvBlueCOUGAR-XD129 (9.2 Mpix [3384 x 2712]) (p. 505) 21.3.8 Minimizing sensor pattern of mvBlueCOUAGR-X1010G Sometimes the gray scale version of Aptina's sensor MT9J003 shows structures comparable with Bayer patterns of color sensors. This pattern is particularly apparent in scaled images: MATRIX VISION GmbH...
Page 325
I.e. there are 4 average values (reference value, red value, green value, blue value). The lowest value will be unchanged, the other values are increased using each "Balance Ratio". However by using the property "Balance White Auto" you can balance the sensor automatically: MATRIX VISION GmbH...
Page 326
21.3 Improving the acquisition / image quality Figure 2: Balance White Auto After balancing, we recommend to save these settings to a UserSet (p. 140). MATRIX VISION GmbH...
21.4.1 Getting a trigger with an incremental encoder If you want to • sychronize image with an incremental encoder you can use a Counter and CounterEnd as the trigger event. The following figure shows the principle of an incremental encoder: MATRIX VISION GmbH...
Page 328
3. "Counter Event Source" to "Line4" to count the number of pulses e.g. as per revolution (e.g. "Counter Duration" to 3600). 4. Then set the trigger "Setting - Base - Camera - GenICam - Acquisition Control - Trigger Selector" "FrameStart" to the "Counter1End" ("Trigger Source") signal. MATRIX VISION GmbH...
To dim a laser line generator, for example, you have to generate a pulse width modulation (PWM). For this, you will need • 2 timers and • the active signal of the second timer at an output line MATRIX VISION GmbH...
Page 330
The timers are defined, now you have to set the digital output, e.g. "Line 0": // Set Digital I/O GenICam::DigitalIOControl io(pDev); io.lineSelector.writeS( "Line0" io.lineSource.writeS( "Timer2Active" See also Digital I/O Control (p. 173) This signal has to be connected with the digital inputs of the application. MATRIX VISION GmbH...
Page 331
1. Setting of Timer1 (blue box) on the master camera: Figure 2: wxPropView - Setting of Timer1 2. Setting of Timer2 (purple on the master camera): Figure 3: wxPropView - Setting of Timer2 3. Assigning timer to DigOut (orange box in Figure 2). MATRIX VISION GmbH...
2. Select the "Trigger Source", e.g. "Line5". 3. Use "Counter1" and count the number of input trigger by setting the "Counter Duration" to "2". 4. Afterwards, start "Timer1" at the end of "Counter1": Figure 1: wxPropView - Setting the sample MATRIX VISION GmbH...
3. Afterwards, use an AND gate followed by OR gate to combine different exposure times. Note Please be sure that the sensor can output the complete image during Counter1 or Counter2. Otherwise, only one integration time will be used. MATRIX VISION GmbH...
Page 334
We take 55 ms to be sure. Now, as different exposure times we take 1 ms (Timer1) and 5 ms (Timer2). To get the 55 ms, we have to add 54000 us (Counter1) and 50000 us (Counter2). Finally, you have to set the logic gate as shown in the figure: MATRIX VISION GmbH...
Page 335
If you have an external trigger, you can use the counter and timer to create longer exposure sequences. For example, if you want a sequence with 4 times exposure A followed by 1 time exposure B you can count the trigger events. That means practically: 1. Use Counter1 to count 5 trigger signals then MATRIX VISION GmbH...
4. Afterwards, an AND gate followed by OR gate combines the different exposure times. In wxPropView (p. 109) it will look like this: Figure 3: wxPropView - Logic gate setting 2 21.4.5 Detecting overtriggering 21.4.5.1 Scenario The image acquisition of a camera consists of two steps: MATRIX VISION GmbH...
Page 337
This trigger will start an acquisition after a rising edge signal on line 4 (= DigIn0 (p. 67) ). Now, set the two counters. Both counters ( Counter1 Counter2 ) will be reset and start after the acquisition AcquisitionStart ) has started. MATRIX VISION GmbH...
Page 338
21.4 Working with triggers While Counter1 increases with every ExposureStart event (see figure above for the event and acquisition details) ... Figure 2: Setting Counter1 Counter2 increases with every RisingEdge of the trigger signal: MATRIX VISION GmbH...
Page 339
) in the payload of the image in "Setting - Base - Camera - GenICam - Chunk Data Control": Figure 4: Enable chunk data Activate the info overlay in the display area. Right-click on the live display and select: "Request Info Overlay" MATRIX VISION GmbH...
Page 340
21.4 Working with triggers Figure 5: Show chunk data The following figure shows that no trigger signal is skipped: Figure 6: Trigger Signal counter equals ExposureStart counter The following figure shows that the acquisition is overtriggered: MATRIX VISION GmbH...
The AND gate result is then connected as TriggerSource of the FrameStart trigger using a logical OR gate. I.e. as soon as the logical AND conjunction is true, the trigger sourde is true and the image acquisition will start. The following figure illustrates the settings: MATRIX VISION GmbH...
Page 342
Finally, we have to set the trigger in "Setting - Base - Camera - GenICam - Acquisition Control" with following settings: Property name wxPropView Setting Trigger Selector FrameStart Trigger Mode Trigger Source mvLogicGateAND1Output Trigger Activation RisingEdge MATRIX VISION GmbH...
21.5 Working with I/Os 21.5.1 Controlling strobe or flash at the outputs Of course, the mvBlueCOUGAR-X supports strobe or flash lights. However, there are several things you have to keep in mind when using strobes or flash: 1. Be sure that the illumination fits with the movement of the device under test.
2. Build flash signal with Timer, 3. trigger Timer with external trigger (e.g. "Line5"). 4. Use "Trigger Delay" to delay exposure of the sensor accordingly. In wxPropView (p. 109) it will look like this: Figure 3: Working with Timer and "Trigger Delay" MATRIX VISION GmbH...
To address problems that can arise from these kinds of trigger signals MATRIX VISION offers debouncing filters at the digital inputs of a device.
Page 347
3), that is reset whenever the signal applied to the input falls below the threshold again. Only if the signal stays at a constant level for a full period of the defined mvLineDebounceTime the input signal will be considered as a valid trigger signal. MATRIX VISION GmbH...
field of view, zoom, focus, or iris. Lenses with motors offer the possibility to remotely manipulate these settings and the mvBlueCOUGAR-XD offers the possibility to control motorized lenses. MATRIX VISION GmbH...
Page 349
21.5.4.3 Connecting the motorized lens to a camera 21.5.4.3.1 Connecting the direct drive lens motors mvBlueCOUGAR-XD offers two connectors at the back. Use the female one on the right side for lens connection. Pinning is shown in the table on the left side below: MATRIX VISION GmbH...
Page 350
100mA current with a selectable voltage to the outputs Focus, Zoom and Iris. Please note that the voltage applied is independent of the supply voltage of the camera. Channel 4 can be left open. MATRIX VISION GmbH...
Page 351
Additional settings such as level (sensitivity) and/or ALC (peak or average) may be possible directly at the lens (via poti). ALC settings do not have effect due to digital video signal! Consult the manual of the lens for more details. Using AGC/AEC & mvIrisAuto may lead to oscillating brightness. MATRIX VISION GmbH...
Page 352
21.5.4.6 Controlling the lens via 3rd party libraries or APIs The properties for "mv Lens Control" are MATRIX VISION specific but appear in the camera’s XML-file according to GigE Vision (p. 222) standards and SFNC (p. 229) thanks to the standard. This makes it possible to use the features from third party applications or programs without problems.
CONTENTS The next screenshot shows the respective HDevelop example under Halcon for the same settings: Figure 7: HDevelop example 21.6 Working with HDR (High Dynamic Range Control) There are several use cases concerning High Dynamic Range Control: MATRIX VISION GmbH...
– The max. signal level of Knee Point 2 is higher than of Knee Point 1. • "Phase 2" – During T2 all pixels are integrated until the possible saturation. – T3 is always smaller than T2, so that the percentage compared to the total exposure time is again lower here. MATRIX VISION GmbH...
Page 355
S2 = 2 x S1 and S3 = 3 x S1, a hundredfold brightness of one pixel's step from S2 to S3, compared to the step from 0 and S1 is needed. 21.6.1.3 Using HDR with mvBlueCOUGAR-X-x00w Figure 3 is showing the usage of the HDR mode. You can reach the HDR settings via "Setting -...
Page 356
21.6 Working with HDR (High Dynamic Range Control) Figure 3: wxPropView HDR screenshot 21.6.1.3.1 Notes about the usage of the HDR mode with mvBlueCOUGAR-X-x00w • In the HDR mode, the basic amplification is reduced by approx. 0.7, to utilize a huge, dynamic area of the sensor.
The exposure time proportion of the three phases can be set independently. 21.6.2.2 Functionality To exceed the typical dynamic range, images are captured at 3 exposure times with given ratios for different expo- sure times. The figure shows a multiple exposure capture using 3 different exposure times. MATRIX VISION GmbH...
Page 358
The longest exposure time (T1) represents the Exposure_us parameter you can set in wxPropView. Afterwards, the signal is fully linearized before going through a compander to be output as a piece-wise linear signal. the next figure shows this. MATRIX VISION GmbH...
Page 359
Increasing R1 and R2 will increase the dynamic range of the sensor at the cost of lower signal-to-noise ratio (and vice versa). 21.6.2.2.2 Possible settings Possible settings of the mvBlueCOUGAR-X-x02d in HDR mode are: • "mv HDR Enable": – "Off": Standard mode –...
21.6.3.2 Functionality MATRIX VISION offers the "mv Linear Logarithmic Mode" to use the HDR mode of the e2v sensors. With this mode you can set the low voltage of the reset signal at pixel level.
The curves are at Gain 1, lambda = 670 nm (40 nm width), room temperature, nominal power supply values, on a 100 x 100 pixel cantered area. "mv Linear Logarithmic Mode" value Dynamic max (dB) T = 2 ms T = 20 ms 21.7 Working with LUTs There are several use cases concerning LUTs (Look-Up-Tables): MATRIX VISION GmbH...
• the LUT operations are independent of the transmission bit depth. 21.7.1.2 Setting the hardware based LUTs via LUT Control On the mvBlueCOUGAR-X using wxPropView (p. 109), you will find the LUT Control (p. 174) via "Setting - Base Camera - GenICam - LUT Control".
Page 363
CONTENTS Figure 2: wxPropView - LUT Control wizard button 2. Click on the "Wizard" button to start the LUT Control wizard tool. The wizard will load the LUT data from the camera. MATRIX VISION GmbH...
Page 364
2. click on "Enable All", and finally, to 3. click on Synchronize and play the settings back to the device (via "Cache - Device"). Note If you select "Enable All" without entering any value the image will be inverted. MATRIX VISION GmbH...
Page 365
To get an inverted 8 bit mono image like shown in Figure 1, you can set the LUT using wxPropView (p. 109). After starting wxPropView (p. 109) and using the device, 1. Set "LUTEnable" to "On" in "Setting - Base - ImageProcessing - LUTOperations". 2. Afterwards, set "LUTMode" to "Direct". MATRIX VISION GmbH...
LUT via the features LUTIndex and LUTValue. LUT data can either be written to a device like this (C++ syntax): const size_t LUT_VALUE_COUNT = 256; int64_type LUTData[LUT_VALUE_COUNT] = getLUTDataToWriteToTheDevice(); mvIMPACT::acquire::GenICam::LUTControl lut(getDevicePointerFromSomewhere()); for(int64_type i=0; i< static_cast<int64_type>(LUT_VALUE_COUNT); i++ ) lut.LUTIndex.write( i ); lut.LUTValue.write( LUTData[i] ); MATRIX VISION GmbH...
Page 367
For details on how the LUT memory is organized for certain sensors please refers to the Sensor overview (p. 93). Please note that all mvBlueCOUGAR-S, mvBlueCOUGAR-X and mvBlueCOUGAR-XD devices are using Big Endian while almost any Windows or Linux distribution on the market uses Little Endian, thus the swapping of the data will most certainly be necessary when using the LUTValueAll feature.
(= 12 bit) input values (= rows) and 512 (= 9 bit) output values (column values). To binarize the image according to the threshold, you have to 1. set all values below the binarization threshold to 0. 2. Set all values above the binarization threshold to 511: MATRIX VISION GmbH...
Page 369
3. Now, save the " .csv" file and 4. import it via the LUT Control wizard. 5. Click on synchronize and 6. finally check "Enable". Afterwards the camera will output binarized images like the following: Figure 3: Binarized image MATRIX VISION GmbH...
• mvBlueFOX-M, • mvBlueFOX-MLC, • mvBlueFOX3, and • mvBlueCOUGAR-X currently offer 512 bytes of user accessible non-volatile memory of which 12 bytes are needed to store header information leaving 500 bytes for user specific data. One entry will currently consume: 1 + <length_of_name (up to 255 chars)>...
Page 371
Figure 2, to see if the write process returned with no errors. If an error occurs a message box will pop up. Figure 2: wxPropView - analysis tool "Output" MATRIX VISION GmbH...
21.8.2 Creating user set entries With mvBlueCOUGAR-X it is possible to store up to five configuration sets (4 user plus one factory default) in the camera. This feature is similar to the storing settings functionality (p. 355), which saves the settings in the registry. How- ever, as mentioned before the user sets are stored in the camera.
Page 373
• "int UserSetLoad()" and • "int UserSetSave()". "User Set Default" is the property, where you can select the user set, which comes up after hard reset. Finally, with "mv User Data" you have the possibility to store arbitrary user data. MATRIX VISION GmbH...
21.8 Saving data on the device 21.8.3 Working with the UserFile section (Flash memory) The mvBlueCOUGAR-X offers a 64 KByte section in the Flash memory that can be used to upload a custom file to (UserFile). To read or write this file you can use the following GenICam File Access Control (p. 172) and its interfaces: •...
Page 375
CONTENTS Figure 1: wxPropView - UserFile wizard 2. Click on the "Wizard" button. Now, a dialog appears where you can choose either to upload or download a file. MATRIX VISION GmbH...
Page 376
Figure 3: wxPropView - Download / Upload dialog 4. Select "UserFile" follow the instructions. 21.8.3.2 Manually control the file access from an application (C++) The header providing the file access related classes must be included into the application: #include <mvIMPACT_CPP/mvIMPACT_acquire_GenICam_FileStream.h> MATRIX VISION GmbH...
21.9 Working with device features There are several use cases concerning device features: 21.9.1 Working with the temperature sensors The mvBlueCOUGAR-X offers two different temperature sensors: • on the sensor board (typically lower) • on FGPA board (typically higher) MATRIX VISION GmbH...
Page 378
Figure 1: wxPropView - Device Temperature Selector Note Avoid temperatures higher than 80 C by lowering thermal resistance of mvBlueCOUGAR-X housing to con- necting structure active cooling means. It is possible to regulate the temperature of the camera. The limits of this feature are •...
Gev Heartbeat Timeout"; red box in Figure 1). As a result, during this interval a certain register (GevCCP = Control Channel Privilege) is read several times from the device to reset the heartbeat timer interval in order to ensure the control channel stays open. MATRIX VISION GmbH...
Page 380
21.9 Working with device features Figure 1: wxPropView - Transport Layer Control Figure 2: Screenshot of a network analyzer - GVCP Protocol MATRIX VISION GmbH...
1. Define the input line ("TriggerSource") to reset the timestamp, e.g. "Line5" and 2. set the "Trigger Selector" to "mvTimestampReset". 3. Connect all input lines of all cameras together. 4. Finally, use one output of one camera to generate reset edge: MATRIX VISION GmbH...
First of all the standard does not provide hardware means to reset the timestamp in a camera other than plug off and on again. Therefore MATRIX VISION has created its own mechanism mvTimestampReset to reset the timestamp by a hardware input.
Page 383
We thus have achieved a synchronized timestamp with the precision of the master camera among all connected cameras. Settings required are shown using MATRIX VISION’s wxPropView (p. 109) tool: Figure 2: Reset the timestamp every second MATRIX VISION GmbH...
21.9.5 Working with the 3 head model The 3 head model behaves like a mvBlueCOUGAR-X standard camera and for this reason it can be used with every GigE Vision compliant software. The information of the three sensors are returned as a packed pseudo RGB image, with each color channel representing one sensor.
As mentioned in GenICam and Advanced Features section of this manual, the mv Serial Interface Control (p. 173) is a feature which allows an easy integration of motor lenses or other peripherals based on RS232. • Available message buffer size: 1 KByte Note Use the Power GND for the RS232 signal. MATRIX VISION GmbH...
Page 386
6. Send messages by executing the function "int mvSerialInterfaceWrite( void )" by either clicking on the 3 dots next to the function name or by right-clicking on the command and then selecting Execute from the context menu.(4) If you listening to the RS232 serial line using a tool like PuTTY with matching settings... MATRIX VISION GmbH...
Page 387
CONTENTS Figure 2: PuTTY - Setting up the serial interface you will see the test message: MATRIX VISION GmbH...
• Control and • Read. With Control, a primary application can used to set up the camera which will stream the data via Multicast. With Read you can set up secondary applications which will playback the data stream. MATRIX VISION GmbH...
Page 389
21.10.1.1 Sample On (the primary) application you have to establish "Control" access. For this, 1. please start wxPropView (p. 109) and select the camera. 2. Click on the "Device" section. 3. Click on "DesiredAccess" and choose "Control". MATRIX VISION GmbH...
Page 390
5. Now, select the "Setting - Base - Camera - GenICam" section and open the "Transport Layer Control" subsection (using the device specific interface (p. 135): "System Settings" and "TransportLayer"). 6. In "GevSCDA" enter a Multicast address like "239.255.255.255" MATRIX VISION GmbH...
Page 392
The machines of the secondary applications have to be connected to the same network as the primary appli- cation. 1. Please start wxPropView (p. 109) on the other machine and click on the "Device" section. Figure 4: wxPropView - Secondary application setting DesiredAccess to "Read" MATRIX VISION GmbH...
Page 393
Figure 5: wxPropView - Secondary application read-only "Transport Layer Control" parameters 3. Once the primary application starts to request images, the secondary applications will be able to receive these images as well. Please click on "Use" and then "Acquire" ("Acquisition Mode" = "Continuous"). MATRIX VISION GmbH...
Page 394
Note The machine that has "Control" access automatically joins the streaming multicast group of the camera it is controlling. If this is not desired, the "mv Auto Join Multicast Groups" property has to be set to false. MATRIX VISION GmbH...
figure below. The application fires a broadcast action command that will reach all the devices on the subnet. Figure 1: Action command sent as a broadcast to all devices in the subnet MATRIX VISION GmbH...
Page 396
A device can define several action commands which can be selected via the in the device ActionSelector features property tree. The conditions for an action command to be asserted by the device are: MATRIX VISION GmbH...
Page 397
filters. Attention Scheduled action commands are not supported by every device. A device supporting scheduled action com- mands should also support time stamp synchronization based on IEEE1588. MATRIX VISION devices cur- rently do NOT support these features. MATRIX VISION GmbH...
Page 400
// create an instance of the GenICam.InterfaceModule class for each interface the device is connected to List<GenICam.InterfaceModule> interfaces = List<GenICam.InterfaceModule>(); foreach (String interfaceIDString interfacesTheDeviceIsConnectedTo) interfaces.Add(new GenICam.InterfaceModule(pDev, interfaceIDToIndexMap[interfaceIDString])); return interfaces; Once the desired interface has been located it could be configured to send an action command like this: MATRIX VISION GmbH...
(if more than one camera is required to span over the complete image, like in the textile and printing industry). To solve this task, the mvBlueCOUGAR-X offers timers that can be used to generate pulse at regular intervals. This pulse can be connected to a digital output. The digital output can be connected digital to the digital input of one or more cameras to use it as a trigger.
Page 402
Figure 2: Slave - Slave connecting Note With "Master - Slave" and according to the delay of the opto-isolated inputs of the slave cameras, you have to adapted the property "Trigger delay" of the master camera to synchronize the cameras exactly. MATRIX VISION GmbH...
Page 403
// Set Digital I/O GenICam::DigitalIOControl io(pDev); io.lineSelector.writeS( "Line0" io.lineSource.writeS( "Timer2Active" See also Digital I/O Control (p. 173) This signal has to be connected with the digital inputs of the slave cameras as shown in Figure 1 and 2. MATRIX VISION GmbH...
Page 404
Now, the two timers will work like the following figure illustrates, which means • Timer1 is the trigger event and • Timer2 the trigger pulse width: Figure 3:Timers By the way, this is a simple "pulse width modulation (PWM)" example. MATRIX VISION GmbH...
Page 405
The following figures show, how you can set the timers and trigger using the GUI tool wxPropView (p. 109) 1. Setting of Timer1 (blue box) on the master camera: Figure 4: wxPropView - Setting of Timer1 on the master camera 2. Setting of Timer2 (purple box) on the master camera: MATRIX VISION GmbH...
Another application that knows the key, can request (and gets granted) device control. You can enable the switchover via "Device - PrimaryApplicationSwitchoverEnable". Set this register to "On" to allow other applications to take control over the device. MATRIX VISION GmbH...
Page 407
Transport Layer Control" the property "Gev Primary Applica- tion Switchover Key" can be used by the control application to define a value that must be specified by an application that wants to take over control over the device. E.g. "666": MATRIX VISION GmbH...
Page 408
The other application now tries to take over control with the correct switchover key and this access is granted. As a result the first application can no longer write to the device (executing "int GevTimestampControlLatchReset()" fails with "DEV_ACCESS_DENIED"). MATRIX VISION GmbH...
Page 409
• how to configure the switchover access and • how to take over the control. //----------------------------------------------------------------------------- template<typename _Ty, typename _Tx> void bindAndSetProperty( _Ty& prop, ComponentLocatorBase& locator, const string& propName, const _Tx& value //----------------------------------------------------------------------------- locator.bindComponent( prop, propName ); if( prop.isValid() ) MATRIX VISION GmbH...
Free running, no external trigger FrameStart" signal needed. "TriggerMode = Off" OnDemand Image acquisition triggered by "TriggerSelector = FrameStart" command (software trigger). "TriggerMode = On" "TriggerSource = Software" "ExposureMode = Timed" To trigger one frame execute the TriggerSoftware@i command then. MATRIX VISION GmbH...
Page 412
LevelHigh" "ExposureMode = TriggerWidth" "TriggerSelector = OnLowExpose Each falling edge of trigger signal FrameStart" acquires one image, exposure time corresponds to pulse width. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = LevelLow" "ExposureMode = TriggerWidth" MATRIX VISION GmbH...
Page 413
Shifting out non active lines takes tvshift, while shifting out active lines will consume t . The number of active pixels per line will not have any impact on readout speed. readline MATRIX VISION GmbH...
) + t vshift trans Note In partial scan mode (readout window ysize 480 lines). To calculate the maximum frames per second (FPS ) you will need following formula (Expose mode: No overlap): FPS_max = ---------------------- t_readout + t_exposure MATRIX VISION GmbH...
2. Time to initialize (erase) the CCD chip after reprogramming this is fixed, abt 4.5 ms So for example when reprogramming the capture window you will need (average values) = change_window + init_ccd regprog = 5ms + 4.5ms regprog = 9.5ms regprog MATRIX VISION GmbH...
– Vertical (V) direction: Front 8 pixels, rear 2 pixels • Number of dummy bits: Horizontal 16 Vertical 5 • Substrate material: Silicon 22.1.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. MATRIX VISION GmbH...
Page 417
CONTENTS 22.1.5.2 Color version MATRIX VISION GmbH...
Page 418
22.1 mvBlueCOUGAR-Xx20a (0.3 Mpix [640 x 480]) 22.1.5.3 Gray scale version MATRIX VISION GmbH...
22.1 mvBlueCOUGAR-Xx20a (0.3 Mpix [640 x 480]) 22.1.6 Device Feature And Property List 22.1.6.1 Gray scale version 22.1.6.2 Color version MATRIX VISION GmbH...
. The number of active pixels per line will not have any impact on readout speed. readline 22.2.3 CCD Timing Note In the "Trigger Overlap ReadOut" mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout MATRIX VISION GmbH...
– Vertical (V) direction: Front 8 pixels, rear 2 pixels • Number of dummy bits: Horizontal 16 Vertical 5 • Substrate material: Silicon 22.2.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. MATRIX VISION GmbH...
Page 427
CONTENTS 22.2.5.2 Color version MATRIX VISION GmbH...
Page 428
22.2 mvBlueCOUGAR-Xx20b (0.3 Mpix [640 x 480]) 22.2.5.3 Gray scale version MATRIX VISION GmbH...
22.2 mvBlueCOUGAR-Xx20b (0.3 Mpix [640 x 480]) 22.2.6 Device Feature And Property List 22.2.6.1 Gray scale version 22.2.6.2 Color version MATRIX VISION GmbH...
. The number of active pixels per line will not have any impact on readout speed. readline 22.3.3 CCD Timing Note In the "Trigger Overlap ReadOut" mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout MATRIX VISION GmbH...
• Unit cell size: 8.3um (H) x 8.3um (V) • Optical black: – Horizontal (H) direction: Front 3 pixels, rear 38 pixels – Vertical (V) direction: Front 8 pixels, rear 2 pixels • Number of dummy bits: Horizontal 19 Vertical 5 • Substrate material: Silicon MATRIX VISION GmbH...
Page 437
CONTENTS 22.3.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. 22.3.5.2 Color version MATRIX VISION GmbH...
Page 438
22.3 mvBlueCOUGAR-Xx20d (0.5 Mpix [776 x 580]) 22.3.5.3 Gray scale version MATRIX VISION GmbH...
. The number of active pixels per line will not have any impact on readout speed. readline 22.4.3 CCD Timing Note In the "Trigger Overlap ReadOut" mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout MATRIX VISION GmbH...
– Vertical (V) direction: Front 8 pixels, rear 2 pixels • Number of dummy bits: Horizontal 4 Vertical 2 • Substrate material: Silicon 22.4.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. MATRIX VISION GmbH...
Page 448
22.4 mvBlueCOUGAR-Xx22 (1.2 Mpix [1280 x 960]) 22.4.5.2 Color version 22.4.5.3 Gray scale version MATRIX VISION GmbH...
"TriggerSelector = OnLowLevel Start an exposure of a frame as long as the trigger input is below AcquisitionActive" "TriggerMode = On" the trigger threshold. (No Frame "TriggerSource = Trigger!) desired Line " "TriggerActivation = LevelLow" MATRIX VISION GmbH "ExposureMode = Timed"...
Page 453
"TriggerSource = desired Line " "TriggerActivation = AnyEdge" "ExposureMode = Timed" Line Mapping (TriggerSource mvIMPACT Acquire - TriggerSource GenICam (valid values for desired Line )): TriggerSource mvIMPACT Acquire TriggerSource GenICam(BCX) GP-IN0 Line4 GP-IN1 Line5 MATRIX VISION GmbH...
. The number of active pixels per line will not have any impact on readout speed. readline 22.5.3 CCD Timing Note In the "Trigger Overlap ReadOut" mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout 22.5.3.1 Timings MATRIX VISION GmbH...
Page 455
1 / us 24.5 Note The calculator returns the max. frame rate supported by the sensor. Please keep in mind that it will depend on the interface and the used image format if this frame rate can be transferred. MATRIX VISION GmbH...
The process of getting an image from the CCD sensor can be separated into three different phases. 22.6.2.1 Trigger When coming out of reset or ready with the last readout the CCD controller is waiting for a Trigger signal. The following trigger modes are available: MATRIX VISION GmbH...
Page 463
RisingEdge" "ExposureMode = Timed" "TriggerSelector = OnHighExpose Each rising edge of trigger signal FrameStart" acquires one image, exposure time corresponds to pulse width. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = LevelHigh" "ExposureMode = TriggerWidth" MATRIX VISION GmbH...
Page 464
Shifting out non active lines takes tvshift, while shifting out active lines will consume t . The number of active pixels per line will not have any impact on readout speed. readline MATRIX VISION GmbH...
)) + ((1248 - Activ readout readout readline ) + t vshift trans Note In partial scan mode (readout window ysize 1200 lines). To calculate the maximum frames per second (FPS ) you will need following formula (Expose mode: No overlap): MATRIX VISION GmbH...
2. Time to initialize (erase) the CCD chip after reprogramming this is fixed, abt 4.5 ms So for example when reprogramming the capture window you will need (average values) = change_window + init_ccd regprog = 5ms + 4.5ms regprog = 9.5ms regprog MATRIX VISION GmbH...
– Vertical (V) direction: Front 10 pixels, rear 2 pixels • Number of dummy bits: Horizontal 28 Vertical 1 • Substrate material: Silicon 22.6.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. MATRIX VISION GmbH...
Page 468
22.6 mvBlueCOUGAR-Xx24 (1.9 Mpix [1600 x 1200]) 22.6.5.2 Color version MATRIX VISION GmbH...
Page 469
CONTENTS 22.6.5.3 Gray scale version MATRIX VISION GmbH...
The process of getting an image from the CCD sensor can be separated into three different phases. 22.7.2.1 Trigger When coming out of reset or ready with the last readout the CCD controller is waiting for a Trigger signal. The following trigger modes are available: MATRIX VISION GmbH...
Page 472
RisingEdge" "ExposureMode = Timed" "TriggerSelector = OnHighExpose Each rising edge of trigger signal FrameStart" acquires one image, exposure time corresponds to pulse width. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = LevelHigh" "ExposureMode = TriggerWidth" MATRIX VISION GmbH...
Page 473
Shifting out non active lines takes t , while shifting out active lines will vshift consume t . The number of active pixels per line will not have any impact on readout speed. readline MATRIX VISION GmbH...
) + t vshift trans Note In partial scan mode (readout window ysize 1460 lines). To calculate the maximum frames per second (FPS ) you will need following formula (Expose mode: No overlap): FPS_max = ---------------------- t_readout + t_exposure MATRIX VISION GmbH...
2. Time to initialize (erase) the CCD chip after reprogramming this is fixed, abt 4.5 ms So for example when reprogramming the capture window you will need (average values) = change_window + init_ccd regprog = 5ms + 4.5ms regprog = 9.5ms regprog MATRIX VISION GmbH...
– Vertical (V) direction: Front 8 pixels each channel • Number of dummy bits: Front 1 each channel • Substrate material: Silicon 22.7.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. MATRIX VISION GmbH...
Page 477
CONTENTS 22.7.5.2 Color version MATRIX VISION GmbH...
Page 478
22.7 mvBlueCOUGAR-XD124a (3 Mpix [1936 x 1460]) 22.7.5.3 Gray scale version MATRIX VISION GmbH...
22.7 mvBlueCOUGAR-XD124a (3 Mpix [1936 x 1460]) 22.7.6 Device Feature And Property List 22.7.6.1 Gray scale version 22.7.6.2 Color version MATRIX VISION GmbH...
. The number of active pixels per line will not have any impact on readout speed. readline 22.8.3 CCD Timing Note In the "Trigger Overlap ReadOut" mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout MATRIX VISION GmbH...
– Vertical (V) direction: Front 8 pixels, rear 2 pixels • Number of dummy bits: Horizontal 1 per channel Vertical 1 • Substrate material: Silicon 22.8.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. MATRIX VISION GmbH...
Page 487
CONTENTS 22.8.5.2 Color version MATRIX VISION GmbH...
Page 488
22.8 mvBlueCOUGAR-X225 (5.1 Mpix [2448 x 2050]) 22.8.5.3 Gray scale version MATRIX VISION GmbH...
22.8 mvBlueCOUGAR-X225 (5.1 Mpix [2448 x 2050]) 22.8.6 Device Feature And Property List 22.8.6.1 Gray scale version 22.8.6.2 Color version MATRIX VISION GmbH...
. The number of active pixels per line will not have any impact on readout speed. readline 22.9.3 CCD Timing Note In the "Trigger Overlap ReadOut" mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout MATRIX VISION GmbH...
– Vertical (V) direction: Front 8 pixels, rear 2 pixels • Number of dummy bits: Horizontal 1 per channel Vertical 1 • Substrate material: Silicon 22.9.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. MATRIX VISION GmbH...
Page 497
CONTENTS 22.9.5.2 Color version MATRIX VISION GmbH...
Page 498
22.9 mvBlueCOUGAR-Xx25a (5.1 Mpix [2448 x 2050]) 22.9.5.3 Gray scale version MATRIX VISION GmbH...
"TriggerSelector = OnLowLevel Start an exposure of a frame as long as the trigger input is below AcquisitionActive" "TriggerMode = On" the trigger threshold. (No Frame "TriggerSource = Trigger!) desired Line " "TriggerActivation = LevelLow" MATRIX VISION GmbH "ExposureMode = Timed"...
Page 502
"TriggerSource = desired Line " "TriggerActivation = AnyEdge" "ExposureMode = Timed" Line Mapping (TriggerSource mvIMPACT Acquire - TriggerSource GenICam (valid values for desired Line )): TriggerSource mvIMPACT Acquire TriggerSource GenICam(BCX) GP-IN0 Line4 GP-IN1 Line5 MATRIX VISION GmbH...
2. Time to initialize (erase) the CCD chip after reprogramming this is fixed, abt 4.5 ms So for example when reprogramming the capture window you will need (average values) = change_window + init_ccd regprog = 5ms + 4.5ms regprog = 9.5ms regprog MATRIX VISION GmbH...
– Vertical (V) direction: Front 8 pixels each channel • Number of dummy bits: Front 1 each channel • Substrate material: Silicon 22.10.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. MATRIX VISION GmbH...
Page 506
22.10 mvBlueCOUGAR-XD126 (6 Mpix [2752 x 2208]) 22.10.5.2 Color version MATRIX VISION GmbH...
Page 507
CONTENTS 22.10.5.3 Gray scale version MATRIX VISION GmbH...
. The number of active pixels per line will not have any impact on readout speed. readline 22.11.3 CCD Timing Note In the "Trigger Overlap ReadOut" mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout MATRIX VISION GmbH...
• Unit cell size: 4.54um (H) x 4.54um (V) • Optical black: – Horizontal (H) direction: Front 40 pixels each channel – Vertical (V) direction: Front 8 pixels each channel • Number of dummy bits: Front 1 each channel • Substrate material: Silicon MATRIX VISION GmbH...
Page 516
22.11 mvBlueCOUGAR-XD126a (6 Mpix [2752 x 2208]) 22.11.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. 22.11.5.2 Color version MATRIX VISION GmbH...
Page 517
CONTENTS 22.11.5.3 Gray scale version MATRIX VISION GmbH...
. The number of active pixels per line will not have any impact on readout speed. readline 22.12.3 CCD Timing Note In the "Trigger Overlap ReadOut" mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout MATRIX VISION GmbH...
• Unit cell size: 3.69um (H) x 3.69um (V) • Optical black: – Horizontal (H) direction: Front 40 pixels each channel – Vertical (V) direction: Front 8 pixels each channel • Number of dummy bits: Front 1 each channel • Substrate material: Silicon MATRIX VISION GmbH...
Page 526
22.12 mvBlueCOUGAR-XD129 (9.2 Mpix [3384 x 2712]) 22.12.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. 22.12.5.2 Color version MATRIX VISION GmbH...
Page 527
CONTENTS 22.12.5.3 Gray scale version MATRIX VISION GmbH...
. The number of active pixels per line will not have any impact on readout speed. readline 22.13.3 CCD Timing Note In the "Trigger Overlap ReadOut" mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout MATRIX VISION GmbH...
• Unit cell size: 3.69um (H) x 3.69um (V) • Optical black: – Horizontal (H) direction: Front 40 pixels each channel – Vertical (V) direction: Front 8 pixels each channel • Number of dummy bits: Front 1 each channel • Substrate material: Silicon MATRIX VISION GmbH...
Page 536
22.13 mvBlueCOUGAR-XD129a (9.2 Mpix [3384 x 2712]) 22.13.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. 22.13.5.2 Color version MATRIX VISION GmbH...
Page 537
CONTENTS 22.13.5.3 Gray scale version MATRIX VISION GmbH...
. The number of active pixels per line will not have any impact on readout speed. readline 22.14.3 CCD Timing Note In the "Trigger Overlap ReadOut" mode, the camera accepts a trigger signal the t period exposure ealier than t is finished. readout MATRIX VISION GmbH...
• Unit cell size: 3.1um (H) x 3.1um (V) • Optical black: – Horizontal (H) direction: Front 40 pixels each channel – Vertical (V) direction: Front 8 pixels each channel • Number of dummy bits: Front 1 each channel • Substrate material: Silicon MATRIX VISION GmbH...
Page 546
22.14 mvBlueCOUGAR-XD1212a (12.1 Mpix [4248 x 2836]) 22.14.5.1 Characteristics These zone definitions apply to both the color and gray scale version of the sensor. 22.14.5.2 Color version MATRIX VISION GmbH...
Page 547
CONTENTS 22.14.5.3 Gray scale version MATRIX VISION GmbH...
) in free running mode you will need following formula: Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS InternalLineLength * 8 ImageHeight + VerticalBlankLines FrameTime = ------------------------------ * ---------------------------------- SensorInClock * NumberOfLVDS 1000 If exposure time is lower than frame time: MATRIX VISION GmbH...
Page 551
Trigger!) desired Line " "TriggerActivation = LevelHigh" "ExposureMode = Timed" OnFallingEdge Each falling edge of trigger signal "TriggerSelector = FrameStart" acquires one image. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = FallingEdge" "ExposureMode = Timed" MATRIX VISION GmbH...
GP-IN1 Line5 23.1.3 Sensor Data Device Structure • CMOS image sensor (Type 1/2.9") • Number of effective pixels: 728 (H) x 544 (V) • Unit cell size: 6.9um (H) x 6.9um (V) 23.1.3.1 Characteristics 23.1.3.2 Color version MATRIX VISION GmbH...
The sensor timing in free running mode is fixed, so there is no control when to start an acquisition. This mode is used with trigger mode Continuous. To calculate the maximum frames per second (FPS ) in free running mode you will need following formula: MATRIX VISION GmbH...
Page 554
Free running, no external trigger FrameStart" signal needed. "TriggerMode = Off" OnDemand Image acquisition triggered by "TriggerSelector = FrameStart" command (software trigger). "TriggerMode = On" "TriggerSource = Software" "ExposureMode = Timed" To trigger one frame execute the TriggerSoftware@i command then. MATRIX VISION GmbH...
23.2 mvBlueCOUGAR-X102f (1.6 Mpix [1456 x 1088]) 23.2.3.1 Characteristics 23.2.3.2 Color version 23.2.3.3 Gray scale version 23.2.4 Device Feature And Property List 23.2.4.1 Gray scale version 23.2.4.2 Color version MATRIX VISION GmbH...
GP-IN1 Line5 23.3.3 Sensor Data Device Structure • CMOS image sensor (Type 1/1.2") • Number of effective pixels: 1936 (H) x 1216 (V) • Unit cell size: 5.86um (H) x 5.86um (V) 23.3.3.1 Characteristics 23.3.3.2 Color version MATRIX VISION GmbH...
The sensor timing in free running mode is fixed, so there is no control when to start an acquisition. This mode is used with trigger mode Continuous. To calculate the maximum frames per second (FPS ) in free running mode you will need following formula: MATRIX VISION GmbH...
Page 561
Free running, no external trigger FrameStart" signal needed. "TriggerMode = Off" OnDemand Image acquisition triggered by "TriggerSelector = FrameStart" command (software trigger). "TriggerMode = On" "TriggerSource = Software" "ExposureMode = Timed" To trigger one frame execute the TriggerSoftware@i command then. MATRIX VISION GmbH...
CONTENTS 23.4.3.2 Color version 23.4.3.3 Gray scale version 23.4.4 Device Feature And Property List 23.4.4.1 Gray scale version 23.4.4.2 Color version MATRIX VISION GmbH...
GP-IN1 Line5 23.5.3 Sensor Data Device Structure • CMOS image sensor (Type 1/1.8") • Number of effective pixels: 2064 (H) x 1544 (V) • Unit cell size: 3.45um (H) x 3.45um (V) 23.5.3.1 Characteristics 23.5.3.2 Color version MATRIX VISION GmbH...
The sensor timing in free running mode is fixed, so there is no control when to start an acquisition. This mode is used with trigger mode Continuous. To calculate the maximum frames per second (FPS ) in free running mode you will need following formula: MATRIX VISION GmbH...
Page 568
Free running, no external trigger FrameStart" signal needed. "TriggerMode = Off" OnDemand Image acquisition triggered by "TriggerSelector = FrameStart" command (software trigger). "TriggerMode = On" "TriggerSource = Software" "ExposureMode = Timed" To trigger one frame execute the TriggerSoftware@i command then. MATRIX VISION GmbH...
This mode is used with trigger mode Continuous. To calculate the maximum frames per second (FPS ) in free running mode you will need following formula: Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS MATRIX VISION GmbH...
Page 571
"TriggerSelector = OnLowLevel Start an exposure of a frame as AcquisitionActive" long as the trigger input is below "TriggerMode = On" the trigger threshold. (No Frame "TriggerSource = Trigger!) desired Line " "TriggerActivation = LevelLow" "ExposureMode = Timed" MATRIX VISION GmbH...
CONTENTS 23.7.3.2 Color version 23.7.3.3 Gray scale version 23.7.4 Device Feature And Property List 23.7.4.1 Gray scale version 23.7.4.2 Color version MATRIX VISION GmbH...
23.8 mvBlueCOUGAR-X[D]109b (8.9 Mpix [4112 x 2176]) 23.8 mvBlueCOUGAR-X[D]109b (8.9 Mpix [4112 x 2176]) 23.8.1 Introduction The CMOS sensor module (IMX267) incorporates the following features: • resolution to 4112 x 2176 gray scale or RGB Bayer mosaic • supports window AOI mode with faster readout •...
Page 575
CONTENTS Note The exposure time step width is limited to the sensor's row time of 21.78 us (mvBlueCOUGAR-X) or 14.04 us (mvBlueCOUGAR-XD) and therefore - auto exposure with very low exposure times will perform with relatively large increments and - exposure mode = TriggerWidth (if available) will perform with a jitter corresponding to the row time The following trigger modes are available: Setting (GenICam (p.
23.9 mvBlueCOUGAR-X[D]1012b (12.4 Mpix [4112 x 3008]) "TriggerSelector = OnAnyEdge Start the exposure of a frame when FrameStart" the trigger input level changes from "TriggerMode = On" high to low or from low to high. "TriggerSource = desired Line "...
-------------- ExposureTime Note The exposure time step width is limited to the sensor's row time of 21.78 us (mvBlueCOUGAR-X) or 14.04 us (mvBlueCOUGAR-XD) and therefore - auto exposure with very low exposure times will perform with relatively large increments and...
23.9.3 Sensor Data Device Structure • CMOS image sensor (Type 1.1") • Number of effective pixels: 4112 (H) x 3008 (V) • Unit cell size: 3.45um (H) x 3.45um (V) 23.9.3.1 Characteristics 23.9.3.2 Color version 23.9.3.3 Gray scale version MATRIX VISION GmbH...
23.9 mvBlueCOUGAR-X[D]1012b (12.4 Mpix [4112 x 3008]) 23.9.4 Device Feature And Property List 23.9.4.1 Gray scale version 23.9.4.2 Color version MATRIX VISION GmbH...
) in free running mode you will need following formula: FrameTime = (ImageWidth + 61) * ((ImageHeight + 45) / PixelClock) If exposure time is lower than frame time: FPS_max = ---------------------- FrameTime If exposure time is greater than frame time: FPS_max = ---------------------- ExposureTime MATRIX VISION GmbH...
Page 582
"TriggerSource = desired Line " "TriggerActivation = FallingEdge" "ExposureMode = Timed" "TriggerSelector = OnRisingEdge Each rising edge of trigger signal FrameStart" acquires one image. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = RisingEdge" "ExposureMode = Timed" MATRIX VISION GmbH...
Page 583
Image data is then shifted out line-by-line and transferred to memory. To calculate the maximum frames per second (FPS ) in snapshot mode you will need following formula: FrameTime = (ImageWidth + 61) * ((ImageHeight + 45) / PixelClock) FPS_max = ----------------------------------- FrameTime + ExposureTime MATRIX VISION GmbH...
FrameTime = (ImageHeight * (1650 / PixelClock)) + (25 * (1650 / PixelClock)) If exposure time is lower than frame time: FPS_max = ---------------------- FrameTime If exposure time is greater than frame time: FPS_max = ------------------------ ExposureTime MATRIX VISION GmbH...
Page 586
"TriggerSource = desired Line " "TriggerActivation = FallingEdge" "ExposureMode = Timed" "TriggerSelector = OnRisingEdge Each rising edge of trigger signal FrameStart" acquires one image. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = RisingEdge" "ExposureMode = Timed" MATRIX VISION GmbH...
24.2 mvBlueCOUGAR-Xx02b (1.2 Mpix [1280 x 960]) 24.2.3.1 Characteristics 24.2.3.2 Color version 24.2.3.3 Gray scale version 24.2.4 Device Feature And Property List 24.2.4.1 Gray scale version 24.2.4.2 Color version MATRIX VISION GmbH...
FrameTime = (ImageHeight * (1650 / PixelClock)) + (25 * (1650 / PixelClock)) If exposure time is lower than frame time: FPS_max = ---------------------- FrameTime If exposure time is greater than frame time: FPS_max = ------------------------ ExposureTime MATRIX VISION GmbH...
Page 590
"TriggerSource = desired Line " "TriggerActivation = FallingEdge" "ExposureMode = Timed" "TriggerSelector = OnRisingEdge Each rising edge of trigger signal FrameStart" acquires one image. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = RisingEdge" "ExposureMode = Timed" MATRIX VISION GmbH...
24.3 mvBlueCOUGAR-Xx02d (1.2 Mpix [1280 x 960]) 24.3.3.1 Characteristics 24.3.3.2 Color version 24.3.3.3 Gray scale version 24.3.4 Device Feature And Property List 24.3.4.1 Gray scale version 24.3.4.2 Color version MATRIX VISION GmbH...
2 * ( ImageHeight + 10 ) FrameTime(ms) = InternalLineLength * -------------------------- InternalADCClock * 1000 If exposure time is lower than frame time: 1000 FPS_max = ------------ FrameTime If exposure time is greater than frame time: FPS_max = -------------- ExposureTime MATRIX VISION GmbH...
Page 594
"TriggerSource = desired Line " "TriggerActivation = FallingEdge" "ExposureMode = Timed" "TriggerSelector = OnRisingEdge Each rising edge of trigger signal FrameStart" acquires one image. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = RisingEdge" "ExposureMode = Timed" MATRIX VISION GmbH...
Page 595
"Height" specifies how often the same line(s) will be used to reach the height of the image. Use "Offset X" to shift horizontally the starting point of the exposed line. Use "Offset Y" to shift the scan line vertically (typically to 512 which represents the optical center). MATRIX VISION GmbH...
Page 596
You may use longer exposure times at the expense of scanning frequency. Note Using more than one line e.g. 20, is like having an area scan with ImageHeight = 20. In line scan mode, the min. ImageHeight is at least 16. MATRIX VISION GmbH...
Page 597
CONTENTS wxPropView settings for line scan usage MATRIX VISION GmbH...
• CMOS image sensor (Type 1/1.8") • Number of effective pixels: 1280 (H) x 1024 (V) • Unit cell size: 5.3um (H) x 5.3um (V) 24.4.3.1 Characteristics 24.4.4 Device Feature And Property List 24.4.4.1 Gray scale version 24.4.4.2 Color version MATRIX VISION GmbH...
The global reset release shutter, which is only available in triggered operation, starts the exposure of all rows simultaneously and the reset to each row is released simultaneously, too. However, the readout of the lines is equal to the readout of the rolling shutter: line by line: MATRIX VISION GmbH...
Page 600
InternalADCClock ImageHeight + 10 FrameTime = InternalLineLength * ---------------- * (-----------------) InternalADCClock 1000 If exposure time is lower than frame time: FPS_max = ------------- FrameTime If exposure time is greater than frame time: FPS_max = -------------- ExposureTime MATRIX VISION GmbH...
Page 601
"TriggerSource = desired Line " "TriggerActivation = FallingEdge" "ExposureMode = Timed" "TriggerSelector = OnRisingEdge Each rising edge of trigger signal FrameStart" acquires one image. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = RisingEdge" "ExposureMode = Timed" MATRIX VISION GmbH...
Page 602
"Height" specifies how often the same line(s) will be used to reach the height of the image. Use "Offset X" to shift horizontally the starting point of the exposed line. Use and "Offset Y" to shift the scan line vertically. MATRIX VISION GmbH...
Page 603
You may use longer exposure times at the expense of scanning frequency. Note Using more than one line e.g. 20, is like having an area scan with ImageHeight = 20. In line scan mode, the min. ImageHeight is at least 16. MATRIX VISION GmbH...
Page 604
24.5 mvBlueCOUGAR-Xx02eGE (1.3 Mpix [1280 x 1024]) wxPropView settings for line scan usage MATRIX VISION GmbH...
• CMOS image sensor (Type 1/1.8") • Number of effective pixels: 1280 (H) x 1024 (V) • Unit cell size: 5.3um (H) x 5.3um (V) 24.5.3.1 Characteristics 24.5.4 Device Feature And Property List 24.5.4.1 Gray scale version MATRIX VISION GmbH...
InternalADCClock ImageHeight + 10 FrameTime = InternalLineLength * ---------------- * (-----------------) InternalADCClock 1000 If exposure time is lower than frame time: FPS_max = ------------ FrameTime If exposure time is greater than frame time: FPS_max = -------------- ExposureTime MATRIX VISION GmbH...
Page 607
"TriggerSource = desired Line " "TriggerActivation = FallingEdge" "ExposureMode = Timed" "TriggerSelector = OnRisingEdge Each rising edge of trigger signal FrameStart" acquires one image. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = RisingEdge" "ExposureMode = Timed" MATRIX VISION GmbH...
Page 608
"Height" specifies how often the same line(s) will be used to reach the height of the image. Use "Offset X" to shift horizontally the starting point of the exposed line. Use "Offset Y" to shift the scan line vertically (typically to 512 which represents the optical center). MATRIX VISION GmbH...
Page 609
Time". For high line scan rates the exposure time has to be proportionally low. To achieve the maximum line scan rate of 12.6 kHz (gray scale sensor) the exposure time has to be set to approx. 80us. You may use longer exposure times at the expense of scanning frequency. MATRIX VISION GmbH...
Page 610
24.6 mvBlueCOUGAR-Xx04e (1.9 Mpix [1600 x 1200]) wxPropView settings for line scan usage (screenshot of -x02e but the properties are similar to -x04e) MATRIX VISION GmbH...
• CMOS image sensor (Type 1/1.8") • Number of effective pixels: 1600 (H) x 1200 (V) • Unit cell size: 4.5um (H) x 4.5um (V) 24.6.3.1 Characteristics 24.6.4 Device Feature And Property List 24.6.4.1 Gray scale version 24.6.4.2 Color version MATRIX VISION GmbH...
24.7 mvBlueCOUGAR-X[D]x04 (2.2 Mpix [2048 x 1088]) TriggerSource mvIMPACT Acquire TriggerSource GenICam(BCX) GP-IN0 Line4 GP-IN1 Line5 24.7.2.2.2 Erase, exposure and readout All pixels are light sensitive at the same period of time. The whole pixel core is reset simultaneously and after the exposure time all pixel values are sampled together on the storage node inside each pixel.
CONTENTS 24.7.3.3 Gray scale version 24.7.3.4 Gray scale version (-XD104a12) 24.7.4 Device Feature And Property List 24.7.4.1 Gray scale version -XD 24.7.4.2 Color version -XD 24.7.4.3 Gray scale version -X 24.7.4.4 Color version -X MATRIX VISION GmbH...
GP-IN1 Line5 24.8.3 Sensor Data Device Structure • CMOS image sensor (Type 1/1.8") • Number of effective pixels: 2064 (H) x 1544 (V) • Unit cell size: 3.45um (H) x 3.45um (V) 24.8.3.1 Characteristics 24.8.3.2 Color version MATRIX VISION GmbH...
24.8.4 Device Feature And Property List 24.8.4.1 Gray scale version 24.8.4.2 Color version 24.9 mvBlueCOUGAR-X[D]x04b (4.2 Mpix [2048 x 2048]) 24.9.1 Introduction The CMOS sensor module (CMV4000) incorporates the following features: • resolution to 2048 x 2048 gray scale or RGB Bayer mosaic •...
24.9 mvBlueCOUGAR-X[D]x04b (4.2 Mpix [2048 x 2048]) 24.9.2 Details of operation The sensor uses a pipelined global snapshot shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential. Therefore the sensor offers two different modes of operation: •...
Page 621
The step width for the exposure time is 1 us. Image data is then shifted out line-by-line and transferred to memory. To calculate the maximum frames per second (FPS ) in snapshot mode you will need following formula (in us): MATRIX VISION GmbH...
• supports window AOI mode with faster readout • programmable analog gain (0..12 dB) • progressive scan sensor (no interlaced problems!) • rolling shutter / global reset • programmable readout timing with free capture windows and partial scan • many trigger modes (free-running, hardware-triggered) MATRIX VISION GmbH...
flash duration is shorter or equal to the exposure time. Furthermore, the sensor offers two operating modes: • free running mode (Overlapping exposure and readout) • snapshot mode (Sequential exposure and readout) in triggered operation MATRIX VISION GmbH...
Page 625
Start an exposure of a frame as "TriggerSelector = long as the trigger input is below AcquisitionActive" "TriggerMode = On" the trigger threshold. (No Frame "TriggerSource = Trigger!) desired Line " "TriggerActivation = LevelLow" "ExposureMode = Timed" MATRIX VISION GmbH...
Page 626
The step width for the exposure time is 1 us. Image data is then shifted out line-by-line and transferred to memory. To calculate the maximum frames per second (FPS ) in snapshot mode you will need following formula: MATRIX VISION GmbH...
• supports window AOI mode with faster readout • programmable analog gain (0..12 dB) • progressive scan sensor (no interlaced problems!) • rolling shutter / global reset • programmable readout timing with free capture windows and partial scan • many trigger modes (free-running, hardware-triggered) MATRIX VISION GmbH...
The sensor timing in free running mode is fixed, so there is no control when to start an acquisition. This mode is used with trigger mode Continuous. To calculate the maximum frames per second (FPS ) in free running mode you will need following formula: MATRIX VISION GmbH...
Page 630
"TriggerSelector = OnLowLevel Start an exposure of a frame as AcquisitionActive" long as the trigger input is below "TriggerMode = On" the trigger threshold. (No Frame "TriggerSource = Trigger!) desired Line " "TriggerActivation = LevelLow" "ExposureMode = Timed" MATRIX VISION GmbH...
Page 631
The step width for the exposure time is 1 us. Image data is then shifted out line-by-line and transferred to memory. To calculate the maximum frames per second (FPS ) in snapshot mode you will need following formula: MATRIX VISION GmbH...
Release). This signal can start a flash light. 24.11.3 Sensor Data Device Structure • CMOS image sensor • Image size: 6.119(H)x4.589(V)mm (Type 1/2.3") • Number of effective pixels: 3856 (H) x 2764 (V) • Unit cell size: 1.67um (H) x 1.67um (V) MATRIX VISION GmbH...
CONTENTS 24.11.3.1 Characteristics 24.11.3.2 Color version 24.11.3.3 Gray scale version 24.11.4 Device Feature And Property List 24.11.4.1 Gray scale version 24.11.4.2 Color version MATRIX VISION GmbH...
Need help?
Do you have a question about the mvBlueCOUGAR-X and is the answer not in the manual?
Questions and answers