Matrix Vision mvBlueFOX3 User manual

mvBlueFOX3
Technical Manual
English - Version 1.55

CONTENTS i
Contents
1 About this manual 2
1.1 Goal of the manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 Contents of the manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2 Migration Guide 4
2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.2 Hardware revision 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3 Imprint 5
3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.2 wxWidgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.3 Sarissa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.4 GenICam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.5 libusb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.6 libusbK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.6.1 libusbK license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.7 Doxygen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.7.1 Doxygen license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3.8 SHA1 algorithm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.9 Expat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.9.1 Expat Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.10 CppUnit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.11 NUnit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3.11.1 NUnit License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
4 Legal notice 9
4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.2 cJSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.2.1 cJSON license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.3 Unity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.3.1 Unity license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
MATRIX VISION GmbH

ii CONTENTS
5 Revisions 11
6 Graphic Symbols 18
6.1 Notes, Warnings, Attentions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
6.2 Webcasts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
7 Important information 19
7.1 Important safety instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
7.2 Operating considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
7.2.1 Important safety notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
7.2.2 Handling and cleaning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
7.2.3 Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
7.2.4 Optimizing performance and life time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
7.2.5 Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
7.2.6 Cleaning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
7.2.7 Adjusting the C-mount (mvBlueFOX3-2xxx-1xxx) . . . . . . . . . . . . . . . . . . . . . . 21
7.2.8 Adjusting the C-mount (mvBlueFOX3-2xxx-2xxx) . . . . . . . . . . . . . . . . . . . . . . 22
7.3 European Union Declaration of Conformity statement . . . . . . . . . . . . . . . . . . . . . . . . 22
7.4 Legal notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
7.4.1 For customers in the U.S.A. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
7.4.2 For customers in Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
7.4.3 Pour utilisateurs au Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
8 Introduction 29
8.1 Software concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
8.2 Order code nomenclatures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
8.2.1 mvBlueFOX3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
8.2.2 mvBlueFOX3-M1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
8.2.3 mvBlueFOX3-M2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8.2.4 Ordering code samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8.3 What's inside and accessories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
8.3.1 Accessories for the mvBlueFOX3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
MATRIX VISION GmbH

CONTENTS iii
9 Quickstart 34
9.1 Driver concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
9.1.1 NeuroCheck support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
9.1.2 VisionPro support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9.1.3 HALCON support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9.1.4 LabVIEW support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9.1.5 DirectShow support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9.1.6 Micro-Manager support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
9.2 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.2.1 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.2.2 Installing the mvGenTL-Acquire driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
9.2.3 Connecting the camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
9.3 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
9.3.1 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
9.3.2 Installing the mvGenTL-Acquire driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
9.3.3 Connecting the camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
9.3.4 Defining udev rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
9.3.5 Optimizing USB performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
9.4 Relationship between driver, firmware, FPGA file and user settings . . . . . . . . . . . . . . . . . 48
9.5 Settings behaviour during startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
10 Technical data 53
10.1 Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
10.1.1 Standard model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
10.1.2 Standard model -2xxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
10.1.3 Model without housing (-M1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
10.1.4 Model without housing (-M2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
10.2 Camera interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
10.2.1 Circular connector male (Power / Digital I/O) . . . . . . . . . . . . . . . . . . . . . . . . . 60
10.2.2 Characteristics of the digital inputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
10.2.3 Characteristics of the digital outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
10.3 Status / Power LED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
10.3.1 Standard model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
10.3.2 Standard model -2xxx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
10.4 Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
MATRIX VISION GmbH

iv CONTENTS
11 Sensor overview 65
11.1 Image data flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
11.2 Output sequence of color sensors (RGB Bayer) . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
11.3 CMOS sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
11.3.1 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
11.3.2 Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
11.4 Supported image formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
12 Filters and Lenses 73
12.1 Hot mirror filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
12.2 Cold mirror filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
12.3 Glass filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
12.4 Lenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
13 Application Usage 75
13.1 wxPropView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
13.1.1 How to work with wxPropView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
13.1.2 How to configure a device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
13.1.3 Command-line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
13.2 mvDeviceConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
13.2.1 How to update the firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
13.2.2 Preserving UserSet settings when updating the Firmware . . . . . . . . . . . . . . . . . . 104
13.2.3 How to disable CPU sleep states a.k.a. C states (<Windows 8) . . . . . . . . . . . . . . 104
13.2.4 Command-line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
MATRIX VISION GmbH

CONTENTS v
14 GenICam and Advanced Features 108
14.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
14.2 Device Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
14.3 Image Format Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
14.4 Acquisition Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
14.5 Counter And Timer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
14.6 Analog Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
14.7 mv Logic Gate Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
14.8 Color Transformation Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
14.9 mv Flat Field Correction Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
14.10Event Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
14.11Chunk Data Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
14.12File Access Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
14.13mv Serial Interface Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
14.14Digital I/O Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
14.15Encoder Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
14.16LUT Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
14.16.1 mvLUTType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
14.16.2 mvLUTInputData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
14.16.3 mvLUTMapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
14.16.4 LUT support in MATRIX VISION cameras . . . . . . . . . . . . . . . . . . . . . . . . . . 124
14.17Sequencer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
14.17.1 Sequencer overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
14.17.2 Configuration of a sequencer set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
14.18Transport Layer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
14.19User Set Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
14.20mv Frame Average Control (only with specific models) . . . . . . . . . . . . . . . . . . . . . . . . 131
14.21mv High Dynamic Range Control (only with specific sensor models) . . . . . . . . . . . . . . . . . 132
15 C developers 133
MATRIX VISION GmbH

vi CONTENTS
16 C++ developers 134
17 .NET developers 135
18 Python developers 136
18.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
18.2 Building . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
18.2.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
18.2.2 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
18.3 Using . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
19 DirectShow Interface 140
19.1 Supported Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
19.1.1 IAMCameraControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
19.1.2 IAMDroppedFrames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
19.1.3 IAMStreamConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
19.1.4 IAMVideoProcAmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
19.1.5 IKsPropertySet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
19.1.6 ISpecifyPropertyPages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
19.2 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
19.3 Registering and renaming devices for DirectShow usage . . . . . . . . . . . . . . . . . . . . . . . 141
19.3.1 Registering devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
19.3.2 Renaming devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
19.3.3 Make silent registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
20 Troubleshooting 145
20.1 There are Image Error Counts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
20.2 I cannot see the mvBlueFOX3 or I can see it but I cannot use it . . . . . . . . . . . . . . . . . . . 145
20.3 I get an oscillating frame rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
20.4 Accessing log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
20.4.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
20.4.2 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
20.5 Why does updating the device list take so long . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
20.6 Error code list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
MATRIX VISION GmbH

CONTENTS vii
21 Glossary 164
22 Use cases 171
22.1 GenICam to mvIMPACT Acquire code generator . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
22.1.1 Using the code generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
22.1.2 Using the result of the code generator in an application . . . . . . . . . . . . . . . . . . . 173
22.2 Introducing acquisition / recording possibilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
22.2.1 Acquiring a number of images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
22.2.2 Recording sequences in the camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
22.2.3 Recording sequences with pre-trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
22.2.4 Creating acquisition sequences (Sequencer Control) . . . . . . . . . . . . . . . . . . . . 178
22.2.5 Generating very long exposure times . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
22.2.6 Working with multiple AOIs (mv Multi Area Mode) . . . . . . . . . . . . . . . . . . . . . . 191
22.2.7 Working with burst mode buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
22.2.8 Using VLC Media Player . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
22.2.9 Using the linescan mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
22.2.10 Working with Event Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
22.3 Improving the acquisition / image quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
22.3.1 Correcting image errors of a sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
22.3.2 Optimizing the color fidelity of the camera . . . . . . . . . . . . . . . . . . . . . . . . . . 215
22.3.3 Reducing noise by frame averaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
22.3.4 Optimizing the bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
22.3.5 Setting a flicker-free auto expose and auto gain . . . . . . . . . . . . . . . . . . . . . . . 233
22.3.6 Working with binning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
22.3.7 Minimizing sensor pattern of mvBlueFOX3-1100G . . . . . . . . . . . . . . . . . . . . . . 239
22.4 Working with triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
22.4.1 Processing triggers from an incremental encoder . . . . . . . . . . . . . . . . . . . . . . 241
22.4.2 Generating a pulse width modulation (PWM) . . . . . . . . . . . . . . . . . . . . . . . . . 245
22.4.3 Outputting a pulse at every other external trigger . . . . . . . . . . . . . . . . . . . . . . 247
22.4.4 Creating different exposure times for consecutive images . . . . . . . . . . . . . . . . . . 249
22.4.5 Detecting overtriggering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
MATRIX VISION GmbH

viii CONTENTS
22.4.6 Triggering of an indefinite sequence with precise starting time . . . . . . . . . . . . . . . . 256
22.5 Working with I/Os . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
22.5.1 Controlling strobe or flash at the outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
22.5.2 Compensating delay of strobe or flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
22.5.3 Creating a debouncing filter at the inputs . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
22.6 Working with HDR (High Dynamic Range Control) . . . . . . . . . . . . . . . . . . . . . . . . . . 263
22.6.1 Adjusting sensor -x02d (-1012d) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
22.6.2 Adjusting sensor -x02e (-1013) / -x04e (-1020) . . . . . . . . . . . . . . . . . . . . . . . . 265
22.6.3 Adjusting sensor -1031C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
22.7 Working with LUTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
22.7.1 Introducing LUTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
22.7.2 Working with LUTValueAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
22.7.3 Implementing a hardware-based binarization . . . . . . . . . . . . . . . . . . . . . . . . . 276
22.8 Saving data on the device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
22.8.1 Creating user data entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
22.8.2 Creating user set entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
22.8.3 Working with the UserFile section (Flash memory) . . . . . . . . . . . . . . . . . . . . . . 282
22.9 Working with device features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
22.9.1 Reset timestamp by hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
22.9.2 Synchronizing camera timestamps without IEEE 1588 . . . . . . . . . . . . . . . . . . . . 287
22.9.3 Using the standby mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
22.9.4 Working with the serial interface (mv Serial Interface Control) . . . . . . . . . . . . . . . . 292
22.10Working with several cameras simultaneously . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
22.10.1 Creating synchronized acquisitions using timers . . . . . . . . . . . . . . . . . . . . . . . 295
MATRIX VISION GmbH

CONTENTS ix
23 Appendix A.1 Pregius CMOS specific camera / sensor data 300
23.1 mvBlueFOX3-2004 (0.4 Mpix [728 x 544]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
23.1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
23.1.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
23.1.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
23.1.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
23.2 mvBlueFOX3-2016 (1.6 Mpix [1456 x 1088]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
23.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
23.2.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
23.2.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
23.2.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
23.3 mvBlueFOX3-2024 (2.4 Mpix [1936 x 1216]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
23.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
23.3.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
23.3.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
23.3.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
23.4 mvBlueFOX3-2024a (2.4 Mpix [1936 x 1216]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
23.4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
23.4.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
23.4.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
23.4.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
23.5 mvBlueFOX3-2032 (3.2 Mpix [2064 x 1544]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
23.5.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
23.5.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
23.5.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
23.5.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
23.6 mvBlueFOX3-2032a (3.2 Mpix [2064 x 1544]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
23.6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
23.6.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
23.6.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
MATRIX VISION GmbH

x CONTENTS
23.6.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
23.7 mvBlueFOX3-2051 (5.1 Mpix [2464 x 2056]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
23.7.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
23.7.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
23.7.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
23.7.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
23.8 mvBlueFOX3-2051a (5.1 Mpix [2464 x 2056]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
23.8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
23.8.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
23.8.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
23.8.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
23.9 mvBlueFOX3-2089 (8.9 Mpix [4112 x 2176]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
23.9.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
23.9.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
23.9.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
23.9.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
23.10mvBlueFOX3-2089a (8.9 Mpix [4112 x 2176]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
23.10.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
23.10.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
23.10.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
23.10.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
23.11mvBlueFOX3-2124 (12.4 Mpix [4112 x 3008]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
23.11.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
23.11.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
23.11.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
23.11.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
23.12mvBlueFOX3-2124a (12.4 Mpix [4112 x 3008]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
23.12.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
23.12.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
23.12.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
23.12.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
MATRIX VISION GmbH

CONTENTS xi
24 Appendix A.2 Starvis CMOS specific camera / sensor data 342
24.1 mvBlueFOX3-2064 (6.4 Mpix [3096 x 2080]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
24.1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
24.1.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
24.1.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
24.1.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
25 Appendix A.3 CMOS specific camera / sensor data 346
25.1 mvBlueFOX3-1012b (1.2 Mpix [1280 x 960]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
25.1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
25.1.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
25.1.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
25.1.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
25.2 mvBlueFOX3-1012d (1.2 Mpix [1280 x 960]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
25.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
25.2.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
25.2.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
25.2.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
25.3 mvBlueFOX3-1013 (1.3 Mpix [1280 x 1024]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
25.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
25.3.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
25.3.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
25.3.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
25.4 mvBlueFOX3-1020 (1.9 Mpix [1600 x 1200]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
25.4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
25.4.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
25.4.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
25.4.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
25.5 mvBlueFOX3-1020a (1.9 Mpix [1600 x 1200]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
25.5.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
25.5.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
MATRIX VISION GmbH

CONTENTS 1
25.5.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
25.5.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
25.6 mvBlueFOX3-1031 (3.2 Mpix [2048 x 1536]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
25.6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
25.6.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
25.6.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
25.6.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
25.7 mvBlueFOX3-1100 (11 Mpix [3856 x 2764]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
25.7.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
25.7.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
25.7.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
25.7.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
25.8 mvBlueFOX3-1140 (14 Mpix [4384 x 3288]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
25.8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
25.8.2 Spectral Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
25.8.3 Timings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
25.8.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
MATRIX VISION GmbH

2 CONTENTS
1 About this manual
1.1 Goal of the manual
This manual gives you an overview of the mvBlueFOX3, MATRIX VISION's compact USB 3.0 industrial camera
family compliant to USB3 Vision, its technical data and basic operation of the mvBlueFOX3. Programming the
device is detailed in a separate documentation, which will be available in an online format.
The mvBlueFOX3 manual is based on a modular concept and contains several individual books. That means like in
many object-oriented programming languages you have for each functionality your own "class". Instead of classes,
you have books. For example, if you want to know anything about the GUI based applications, then you have to go
to the Application Usage (p. 75) book. If you want to know how images are acquired with the mvBlueFOX3, have
a look in the respective programming language chapter.
1.2 Contents of the manual
At the beginning of the manual, you will get an introduction (p. 29) to the possible usages of the camera. The
further chapters contain general information about the mvBlueFOX3 including:
• how to install the mvBlueFOX3 for the first time (p. 34) followed by
•Technical data (p. 53)
•Sensor overview (p. 65)
•Filters and Lenses (p. 73)
The general information is followed by the description of the
•software tools for mvBlueFOX3 (p. 75) including the tools
– wxPropView (p. 75)
– mvDeviceConfigure (p. 101)
•GenICam and Advanced Features (p. 108) introduces the GenICam and the Advanced features of the mv -
BlueFOX3 (The mvBlueFOX3 is a GenICam / USB3 Vision compliant camera).
•DirectShow developers (p. 140) documents MATRIX VISION's DirectShow_acquire interface.
•Troubleshooting (p. 145) shows how to detect damages and other inconveniences.
•Use cases (p. 171) describes solutions for general tasks and
• A Glossary (p. 164) explains abbreviations and technical terms.
•Appendix A.1 Pregius CMOS specific camera / sensor data (p. 300) contains all data of the Pregius CMOS
sensors like timings, details of operation, etc.
•Appendix A.2 Starvis CMOS specific camera / sensor data (p. 342) contains all data of the Starvis CMOS
sensors like timings, details of operation, etc.
•Appendix A.3 CMOS specific camera / sensor data (p. 346) contains all data of the other CMOS sensors
like timings, details of operation, etc.
MATRIX VISION GmbH

1.2 Contents of the manual 3
Note
For C, C++, .NET developers, there are separate mvIMPACT Acquire manuals
•"mvIMPACT_Acquire_API_CPP_manual.chm",
•"mvIMPACT_Acquire_API_C_manual.chm", and
•"mvIMPACT_Acquire_API_NET_manual.chm"
available as downloads from our website https://www.matrix-vision.com. The manuals contain
chapter about
• how to link and build applications using mvIMPACT Acquire,
• 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

4 CONTENTS
2 Migration Guide
2.1 Introduction
Since
Firmware 2.27.0 for mvBlueCOUGAR-X(D) devices (released 9th of February 2018)
In general all firmware versions are meant to operate on every device. Whenever this is not the case this page will
provide some guidelines on what to do or what to consider. Apart from that all known compatibility issues are listed
here.
2.2 Hardware revision 5
Hardware revision 5 for mvBlueCOUGAR-X(D) devices are shipped with a different network interface chip since the
chip used before is no longer available. As a consequence devices with this hardware revision cannot be operated
with previous firmware releases:
Device version / Hardware revision Supported firmware versions
<5.0 All
5.0 >= 2.27.0 (2.28.0 and greater is recommended)
Warning
Downgrading to a firmware version smaller than the versions listed in the table above may result in device
malfunction!
To verify the compatibility of you application with new firmware / mvIMPACT Acquire versions you can use cameras
with smaller hardware revisions. Just update them to firmware version 2.28.0 or greater. If your applications runs
without any problems afterwards you can use the new hardware revisions without any problems as well.
For a detailed migration guide for your application please refer to https://www.matrix-vision. -
com/manuals/SDK_CPP/MigrationGuide.html
MATRIX VISION GmbH

3 Imprint 5
3 Imprint
MATRIX VISION GmbH
Talstrasse 16
DE - 71570 Oppenweiler
Telephone: [phone]
Fax: [phone]
Website: http://www.matrix-vision.de
E-Mail:
[email protected]
[email protected]
[email protected]
Author
U. Lansche
H. Mattfeldt
S. Battmer
U. Hagmaier
D. Neuholz
Date
2016
This document assumes a general knowledge of PCs and programming.
Since the documentation is published electronically, an updated version may be available online. For this reason we
recommend checking for updates on the 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.
MATRIX VISION reserves the right to change technical data and design and specifications of the described products
at any time without notice.
Copyright
MATRIX VISION GmbH. All rights reserved. The text, images and graphical content are protected by copyright
and other laws which protect intellectual property. It is not permitted to copy or modify them for trade use or
transfer. They may not be used on websites.
• Windows® XP, Windows® Vista, Windows® 7 are trademarks of Microsoft, Corp.
• Linux® is a trademark of Linus Torvalds.
• GenICam™ is a trademark of the GenICam™ standard group.
• GigE Vision™ and the distinctive logo are trademarks owned by the Automated Imaging Association and may
only be used under license for compliant products registered with the AIA.
MATRIX VISION GmbH

6 CONTENTS
3.1 Introduction
The mvIMPACT Acuire SDK and its underlying libraries and drivers as well as some of the applications shipped with
the mvIMPACT Acquire packages 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 the mvIMPACT Acquire SDK.
3.2 wxWidgets
Most of the applications offering a graphical user interface have been written using wxWidgets (http://www. -
wxwidgets.org/).
wxWidgets is a C++ library that lets developers create applications for Windows, OS X, Linux and Unix on 32-bit
and 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. -
com) using wxWidgets is either part of the packet this document was taken from or can be obtained by contacting
MATRIX VISON GmbH.
3.3 Sarissa
Parts of the log file creation and the log file display make use of Sarissa (Website: http://dev.abiss. -
gr/sarissa) which is distributed under the GNU GPL version 2 or higher, GNU LGPL version 2.1 or higher and
Apache Software License 2.0 or higher. The Apache Software License 2.0 is part of this driver package.
3.4 GenICam
At least one driver package shipped under the product family name mvIMPACT Acquire makes use of the GenI -
Cam (p. 164) reference implementation, which is hosted by the EVMA and can be downloaded from their website:
http://www.emva.org. All license files belonging to the GenICam (p. 164) reference implementation are
shipped with the libraries belonging to the GenICam (p. 164) runtime.
3.5 libusb
The Linux version of the mvBlueFOX driver package makes use of a modified version of libusb (http://www. -
libusb.org/), which comes under LGPL 2.1. The full license text is included in the Linux distribution of the
mvBlueFOX driver package. The source code for the modified version of libusb can be obtained by contacting
MATRIX VISION GmbH or it can be downloaded from here: http://gpl.matrix-vision.com (navigate to
others/libusb).
3.6 libusbK
The USB3 Vision implementation currently makes use of libusbK (http://libusbk.sourceforge.net)
written by Travis Lee Robinson who owns all rights for the source code of all modules belonging to the libusbK
framework.
MATRIX VISION GmbH

3.7 Doxygen 7
3.6.1 libusbK license
APPLICABLE FOR ALL LIBUSBK BINARIES AND SOURCE CODE UNLESS OTHERWISE SPECIFIED. PLEASE SEE INDIVIDUAL COMPONENTS LICENSING TERMS FOR DETAILS.
Note
Portions of dpscat use source code from libwdi which is licensed for LGPL use only. (See dpscat.c)
libusbK-inf-wizard.exe is linked to libwdi which is licensed for LGPL use only.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
following conditions are met:
• Redistributions of source code must retain the above copyright notice, this list of conditions and the following
disclaimer.
• Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the fol-
lowing disclaimer in the documentation and/or other materials provided with the distribution.
• Neither the name of Travis Lee Robinson nor the names of its contributors may be used to endorse or promote
products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL TRAVIS ROBINSON BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
3.7 Doxygen
All the documentation belonging to the mvIMPACT Acquire framework has been generated using Doxygen (http -
://www.doxygen.org/) written by Dimitri van Heesch.
3.7.1 Doxygen license
Copyright © 1997-2013 by Dimitri van Heesch.
Permission to use, copy, modify, and distribute this software and its documentation under the terms of the GNU
General Public License is hereby granted. No representations are made about the suitability of this software for any
purpose. 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

8 CONTENTS
3.8 SHA1 algorithm
Parts of this framework make use of an open source implementation of the SHA1 algorithm written by Dominik
Reichl (http://www.dominik-reichl.de).
3.9 Expat
Expat is used to parse XML strings within the SDK.
3.9.1 Expat Copyright
Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons
to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT 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.
3.10 CppUnit
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.
3.11 NUnit
The .NET code is tested using the NUnit (http://www.nunit.org/) framework.
3.11.1 NUnit License
Copyright © 2002-2008 Charlie Poole Copyright © 2002-2004 James W. Newkirk, Michael C. Two, Alexei A.
Vorontsov Copyright © 2000-2002 Philip A. Craig
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable
for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and to
alter it and redistribute it freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not claim that you wrote the original soft-
ware. If you use this software in a product, an acknowledgment (see the following) in the product documenta-
tion is required. Portions Copyright © 2002-2008 Charlie Poole or Copyright © 2002-2004 James W. Newkirk,
Michael C. Two, Alexei A. Vorontsov or Copyright © 2000-2002 Philip A. Craig
2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original
software.
3. This notice may not be removed or altered from any source distribution.
MATRIX VISION GmbH