Matrix Vision mvBlueCOUGAR-X User manual

mvBlueCOUGAR-X/-XD
Technical Manual
English - Version 4.36

CONTENTS i
Contents
1 About this manual 2
1.1 Composition of the manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 How to get started? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2.2 Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2.3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2.4 Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2 Imprint 8
3 Legal notice 9
3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.2 cJSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.2.1 cJSON license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.3 Unity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.3.1 Unity license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4 Revisions 11
5 Graphic Symbols 24
5.1 Notes, Warnings, Attentions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
5.2 Webcasts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
6 Important information 25
6.1 Important safety instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
6.2 Operating considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
6.2.1 Important safety notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
6.2.2 Handling and cleaning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.2.3 Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.2.4 Optimizing performance and life time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.2.5 Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.2.6 Cleaning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.2.7 Adjusting the C-mount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
6.2.8 Additional temperature and power consumption notes concerning mvBlueCOUGAR-XD and
mvBlueCOUGAR-X2xx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
6.3 European Union Declaration of Conformity statement . . . . . . . . . . . . . . . . . . . . . . . . 28
6.4 Legal notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
6.4.1 For customers in the U.S.A. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
6.4.2 For customers in Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
6.4.3 Pour utilisateurs au Canada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
MATRIX VISION GmbH

ii CONTENTS
7 Introduction 35
7.1 Order code nomenclature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
7.1.1 mvBlueCOUGAR-X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
7.1.2 mvBlueCOUGAR-XD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
7.1.3 mvBlueCOUGAR-3X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
7.1.4 Ordering code samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
7.2 What's inside and accessories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
8 Quickstart 39
8.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
8.1.1 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
8.1.2 Installing the mvGenTL-Acquire driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
8.1.3 Optimizing the network configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
8.1.4 Adjusting the network controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
8.1.5 Additional network configuration for mvBlueCOUGAR-XD . . . . . . . . . . . . . . . . . . 47
8.2 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
8.2.1 System requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
8.2.2 Installing the mvGenTL-Acquire driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
8.2.3 Optimizing the network configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
8.2.4 Adjusting the network controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
8.2.5 Additional network configuration for mvBlueCOUGAR-XD . . . . . . . . . . . . . . . . . . 53
8.3 Connecting the camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
8.3.1 Communicating with the camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
8.3.2 Setting up the camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
8.3.3 Settings behaviour during startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
8.4 Relationship between driver, firmware, FPGA file and user settings . . . . . . . . . . . . . . . . . 59
MATRIX VISION GmbH

CONTENTS iii
9 Technical data 64
9.1 mvBlueCOUGAR-X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
9.1.1 Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
9.1.2 Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
9.1.3 Signal LED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
9.2 mvBlueCOUGAR-X-POE-I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
9.2.1 Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
9.2.2 Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
9.3 mvBlueCOUGAR-XD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
9.3.1 Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
9.3.2 Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
9.3.3 Signal LED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
9.4 mvBlueCOUGAR-3X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
9.4.1 Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
9.4.2 Model specific features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
9.5 Summary of components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
9.6 Summary of advanced features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
10 Sensor overview 93
10.1 Image data flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
10.2 CCD sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
10.2.1 mvBlueCOUGAR-XD specific CCD sensors . . . . . . . . . . . . . . . . . . . . . . . . . 95
10.2.2 Negative gain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
10.3 mvBlueCOUGAR-X specific CMOS sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
10.3.1 Sony Pregius . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
10.3.2 Aptina, CMOSIS, e2v . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
10.3.3 mvBlueCOUGAR-XD specific CMOS sensors . . . . . . . . . . . . . . . . . . . . . . . . 102
10.4 Output sequence of color sensors (RGB Bayer) . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
10.5 Bilinear interpolation of color sensors (RGB Bayer) . . . . . . . . . . . . . . . . . . . . . . . . . . 105
10.6 Supported image formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
MATRIX VISION GmbH

iv CONTENTS
11 Filters 107
11.1 Hot mirror filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
11.2 Cold mirror filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
11.3 Glass filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
12 Application Usage 109
12.1 wxPropView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
12.1.1 How to work with wxPropView . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
12.1.2 How to configure a device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
12.1.3 Command-line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
12.2 mvGigEConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
12.2.1 Install GigE Vision capture filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
12.2.2 Remove GigE Vision capture filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
12.2.3 Command-line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
12.3 mvIPConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
12.3.1 Configure a GigE Vision device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
12.3.2 Recover a misconfigured GigE Vision device . . . . . . . . . . . . . . . . . . . . . . . . . 148
12.4 mvDeviceConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
12.4.1 How to set the device ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
12.4.2 How to update the firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
12.4.3 Preserving UserSet settings when updating the Firmware . . . . . . . . . . . . . . . . . . 155
12.4.4 How to disable CPU sleep states a.k.a. C states (<Windows 8) . . . . . . . . . . . . . . 156
12.4.5 Command-line options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
MATRIX VISION GmbH

CONTENTS v
13 GenICam and Advanced Features 160
13.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
13.2 Device Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
13.3 Image Format Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
13.4 Acquisition Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
13.5 Counter And Timer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
13.6 Analog Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
13.7 mv Logic Gate Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
13.8 Color Transformation Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
13.9 mv Flat Field Correction Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
13.10Event Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
13.11Chunk Data Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
13.12File Access Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
13.13mv Serial Interface Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
13.14Digital I/O Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
13.15LUT Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
13.15.1 mvLUTType . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
13.15.2 mvLUTInputData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
13.15.3 mvLUTMapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
13.15.4 LUT support in MATRIX VISION cameras . . . . . . . . . . . . . . . . . . . . . . . . . . 175
13.16Sequencer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
13.16.1 Sequencer overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
13.16.2 Configuration of a sequencer set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
13.17mv Defective Pixel Correction Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
13.18Transport Layer Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
13.19User Set Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
13.20mv Frame Average Control (only with specific models) . . . . . . . . . . . . . . . . . . . . . . . . 186
13.21mv High Dynanmic Range Control (only with specific sensor models) . . . . . . . . . . . . . . . . 187
14 C developers 188
MATRIX VISION GmbH

vi CONTENTS
15 C++ developers 189
16 .NET developers 190
17 Python developers 191
17.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
17.2 Building . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
17.2.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
17.2.2 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
17.3 Using . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
18 DirectShow Interface 195
18.1 Supported Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
18.1.1 IAMCameraControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
18.1.2 IAMDroppedFrames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
18.1.3 IAMStreamConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
18.1.4 IAMVideoProcAmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
18.1.5 IKsPropertySet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
18.1.6 ISpecifyPropertyPages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
18.2 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
18.3 Registering and renaming devices for DirectShow usage . . . . . . . . . . . . . . . . . . . . . . . 196
18.3.1 Registering devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
18.3.2 Renaming devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
18.3.3 Make silent registration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
MATRIX VISION GmbH

CONTENTS vii
19 Troubleshooting 200
19.1 I can see the camera in mvIPConfigure, but I cannot access the camera . . . . . . . . . . . . . . 200
19.2 Image Data is lost (incomplete frames) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
19.3 There are image error counts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
19.4 I get an exception when setting offsetX or offsetY . . . . . . . . . . . . . . . . . . . . . . . . . . 201
19.5 Cognex VisionPro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
19.5.1 I cannot use mvBlueCOUGAR-XD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
19.5.2 I cannot initialize 4 Tap sensor mvBlueCOUGAR-XDs . . . . . . . . . . . . . . . . . . . . 202
19.6 I get an oscillating frame rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
19.7 I cannot focus on distant objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
19.8 Accessing log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
19.8.1 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
19.8.2 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
19.9 mvGigEConfigure freezes when trying to activate/deactivate the filter driver a Link Aggregation
Group (LAG) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
19.9.1 Symptoms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
19.9.2 Cause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
19.9.3 Resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
19.10Error code list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
20 Glossary 220
MATRIX VISION GmbH

viii CONTENTS
21 Use cases 233
21.1 GenICam to mvIMPACT Acquire code generator . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
21.1.1 Using the code generator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
21.1.2 Using the result of the code generator in an application . . . . . . . . . . . . . . . . . . . 235
21.2 Introducing acquisition / recording possibilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
21.2.1 Acquiring a number of images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
21.2.2 Recording sequences in the camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
21.2.3 Recording sequences with pre-trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
21.2.4 Creating acquisition sequences (Sequencer Control) . . . . . . . . . . . . . . . . . . . . 240
21.2.5 Working with multiple AOIs (mv Multi Area Mode) . . . . . . . . . . . . . . . . . . . . . . 248
21.2.6 Working with burst mode buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
21.2.7 Using the SmartFrameRecall feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
21.2.8 Using VLC Media Player . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
21.2.9 Using the linescan mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
21.2.10 Working with Event Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
21.3 Improving the acquisition / image quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
21.3.1 Correcting image errors of a sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
21.3.2 Optimizing the color fidelity of the camera . . . . . . . . . . . . . . . . . . . . . . . . . . 282
21.3.3 Reducing noise by frame averaging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
21.3.4 Optimizing the bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
21.3.5 Setting a flicker-free auto expose and auto gain . . . . . . . . . . . . . . . . . . . . . . . 301
21.3.6 Working with binning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
21.3.7 Working with Sony's 4 Tap CCD sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
21.3.8 Minimizing sensor pattern of mvBlueCOUAGR-X1010G . . . . . . . . . . . . . . . . . . . 309
21.4 Working with triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
21.4.1 Getting a trigger with an incremental encoder . . . . . . . . . . . . . . . . . . . . . . . . 312
21.4.2 Generating a pulse width modulation (PWM) . . . . . . . . . . . . . . . . . . . . . . . . . 314
21.4.3 Outputting a pulse at every other external trigger . . . . . . . . . . . . . . . . . . . . . . 317
21.4.4 Creating different exposure times for consecutive images . . . . . . . . . . . . . . . . . . 318
21.4.5 Detecting overtriggering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
MATRIX VISION GmbH

CONTENTS ix
21.4.6 Triggering of an indefinite sequence with precise starting time . . . . . . . . . . . . . . . . 326
21.5 Working with I/Os . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
21.5.1 Controlling strobe or flash at the outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
21.5.2 Compensating delay of strobe or flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
21.5.3 Creating a debouncing filter at the inputs . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
21.5.4 Using motorized lenses with mvBlueCOUGAR-XD . . . . . . . . . . . . . . . . . . . . . . 333
21.6 Working with HDR (High Dynamic Range Control) . . . . . . . . . . . . . . . . . . . . . . . . . . 338
21.6.1 Adjusting sensor -x00w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
21.6.2 Adjusting sensor -x02d (-1012d) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
21.6.3 Adjusting sensor -x02e (-1013) / -x04e (-1020) . . . . . . . . . . . . . . . . . . . . . . . . 345
21.7 Working with LUTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
21.7.1 Introducing LUTs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
21.7.2 Working with LUTValueAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
21.7.3 Implementing a hardware-based binarization . . . . . . . . . . . . . . . . . . . . . . . . . 353
21.8 Saving data on the device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
21.8.1 Creating user data entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
21.8.2 Creating user set entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
21.8.3 Working with the UserFile section (Flash memory) . . . . . . . . . . . . . . . . . . . . . . 359
21.9 Working with device features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
21.9.1 Working with the temperature sensors . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
21.9.2 Disabling the heartbeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
21.9.3 Reset timestamp by hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
21.9.4 Synchronizing camera timestamps without IEEE 1588 . . . . . . . . . . . . . . . . . . . . 367
21.9.5 Working with the 3 head model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
21.9.6 Working with the serial interface (mv Serial Interface Control) . . . . . . . . . . . . . . . . 370
21.10Working with several camera simultaneously . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
21.10.1 Introducing multicasting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
21.10.2 Using Action Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
21.10.3 Creating synchronized acquisitions using timers . . . . . . . . . . . . . . . . . . . . . . . 386
21.10.4 Using the primary application switchover functionality . . . . . . . . . . . . . . . . . . . . 391
MATRIX VISION GmbH

x CONTENTS
22 Appendix A.1 CCD specific camera / sensor data 396
22.1 mvBlueCOUGAR-Xx20a (0.3 Mpix [640 x 480]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
22.1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
22.1.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
22.1.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
22.1.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
22.1.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
22.1.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
22.2 mvBlueCOUGAR-Xx20b (0.3 Mpix [640 x 480]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
22.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
22.2.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
22.2.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
22.2.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
22.2.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
22.2.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
22.3 mvBlueCOUGAR-Xx20d (0.5 Mpix [776 x 580]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
22.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
22.3.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
22.3.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
22.3.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
22.3.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
22.3.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
22.4 mvBlueCOUGAR-Xx22 (1.2 Mpix [1280 x 960]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
22.4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
22.4.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
22.4.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
22.4.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
22.4.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
22.5 mvBlueCOUGAR-Xx23 (1.4 Mpix [1360 x 1024]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
22.5.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
MATRIX VISION GmbH

CONTENTS xi
22.5.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
22.5.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
22.5.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
22.5.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
22.5.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
22.6 mvBlueCOUGAR-Xx24 (1.9 Mpix [1600 x 1200]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
22.6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
22.6.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
22.6.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
22.6.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
22.6.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
22.6.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
22.7 mvBlueCOUGAR-XD124a (3 Mpix [1936 x 1460]) . . . . . . . . . . . . . . . . . . . . . . . . . . 456
22.7.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
22.7.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
22.7.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
22.7.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
22.7.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
22.7.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
22.8 mvBlueCOUGAR-X225 (5.1 Mpix [2448 x 2050]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
22.8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
22.8.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
22.8.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
22.8.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
22.8.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
22.8.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
22.9 mvBlueCOUGAR-Xx25a (5.1 Mpix [2448 x 2050]) . . . . . . . . . . . . . . . . . . . . . . . . . . 476
22.9.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
22.9.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
22.9.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
MATRIX VISION GmbH

xii CONTENTS
22.9.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
22.9.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
22.10mvBlueCOUGAR-XD126 (6 Mpix [2752 x 2208]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
22.10.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
22.10.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
22.10.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
22.10.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
22.10.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
22.10.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
22.11mvBlueCOUGAR-XD126a (6 Mpix [2752 x 2208]) . . . . . . . . . . . . . . . . . . . . . . . . . . 495
22.11.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
22.11.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495
22.11.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
22.11.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
22.11.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
22.11.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
22.12mvBlueCOUGAR-XD129 (9.2 Mpix [3384 x 2712]) . . . . . . . . . . . . . . . . . . . . . . . . . . 505
22.12.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
22.12.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
22.12.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507
22.12.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
22.12.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
22.12.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514
22.13mvBlueCOUGAR-XD129a (9.2 Mpix [3384 x 2712]) . . . . . . . . . . . . . . . . . . . . . . . . . 515
22.13.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
22.13.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
22.13.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
22.13.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
22.13.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
22.13.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
22.14mvBlueCOUGAR-XD1212a (12.1 Mpix [4248 x 2836]) . . . . . . . . . . . . . . . . . . . . . . . . 525
22.14.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
22.14.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
22.14.3 CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
22.14.4 Reprogramming CCD Timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
22.14.5 CCD Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
22.14.6 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
MATRIX VISION GmbH

CONTENTS xiii
23 Appendix A.2 Pregius CMOS specific camera / sensor data 535
23.1 mvBlueCOUGAR-X100f (0.4 Mpix [1456 x 1088]) . . . . . . . . . . . . . . . . . . . . . . . . . . 535
23.1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
23.1.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
23.1.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
23.1.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
23.2 mvBlueCOUGAR-X102f (1.6 Mpix [1456 x 1088]) . . . . . . . . . . . . . . . . . . . . . . . . . . 538
23.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
23.2.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
23.2.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
23.2.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
23.3 mvBlueCOUGAR-XD104d (2.4 Mpix [1936 x 1216]) . . . . . . . . . . . . . . . . . . . . . . . . . 542
23.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
23.3.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
23.3.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
23.3.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
23.4 mvBlueCOUGAR-Xx04f (2.4 Mpix [1936 x 1216]) . . . . . . . . . . . . . . . . . . . . . . . . . . 545
23.4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
23.4.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
23.4.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
23.4.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
23.5 mvBlueCOUGAR-Xx04i (3.2 Mpix [2064 x 1544]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
23.5.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
23.5.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
23.5.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
23.5.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
23.6 mvBlueCOUGAR-XD105a (5.1 Mpix [2464 x 2056]) . . . . . . . . . . . . . . . . . . . . . . . . . 552
23.6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
23.6.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
23.6.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
MATRIX VISION GmbH

xiv CONTENTS
23.6.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
23.7 mvBlueCOUGAR-Xx05b (5.1 Mpix [2464 x 2056]) . . . . . . . . . . . . . . . . . . . . . . . . . . 555
23.7.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
23.7.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
23.7.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557
23.7.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
23.8 mvBlueCOUGAR-X[D]109b (8.9 Mpix [4112 x 2176]) . . . . . . . . . . . . . . . . . . . . . . . . 559
23.8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
23.8.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
23.8.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
23.8.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
23.9 mvBlueCOUGAR-X[D]1012b (12.4 Mpix [4112 x 3008]) . . . . . . . . . . . . . . . . . . . . . . . 561
23.9.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
23.9.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562
23.9.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
23.9.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565
24 Appendix A.3 CMOS specific camera / sensor data 566
24.1 mvBlueCOUGAR-Xx00w (0.4 Mpix [752 x 480]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
24.1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
24.1.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
24.1.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
24.1.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
24.2 mvBlueCOUGAR-Xx02b (1.2 Mpix [1280 x 960]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
24.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
24.2.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
24.2.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572
24.2.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573
24.3 mvBlueCOUGAR-Xx02d (1.2 Mpix [1280 x 960]) . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
24.3.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
24.3.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
MATRIX VISION GmbH

CONTENTS 1
24.3.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
24.3.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
24.4 mvBlueCOUGAR-Xx02e (1.3 Mpix [1280 x 1024]) . . . . . . . . . . . . . . . . . . . . . . . . . . 578
24.4.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
24.4.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
24.4.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
24.4.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
24.5 mvBlueCOUGAR-Xx02eGE (1.3 Mpix [1280 x 1024]) . . . . . . . . . . . . . . . . . . . . . . . . 584
24.5.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
24.5.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
24.5.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
24.5.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
24.6 mvBlueCOUGAR-Xx04e (1.9 Mpix [1600 x 1200]) . . . . . . . . . . . . . . . . . . . . . . . . . . 591
24.6.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
24.6.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
24.6.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
24.6.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
24.7 mvBlueCOUGAR-X[D]x04 (2.2 Mpix [2048 x 1088]) . . . . . . . . . . . . . . . . . . . . . . . . . 597
24.7.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
24.7.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
24.7.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
24.7.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
24.8 mvBlueCOUGAR-XD104h (3.2 Mpix [2064 x 1544]) . . . . . . . . . . . . . . . . . . . . . . . . . 601
24.8.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
24.8.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
24.8.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
24.8.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
24.9 mvBlueCOUGAR-X[D]x04b (4.2 Mpix [2048 x 2048]) . . . . . . . . . . . . . . . . . . . . . . . . . 604
24.9.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
24.9.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
24.9.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
24.9.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
24.10mvBlueCOUGAR-Xx05 (5 Mpix [2592 x 1944]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
24.10.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
24.10.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
24.10.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
24.10.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
24.11mvBlueCOUGAR-Xx010 (10 Mpix [3856 x 2764]) . . . . . . . . . . . . . . . . . . . . . . . . . . 613
24.11.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
24.11.2 Details of operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614
24.11.3 Sensor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
24.11.4 Device Feature And Property List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
MATRIX VISION GmbH

2 CONTENTS
1 About this manual
1.1 Composition of the manual
The mvBlueCOUGAR 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. 109) book. If you want to know how images are acquired with the
mvBlueCOUGAR, have a look in the respective programming language chapter.
Here is a short summary about all books of the mvBlueCOUGAR manual:
• The manual starts with technical data of the mvBlueCOUGAR like sensors as well as a quick start chapter.
Furthermore, it describes the advanced features (p. 90) of the mvBlueCOUGAR-X. Afterwards, you will find
the different books:
•Application Usage (p. 109)
–The mvBlueCOUGAR can be managed via user interface. There are two programs to do this:
*wxPropView (p. 109)
*mvGigEConfigure (p. 142)
*mvIPConfigure (p. 145)
*mvDeviceConfigure (p. 149)
•GenICam and Advanced Features (p. 160)
–The mvBlueCOUGAR is a GenICam / GigE Vision compliant camera. This chapter introduces the
GenICam and the Advanced features of the mvBlueCOUGAR-X.
•DirectShow developers (p. 195)
–This is the documentation of the MATRIX VISION DirectShow_acquire interface.
•Use cases (p. 233)
–This book offers solutions and explanations for standard use cases.
•Troubleshooting (p. 200)
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 http://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

1.2 How to get started? 3
1.2 How to get started?
1.2.1 Introduction
This chapter gives you a short overview, how to get started with mvBlueCOUGAR and where to find the necessary
information in the manual. It will also explain or link to the concepts behind the driver and the image acquisition.
Furthermore, it shows you how to get start programming (p. 7) own applications.
1.2.2 Basics
1.2.2.1 Driver concept
The driver supplied with the MATRIX VISION product represents the port between the programmer and the
hardware. The driver concept of MATRIX VISION provides a standardized programming interface to all image
processing products (excluding mvBlueLYNX) made by MATRIX VISION GmbH.
The advantage of this concept for the programmer is that a developed application runs without the need for
any major modifications to the various image processing products made by MATRIX VISION GmbH. You can
also incorporate new driver versions, which are available for download free of charge on our website: https -
://www.matrix-vision.com.
The following diagram shows a schematic structure of the driver concept:
Figure 1: Driver concept
MATRIX VISION GmbH

4 CONTENTS
•1Part of any mvIMPACT Acquire driver installation package (Windows).
•2Separately available for 32 bit and 64 bit. Requires at least one installed driver package.
•3See 2, but requires an installed version of the mvBlueFOX driver.
•4Part of the NeuroCheck installer but requires at least one installed frame grabber driver.
•5Part of the mvIMPACT SDK installation. However, new designs should use the .NET libs that are now part
of mvIMPACT Acquire ("mv.impact.acquire.dll"). The namespace "mv.impact.acquire" of
"mv.impact.acquire.dll" provides a more natural and more efficient access to the same features
as contained in the namespace "mvIMPACT_NET.acquire" of "mvIMPACT_NET.dll", which is why
the latter one should only be used for backward compatibility but NOT when developing a new application.
•6Part of Micro-Manager.
1.2.2.2 NeuroCheck support
A couple of devices are supported by NeuroCheck. However between NeuroCheck 5.x and NeuroCheck 6.x there
has been a breaking change in the internal interfaces. Therefore also the list of supported devices differs from one
version to another and some additional libraries might be required.
For NeuroCheck 5.x the following devices are supported:
Device Additional software needed
mvTITAN-G1 mvSDK driver for mvTITAN/mvGAMMA devices
mvTITAN-CL mvSDK driver for mvTITAN/mvGAMMA devices
mvGAMMA-CL mvSDK driver for mvTITAN/mvGAMMA devices
mvBlueFOX mvIMPACT Acquire driver for mvBlueFOX devices, "NCUSBmvBF.dll"
For NeuroCheck 6.0 the following devices are supported:
Device Additional software needed
mvTITAN-G1 mvIMPACT Acquire driver for mvTITAN/mvGAMMA de-
vices
mvTITAN-CL mvIMPACT Acquire driver for mvTITAN/mvGAMMA de-
vices
mvGAMMA-CL mvIMPACT Acquire driver for mvTITAN/mvGAMMA de-
vices
mvHYPERION-CLb mvIMPACT Acquire driver for mvHYPERION devices
Every other mvIMPACT Acquire compliant device mvIMPACT Acquire driver for the corresponding device
family, "mv.impact.acquire.NeuroCheck6. -
dll" (comes with the driver package, but the driver
package must be installed AFTER installing NeuroCheck 6
For NeuroCheck 6.1 the following devices are supported:
Device Additional software needed
mvTITAN-G1 mvIMPACT Acquire driver for mvTITAN/mvGAMMA de-
vices
mvTITAN-CL mvIMPACT Acquire driver for mvTITAN/mvGAMMA de-
vices
mvGAMMA-CL mvIMPACT Acquire driver for mvTITAN/mvGAMMA de-
vices
mvHYPERION-CLb mvIMPACT Acquire driver for mvHYPERION devices
MATRIX VISION GmbH

1.2 How to get started? 5
Every other mvIMPACT Acquire compliant device mvIMPACT Acquire driver for the corresponding device
family, "mv.impact.acquire.NeuroCheck6_ -
1.dll" (comes with the driver package, but the driver
package must be installed AFTER installing NeuroCheck
6.1
1.2.2.3 VisionPro support
Every mvIMPACT Acquire driver package under Windows comes with an adapter to VisionPro from Cognex. The
installation order does not matter. After the driver package and VisionPro has been installed, the next time VisionPro
is started it will allow selecting the mvIMPACT Acquire device. No additional steps are needed.
MATRIX VISION devices that also comply with the GigE Vision standard don't need any software at all, but can also
use VisionPro's built-in GigE Vision support.
1.2.2.4 HALCON support
HALCON comes with built-in support for mvIMPACT Acquire compliant devices, so once a device driver has been
installed for the mvIMPACT Acquire device, it can also be operated from a HALCON environment using the corre-
sponding acquisition interface. 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 HALCON's built-in GigE Vision support.
As some mvIMPACT Acquire device driver packages also come with a GenTL compliant interface, these can also
be operated through HALCON's built-in GenTL acquisition interface.
1.2.2.5 LabVIEW support
Every mvIMPACT Acquire compliant device can be operated under LabVIEW through an additional set of VIs which
is shipped by MATRIX VISION as a separate installation ("mvLabVIEW Acquire").
MATRIX VISION devices that also comply with the GigE Vision or USB3 Vision standard don't need any additional
software at all, but can also be operated through LabVIEW's GigE Vision or USB3 Vision driver packages.
1.2.2.6 DirectShow support
Every mvIMPACT Acquire compliant device driver package comes with an interface to DirectShow. In order to be
usable from a DirectShow compliant application, devices must first be registered for DirectShow support. How to
this is explained here (p. 196).
1.2.2.7 Micro-Manager support
Every mvIMPACT Acquire compliant device can be operated under https://micro-manager.org when
using mvIMPACT Acquire 2.18.0 or later and at least Micro-Manager 1.4.23 build AFTER 15.12.2016. The
adapter needed is part of the Micro-Manager release. Additional information can be found here: https -
://micro-manager.org/wiki/MatrixVision.
1.2.2.7.1 code
•https://valelab4.ucsf.edu/svn/micromanager2/trunk/DeviceAdapters/Matrix -
Vision/
•https://valelab4.ucsf.edu/trac/micromanager/browser/DeviceAdapters/ -
MatrixVision
MATRIX VISION GmbH