Main Content

matroxcam

Create matroxcam object to acquire images from Matrox frame grabbers

collapse all in page

Add-On Required: This feature requires the Image Acquisition Toolbox Support Package for Matrox Hardware add-on.

Syntax

m = matroxcam(devicenumber, 'DCFfilename')

Description

m = matroxcam(devicenumber, 'DCFfilename') creates a matroxcam object m, where devicenumber is a numeric scalar value that identifies a particular device by its index number and DCFfilename is the name and fully qualified path of your Matrox® DCF file, and connects it to that frame grabber.

example

Examples

collapse all

Use the matroxcam function with an index as the first input argument to create the object corresponding to that index and connect it to that frame grabber. The index corresponds to the order of boards in the cell array returned by matroxlist when you have multiple frame grabbers connected. If you only have one frame grabber, you must use a 1 as the input argument. The second argument must be the name and path of your DCF file, entered as a character vector.

Use the matroxlist function to ensure that MATLAB® is discovering your frame grabbers.

matroxlist
ans = 

   Solios XCL (digitizer 0)
   Solios XCL (digitizer 1)
   VIO (digitizer 0)

Create an object, m, using the index number. In this example, for the Solios XCL at digitizer 1, use a 2 as the index number, since it is the second device on the list. The second argument must be the name of your DCF file, entered as a character vector. It must contain the fully qualified path to the file as well. In this example, the DCF file is named mycam.dcf.

m = matroxcam(2, 'C:\Drivers\Solios\dcf\XCL\Basler\A404K\mycam.dcf')
m = 

Display Summary for matroxcam:

         DeviceName: 'Solios XCL (digitizer 1)'
            DCFName: 'C:\Drivers\Solios\dcf\XCL\Basler\A404K\mycam.dcf'
    FrameResolution: '1300 x 1080' 
            Timeout: 10

Input Arguments

collapse all

Device number of your frame grabber, specified as a numeric scalar. This number identifies a particular board by its index order. It creates the object corresponding to that index and connects it to that frame grabber. The index corresponds to the order of frame grabbers in the table returned by matroxlist when you have multiple boards connected.

If you only have one frame grabber, you must use a 1 as the input argument.

Example: m = matroxcam(2, 'C:\Drivers\Solios\dcf\XCL\Basler\A404K\mycam.dcf')

Data Types: double

Name of your DCF file, specified as a character vector. The Digitizer Configuration File (DCF) is used to set acquisition properties and is configured using the Matrox Intellicam software. The DCF file contains properties relating to exposure signal, grab mode, sync signal, camera, video signal, video timing, and pixel clock. Once you have configured these properties in your DCF file, you create the matroxcam object using that file as an input argument. It must contain the fully qualified path to the file as well. In this example, the DCF file is named mycam.dcf.

Example: m = matroxcam(2, 'C:\Drivers\Solios\dcf\XCL\Basler\A404K\mycam.dcf')

Data Types: char | string

Version History

Introduced in R2014b

See Also

| | |

Topics