GigE Camera

Table of Contents

• Overview
• Initializing GigE cameras
• Special features

Overview

The GigE camera implementation only supports IMAGO devices which have installed and running a dedicated GigE server, acting as a GigE Vision device.

GigE server	Camera hardware	eFG_CAMERA_TYPE	Number of pixels
Stand-alone	VisionSensor PV3 - EV2S02MB	FG_CAMERA_TYPE_GIGE_IMAGO_VSx_EV2S02MB	1920 x 1080
	VisionSensor PV3 - EV2S02MC	FG_CAMERA_TYPE_GIGE_IMAGO_VSx_EV2S02MC	1920 x 1080
	VisionSensor PV3 - EV2S05MB	FG_CAMERA_TYPE_GIGE_IMAGO_VSx_EV2S05MB	2560 x 1936
	VisionSensor PV3 - EV2S05MC	FG_CAMERA_TYPE_GIGE_IMAGO_VSx_EV2S05MC	2560 x 1936
ViewIT	dynamic	FG_CAMERA_TYPE_GIGE_IMAGO_VIEWIT	dynamic

Note

The GigE device implementations provided by IMAGO can also be used with other third-party GigE applications. But the FG Camera library currently only supports IMAGO's servers / cameras.

Initializing GigE cameras

For GigE cameras the function FG_install_camera() expects an additional 32-bit argument containing the IPv4 address of the device. The camera type FG_CAMERA_TYPE_GIGE_AUTO can be used for auto-detection of the camera type.

Example:

struct in_addr addr;
 
if (inet_aton("192.168.0.100", &addr) != 0)
{
    printf("Invalid IP address\n");
    return -1;
}
 
if (FG_install_camera(FG_CAMERA_TYPE_GIGE_AUTO, addr.s_addr) != FG_ERROR_CODE_NoError)
{
    char error_text[200];
    FG_get_last_error(error_text, sizeof(error_text));
    printf("FG_install_camera() failed: %s", error_text);
    return -1;
}
 
...

Special features

The GigE camera supports the following special features:

Special features

Property name	Argument	Description
SCPDx	0...1000000: Inter-packet delay in micro-seconds	Sets the Stream Channel Packet Delay value which controls transmission speed. The default value is 0.
FrameRate	0: Use maximum frame rate ≥ 1: Desired frame rate in Hertz	Sets the desired sensor frame rate. This setting is only applied in free run mode. The actual frame rate may be lower if the exposure time setting is too high, or if the sensor's limit is exceeded.
Mirror	0: no flipping (default) 1: flip horizontally 2: flip vertically 3: flip horizontally and vertically (rotation by 180°)	Flips the image horizontally and / or vertically. Note The order of color components for raw Bayer format depends on this setting. Use FG_get_pixel_order() to get the order after the Mirror option is configured.
ImageMode	0: Video output 1: Enable test pattern	Controls the digital test pattern.
StrobeMode	0...3: strobe mode (default: 2)	Sets the operating mode for the integrated LED and the exposure signal for replacing the physical mode switch, see also: Controlling the integrated LED and exposure signal output
StrobeOutput	0...<i>: index of digital output signal OUT<i> (default: 0)	Selects the digital output line for the external exposure signal.
TriggerLine	See VisionSensor PV3 hardware trigger	Selects the trigger signal in hardware triggered mode.
Focus	0...255: DAC value (default: 128)	Sets the focus of the optional Liquid Lens, see also: Liquid Lens (VisionSensor PV3)
DebounceTime	0...1000000: Debounce time in micro-seconds	Sets the debounce time for the digital inputs. Note This feature is not supported by the ViewIT GigE server.

Note

Support for some features depend on the actual hardware that the ViewIT GigE server is running on.