Basic example source code

First Steps example source code

/opt/ImagoTechnologies/SDK/examples/FGExample_Linux/src/main.c

#include <stdio.h>
#include <signal.h>
 
#include "FG_CameraInterface.h"
 
#define NUM_BUFFERS 4   // number of image buffers used for the acquisition queue
 
int isRunning = 1;
 
// Signal handler for stopping the program
static void sigint_handler(int signo)
{
    if (signo == SIGINT)
        isRunning = 0;
}
 
int main()
{
    FG_IMAGE imageList[NUM_BUFFERS];
    UINT32 fgResult;
    char ErrText[512];
    UINT32 x1, y1, x2, y2;
    UINT32 width, height;
    enum eFG_PIXEL_TYPE pixel_type;
 
    // register signal handler for CTRL-C:
    signal(SIGINT, sigint_handler);
 
 
    // initialize the camera using automatic type detection
    fgResult = FG_install_camera(FG_CAMERA_TYPE_X_X_IMAGO_Vxx_AUTO);
    if (fgResult != FG_ERROR_CODE_NoError)
    {
        FG_get_last_error(ErrText, sizeof(ErrText));
        printf("FG_install_camera() failed! \n - ErrorCode: %d \n - ErrorText '%s'", fgResult, ErrText);
        return -1;
    }
 
 
    // set trigger mode to free-run:
    FG_set_trigger_mode(FG_TRIGGER_MODE_FREERUN);
 
    // get default AOI and pixel type:
    FG_get_aoi(&x1, &y1, &x2, &y2, &pixel_type);
    // set new pixel type:
    FG_set_aoi(x1, y1, x2, y2, FG_PIXEL_TYPE_Y_8);
 
    // Set the exposure time:
    FG_set_shutter_time(1000);   // 1000 microseconds
 
    width = x2 - x1 + 1;
    height = y2 - y1 + 1;
    printf("Sensor size: %u x %u\n", width, height);
 
    // allocate image buffers and them to the queue
    for (UINT32 i = 0; i < NUM_BUFFERS; i++)
    {
        FG_alloc_image(&imageList[i]);
        FG_append_image(&imageList[i]);
    }
 
    printf("Starting acquisition loop, press CTRL-C to stop the program.\n");
 
    while (isRunning)
    {
        FG_IMAGE currentImage;
 
        // wait for the image
        fgResult = FG_get_image(&currentImage, 1000);   // 1000 ms timeout
        if (fgResult == FG_ERROR_CODE_NoError)
        {
            if ((currentImage.image_number % 100) == 0)
                printf("100 frames received, current frame number: %u\n", currentImage.image_number);
 
            // todo: work with the image data => currentImage.pixel_ptr[x + y * width];
 
            // add the buffer again to the free queue again
            FG_append_image(&currentImage);
        }
        else if (fgResult == FG_ERROR_CODE_BrokenImage)
        {
            // the image is valid, but the contents are broken or incomplete, add the buffer again or release it
            printf("FG_get_image() returned a broken image\n");
            FG_append_image(&currentImage);
        }
        else if (fgResult == FG_ERROR_CODE_GrabTimeOut)
        {
            // timout occured, the image is invalid
            printf("FG_get_image() timeout occured\n");
        }
        else
        {
            // other error occured, the image is invalid
            FG_get_last_error(ErrText, sizeof(ErrText));
            printf("FG_get_image() failed! \n - ErrorCode: %d \n - ErrorText '%s'", fgResult, ErrText);
            break;
        }
    }
 
    printf("Closing the program...\n");
    
    // abort image acquisition
    FG_stop_image();
 
    // free buffers
    for (UINT32 i = 0; i < NUM_BUFFERS; i++)
    {
        FG_free_image(&imageList[i]);
    }
 
    // close the camera
    FG_uninstall_camera();
    
    return 0;
}