Matrix MvBlueFOX3 Manuale utente

ProductFeatures

Table of Contents

1 Imprint..............................................................................................................................................1

1.1 Introduction.......................................................................................................................2

1.2 wxWidgets.........................................................................................................................2

1.3 Sarissa..............................................................................................................................2

1.4 GenICam...........................................................................................................................2

1.5 libusb.................................................................................................................................2

1.6 libusbK..............................................................................................................................2

1.6.1 libusbK license.........................................................................................................3

1.7 Doxygen............................................................................................................................3

1.7.1 Doxygen license.......................................................................................................3

1.8 SHA1 algorithm.................................................................................................................4

1.9 Expat.................................................................................................................................4

1.9.1 Expat Copyright........................................................................................................4

1.10 OpenSSL........................................................................................................................4

1.10.1 OpenSSL License Issues.......................................................................................4

1.10.2 OpenSSL License..................................................................................................4

1.11 CppUnit...........................................................................................................................5

1.12 NUnit...............................................................................................................................5

1.12.1 NUnit License.........................................................................................................5

2 Legal notice.....................................................................................................................................7

2.1 Introduction.......................................................................................................................7

2.2 cJSON...............................................................................................................................7

2.2.1 cJSON license..........................................................................................................7

2.3 Unity..................................................................................................................................7

2.3.1 Unity license.............................................................................................................7

3 Revisions.........................................................................................................................................9

4 Graphic Symbols..........................................................................................................................15

4.1 Notes, Warnings, Attentions...........................................................................................15

4.2 Webcasts........................................................................................................................15

5 Important information..................................................................................................................17

5.1 Important safety instructions...........................................................................................17

5.2 Operating considerations................................................................................................17

5.2.1 Important safety notes............................................................................................17

5.2.2 Handling and cleaning............................................................................................18

5.2.3 Installing.................................................................................................................18

5.2.4 Optimizing performance and life time.....................................................................18

5.2.5 Connectors.............................................................................................................18

5.2.6 Cleaning.................................................................................................................18

5.2.7 Adjusting the C-mount (mvBlueFOX3-2xxx-1xxx)..................................................18

5.2.8 Adjusting the C-mount (mvBlueFOX3-2xxx-2xxx)..................................................19

5.3 European Union Declaration of Conformity statement....................................................20

5.4 Legal notice.....................................................................................................................26

5.4.1 For customers in the U.S.A....................................................................................26

5.4.2 For customers in Canada.......................................................................................26

5.4.3 Pour utilisateurs au Canada...................................................................................26

6 Introduction...................................................................................................................................27

6.1 Software concept............................................................................................................27

6.2 Order code nomenclature...............................................................................................28

6.2.1 Ordering code samples..........................................................................................30

Table of Contents

6 Introduction

6.3 What's inside and accessories........................................................................................31

6.3.1 Accessories for the mvBlueFOX3..........................................................................31

7 Quickstart......................................................................................................................................33

7.1 Driver concept.................................................................................................................33

7.1.1 LabVIEW support...................................................................................................35

7.2 Windows.........................................................................................................................35

7.2.1 System requirements.............................................................................................35

7.2.2 Installing the mvGenTL-Acquire driver...................................................................35

7.2.3 Connecting the camera..........................................................................................38

7.3 Linux...............................................................................................................................39

7.3.1 System requirements.............................................................................................39

7.3.2 Installing the mvGenTL-Acquire driver...................................................................40

7.3.3 Connecting the camera..........................................................................................41

7.3.4 Defining udev rules................................................................................................41

7.3.5 Optimizing USB performance.................................................................................42

7.4 Relationship between driver, firmware, FPGA file and user settings..............................45

7.5 Settings behaviour during startup...................................................................................48

8 Technical data...............................................................................................................................51

8.1 Dimensions.....................................................................................................................51

8.1.1 Standard model......................................................................................................51

8.1.2 Standard model -2xxx............................................................................................52

8.1.3 Model without housing (-M1)..................................................................................54

8.1.4 Model without housing (-M2)..................................................................................55

8.2 Camera interfaces...........................................................................................................56

8.2.1 Circular connector male (Power / Digital I/O).........................................................56

8.2.2 Characteristics of the digital inputs........................................................................58

8.2.3 Characteristics of the digital outputs......................................................................59

8.3 Status / Power LED.........................................................................................................59

8.3.1 Standard model......................................................................................................59

8.3.2 Standard model -2xxx............................................................................................60

8.4 Components....................................................................................................................60

9 Sensor overview...........................................................................................................................61

9.1 Image data flow...............................................................................................................61

9.2 Output sequence of color sensors (RGB Bayer).............................................................61

9.3 CMOS sensors................................................................................................................62

9.3.1 Details of operation................................................................................................62

9.3.2 Models....................................................................................................................64

9.4 Supported image formats................................................................................................65

10 Filters and Lenses......................................................................................................................67

10.1 Hot mirror filter..............................................................................................................67

10.2 Cold mirror filter............................................................................................................67

10.3 Glass filter.....................................................................................................................68

10.4 Lenses..........................................................................................................................68

11 GUI...............................................................................................................................................69

11.1 wxPropView..................................................................................................................69

11.1.1 How to work with wxPropView.............................................................................69

11.1.2 How to configure a device....................................................................................86

11.2 mvDeviceConfigure.......................................................................................................93

Table of Contents

11 GUI 11.2.1 How to update the firmware.................................................................................93

11.2.2 Preserving UserSet settings when updating the Firmware..................................97

11.2.3 How to disable CPU sleep states a.k.a. C states (Windows)...............................98

12 GenICam and Advanced Features..........................................................................................101

12.1 Introduction.................................................................................................................101

12.2 Device Control............................................................................................................102

12.3 Image Format Control.................................................................................................102

12.4 Acquisition Control......................................................................................................103

12.5 Counter And Timer Control.........................................................................................106

12.6 Analog Control............................................................................................................107

12.7 mv Logic Gate Control................................................................................................108

12.8 Color Transformation Control......................................................................................109

12.9 mv Flat Field Correction Control.................................................................................110

12.10 Event Control............................................................................................................110

12.11 Chunk Data Control..................................................................................................111

12.12 File Access Control...................................................................................................112

12.13 Digital I/O Control......................................................................................................113

12.14 LUT Control...............................................................................................................114

12.14.1 mvLUTType......................................................................................................114

12.14.2 mvLUTInputData..............................................................................................115

12.14.3 mvLUTMapping................................................................................................115

12.14.4 LUT support in MATRIX VISION cameras.......................................................115

12.15 Sequencer Control....................................................................................................119

12.16 Transport Layer Control............................................................................................120

12.17 User Set Control.......................................................................................................122

12.18 mv Frame Average Control (only with specific models)............................................122

12.19 mv High Dynanmic Range Control (only with specific sensor models).....................123

13 C developers.............................................................................................................................125

14 C++ developers.........................................................................................................................127

15 .NET developers........................................................................................................................129

16 DirectShow Interface................................................................................................................131

16.1 Supported Interfaces...................................................................................................131

16.1.1 IAMCameraControl............................................................................................131

16.1.2 IAMDroppedFrames...........................................................................................131

16.1.3 IAMStreamConfig...............................................................................................131

16.1.4 IAMVideoProcAmp.............................................................................................131

16.1.5 IKsPropertySet...................................................................................................131

16.1.6 ISpecifyPropertyPages.......................................................................................131

16.2 Logging.......................................................................................................................131

16.3 Registering and renaming devices for DirectShow usage..........................................131

16.3.1 Registering devices............................................................................................132

16.3.2 Renaming devices..............................................................................................134

16.3.3 Make silent registration......................................................................................135

17 Troubleshooting.......................................................................................................................137

17.1 There are Image Error Counts....................................................................................137

17.2 I cannot see the mvBlueFOX3 or I can see it but I cannot use it................................137

17.3 I get an oscillating frame rate......................................................................................143

iii

Table of Contents

17 Troubleshooting

17.4 Accessing log files......................................................................................................143

17.4.1 Windows.............................................................................................................144

17.4.2 Linux..................................................................................................................144

18 Use cases..................................................................................................................................145

18.1 GenICam to mvIMPACT Acquire code generator.......................................................145

18.1.1 Using the code generator...................................................................................145

18.1.2 Using the result of the code generator in an application....................................148

18.2 Introducing acquisition / recording possibilities...........................................................149

18.2.1 Acquiring a number of images...........................................................................150

18.2.2 Recording sequences in the camera..................................................................151

18.2.3 Recording sequences with pretrigger.................................................................152

18.2.4 Working with burst mode buffer.........................................................................154

18.2.5 Using VLC Media Player....................................................................................158

18.2.6 Using the linescan mode....................................................................................161

18.2.7 Working with Event Control................................................................................166

18.3 Improving the acquisition / image quality....................................................................168

18.3.1 Correcting image errors of a sensor...................................................................168

18.3.2 Optimizing the color fidelity of the camera.........................................................176

18.3.3 Reducing noise by frame averaging...................................................................193

18.3.4 Setting a flicker-free auto expose and auto gain................................................197

18.3.5 Minimizing sensor pattern of mvBlueFOX3-1100G............................................202

18.4 Working with triggers..................................................................................................205

18.4.1 Getting a trigger with an incremental encoder...................................................205

18.4.2 Generating a pulse width modulation (PWM).....................................................207

18.4.3 Outputting a pulse at every other external trigger..............................................210

18.4.4 Creating different exposure times for consecutive images................................212

18.4.5 Detecting overtriggering.....................................................................................217

18.4.6 Triggering of an indefinite sequence with precise starting time.........................222

18.5 Working with I/Os........................................................................................................225

18.5.1 Controlling strobe or flash at the outputs...........................................................225

18.5.2 Compensating delay of strobe or flash...............................................................226

18.5.3 Creating a debouncing filter at the inputs...........................................................228

18.6 Working with HDR (High Dynamic Range Control).....................................................230

18.7 Working with LUTs......................................................................................................231

18.8 Saving data on the device...........................................................................................231

18.8.1 Creating user data entries..................................................................................231

18.8.2 Creating user set entries....................................................................................233

18.8.3 Working with the UserFile section (Flash memory)............................................235

18.9 Working with device features......................................................................................238

18.9.1 Reset timestamp by hardware...........................................................................238

18.9.2 Synchronizing camera timestamps without IEEE 1588......................................240

18.9.3 Using the standby mode....................................................................................242

18.10 Working with several camera simultaneously...........................................................245

18.10.1 Creating synchronized acquisitions using timers.............................................245

19 Glossary....................................................................................................................................251

20 Appendix A.1 Pregius CMOS specific camera / sensor data................................................257

20.1 mvBlueFOX3-2024 (2.4 Mpix [1936 x 1216])..............................................................257

20.1.1 Introduction........................................................................................................257

20.1.2 Spectral Sensitivity.............................................................................................257

20.1.3 Timings...............................................................................................................258

Table of Contents

20 Appendix A.1 Pregius CMOS specific camera / sensor data

20.1.4 Device Feature And Property List......................................................................261

20.2 mvBlueFOX3-2024a (2.4 Mpix [1936 x 1216])............................................................357

20.2.1 Introduction........................................................................................................357

20.2.2 Spectral Sensitivity.............................................................................................357

20.2.3 Timings...............................................................................................................358

20.2.4 Device Feature And Property List......................................................................361

20.3 mvBlueFOX3-2032 (3.2 Mpix [2064 x 1544])..............................................................456

20.3.1 Introduction........................................................................................................456

20.3.2 Spectral Sensitivity.............................................................................................457

20.3.3 Timings...............................................................................................................458

20.3.4 Device Feature And Property List......................................................................460

20.4 mvBlueFOX3-2032a (3.2 Mpix [2064 x 1544])............................................................556

20.4.1 Introduction........................................................................................................556

20.4.2 Spectral Sensitivity.............................................................................................557

20.4.3 Timings...............................................................................................................558

20.4.4 Device Feature And Property List......................................................................560

20.5 mvBlueFOX3-2051 (5.1 Mpix [2464 x 2056])..............................................................654

20.5.1 Introduction........................................................................................................654

20.5.2 Spectral Sensitivity.............................................................................................655

20.5.3 Timings...............................................................................................................656

20.5.4 Device Feature And Property List......................................................................658

20.6 mvBlueFOX3-2051a (5.1 Mpix [2464 x 2056])............................................................754

20.6.1 Introduction........................................................................................................755

20.6.2 Spectral Sensitivity.............................................................................................755

20.6.3 Timings...............................................................................................................756

20.6.4 Device Feature And Property List......................................................................758

20.7 mvBlueFOX3-2089 (8.9 Mpix [4112 x 2176])..............................................................852

20.7.1 Introduction........................................................................................................853

20.7.2 Spectral Sensitivity.............................................................................................853

20.7.3 Timings...............................................................................................................854

20.7.4 Device Feature And Property List......................................................................856

20.8 mvBlueFOX3-2089a (8.9 Mpix [4112 x 2176])............................................................952

20.8.1 Introduction........................................................................................................952

20.8.2 Spectral Sensitivity.............................................................................................953

20.8.3 Timings...............................................................................................................953

20.8.4 Device Feature And Property List......................................................................956

20.9 mvBlueFOX3-2124 (12.4 Mpix [4112 x 3008])..........................................................1049

20.9.1 Introduction......................................................................................................1049

20.9.2 Spectral Sensitivity...........................................................................................1049

20.9.3 Timings.............................................................................................................1050

20.9.4 Device Feature And Property List....................................................................1053

20.10 mvBlueFOX3-2124a (12.4 Mpix [4112 x 3008])......................................................1149

20.10.1 Introduction....................................................................................................1149

20.10.2 Spectral Sensitivity.........................................................................................1149

20.10.3 Timings...........................................................................................................1150

20.10.4 Device Feature And Property List..................................................................1153

21 Appendix A.2 CMOS specific camera / sensor data............................................................1247

21.1 mvBlueFOX3-1012b (1.2 Mpix [1280 x 960])............................................................1247

21.1.1 Introduction......................................................................................................1247

21.1.2 Spectral Sensitivity...........................................................................................1247

21.1.3 Timings.............................................................................................................1248

21.1.4 Device Feature And Property List....................................................................1250

Table of Contents

21 Appendix A.2 CMOS specific camera / sensor data

21.2 mvBlueFOX3-1012d (1.2 Mpix [1280 x 960])............................................................1342

21.2.1 Introduction......................................................................................................1342

21.2.2 Spectral Sensitivity...........................................................................................1343

21.2.3 Timings.............................................................................................................1344

21.2.4 Device Feature And Property List....................................................................1345

21.3 mvBlueFOX3-1013 (1.3 Mpix [1280 x 1024])............................................................1438

21.3.1 Introduction......................................................................................................1438

21.3.2 Spectral Sensitivity...........................................................................................1439

21.3.3 Timings.............................................................................................................1439

21.3.4 Device Feature And Property List....................................................................1441

21.4 mvBlueFOX3-1020 (1.9 Mpix [1600 x 1200])............................................................1575

21.4.1 Introduction......................................................................................................1575

21.4.2 Spectral Sensitivity...........................................................................................1576

21.4.3 Timings.............................................................................................................1576

21.4.4 Device Feature And Property List....................................................................1578

21.5 mvBlueFOX3-1020a (1.9 Mpix [1600 x 1200])..........................................................1670

21.5.1 Introduction......................................................................................................1670

21.5.2 Spectral Sensitivity...........................................................................................1670

21.5.3 Timings.............................................................................................................1671

21.5.4 Device Feature And Property List....................................................................1673

21.6 mvBlueFOX3-1031 (3.2 Mpix [2048 x 1536])............................................................1763

21.6.1 Introduction......................................................................................................1763

21.6.2 Spectral Sensitivity...........................................................................................1764

21.6.3 Timings.............................................................................................................1765

21.6.4 Device Feature And Property List....................................................................1766

21.7 mvBlueFOX3-1100 (11 Mpix [3856 x 2764]).............................................................1815

21.7.1 Introduction......................................................................................................1815

21.7.2 Spectral Sensitivity...........................................................................................1817

21.7.3 Timings.............................................................................................................1818

21.7.4 Device Feature And Property List....................................................................1819

21.8 mvBlueFOX3-1140 (14 Mpix [4384 x 3288]).............................................................1914

21.8.1 Introduction......................................................................................................1914

21.8.2 Spectral Sensitivity...........................................................................................1916

21.8.3 Timings.............................................................................................................1917

21.8.4 Device Feature And Property List....................................................................1918

22 Appendix B. Linux commands..............................................................................................1965

22.1 List of the most important shell commands...............................................................1965

1 Imprint

MATRIX VISION GmbH

Talstrasse 16

DE - 71570 Oppenweiler

Telephone: +49-7191-9432-0

Fax: +49-7191-9432-288

Website: http://www.matrix-vision.de

E-Mail:

[email protected]

Author:

U. Lansche

H. Mattfeldt

S. Battmer

U. Hagmaier

D. Neuholz

Date: 2013

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, assumes 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.

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.

•

1.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.

1.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.

1.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.

1.4 GenICam

At least one driver package shipped under the product family name mvIMPACT Acquire makes use

of the GenICam 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 reference

implementation are shipped with the libraries belonging to the GenICam runtime.

1.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).

1.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.

1 Imprint

Indice

Altri manuali Matrix Macchina fotografica digitale

Matrix

Matrix SATATYA Manuale utente

Manuali Macchina fotografica digitale popolari di altre marche

Mercury

Mercury 350K Manuale utente

Pentax

Pentax Optio LS 465 Manuale utente

Sanyo

Sanyo VPC-S1085 Manuale utente

GE SMART A1255 Manuale utente

Point Grey

Point Grey Gazelle Manuale utente

Nikon

Nikon COOLPIX A Manuale utente

Pentax

Pentax P-5 Manuale utente

BlazeVideo

BlazeVideo A280 Manuale utente

Sony

Sony MCA-20 Manuale utente

Sony

Sony Alpha DSLR-A290 Manuale utente

ATIK Cameras

ATIK Cameras One Manuale utente

CohuHD Costar

CohuHD Costar 3930 Series Manuale utente

Leica

Leica M10-R Manuale utente

FujiFilm

FujiFilm FinePix A700 Manuale utente

Lorex

Lorex LNZ81P25 Series Manuale utente

GE J1470S Manuale utente

Sony

Sony A6700 Guida utente

Canon

Canon EOS ELAN7 Manuale utente

Matrix mvBlueFOX3 Manuale utente

Manuali Macchina fotografica digitale popolari di altre marche