Matlab Use Cameras

Using Cameras in MATLAB

Use Image Acquisition Toolbox's videoinput as the primary interface for all camera workflows. Other interfaces (webcam, gigecam) are secondary and should only be used when explicitly requested or when videoinput is unavailable.

When to Use

• User wants to connect to a camera (webcam, USB, GigE, USB3 Vision, CoaXPress, Camera Link)
• User wants to acquire images or video frames
• User wants to preview live camera feed
• User wants to list or enumerate available cameras
• User wants to acquire images from a CoaXPress frame grabber
• User wants to acquire images via a Camera Link frame grabber
• User asks "how do I use my webcam/camera in MATLAB?"
• User mentions Image Acquisition Toolbox

When NOT to Use

• User explicitly requests webcam() from the webcam support package
• User is on MATLAB Online (where videoinput is not available — use webcam())
• User is doing image processing on existing files (no camera involved)
• User is working with non-imaging hardware (oscilloscopes, data acquisition boards)

Conventions

API Priority Rules

These rules are critical. Follow them unless the user explicitly requests otherwise.

1. Always use videoinput() from Image Acquisition Toolbox as the primary camera interface
2. Always use imaqhwinfo for device enumeration — not webcamlist or gigecamlist
3. For GigE Vision cameras: use videoinput("gentl", ...) — not gigecam or videoinput("gige")
4. For USB/built-in webcams on Windows: use videoinput("winvideo", ...)
5. For USB/built-in webcams on macOS: use videoinput("macvideo", ...)
6. For USB/built-in webcams on Linux: use videoinput("linuxvideo", ...)
7. For CoaXPress cameras: use videoinput("gentl", ...) — CoaXPress frame grabbers always provide GenTL producers
8. For Camera Link cameras: prefer videoinput("gentl", ...) if the frame grabber provides a GenTL producer; otherwise use the vendor-specific adaptor (e.g., videoinput("ni", ...), videoinput("dalsa", ...))
9. If user specifies a CoaXPress or Camera Link camera without naming the frame grabber: ask the user which frame grabber they are using before writing code — the adaptor choice depends on the frame grabber
10. Never describe videoinput as "legacy" or "advanced" — it is the primary, full-featured interface

When to use webcam() instead

Only in these cases:

• User explicitly asks for it
• User is on MATLAB Online
• Image Acquisition Toolbox is not installed (confirm with imaqhwinfo)

Required support packages

Important: The GenICam Interface support package provides only the MATLAB-side consumer. For gentl cameras, you must also install the vendor's GenTL producer (a .cti file). Examples: Spinnaker SDK for FLIR, Vimba X for Allied Vision, ImpactAcquire for Balluff, Euresys eGrabber for Euresys frame grabbers. The producer is NOT bundled with the MATLAB support package.

Workflow

1. Enumerate devices

% List all available adaptors and devices
info = imaqhwinfo;
disp(info.InstalledAdaptors)

% Get details for a specific adaptor
adaptorInfo = imaqhwinfo("winvideo");
disp(adaptorInfo.DeviceInfo)

2. Connect to camera

% USB/built-in webcam on Windows
vid = videoinput("winvideo", 1);

% GigE Vision camera via GenTL
vid = videoinput("gentl", 1);

% Specify a format
vid = videoinput("winvideo", 1, "YUY2_1280x720");

3. Configure properties

% Set color space
vid.ReturnedColorSpace = "rgb";

% Set region of interest [x_offset y_offset width height]
vid.ROIPosition = [0 0 640 480];

% Access device-specific properties via the source object
src = getselectedsource(vid);

4. Preview live video

preview(vid);
pause(3);

5. Acquire frames

Single snapshot:

img = getsnapshot(vid);
imshow(img);

Multiple frames (immediate trigger):

vid.FramesPerTrigger = 10;
start(vid);
wait(vid);
[frames, timestamps] = getdata(vid);

Manual trigger (acquire on demand):

triggerconfig(vid, "manual");
vid.FramesPerTrigger = 1;
start(vid);
trigger(vid);
img = getdata(vid);

6. Clean up

stoppreview(vid);
stop(vid);
delete(vid);
clear vid;

Key Functions

Patterns

USB/Built-in Webcam (Windows)

% Enumerate
info = imaqhwinfo("winvideo");
disp(info.DeviceInfo.DeviceName)

% Connect and configure
vid = videoinput("winvideo", 1, "YUY2_1280x720");
vid.ReturnedColorSpace = "rgb";
vid.FramesPerTrigger = 1;

% Preview and capture
preview(vid);
pause(2);
img = getsnapshot(vid);
imshow(img);

% Clean up
stoppreview(vid);
delete(vid);
clear vid;

GigE Vision Camera (GenTL)

The GenTL adaptor is the preferred interface for GigE Vision and USB3 Vision cameras. It supports the full GenICam standard and works across camera vendors.

% Enumerate
info = imaqhwinfo("gentl");
disp(info.DeviceInfo.DeviceName)

% Connect
vid = videoinput("gentl", 1);
vid.ReturnedColorSpace = "rgb";

% Configure acquisition
vid.FramesPerTrigger = 10;

% Access GenICam properties via source object
src = getselectedsource(vid);

% Acquire
start(vid);
wait(vid);
[frames, timestamps] = getdata(vid);

% Clean up
stop(vid);
delete(vid);
clear vid;

If the GenTL adaptor is not installed, guide the user through setup:

1. Install "Image Acquisition Toolbox Support Package for GenICam Interface" via Add-On Explorer
2. Install the vendor's GenTL producer (a .cti file) — e.g., Spinnaker SDK for FLIR cameras, Vimba X for Allied Vision, or the vendor's GigE Vision SDK
3. Verify with imaqhwinfo("gentl") — the camera should appear in DeviceInfo

See references/gentl-setup.md for detailed GenTL producer configuration and troubleshooting.

CoaXPress Camera (via Frame Grabber)

CoaXPress frame grabbers always provide a GenTL producer, so the workflow is identical to GigE Vision via the gentl adaptor.

% Enumerate — CoaXPress cameras appear under the gentl adaptor
info = imaqhwinfo("gentl");
disp(info.DeviceInfo.DeviceName)

% Connect and acquire
vid = videoinput("gentl", 1);
vid.ReturnedColorSpace = "rgb";
vid.FramesPerTrigger = 10;
src = getselectedsource(vid);
start(vid);
wait(vid);
[frames, timestamps] = getdata(vid);

% Clean up
stop(vid);
delete(vid);
clear vid;

Camera Link Camera (via Frame Grabber)

Camera Link has two paths depending on whether the frame grabber vendor provides a GenTL producer:

With GenTL producer (preferred): Use videoinput("gentl", ...) — same as GigE/CoaXPress above.

Without GenTL producer (vendor adaptor): Use the vendor-specific adaptor registered with imaqhwinfo:

% Check which adaptors are available
info = imaqhwinfo;
disp(info.InstalledAdaptors)

% Connect via vendor adaptor (e.g., "ni" for National Instruments)
vid = videoinput("ni", 1);
vid.ReturnedColorSpace = "rgb";
src = getselectedsource(vid);

Important: If the user mentions a Camera Link or CoaXPress camera without specifying the frame grabber, ask which frame grabber they are using. The correct adaptor depends on the frame grabber, not the camera.

Common Mistakes

Copyright 2026 The MathWorks, Inc.