Structures

This section outlines the primary structures used to handle frame data, network configuration, and device information for Emergent Vision Technologies cameras.

CEmergentFrame structure

The CEmergentFrame structure provides comprehensive information about each captured image frame, including details on format, size, offsets, and timing data. It organizes these essential attributes, enabling easy management of image data, timestamps, and format options. For example, pixel_type and imagePtr allow developers to interpret and manipulate raw pixel data, while size_x and size_y define the frame dimensions.

The CEmergentFrame structure contains the following fields:

• enum PIXEL_FORMAT pixel_type: Defines the pixel format (types are listed in emergentframebase.h).
• unsigned int size_x: Frame width in pixels (from GVSP header).
• unsigned int size_y: Frame height in pixels (from GVSP header).
• unsigned int offset_x: X-axis offset within the frame (from GVSP header).
• unsigned int offset_y: Y-axis offset within the frame (from GVSP header).
• unsigned int padding_x: Horizontal padding to align frame data.
• unsigned int padding_y: Vertical padding to align frame data.
• unsigned int trailer_size_y: Size of any trailer data after the image data.
• unsigned short frame_id: Frame’s unique identifier (also called block_id in GVSP).
• unsigned char* imagePtr: Pointer to the image data buffer.
• int convertColor: Defines color conversion (types are listed in emergentframebase.h).
• int convertBitDepth: Defines bit-depth conversion (types are listed in emergentframebase.h).
• unsigned long long nsecs: Precise timestamp in nanoseconds for frames using Myri sync NIC and IRIGB.
• unsigned long long timestamp: General timestamp for GevTimestamp values.

GigEVisionDeviceInfo structure

The GigEVisionDeviceInfo structure contains essential configuration and identification data for GigE Vision-compliant cameras, pulling data directly from the GigE Vision bootstrap registers to facilitate networked camera management. This structure streamlines the handling of network settings and device metadata, providing key details for IP configuration, device identification, and versioning—crucial for applications using multiple networked cameras.

The GigEVisionDeviceInfo structure contains the following fields:

• unsigned short specVersionMajor: Major version of the GigE Vision specification.
• unsigned short specVersionMinor: Minor version of the GigE Vision specification.
• unsigned int deviceMode: Specifies the current operating mode of the device.
• char macAddress[18]: MAC address of the device.
• unsigned int ipConfigOptions: Available IP configuration options (e.g., DHCP, static IP).
• unsigned int ipConfigCurrent: Current IP configuration mode.
• char currentIp[16]: Current IP address of the device.
• char currentSubnetMask[16]: Current subnet mask of the device.
• char defaultGateway[16]: Default gateway for the device.
• char manufacturerName[32]: Manufacturer’s name.
• char modelName[32]: Model name of the device.
• char deviceVersion[32]: Firmware version of the device.
• char manufacturerSpecifiedInfo[48]: Additional manufacturer-specific information.
• char serialNumber[16]: Unique serial number of the device.
• char userDefinedName[16]: Customizable user-defined name for the device.
• char hostInterfaceIp[16]: IP address of the host interface communicating with the device.