GigE Vision Image Acquisition

Acquire images from GigE Vision^® cameras

Image Acquisition Toolbox™ includes a separate interface for use with GigE Vision compliant cameras. This interface is designed for GigE Vision cameras and supports more GigE-specific functionality.

You can continue to use the GigE Vision adaptor (gige) with the videoinput object, or you can use the gigecam object, which takes advantage of GigE properties and features and is more consistent with GigE Vision conventions for displaying properties and managing selector properties. The functionality for both of these objects is included in the support package.

For more information about choosing the interface, see GigE Vision Acquisition: gigecam Object vs. videoinput Object.

For information about acquiring images from GigE Vision hardware using the GigE Vision adaptor (gige) with the videoinput object, see the Image Acquisition Toolbox documentation. The functions and topics below contain information about acquiring images from GigE Vision hardware using the gigecam object.

Functions

`gigecamlist`	List of GigE Vision cameras connected to your system
`gigecam`	Create `gigecam` object to acquire images from GigE Vision cameras
`commands`	List of commands available for GigE Vision camera
`executeCommand`	Execute command on GigE Vision camera
`snapshot`	Acquire single image frame from GigE Vision camera
`preview`	Preview of live video data
`closepreview`	Close Video Preview window

Topics

GigE Vision Acquisition: gigecam Object vs. videoinput Object
You can continue to use the GigE Vision adaptor (gige) with the videoinput object, or you can use the gigecam object, which takes advantage of GigE properties and features and is more consistent with GigE Vision conventions for displaying properties and managing selector properties.
Connect to GigE Vision Cameras
Use the gigecamlist function to return the list of available GigE Vision Compliant cameras connected to your system.
Set Properties for GigE Acquisition
One of the main advantages of using the gigecam object for image acquisition, instead of the gige adaptor with the videoinput object, is the advanced property features of GigE Vision Compliant hardware.
Acquire Images from GigE Vision Cameras
To acquire images from a GigE Vision Compliant camera, you first use the gigecam function to create a GigE object. You then use the snapshot function to acquire images one frame at a time.
Use Advanced Property Support in the GigE Vision and GenICam GenTL Interfaces
The GigE Vision and GenICam™ GenTL interfaces offer advanced property support.

Troubleshooting

GigE Vision Hardware

Try these tips if you have problems using the toolbox with GigE Vision image acquisition devices. Information is provided for all platforms.

Featured Examples

Hardware-Triggered Acquisition with a GigE Vision Camera

Image Acquisition Toolbox™ provides functionality for hardware-triggered acquisition from GigE Vision® cameras. This is useful in applications where camera acquisition needs to be synchronized with another device (such as a DAQ device or another camera) by means of an external triggering signal. Other applications include controlling the acquisition frame rate with an external signal, or acquiring a multiple-exposure image sequence for high dynamic range (HDR) imaging. This example shows how to use the videoinput gige interface to configure a camera acquisition to allow external triggering-signal control over the frame rate and over the exposure time.

Open Live Script