|
FG Camera Library
1.7.3.0 (2026-04-13)
|
|
|
FG Camera Library
1.7.3.0 (2026-04-13)
|
|
Header file for this libraray.
For a description on how to use this library take a look at First Steps.
Data Structures | |
| struct | FG_IMAGE |
| This structure stores information associated with image buffers. More... | |
| struct | FG_VERSION |
| struct for the library version "libFGCamera.so.major.minor.patchlevel.buildnumber" More... | |
Macros | |
| #define | FG_VERSION_BUILDNUMBER 0 |
| Library version build number. | |
| #define | FG_VERSION_MAJOR 1 |
| Library version major number. | |
| #define | FG_VERSION_MINOR 7 |
| Library version minor number. | |
| #define | FG_VERSION_NUMBER (FG_VERSION_BUILDNUMBER + 100 * (FG_VERSION_PATCHLEVEL + 100 * (FG_VERSION_MINOR + 100 * FG_VERSION_MAJOR))) |
| Library version number. | |
| #define | FG_VERSION_PATCHLEVEL 3 |
| Library version patch number. | |
Enumerations | |
| enum | eFG_CAMERA_TYPE |
| The following camera models are supported by this library. More... | |
| enum | eFG_ERROR_CODE |
| The result code for all library functions. More... | |
| enum | eFG_PIXEL_ORDER |
| Order of pixel components in memory (see FG_get_pixel_order()). More... | |
| enum | eFG_PIXEL_TYPE |
| The data format for storing images in memory, see FG_set_scan_param() and FG_set_aoi(). More... | |
| enum | eFG_TRIGGER_MODE |
| Trigger mode definitions, see FG_set_trigger_mode() for a description. More... | |
Functions | |
| UINT32 DLL_FG_API | FG_alloc_image (FG_IMAGE *img) |
| Allocates a new image buffer for storing sensor frames. | |
| UINT32 DLL_FG_API | FG_append_image (FG_IMAGE *img) |
| Puts an image buffer into the aquisition queue. | |
| UINT32 DLL_FG_API | FG_free_image (FG_IMAGE *img) |
| Releases an image buffer. | |
| UINT32 DLL_FG_API | FG_get_aoi (UINT32 *x1, UINT32 *y1, UINT32 *x2, UINT32 *y2, enum eFG_PIXEL_TYPE *pixel_type) |
| Returns the area of interest and the output format. | |
| UINT32 DLL_FG_API | FG_get_black (UINT32 *black) |
| Returns the normalized black level. | |
| UINT32 DLL_FG_API | FG_get_camera_type (enum eFG_CAMERA_TYPE *camera_type) |
| Returns the installed camera type. | |
| UINT32 DLL_FG_API | FG_get_gain (UINT32 *gain) |
| Returns the normalized gain value. | |
| UINT32 DLL_FG_API | FG_get_gain_rgb (UINT32 *gain_red, UINT32 *gain_green, UINT32 *gain_blue) |
| Returns the normalized color gain values for supported hardware. | |
| UINT32 DLL_FG_API | FG_get_image (FG_IMAGE *img, UINT32 TimeOut_ms) |
| Returns captured images to the user. | |
| UINT32 DLL_FG_API | FG_get_image_size (UINT32 *width, UINT32 *height, UINT32 *bytes) |
| Returns the size of the image buffers. | |
| UINT32 DLL_FG_API | FG_get_last_error (char *error_sting, UINT32 max_string_size) |
| Returns an error description for the last failed library call. | |
| UINT32 DLL_FG_API | FG_get_pixel_order (enum eFG_PIXEL_ORDER *pixel_order) |
| Returns the order of pixel components within image buffers. | |
| UINT32 DLL_FG_API | FG_get_scan_param (UINT32 *scan_x, UINT32 *scan_y, UINT32 *scan_width, UINT32 *scan_height, UINT32 *image_scan_count, enum eFG_PIXEL_TYPE *pixel_type) |
| Returns the area of interest and the output format. | |
| UINT32 DLL_FG_API | FG_get_shutter_time (UINT32 *shutter_time_us) |
| Returns the exposure time in µs. | |
| UINT32 DLL_FG_API | FG_get_special_option (const char *option, INT64 *result) |
| Returns a special camera property value. | |
| UINT32 DLL_FG_API | FG_get_timestamp (FG_IMAGE *img, UINT64 *pTimestamp) |
| Returns the image completion timestamp of a captured image. | |
| UINT32 DLL_FG_API | FG_get_trigger_mode (enum eFG_TRIGGER_MODE *trigger_mode) |
| Returns the configured trigger mode. | |
| UINT32 DLL_FG_API | FG_get_version (FG_VERSION *lib_version) |
| Returns the library version. | |
| UINT32 DLL_FG_API | FG_install_camera (enum eFG_CAMERA_TYPE camera_type,...) |
| Opens and initializes the camera. | |
| UINT32 DLL_FG_API | FG_save_image (FG_IMAGE *img, const char *filename) |
| Saves the given image into an BMP file. | |
| UINT32 DLL_FG_API | FG_set_aoi (UINT32 x1, UINT32 y1, UINT32 x2, UINT32 y2, enum eFG_PIXEL_TYPE pixel_type) |
| Sets the area of interest and the output format. | |
| UINT32 DLL_FG_API | FG_set_black (UINT32 black) |
| Sets the black level using a normalized value. | |
| UINT32 DLL_FG_API | FG_set_gain (UINT32 gain) |
| Sets the gain using a normalized value. | |
| UINT32 DLL_FG_API | FG_set_gain_rgb (UINT32 gain_red, UINT32 gain_green, UINT32 gain_blue) |
| Sets the color component gain values for supported hardware. | |
| UINT32 DLL_FG_API | FG_set_pixel_order (enum eFG_PIXEL_ORDER pixel_order) |
| Sets the order of pixel components within image buffers. | |
| UINT32 DLL_FG_API | FG_set_scan_param (UINT32 scan_x, UINT32 scan_y, UINT32 scan_width, UINT32 scan_height, UINT32 image_scan_count, enum eFG_PIXEL_TYPE pixel_type) |
| Sets the area of interest and output format. | |
| UINT32 DLL_FG_API | FG_set_shutter_time (UINT32 shutter_time_us) |
| Sets the exposure time in µs. | |
| UINT32 DLL_FG_API | FG_set_special_option (const char *option, INT64 arg) |
| Configures a special camera property. | |
| UINT32 DLL_FG_API | FG_set_trigger_mode (enum eFG_TRIGGER_MODE trigger_mode) |
| Sets the trigger mode. | |
| UINT32 DLL_FG_API | FG_stop_image (void) |
| Forces the camera to stop grabbing and using any buffers. | |
| UINT32 DLL_FG_API | FG_trigger_image (void) |
| Triggers the next image in software triggered mode. | |
| UINT32 DLL_FG_API | FG_uninstall_camera (void) |
| Closes the camera. | |
| #define FG_VERSION_NUMBER (FG_VERSION_BUILDNUMBER + 100 * (FG_VERSION_PATCHLEVEL + 100 * (FG_VERSION_MINOR + 100 * FG_VERSION_MAJOR))) |
Library version number.
The library version has the following structure: <major>.<minor>.<patchlevel>.<buildnumber>
For example, the library version 1.2.8.0 produces a value of 1020800 after evaluation of the VIB_VERSION expression by the compiler.
| enum eFG_CAMERA_TYPE |
The following camera models are supported by this library.
| enum eFG_ERROR_CODE |
The result code for all library functions.
| Enumerator | ||
|---|---|---|
| FG_ERROR_CODE_NoError | 0 | The function was successful. |
| FG_ERROR_CODE_Unknown | 1 | Unknown error. |
| FG_ERROR_CODE_InvalidArgument | 3 | The function arguments are invalid. |
| FG_ERROR_CODE_InvalidCameraChannel | 4 | The selected camera channel is invalid. |
| FG_ERROR_CODE_GrabTimeOut | 5 | Only valid for FG_get_image(): acquisition timeout. |
| FG_ERROR_CODE_BrokenImage | 6 | Only valid for FG_get_image(): the returned image contents are invalid. |
| FG_ERROR_CODE_ExtraErrorInformation | 100 | Other errors, use FG_get_last_error() to obtain the error message. |
| enum eFG_PIXEL_ORDER |
Order of pixel components in memory (see FG_get_pixel_order()).
| enum eFG_PIXEL_TYPE |
The data format for storing images in memory, see FG_set_scan_param() and FG_set_aoi().
Supported values depend on the sensor / camera type.
| enum eFG_TRIGGER_MODE |
Trigger mode definitions, see FG_set_trigger_mode() for a description.
| Enumerator | ||
|---|---|---|
| FG_TRIGGER_MODE_SOFTWARE | 0 | Software triggered mode. |
| FG_TRIGGER_MODE_HARDWARE | 1 | Hardware triggered mode. |
| FG_TRIGGER_MODE_FREERUN | 2 | Free-run triggered mode. |
1.16.1