For example, if you want to know anything about the GUI based applications, then you have to go to the Application Usage (p. 74) book. If you want to know how images are acquired with the mvBlueFOX3, have a look in the respective programming language chapter.
Page 14
• how the log output for "mvIMPACT Acquire" devices is configured and how it works in general, • how to create your own installer packages for Windows and Linux, and • the general mvIMPACT Acquire API documentation. 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.
64-bit architectures as well as several mobile platforms including Windows Mobile, iPhone SDK and embedded GTK+. Please refer to the wxWidgets website for detailed license information. The source code of the applications provided by MATRIX VISION GmbH ( http://www.matrix-vision.
It is provided "as is" without express or implied warranty. See the GNU General Public License for more details. Documents produced by Doxygen are derivative works derived from the input used in their production; they are not affected by this license. MATRIX VISION GmbH...
The OpenSSL toolkit stays under a dual license, i.e. both the conditions of the OpenSSL License and the original SSLeay license apply to the toolkit. See below for the actual license texts. Actually both licenses are BSD-style Open Source licenses. In case of any license issues related to OpenSSL please contact openssl-core@openssl.org MATRIX VISION GmbH...
The C and C++ code is tested using the CppUnit ( http://cppunit.sourceforge.net ) framework, which come under GNU LESSER GENERAL PUBLIC LICENSE Version 2.1, February 1999. 2.12 NUnit The .NET code is tested using the NUnit ( http://www.nunit.org/ ) framework. MATRIX VISION GmbH...
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 22
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...
15. December 2016 V1.31 Added Micro-Manger in Driver Firmware: 2.15.578.0 concept (p. 35). 17. November 2016 V1.29 Added information about the cooling area of mvBlueFOX3- M2xxx-1111. 26. October 2016 V1.28 Updated sensor characteristics. Extended use case Using the 23. August 2016 V1.27 Firmware: 2.12.406.0...
Page 24
V1.09 Added Windows 10 support. 31. July 2015 V1.08 Added dimensional drawing of mvBlueFOX3-IO NC (p. 56). Added USB performance im- provements For Odroid-U2 / - U3 Users (p. 47) and For Rasp- berry Pi Users (p. 47). MATRIX VISION GmbH...
Page 26
4 Revisions 25. March 2015 V0.52b Upgraded frame rate calcula- tor of mvBlueFOX3-2024 (2. 4 Mpix [1936 x 1216]) (p. 289). 11. March 2015 V0.51b Added chapter Accessing log files (p. 92). 05. March 2015 V0.50b Added -2xx Standard model - 2xxx (p.
Page 27
05. June 2014 V0.29b Update chapter Using linescan mode (p. 187). 02. June 2014 V0.28b Removed global reset release mode from mvBlueFOX3-1031 (3.2 Mpix [2048 1536]) (p. 345). 27. May 2014 V0.27b Added use case Reducing noise by frame averaging (p.
Page 28
Added Image data flow (p. 64). 06 Aug. 2013 V0.7b Added troubleshooting chapter: I cannot see the mvBlueFOX3 or I can see it but I cannot use it (p. 138). Added information about Status / Power LED (p. 62). mvBlueFOX3-1100 27 May 2013 V0.6b Updated (11 Mpix [3856 x 2764]) (p.
Page 29
CONTENTS Updated chapters Quickstart 28 Mar. 2013 V0.2b (p. 35), Application Usage (p. 74), GenICam vanced Features (p. 107), and Use cases (p. 162). March 2013 V0.1b Initial version MATRIX VISION GmbH...
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.
6.1 Important safety instructions • We cannot and do not take any responsibility for the damage caused to you or to any other equipment connected to the mvBlueFOX3. Similarly, warranty will be void, if a damage is caused by not following the manual.
Additional cooling by e.g. air convection is recommended. 6.2.5 Connectors Confirm the power is off before connecting or disconnecting a signal cable. Grasp connectors by the body, not the attached wires. MATRIX VISION GmbH...
• Do not use benzene, thinner, alcohol, liquid cleaner or spray-type cleaner. 6.2.7 Adjusting the C-mount (mvBlueFOX3-2xxx-1xxx) The mvBlueFOX3-2xxx-1xxx does not support back focus adjustment. However, with the four screw locks at the front of the lens holder, it is possible to rotate the C-mount ring.
6.2.8 Adjusting the C-mount (mvBlueFOX3-2xxx-2xxx) The mvBlueFOX3-2xxx-2xxx cameras allow a precise adjustment of the back focus of the C-mount by means of a back focus ring which is threaded into the C-mount and is secured by a lock nut ring which itself is secured by two screws.
Page 35
CONTENTS The mvBlueFOX3 is in conformity with all applicable essential requirements necessary for CE marking. It corresponds to the EU EMC guideline 2014/30/EU based on the following harmonized standards Electromagnetic compatibility (EMC) • Interference emission EN 61000-6-3 / 2007 • Interference immunity EN 61000-6-2 / 2005 MATRIX VISION corresponds to the EU guideline WEEE 2002/96/EG on waste electrical and elec- tronic equipment and is registered under WEEE-Reg.-No.
Page 36
6.3 European Union Declaration of Conformity statement MATRIX VISION GmbH...
This apparatus complies with the Class B limits for radio noise emissions set out in the Radio Interference Regula- tions. 6.4.3 Pour utilisateurs au Canada Cet appareil est conforme aux normes classe B pour bruits radioélectriques, spécifiées dans le Règlement sur le brouillage radioélectrique. MATRIX VISION GmbH...
CONTENTS 7 Introduction Figure 1: mvBlueFOX3-1 The mvBlueFOX3 is a compact USB 3.0 camera which is compliant to the brand new vision standard USB3 Vision (p. 161). The mvBlueFOX3 offers • a wide range of CMOS sensors, • high frame rates, •...
Figure 2: Software concept of mvBlueFOX3 As shown in figure 2, for the mvBlueFOX3 the mvIMPACT_Acquire (p. 157) interface is stacked on the USB3 Vision (p. 161) and Genicam (p. 155) layers. The mvIMPACT_Acquire (p. 157) interface internally uses the Gen ICam (p.
2: Color black, no logo - (4): I/O 1: None (standard) 2: With I/O 7.2.2 mvBlueFOX3-M1 The mvBlueFOX3-M1 nomenclature scheme is as follows: mvBlueFOX3-M1(A)(B)(C) - (1)(2)(3)(4) - (A): Sensor model 012b: 1.2 Mpix, 1280 x 960, 1/3" 012d: 1.2 Mpix, 1280 x 960, 1/3"...
7.3 What's inside and accessories 1: standard - (4): I/O 1: standard; if I/O is needed, use separate article: mvBlueFOX3-IO 7.2.3 mvBlueFOX3-M2 The mvBlueFOX3-M2 nomenclature scheme is as follows: mvBlueFOX3-M2(A)(B) - (1)(2)(3)(4) - (A): Sensor model 004: 0.4 Mpix, 728 x 544, 1/2.9", CMOS...
CONTENTS Figure 3: mvBlueFOX3 - scope of supply For this reason, you will need at least • a lens (by default, the mvBlueFOX3 is shipped without lens) and • a USB 3.0 cable to use the mvBlueFOX3. Note Although maximum cable length is not specified in the USB 3.0 standard, the electrical properties of the cable and signal quality limitations may define the practical maximum length.
8 Quickstart 8.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.
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.
- your product - Downloads" 8.2.1.1 Hardware MATRIX VISION testet successfully several USB 3.0 extension cards or adapters for PCs and Notebooks. Please have a look here for a current listing: See also http://www.matrix-vision.com/faq-mvbluefox-en.html?show=824 8.2.2 Installing the mvGenTL-Acquire driver By double clicking on •...
Page 50
8.2 Windows Figure 2: Driver installation - start window • Now, follow the instructions of installation program Figure 3: Driver installation - select installation folder • and use default settings: MATRIX VISION GmbH...
Page 51
CONTENTS Figure 4: Driver installation - select features • The installation will start and copies the data. At the end, MATRIX VISION's USB3 Vision (p. 161) capture filter driver will be installed. A "Windows Security" dialog will appear. • Click on Install (This however requires the system to be rebooted, thus the installer will ask the user to reboot the system.).
GigE Vision devices like the mvBlueCOUGAR-X. During installation, you can select the features you want to install. It is also possible to select "Firmware updates": In this case, the installer will copy the update file "mvBlueFOX3_Update.mvu" into the MATRIX VISION driver installation directory: "[Path: e.g.
• build-essential (meta package) • libgtk2.0-dev • gcc 4.1 environment or newer 8.3.1.1 Hardware MATRIX VISION testet successfully several USB 3.0 extension cards or adapters for PCs and Notebooks. Please have a look here for a current listing: See also http://www.matrix-vision.com/faq-mvbluefox-en.html?show=824...
8.3 Linux 8.3.2 Installing the mvGenTL-Acquire driver To use the mvBlueFOX3 camera within Linux (grab images from it and change its settings), a driver is needed, consisting of several libraries and several configuration files. These files are required during run time.
Most Linux system nowadays use the udev device manager, which is responsible for dynamically managing the /dev tree. In order to be able to use the MATRIX VISION mvBlueFOX3 USB3 Vision (p. 161) camera as non-root user, a special set of rules has to be handed to the udev device manager.
3. OPTIONAL: Create another file in the directory with name "/etc/udev/rules.d" 52-mvbf3.rules . This step is only necessary if a mvBlueFOX3 in the "mvbootloader" state should be recognised by the system. 4. OPTIONAL: Type the following content into the file: SUBSYSTEM!="usb|usb_device|plugdev", GOTO="mvbf_rules_end"...
Page 57
1. Open the file .ini as root. /media/boot/boot 2. Add or adapt the string "usbcore.usbfs_memory_mb=256" at the end of the boot arguments using a blank: setenv bootargs "... usbcore.usbfs_memory_mb=256" 3. Save the file. 4. Reboot the Odroid-XU3 board. MATRIX VISION GmbH...
Page 58
8.3 Linux 8.3.5.2 For Odroid-U2 / -U3 Users Although Odroid-U2 and Odroid-U3 do not have a USB 3.0 port, you can use the mvBlueFOX3 cameras with the USB 2.0. Jusst adapt the following settings: 1. Locate the file (by default: boot.scr...
(c) Set "usbcore.usbfs_memory_mb=256" (this will increase the buffer of the USB bus) 3. Install the mvGenTL_Acquire driver. Now, the camera should work. If you could not find the mvBlueFOX3 driver, you would add the current user to the plugdev group: sudo usermod -a -G plugdev ubuntu 8.4 Relationship between driver, firmware, FPGA file and user settings...
Page 60
(p. 100) to update devices the latter mechanism will be used by the tool thus it is NOT necessary to unplug the device. When the device has completed rebooting the new firmware version will become active: MATRIX VISION GmbH...
Page 61
User Sets are bound to major GenICam (p. 155) XML file releases, thus these settings will be lost whenever a firmware contains a different major version of a devices GenICam (p. 155) XML file MATRIX VISION GmbH...
Now, whenever a device is opened, the driver will execute following procedure: Figure 11 : wxPropView - Device setting start procedure MATRIX VISION GmbH...
Page 63
One version of the tool will always be delivered in source so it can be used as a reference to find out how to get the desired information from the device driver. MATRIX VISION GmbH...
Size of body (w x h x l) 39 x 39 x 24 mm Lens protrusion C-Mount CS-Mount 12.5 mm 7.5 mm 9.1.1.1 Mounting holes On the bottomside, the mvBlueFOX3 provides integrated tripod mounting holes. Figure 2: mvBlueFOX3 mounting holes MATRIX VISION GmbH...
Figure 3: Dimensional drawing of tripod adapter 9.1.2 Standard model -2xxx 9.1.2.1 Option -1xxx (lensholder without back focus adjustment) Figure 4: mvBlueFOX3-2xxx-1xxx dimensions and connectors mvBlueFOX3-2xxx-1xxx Size of body (w x h x l) 40 x 40 x 50.9 mm Lens protrusion 10.7 mm with 1"...
Page 66
9.1 Dimensions Figure 5: mvBlueFOX3-2xxx-1xxx mounting holes 9.1.2.2 Option -2xxx (lensholder with back focus adjustment) Figure 6: mvBlueFOX3-2xxx-2xxx dimensions and connectors mvBlueFOX3-2xxx-2xxx Size of body (w x h x l) 39.8 x 39.8 x 37.7 mm Lens protrusion C-Mount CS-Mount...
In combination with the connectors, the mechanical stress needs to be limited. Figure 8: mvBlueFOX3-M dimensions and connectors 9.1.3.1 I/O board for mvBlueFOX3-M (mvBlueFOX3-IO) Figure 9: mvBlueFOX3-M dimensions of additional I/O board The following figure shows, how the additional I/O board gets connected correctly. MATRIX VISION GmbH...
Page 68
The pinning of the mvBlueFOX3-I/O is described in the chapter Circular connector male (Power / Digital I/O) (p. 59). Note There is also a version of the I/O board without connector as "mvBlueFOX3-IO NC" (NC = not connected). The pinning is provided in the figure: Figure 11: mvBlueFOX3-M dimensions of additional I/O board without connector.
fixing points. Both, the mounting holes on the lensholder as well as the mounting holes at the heat sink plate can be used to mount the camera. Figure 13: mvBlueFOX3-M2xxx-495x dimensions and connectors Warning Please pay attention to the Important safety notes (p. 20) when operating the mvBlueFOX3-M2 without the heat sink backplate. MATRIX VISION GmbH...
Plug (matching cable plug): Hirose HR10A-10P-12S (01) or equivalent Note RS232 is not implemented in the firmware. 9.2.1.1 Pinning of KS-BCX-HR12 Pin. CON 1 mvBlueFOX3-1xxx Signal CON 1 mvBlueFOX3-2xxx Signal CON 2 cutted cable Color GND (for VDC) black not connected...
Color assignment following international code for UL wiring. 9.2.1.2 Power Supply The mvBlueFOX3 is bus powered. Anyway, it is possible to power the mvBlueFOX3-2 externally with following specs: • Input voltage range: – 12 .. 24V DC (typical) –...
1. Off No power or no bootloader found. 2. Red Bootloader was recognized and FPGA is booting-up or device is in standby mode. 3. Green mvBlueFOX3 is running. 4. Green blink mvBlueFOX3 is busy (e.g. file upload). MATRIX VISION GmbH...
4. Green mvBlueFOX3 is streaming images. 5. Yellow blink mvBlueFOX3 is busy (e.g. file upload). 6. White blink Waiting for USB connection (external power is connected) 7. Red Error or if you put the device into standby 9.4 Components...
The following block diagrams show the data flow of the image data after being read from the sensor chip in the camera. Figure 1: Block diagram 10.2 Output sequence of color sensors (RGB Bayer) Figure 2: Output sequence of RAW data MATRIX VISION GmbH...
• Erase, exposure and readout 10.3.1.2.1 Trigger Snapshot mode starts with a trigger. This can be either a hardware or a software signal. The CMOS sensors used in mvBlueFOX3 cameras support the following trigger modes: Description Setting in GenICam Free running, no external trigger signal needed (for- "TriggerSelector = FrameStart"...
Page 77
The first image will start with the low-high edge of the signal. The integration time of the exposure register will be used. – OnLowLevel: The first image will start with the high-low edge of the signal. MATRIX VISION GmbH...
Page 79
X / X X / X X / X X / X X / X Pipelined global shut- trig- mode (p. 158) Linescan mode High color pro- duc- tivity (for color ver- sion) Many trig- modes (free- running, MATRIX VISION GmbH...
YUV422_YUYVPacked YUV444Packed See also For more details about the image formats, please have a look at the enums "TImageDestinationPixel Format" and "TImageBufferPixelFormat" in the C++ developers section. An example application about the pixel formats is also available MATRIX VISION GmbH...
CONTENTS 11 Filters and Lenses MATRIX VISION offers several filters for the mvBlueFOX3camera. The hot mirror filter (p. 72) 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.
Surface quality polished on both sides P4 Surface irregularity 5/3x0.06 on both sides 11.4 Lenses MATRIX VISION offers a high-quality selection of lenses. If you have questions about our accessories, please contact our sales team: info@matrix-vision.com MATRIX VISION GmbH...
12.1 wxPropView wxPropView (p. 74) 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. 74) •...
Page 86
• a host (PC) based sensor specific "Color Correction Matrix" and use the respective "sRGB display matrix". These settings will also be applied whenever the "Color Preset" button is pressed. It is herewith assumed that color camera image is optimized for best human visual feedback. MATRIX VISION GmbH...
Page 87
Use OK to use the values and settings of the Quick Setup Wizard and go back to the tree mode of wxPropView. Use Cancel to discard the Quick Setup Wizard values and settings and go back to wxPropView and use the former (or default) settings. MATRIX VISION GmbH...
Page 88
– Europe: 50 Hz; Set frame rate to 100, 50, 25 12.5 fps or appropriate. – In countries with 60 Hz use 120, 60, 30 or 15. . . accordingly. 12.1.1.2 First View of wxPropView wxPropView (p. 74) consists of several areas: Figure 2:wxPropView started MATRIX VISION GmbH...
Page 89
(settings or parameters) (according to the "interface layout") accessible by the user. Note Please have a look at the troubleshooting chapter if you neither see the mvBlueFOX3 nor cannot use it (p. 138). You've also got the possibility to set your "User Experience". According to the chosen experience, the level of visibility is different: •...
Page 90
When the device has been opened successfully, the remaining buttons of the dialog will be enabled: Note Following screenshots are representative and where made using a mvBlueFOX3 camera as the capturing device. For color sensors, it is recommended to perform a white balance (p. 95) calibration before acquiring images. This will improve the quality of the resulting images significantly.
Page 91
• click the "Acquire" button. Note The techniques behind the image acquisition can be found in the developers sections. Figure 4: wxPropView - First image Three different acquisition modes are available: • Continuous ("Live Mode") • MultiFrame ("Number of Single Snaps") MATRIX VISION GmbH...
Page 92
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 93
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 94
). Properties with no streamable attribute set, will be silently ignored when saving, which 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 95
To restore the default value for a complete list (which might include sub-lists) • right click on the name of a list and • select "Restore Default". In this case a popup window will be opened and you have to confirm again. MATRIX VISION GmbH...
Page 96
Also the user might want to set all (or a certain range of) values for properties that store multiple values with a single operation. 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: MATRIX VISION GmbH...
Page 97
It's possible to either set all (or a range of) elements of the property to a certain value OR to define a value range, that then will be applied to the range of property elements selected by the user. The following example will explain how this works: MATRIX VISION GmbH...
Page 98
)". This will specific a function returning an integer value and expecting a string and an integer as input parameters. To execute a method object • right click on the name of a method and • select "Execute" from the popup menu: MATRIX VISION GmbH...
Page 99
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. Figure 13:wxPropView - Copying grid data to the clipboard MATRIX VISION GmbH...
Page 100
"dcy" . In this step by step setup wxPropView (p. 74) has been started like this from the command line: wxPropView dcx=1 dcy=2 This will result in 1 display in horizontal direction and 2 in vertical direction. MATRIX VISION GmbH...
Page 101
(p. 74) 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 102
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 103
Figure 17: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...
As described above, after the device has been initialized successfully in the "Grid" area of the GUI the available "interface layout" properties are displayed in a hierarchy tree. GenICam (p. 155) is the default interface layout of the mvBlueFOX3 and we recommend to use it! wxPropView - Configuring a device: https://www.matrix-vision.com/tl_files/mv11/trainings/wxPropView/wx...
Page 105
• When an application shall be able to work with every MATRIX VISION device and every GigE Vision (p. 156) and GenICam (p. 155) compliant device both approaches make sense however a mixture between the 2 worlds can't be avoided.
Page 106
Standard Feature Naming Convention of GenICam properties (p. 159) 12.1.2.2 White balance of a camera device (color version) Start the wxPropView (p. 74) and initialize the device by clicking "Use" and start a "Continuous" acquisition. Figure 21: wxPropView - Continuous mode MATRIX VISION GmbH...
Page 107
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 22: wxPropView - Selecting WhiteBalance profile MATRIX VISION GmbH...
Page 108
(Analysis tabs). Whenever an event is send by the device that updates one of the properties a callback has been attached to, the output window will print a message with some information about the detected change. MATRIX VISION GmbH...
Page 109
12.1.2.5 Saving user settings in the non-volatile flash memory The mvBlueFOX3 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. 74) 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...
CONTENTS 12.2 mvDeviceConfigure mvDeviceConfigure (p. 100) is an interactive GUI tool to configure MATRIX VISION devices. It shows all connected devices. With mvDeviceConfigure (p. 100) it is possible e.g. • to check, if the camera is accessible on host PC, •...
Page 112
12.2.1.2 Step 2: Start firmware update • You have to close applications using the device and click Figure 27: mvDeviceConfigure - Close all applications • You have to select the update file – mvBlueFOX3: mvBlueFOX3_Update.mvu Figure 28: mvDeviceConfigure - Select firmware file Warning All current camera settings will be lost when updating the firmware.
Page 113
(versionInfo.txt and/or the manual to see if the update will fix your problem). The firmware update takes several minutes and during this time the application will not respond! MATRIX VISION GmbH...
This time is enough to cause image error counts! See also More informations about ACPI: http://en.wikipedia.org/wiki/Advanced_Configuration _and_Power_Interface To disable the power management on the processor level (so-called "C states"), you can use mvDevice Configure: MATRIX VISION GmbH...
Page 115
1. Start mvDeviceConfigure. 2. Go to tab and unselect "Settings" "CPU Idle States Enabled" Figure 33: mvDeviceConfigure - Settings The sleep states can also be enabled or disabled from a script by calling mvDeviceConfigure like this: mvDeviceConfigure.exe set_processor_idle_states=1 quit MATRIX VISION GmbH...
(if no suitable device is found) a device with a matching product string. The number of commands that can be passed to the application is not limited. MATRIX VISION GmbH...
Page 117
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 firmware version. DeviceTemperature deviceTemperature Device temperature. etc. related to the device and its sensor. MATRIX VISION offers also some information properties about the • FPGA – mvDeviceFPGAVersion • and the image sensor – mvDeviceSensorName – mvDeviceSensorColorMode 13.3 Image Format Control The "Image Format Control"...
• mvBayerRaw (the Bayer mosaic raw image) • mvFFCImage (the flat-field correction image (p. 200) ) Additionally, MATRIX VISION offers numerous additional features like: • mvMultiAreaMode which can be used to define multiple AOIs (Areas of Interests) in one image.
Page 121
1 us. Please check in the sensor summary (p. 64) if this fea- ture exists for the requested sen- sor. TriggerSelector triggerSelector Selects the type of trigger to con- figure. possible option TimestampReset. case about mvTimestampReset is available (p. 271). MATRIX VISION GmbH...
Page 122
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 123
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. 167) 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...
13.7 mv Logic Gate Control 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. 74) 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. 200) 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. 159)) CT Acquire (p. 157)) 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...
OutputValue. etc. related to the control of the general input and output pins of the device. Additionally, MATRIX VISION offers: • "mv Line Debounce Time Rising Edge" and • "mv Line Debounce Time Falling Edge" functionality. A description of these functions can be found in the use case Creating a debouncing filter at the inputs (p. 246).
13.14.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...
The purpose of a sequencer is to allow the user of a camera to define a series of feature sets for image acquisition which can consecutively be activated during the acquisition by the camera. Accordingly, the proposed sequence is MATRIX VISION GmbH...
• Off: Disables the sequencer. • On: Enables the sequencer. SequencerConfigurationMode sequencerConfigurationMode Controls if the sequencer config- uration mode is active. Possible values are: • Off: Disables the sequencer configuration mode. • On: Enables the sequencer configuration mode. MATRIX VISION GmbH...
Page 135
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 136
13.15 Sequencer Control 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 137
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: •...
Selects which physical network in- terface to control. GevMACAddress[GevInterface gevMACAddress MAC address of the network inter- Selector] face. GevMACAddress[GevInterface gevMACAddress MAC address of the network inter- Selector] face. GevStreamChannelSelector gevStreamChannelSelector Selects the stream channel to con- trol. MATRIX VISION GmbH...
Transport Layer Control. In this section MATRIX VISION provides a bandwidth control feature . 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.
First HDR Exposure in ppm. mvHDRExposure2 Second HDR Exposure in ppm. related to the control of the device High Dynamic Range parameters. The use case Adjusting sensor -x02d (-1012d) (p. 248) shows 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...
17.1.6 ISpecifyPropertyPages 17.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. 100) ("C:\Program Files\MATRIX VISION\mvI MPACT Acquire\bin") ! 17.3.1 Registering devices...
Page 146
17.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...
USB3 Vision (p. 161) device is bound to the system via a driver. Because a device can only be bound to one driver in the system, it could be possible that the mvBlueFOX3 is bound to another USB3 Vision (p.
Page 150
18.2 I cannot see the mvBlueFOX3 or I can see it but I cannot use it Note Please be sure, that you have already installed the mvGenTL_Acquire driver (p. 38). • Open the "Device Manager" from "Control Panel - System - Device Manager"...
Page 151
• Select the MATRIX VISON USB3 Vision driver called "USB3 Vision Device(Bound to MATRIX VISION !GmbH driver using libusbK)" and click on "Next" Figure 5: Select the MATRIX VISION driver Afterwards, the driver will be switched. • Finally, click on "Close" MATRIX VISION GmbH...
18.3 I get an oscillating frame rate Figure 6: Driver update was successful • Now, you can see, that the mvBlueFOX3 is bound to the MATRIX VISION driver via libusbK Figure 7: mvBlueFOX3 is bound to the MATRIX VISION driver via libusbK 18.3 I get an oscillating frame rate...
// <- Change the directory user@linux-desktop:/home/workspace/apps/mvPropView/x86/$ ./wxPropView // <- Start the executable Afterwards, several log files are generated which are listed in . The log files have the file files.mvloglist extension .mvlog. Please send these files to our support team. MATRIX VISION GmbH...
-2008 PROPHANDLING_UNSU One or more of the speci- This error might also be gen- PPORTED_PARAMETER fied parameters are not sup- erated if a certain feature is ported by the function. not available on the current platform.[-2008] MATRIX VISION GmbH...
Page 155
[-2012] -2013 PROPHANDLING_PROP The properties translation The properties translation _TRANSLATION_TABLE table has been corrupted. table has been corrupted _CORRUPTED for an unknown reason and can't be used anymore.[- 2013] MATRIX VISION GmbH...
Page 156
-2019 PROPHANDLING_COMP The specified component [-2019] ONENT_NOT_FOUND could not be found. -2020 PROPHANDLING_LIST_I An invalid list has been refer- [-2020] D_INVALID enced. MATRIX VISION GmbH...
Page 157
_REGISTERED callback has been registered for this component. -2031 PROPHANDLING_INPUT The user tried to read data [-2031] _BUFFER_TOO_SMALL into a user supplied storage location, but the buffer was too small to accommodate the result. MATRIX VISION GmbH...
Page 158
ID has been passed to the device man- ager or if the caller tried to close a device which cur- rently isn't initialized.[-2100] -2101 DMR_INIT_FAILED The device manager couldn't This is an internal error.[- be initialized. 2101] MATRIX VISION GmbH...
Page 160
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 161
'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 162
-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 163
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 164
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 165
[-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...
19 Glossary 19 Glossary Application programming interface (API). The standard API for MATRIX VISION products is called mvIMPACT_Acquire (p. 157). Common internet file system (CIFS) replaced Samba in 2006. CIFS It gets rid of NetBIOS packets an introduced Unix features like soft/hard links and allows larger files.
Page 167
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 168
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 169
In overlapped trigger mode, you have to keep in mind the following formula interval between two trigger events >= (readout time - exposure time) Sofware development kit (SDK). The standard image processing software library from MARTIX VISION is mvIMPACT. MATRIX VISION GmbH...
Page 170
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 171
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 172
• point it to the remote system. You won't need a password. Of course, you won't get a very fast live image display via the network with VNC but you should be able to start wxPropView (p. 74) and capture images. 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 174
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(); 20.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. 74) 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. 109) can be increased by reducing the image height. 20.2.3 Recording sequences with pre-trigger 20.2.3.1 What is pre-trigger? With pretrigger it is possible to record frames before and after a trigger event. MATRIX VISION GmbH...
Page 179
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 181
• 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 182
However, wxPropView offers a wizard (p. 176) 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 183
= "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 184
"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 185
CONTENTS 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 186
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 187
Figure 7: wxPropView - Info Plot shows the exposure times 20.2.4.3 Using the Sequencer Control wizard Since mvIMPACT Acquire 2.18.0 wxPropView (p. 74) offers a wizard for the Sequencer Control (p. 122) 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 189
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 190
(p. 74) 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 mvBlueFOX3. Figure 1: Principle of burst mode buffering of images Note The maximum buffer size can be found in "Setting -...
Page 193
Gev Stream Channel Selector - mv Gev SCBW Control". Figure 4: wxPropView - Setting the bandwidth using "mvGevSCBW" Now, the camera will buffer burst number of images in internal memory and readout at frames per second out. MATRIX VISION GmbH...
Page 194
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...
CONTENTS Figure 6: Principle of FrameBurstStart 20.2.7 Using VLC Media Player With the DirectShow Interface (p. 133) MATRIX VISION devices become a (acquisition) video device for the VLC Media Player. MATRIX VISION GmbH...
Page 196
• 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 197
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. 100) ("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.
20.2.8.1 System requirements • mvBlueCOUGAR-X – "firmware version" at least "1.6.32.0" • mvBlueFOX3 – "firmware version" at least "1.6.139.0" • mvBlueLYNX-X – free running line scan mode is available; the complete line scan functionality will be available in one of the next firmware updates...
Page 199
With regards to the external trigger signals provided by an incremental encoder (p. 227), there are two possible scenarios: 1. A conveyor belt runs continuously and so does the incremental encoder (p. 227), or - like in a reverse vending machine, MATRIX VISION GmbH...
Page 200
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 201
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 202
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" ) otherwise a paused trigger signal can be misinterpreted as a lost connection: MATRIX VISION GmbH...
20.2.9 Working with Event Control The mvBlueFOX3 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 204
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...
20.3.1 Correcting image errors of a sensor 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.
Page 206
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 207
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 208
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 209
"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 210
20.3 Improving the acquisition / image quality 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 211
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 212
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...
Of course host based settings can be used with all families of cameras (e.g. also mvBlueFOX). Host based settings are: • look-up table (LUTOperations) • color correction (ColorTwist) To show the different color behaviors, we take a color chart as a starting point: MATRIX VISION GmbH...
Page 214
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 215
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 216
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 217
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 218
20.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 219
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 220
20.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 221
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 222
20.3 Improving the acquisition / image quality Figure 15: Back level adjustment The image will look like this now: MATRIX VISION GmbH...
Page 223
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 224
20.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 225
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 226
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...
• reduce the noise in an image and • compensate motion in an image. MATRIX VISION implemented one version of the frame averaging: • "mvNTo1". This mode is a FPGA function which will not need any CPU of the host system. However, this mode is only available for the following cameras: •...
Page 228
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 229
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...
This means the camera must strictly be coupled to this frequency. In conjunction with auto exposure this can only be maintained by using a timer based generation of external trigger pulses. This is a behavior of both sensor types: CCD and CMOS. MATRIX VISION GmbH...
Page 231
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 232
20.3.4.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 233
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.
The last image shows, that you can reduce the noise, caused by the increased gain, using frame averaging (p. 216). 20.3.6 Minimizing sensor pattern of mvBlueFOX3-1100G Sometimes the gray scale version of Aptina's sensor MT9J003 shows structures comparable with Bayer patterns of color sensors.
Page 237
"Balance Ratio". However by using the property "Balance White Auto" you can balance the sensor automatically: Figure 2: Balance White Auto After balancing, we recommend to save these settings to a UserSet (p. 98). MATRIX VISION GmbH...
20.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 239
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 241
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. 120) This signal has to be connected with the digital inputs of the application. MATRIX VISION GmbH...
Page 242
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 245
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 246
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. 74) it will look like this: Figure 3: wxPropView - Logic gate setting 2 20.4.5 Detecting overtriggering 20.4.5.1 Scenario The image acquisition of a camera consists of two steps: MATRIX VISION GmbH...
Page 248
This trigger will start an acquisition after a rising edge signal on line 4 (= DigIn0 ). Now, set the two counters. Both counters ( Counter1 Counter2 ) will be reset and start after the acquisition AcquisitionStart ) has started. MATRIX VISION GmbH...
Page 249
CONTENTS 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 250
) 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 251
CONTENTS 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 253
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...
20.5 Working with I/Os Exposure Mode Timed Figure 2: Sample settings 20.5 Working with I/Os There are several use cases concerning I/Os: MATRIX VISION GmbH...
This means that the signal will be high for the exposure time and only while acquisition of the camera is active. Figure 1: Setting the "Line Source" to "mvExposureAndAcquisitionActive" Note This can be combined using an external trigger. MATRIX VISION GmbH...
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. 74) 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 258
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...
The HDR (High Dynamic Range) mode of the Aptina sensor increases the usable contrast range. This is achieved by dividing the integration time in three phases. The exposure time proportion of the three phases can be set independently. MATRIX VISION GmbH...
Page 260
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...
20.6.2 Adjusting sensor -x02e (-1013) / -x04e (-1020) 20.6.2.1 Introduction The HDR (High Dynamic Range) mode of the e2v sensors increases the usable contrast range. This is achieved by adjusting the logarithmic response of the pixels. MATRIX VISION GmbH...
Page 262
20.6 Working with HDR (High Dynamic Range Control) 20.6.2.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.
(T2 = T1 / Ratio). With wxPropView (p. 90) you can shift through the bits. • high dynamic mode (HDR) which compresses the 16 bit value to 12 bits using Adaptive Local Tone Mapping (ALTM) or by companding to 12 or 14 bits (figure 1). MATRIX VISION GmbH...
Page 264
Using the HDR mode, you have to do the following step: 1. Start wxPropView (p. 74) and 2. connect to the camera. 3. Then in "Setting - Base - Camera - GenICam - mv High Dynamic Range Control" you can enable the "mv HDR Enable". MATRIX VISION GmbH...
Page 265
1. Start wxPropView (p. 74) and 2. connect to the camera. mv Custom Data" you can set the "mv Sensor 3. Then in "Setting - Base - Camera - GenICam - Register" to "0x2400" and "mv Sensor Register Value" to "0x1". MATRIX VISION GmbH...
There are several use cases concerning LUTs (Look-Up-Tables): 20.7.1 Introducing LUTs 20.7.1.1 Introduction Look-Up-Tables (LUT) are used to transform input data into a desirable output format. For example, if you want to invert an 8 bit image, a Look-Up-Table will look like the following: MATRIX VISION GmbH...
Page 267
• the LUT operations are independent of the transmission bit depth. 20.7.1.2 Setting the hardware based LUTs via LUT Control On the mvBlueFOX3 using wxPropView (p. 74), you will find the LUT Control (p. 120) via "Setting - Base -...
Page 268
20.7 Working with LUTs 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 269
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 270
To get an inverted 8 bit mono image like shown in Figure 1, you can set the LUT using wxPropView (p. 74). After starting wxPropView (p. 74) 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 272
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. MATRIX VISION GmbH...
(= 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 274
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, • 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.
Page 276
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...
Addtitionally, you can select, which user set comes up after hard reset. Attention The storage of user data in the registry can still override user set data! User sets are cleared after firmware change. MATRIX VISION GmbH...
Page 278
• "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...
(p. 74) offers a wizard for the File Access Control (p. 119) usage: 1. Click on "Setting - Base - Camera - GenICam - File Access Control - File Selector - File Operator Selector". Now, the "Wizard" button becomes active. MATRIX VISION GmbH...
Page 280
20.8 Saving data on the device 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 281
Figure 3: wxPropView - Download / Upload dialog 4. Select "UserFile" follow the instructions. 20.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...
– to synchronize timestamp of multitude of cameras. The latter sample, can be achieved by follwing steps: 1. Define the input line ("TriggerSource") to reset the timestamp, e.g. "Line5" and 2. set the "Trigger Selector" to "mvTimestampReset". MATRIX VISION GmbH...
Page 283
- to reset all timestamps either by hardware signal or by command and regularly resynchronize or check the drift algorithmically - in order to make sure that the drift is less half an image frame time. 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 285
The task of resetting the counter at the beginning of the acquisition can be done by setting the reset property accordingly. Of course is this all independent whether the camera is acquiring images in triggered or continuous mode. MATRIX VISION GmbH...
• "mvIMPACT Acquire driver version" at least "2.17.1" 20.9.3.2 Introduction It is possible to switch the mvBlueFOX3 into a power down mode (standby) either • by changing the property "mvDevicePowerMode" to "mvStandby" or • by enabling the automatic power down mode by setting the property "mvDeviceStandbyTimeoutEnable" to "bTrue"...
Page 287
"mv Device Standby Timeout Enable" and 4. set the time in seconds via "mv Device Standby Timeout" after which the camera switches to standby if no register was read. Figure 2: wxPropView: mv Device Standby Timeout Enable MATRIX VISION GmbH...
One camera is used as master (M), which generates the trigger signal. The other ones receive the trigger signal and act as slaves (S). 20.10.1.2.1 Connecting the cameras The connection of the mvBlueFOX3 cameras should be like this: Figure 1: Master - Slave connecting Symbol...
Page 289
// Set Digital I/O GenICam::DigitalIOControl io(pDev); io.lineSelector.writeS( "Line0" io.lineSource.writeS( "Timer2Active" See also Digital I/O Control (p. 120) 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 290
By the way, this is a simple "pulse width modulation (PWM)" example. 20.10.1.4 Setting the synchronized acquisition using wxPropView The following figures show, how you can set the timers and trigger using the GUI tool wxPropView (p. 74) 1. Setting of Timer1 (blue box) on the master camera: MATRIX VISION GmbH...
Page 291
3. Setting the trigger slave camera(s) - The red box in Figure 5 is showing "Master - Slave"), which means that the master is triggered internally and the slave camera is set as shown in Figure 4. MATRIX VISION GmbH...
Page 292
20.10 Working with several camera simultaneously 4. Assigning timer to DigOut (orange box in Figure 3). Figure 5: Trigger setting of the master camera using "Master - Slave" MATRIX VISION GmbH...
CONTENTS 21 Appendix A.1 Pregius CMOS specific camera / sensor data 21.1 mvBlueFOX3-2004 (0.4 Mpix [1456 x 1088]) 21.1.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
21.1 mvBlueFOX3-2004 (0.4 Mpix [1456 x 1088]) Figure 2: Spectral sensitivity mvBlueFOX3-2004C 21.1.3 Timings Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS 21.1.3.1 Free running mode In free running mode, the sensor reaches its maximum frame rate. This is done by overlapping erase, exposure and readout phase.
Page 295
"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...
21.2 mvBlueFOX3-2016 (1.6 Mpix [1456 x 1088]) "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 "...
Page 298
21.2 mvBlueFOX3-2016 (1.6 Mpix [1456 x 1088]) Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS 21.2.3.1 Free running mode In free running mode, the sensor reaches its maximum frame rate. This is done by overlapping erase, exposure and readout phase.
"TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = AnyEdge" "ExposureMode = Timed" 21.2.4 Device Feature And Property List 21.2.4.1 Gray scale version 21.2.4.2 Color version MATRIX VISION GmbH...
21.3 mvBlueFOX3-2024 (2.4 Mpix [1936 x 1216]) 21.3 mvBlueFOX3-2024 (2.4 Mpix [1936 x 1216]) 21.3.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential. Feature Description Manufacturer...
CONTENTS Figure 2: Spectral sensitivity mvBlueFOX3-2024C 21.3.3 Timings Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS 21.3.3.1 Free running mode In free running mode, the sensor reaches its maximum frame rate. This is done by overlapping erase, exposure and readout phase.
Page 302
21.3 mvBlueFOX3-2024 (2.4 Mpix [1936 x 1216]) Note The exposure time step width is limited to the sensor's row time of 4.86 us and therefore - auto exposure with very low exposure times will perform with relatively large increments and...
21.3.4 Device Feature And Property List 21.3.4.1 Gray scale version 21.3.4.2 Color version 21.4 mvBlueFOX3-2024a (2.4 Mpix [1936 x 1216]) 21.4.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
21.4 mvBlueFOX3-2024a (2.4 Mpix [1936 x 1216]) "TriggerSelector = OnLowLevel Start an exposure of a frame as AcquisitionActive" long as the trigger input is below the trigger threshold. (No Frame "TriggerMode = On" "TriggerSource = Trigger!) desired Line " "TriggerActivation = LevelLow"...
CONTENTS 21.5 mvBlueFOX3-2032 (3.2 Mpix [2064 x 1544]) 21.5.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential. Feature Description Manufacturer Sensor Sensor name IMX252 Max. frames per second...
21.5 mvBlueFOX3-2032 (3.2 Mpix [2064 x 1544]) Figure 2: Spectral sensitivity mvBlueFOX3-2032C 21.5.3 Timings Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS 21.5.3.1 Free running mode In free running mode, the sensor reaches its maximum frame rate. This is done by overlapping erase, exposure and readout phase.
Page 309
"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...
21.6 mvBlueFOX3-2032a (3.2 Mpix [2064 x 1544]) "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 "...
Page 312
21.6 mvBlueFOX3-2032a (3.2 Mpix [2064 x 1544]) Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS 21.6.3.1 Free running mode In free running mode, the sensor reaches its maximum frame rate. This is done by overlapping erase, exposure and readout phase.
Page 313
OnAnyEdge Start the exposure of a frame when FrameStart" the trigger input level changes from high to low or from low to high. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = AnyEdge" "ExposureMode = Timed" MATRIX VISION GmbH...
21.7 mvBlueFOX3-2051 (5.1 Mpix [2464 x 2056]) 21.6.4 Device Feature And Property List 21.6.4.1 Gray scale version 21.6.4.2 Color version 21.7 mvBlueFOX3-2051 (5.1 Mpix [2464 x 2056]) 21.7.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
Page 316
21.7 mvBlueFOX3-2051 (5.1 Mpix [2464 x 2056]) Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS 21.7.3.1 Free running mode In free running mode, the sensor reaches its maximum frame rate. This is done by overlapping erase, exposure and readout phase.
Page 317
OnAnyEdge Start the exposure of a frame when FrameStart" the trigger input level changes from high to low or from low to high. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = AnyEdge" "ExposureMode = Timed" MATRIX VISION GmbH...
21.8 mvBlueFOX3-2051a (5.1 Mpix [2464 x 2056]) 21.7.4 Device Feature And Property List 21.7.4.1 Gray scale version 21.7.4.2 Color version 21.8 mvBlueFOX3-2051a (5.1 Mpix [2464 x 2056]) 21.8.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
Page 320
21.8 mvBlueFOX3-2051a (5.1 Mpix [2464 x 2056]) Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS 21.8.3.1 Free running mode In free running mode, the sensor reaches its maximum frame rate. This is done by overlapping erase, exposure and readout phase.
Page 321
OnAnyEdge Start the exposure of a frame when FrameStart" the trigger input level changes from high to low or from low to high. "TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = AnyEdge" "ExposureMode = Timed" MATRIX VISION GmbH...
21.9 mvBlueFOX3-2064 (6.4 Mpix [1456 x 1088]) 21.8.4 Device Feature And Property List 21.8.4.1 Gray scale version 21.8.4.2 Color version 21.9 mvBlueFOX3-2064 (6.4 Mpix [1456 x 1088]) 21.9.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
Page 324
21.9 mvBlueFOX3-2064 (6.4 Mpix [1456 x 1088]) Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS 21.9.3.1 Free running mode In free running mode, the sensor reaches its maximum frame rate. This is done by overlapping erase, exposure and readout phase.
"TriggerMode = On" "TriggerSource = desired Line " "TriggerActivation = AnyEdge" "ExposureMode = Timed" 21.9.4 Device Feature And Property List 21.9.4.1 Gray scale version 21.9.4.2 Color version MATRIX VISION GmbH...
21.10 mvBlueFOX3-2089 (8.9 Mpix [4112 x 2176]) 21.10 mvBlueFOX3-2089 (8.9 Mpix [4112 x 2176]) 21.10.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential. Feature Description Manufacturer...
CONTENTS Figure 2: Spectral sensitivity mvBlueFOX3-2089C 21.10.3 Timings Name Value InternalLineLength VerticalBlankLines SensorInClock 74.25 (@50 MHz Pixel clock) NumberOfLVDS 21.10.3.1 Free running mode In free running mode, the sensor reaches its maximum frame rate. This is done by overlapping erase, exposure and readout phase.
Page 328
21.10 mvBlueFOX3-2089 (8.9 Mpix [4112 x 2176]) 21.10.3.2 Frame rate calculator 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.
21.10.4 Device Feature And Property List 21.10.4.1 Gray scale version 21.10.4.2 Color version 21.11 mvBlueFOX3-2089a (8.9 Mpix [4112 x 2176]) 21.11.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
21.11 mvBlueFOX3-2089a (8.9 Mpix [4112 x 2176]) Note Max. AOI width of color version is 4096 pixels. 21.11.2 Spectral Sensitivity Figure 1: Spectral sensitivity mvBlueFOX3-2089aG Figure 2: Spectral sensitivity mvBlueFOX3-2089aC 21.11.3 Timings MATRIX VISION GmbH...
Page 331
- 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: MATRIX VISION GmbH...
21.11.4 Device Feature And Property List 21.11.4.1 Gray scale version 21.11.4.2 Color version 21.12 mvBlueFOX3-2124 (12.4 Mpix [4112 x 3008]) 21.12.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
21.12 mvBlueFOX3-2124 (12.4 Mpix [4112 x 3008]) Note Max. AOI width of color version is 4096 pixels. 21.12.2 Spectral Sensitivity Figure 1: Spectral sensitivity mvBlueFOX3-2124G Figure 2: Spectral sensitivity mvBlueFOX3-2124C 21.12.3 Timings MATRIX VISION GmbH...
Page 335
- 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: MATRIX VISION GmbH...
21.12.4 Device Feature And Property List 21.12.4.1 Gray scale version 21.12.4.2 Color version 21.13 mvBlueFOX3-2124a (12.4 Mpix [4112 x 3008]) 21.13.1 Introduction The sensor uses a global shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
21.13 mvBlueFOX3-2124a (12.4 Mpix [4112 x 3008]) Note Max. AOI width of color version is 4096 pixels. 21.13.2 Spectral Sensitivity Figure 1: Spectral sensitivity mvBlueFOX3-2124aG Figure 2: Spectral sensitivity mvBlueFOX3-2124aC 21.13.3 Timings MATRIX VISION GmbH...
Page 339
- 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: MATRIX VISION GmbH...
22.1 mvBlueFOX3-1012b (1.2 Mpix [1280 x 960]) 22 Appendix A.2 CMOS specific camera / sensor data 22.1 mvBlueFOX3-1012b (1.2 Mpix [1280 x 960]) 22.1.1 Introduction The sensor uses a pipelined global snapshot shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
CONTENTS Figure 1: Spectral sensitivity mvBlueFOX3-1012dG Figure 2: Spectral sensitivity mvBlueFOX3-1012dC 22.1.3 Timings Name Value PixelClock 40 & 66 VerticalBlank 22.1.3.1 Free running mode To calculate the maximum frames per second (FPS ) in free running mode you will need following formula:...
22.2 mvBlueFOX3-1012d (1.2 Mpix [1280 x 960]) 22.1.3.2 Snapshot mode To calculate the maximum frames per second (FPS ) in snapshot mode you will need following formula: (ImageHeight * ( 1650 )) + ((VerticalBlank+2) * 1650 FrameTime = ------------ ------------...
1280 (H) x 960 (V) Unit cell size 3.75um (H) x 3.75um (V) ADC resolution / output 12 bit 8/10/(12) Measured accord. to EMVA1288 with gray scale version of the camera 22.2.2 Spectral Sensitivity Figure 2: Spectral sensitivity mvBlueFOX3-1012dG MATRIX VISION GmbH...
22.2 mvBlueFOX3-1012d (1.2 Mpix [1280 x 960]) Figure 3: Spectral sensitivity mvBlueFOX3-1012dC 22.2.3 Timings Name Value PixelClock 40 & 74,25 VerticalBlank 22.2.3.1 Free running mode To calculate the maximum frames per second (FPS ) in free running mode you will need following formula:...
22.2.4 Device Feature And Property List 22.2.4.1 Gray scale version 22.2.4.2 Color version 22.3 mvBlueFOX3-1013 (1.3 Mpix [1280 x 1024]) 22.3.1 Introduction The sensor uses a pipelined global snapshot shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
22.3 mvBlueFOX3-1013 (1.3 Mpix [1280 x 1024]) Measured accord. to EMVA1288 with gray scale version of the camera 22.3.2 Spectral Sensitivity Figure 1: mvBlueFOX3-1013 22.3.3 Timings Name Value InternalLineLength InternalADCClock 118.75 22.3.3.1 Free running mode To calculate the maximum frames per second (FPS...
Page 349
. However, if an external (line) trigger will have to be used, it is absolutely required that the external trigger is always present. During a trigger interrup- tion, controlling or communication to the camera is not possible! MATRIX VISION GmbH...
22.4 mvBlueFOX3-1020 (1.9 Mpix [1600 x 1200]) 22.3.4 Device Feature And Property List 22.3.4.1 Gray scale version 22.3.4.2 Enhanced Infrared version 22.3.4.3 Color version 22.4 mvBlueFOX3-1020 (1.9 Mpix [1600 x 1200]) 22.4.1 Introduction The sensor uses a pipelined global snapshot shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
CONTENTS 22.4.2 Spectral Sensitivity Figure 1: mvBlueFOX3-1020 22.4.3 Timings Name Value InternalLineLength InternalADCClock 22.4.3.1 Free running mode To calculate the maximum frames per second (FPS ) in free running mode you will need following formula: ImageHeight + 10 ReadOutTime =...
Page 352
22.4 mvBlueFOX3-1020 (1.9 Mpix [1600 x 1200]) 22.4.3.2 Snapshot mode To calculate the maximum frames per second (FPS ) in snapshot mode you will need following formula: ImageHeight + 10 ReadOutTime = InternalLineLength * ---------------- * (-----------------) InternalADCClock 1000 1000...
22.4.4 Device Feature And Property List 22.4.4.1 Gray scale version 22.4.4.2 Color version 22.5 mvBlueFOX3-1020a (1.9 Mpix [1600 x 1200]) 22.5.1 Introduction The sensor uses a pipelined global snapshot shutter, i.e. light exposure takes place on all pixels in parallel, although subsequent readout is sequential.
22.5 mvBlueFOX3-1020a (1.9 Mpix [1600 x 1200]) 22.5.2 Spectral Sensitivity Figure 1: mvBlueFOX3-1020a 22.5.3 Timings Name Value InternalLineLength InternalADCClock 142. 22.5.3.1 Free running mode To calculate the maximum frames per second (FPS ) in free running mode you will need following formula:...
Page 355
. However, if an external (line) trigger will have to be used, it is absolutely required that the external trigger is always present. During a trigger interrup- tion, controlling or communication to the camera is not possible! MATRIX VISION GmbH...
22.6 mvBlueFOX3-1031 (3.2 Mpix [2048 x 1536]) 22.5.3.4 Frame rate calculator (line scan mode) 22.5.4 Device Feature And Property List 22.5.4.1 Gray scale version 22.5.4.2 Color version 22.6 mvBlueFOX3-1031 (3.2 Mpix [2048 x 1536]) 22.6.1 Introduction The sensor features several acquisition modes ( "mv Shutter Mode"...
2064 x 1578 (V) Unit cell size 2.2µm (H) x 2.2µm (V) ADC resolution / output 12 bit 8/10/12 Not quantifiable according to EMVA1288 22.6.2 Spectral Sensitivity Figure 2: Spectral sensitivity mvBlueFOX3-1031C 22.6.3 Timings Name Value PixelClock 74.25 VerticalBlank 22.6.3.1 Free running mode...
22.7 mvBlueFOX3-1100 (11 Mpix [3856 x 2764]) (ImageHeight * ( 2176 )) + (VerticalBlank * 2176 FrameTime = ------------ ------------ PixelClock PixelClock 1000000 FPS_max = ---------------- FrameTime 22.6.3.2 Snapshot mode To calculate the maximum frames per second (FPS ) in snapshot mode you will need following formula:...
Page 359
Thus, the gray value factor of the first line, which is similar to the one of the rolling shutter, is different to the factor of the last line: ExposureTime2 + FrameTime GreyValueFactor (last line) = ------------------------- ExposureTime1 + FrameTime MATRIX VISION GmbH...
CONTENTS Figure 4: Spectral sensitivity mvBlueFOX3-1100C 22.7.3 Timings Name Value PixelClock 81.25 VerticalBlank 22.7.3.1 Free running mode To calculate the maximum frames per second (FPS ) in free running mode you will need following formula: (ImageHeight * ( 1648 )) + (VerticalBlank *...
22.8 mvBlueFOX3-1140 (14 Mpix [4384 x 3288]) 22.7.4 Device Feature And Property List 22.7.4.1 Gray scale version 22.7.4.2 Color version 22.8 mvBlueFOX3-1140 (14 Mpix [4384 x 3288]) 22.8.1 Introduction The sensor features several acquisition modes ( "mv Shutter Mode" • rolling shutter ( "mvRollingShutter"...
Page 363
ExposureTime2 + FrameTime GreyValueFactor (last line) = ------------------------- ExposureTime1 + FrameTime With 80 MHz, for example, the FrameTime is about 194 ms. I.e, doubling from e.g. 1ms to 2ms won't be visible effectively. MATRIX VISION GmbH...
) in snapshot mode you will need following formula: (ImageHeight * ( 4702 )) + (VerticalBlank * 4702 FrameTime = ------------ ------------ PixelClock PixelClock 1000000 FPS_max = ---------------- ExposureTime 22.8.4 Device Feature And Property List 22.8.4.1 Color version MATRIX VISION GmbH...
Need help?
Do you have a question about the mvBlueFOX3 and is the answer not in the manual?
Questions and answers