void configureExternalTriggerCamera(FlyCaptureContext context){
FlyCaptureError error;
FlyCaptureImage image;
//printf( "Initializing camera.\n" );
//
// Initialize the first camera on the bus.
//
error = flycaptureInitialize( context, 0 );
_HANDLE_ERROR(error, "flycaptureInitialize()" );
/* //
// Reset the camera to default factory settings by asserting bit 0
//
error = flycaptureSetCameraRegister( context, INITIALIZE, 0x80000000 );
_HANDLE_ERROR(error, "flycaptureSetCameraRegister()" );*/
//
// Power-up the camera (for cameras that support this feature)
//
error = flycaptureSetCameraRegister( context, CAMERA_POWER, 0x80000000 );
_HANDLE_ERROR(error, "flycaptureSetCameraRegister()" );
//
// Determine whether or not the camera supports external trigger mode.
// If it does, put the camera into external trigger mode and otherwise
// exit.
//
bool bTriggerPresent;
error = flycaptureQueryTrigger(
context, &bTriggerPresent, NULL, NULL, NULL, NULL, NULL, NULL, NULL );
_HANDLE_ERROR(error, "flycaptureQueryTrigger()" );
if( !bTriggerPresent)
{
printf("This camera does not support external trigger... exiting\n");
}
int iPolarity;
int iSource;
int iRawValue;
int iMode;
error = flycaptureGetTrigger(
context, NULL, &iPolarity, &iSource, &iRawValue, &iMode, NULL );
_HANDLE_ERROR(error, "flycaptureGetTrigger()" );
//printf( "Going into asynchronous Trigger_Mode_0.\n" );
//
// Ensure the camera is in Trigger Mode 0 by explicitly setting it,
// as the camera could have a different default trigger mode
//
#ifdef SOFTWARE_TRIGGER_CAMERA
//
// We are triggering the camera using the internal software trigger.
// If we are using the DCAM SOFTWARE_TRIGGER functionality, we must
// change the Trigger_Source to reflect the Software Trigger ID = 7.
//
error = flycaptureSetTrigger(
context, true, iPolarity, 7, 0, 0 );
_HANDLE_ERROR( "flycaptureSetCameraTrigger()", error );
#else
//
// We are triggering the camera using an external hardware trigger.
//
error = flycaptureSetTrigger(
context, true, iPolarity, iSource, 0, 0 );
_HANDLE_ERROR(error, "flycaptureSetCameraTrigger()" );
#endif
//
// Poll the camera to make sure the camera is actually in trigger mode
// before we start it (avoids timeouts due to the trigger not being armed)
//
checkTriggerReady( context );
//
// Start the camera and grab any excess images that are already in the pipe.
// Although it is extremely rare for spurious images to occur, it is
// possible for the grab call to return an image that is not a result of a
// user-generated trigger. To grab excess images, set a zero-length timeout.
// A value of zero makes the grab call non-blocking.
//
//printf( "Checking for any buffered images..." );
error = flycaptureSetGrabTimeoutEx( context, 0 );
_HANDLE_ERROR(error, "flycaptureSetGrabTimeoutEx()" );
error = flycaptureStart(
context, FLYCAPTURE_VIDEOMODE_ANY, FLYCAPTURE_FRAMERATE_ANY );
_HANDLE_ERROR(error, "flycaptureStart()" );
//
// Grab the image immediately whether or not trigger present
//
error = flycaptureGrabImage2( context, &image );
if( error == FLYCAPTURE_OK )
{
;//printf( "buffered image found. Flush successful.\n" );
}
else if( error == FLYCAPTURE_TIMEOUT )
{
;//printf( "no flush required! (normal behaviour)\n" );
}
else
{
_HANDLE_ERROR(error, "flycaptureGrabImage2()" );
}
error = flycaptureStop( context );
_HANDLE_ERROR(error, "flycaptureStop()" );
}
//=============================================================================
// Main Program
//=============================================================================
int
main( int /* argc */, char* /* argv[] */ )
{
FlyCaptureError error;
FlyCaptureContext context;
FlyCaptureImage image;
printf( "Initializing camera.\n" );
//
// Create the context.
//
error = flycaptureCreateContext( &context );
HANDLE_ERROR( "flycaptureCreateContext()", error );
//
// Initialize the first camera on the bus.
//
error = flycaptureInitialize( context, 0 );
HANDLE_ERROR( "flycaptureInitialize()", error );
//
// Reset the camera to default factory settings by asserting bit 0
//
error = flycaptureSetCameraRegister( context, INITIALIZE, 0x80000000 );
HANDLE_ERROR( "flycaptureSetCameraRegister()", error );
//
// Power-up the camera (for cameras that support this feature)
//
error = flycaptureSetCameraRegister( context, CAMERA_POWER, 0x80000000 );
HANDLE_ERROR( "flycaptureSetCameraRegister()", error );
//
// Determine whether or not the camera supports external trigger mode.
// If it does, put the camera into external trigger mode and otherwise
// exit.
//
bool bTriggerPresent;
error = flycaptureQueryTrigger(
context, &bTriggerPresent, NULL, NULL, NULL, NULL, NULL, NULL, NULL );
HANDLE_ERROR( "flycaptureQueryTrigger()", error );
if( !bTriggerPresent)
{
printf("This camera does not support external trigger... exiting\n");
return 1;
}
int iPolarity;
int iSource;
int iRawValue;
int iMode;
error = flycaptureGetTrigger(
context, NULL, &iPolarity, &iSource, &iRawValue, &iMode, NULL );
HANDLE_ERROR( "flycaptureGetTrigger()", error );
printf( "Going into asynchronous Trigger_Mode_0.\n" );
//
// Ensure the camera is in Trigger Mode 0 by explicitly setting it,
// as the camera could have a different default trigger mode
//
#ifdef SOFTWARE_TRIGGER_CAMERA
//
// We are triggering the camera using the internal software trigger.
// If we are using the DCAM SOFTWARE_TRIGGER functionality, we must
// change the Trigger_Source to reflect the Software Trigger ID = 7.
//
error = flycaptureSetTrigger(
context, true, iPolarity, 7, 0, 0 );
HANDLE_ERROR( "flycaptureSetCameraTrigger()", error );
#else
//
// We are triggering the camera using an external hardware trigger.
//
error = flycaptureSetTrigger(
context, true, iPolarity, iSource, 0, 0 );
HANDLE_ERROR( "flycaptureSetCameraTrigger()", error );
#endif
//
// Poll the camera to make sure the camera is actually in trigger mode
// before we start it (avoids timeouts due to the trigger not being armed)
//
checkTriggerReady( context );
//
// Start the camera and grab any excess images that are already in the pipe.
// Although it is extremely rare for spurious images to occur, it is
// possible for the grab call to return an image that is not a result of a
// user-generated trigger. To grab excess images, set a zero-length timeout.
// A value of zero makes the grab call non-blocking.
//
printf( "Checking for any buffered images..." );
error = flycaptureSetGrabTimeoutEx( context, 0 );
HANDLE_ERROR( "flycaptureSetGrabTimeoutEx()", error );
error = flycaptureStart(
context, FLYCAPTURE_VIDEOMODE_ANY, FLYCAPTURE_FRAMERATE_ANY );
HANDLE_ERROR( "flycaptureStart()", error );
//
// Grab the image immediately whether or not trigger present
//
error = flycaptureGrabImage2( context, &image );
if( error == FLYCAPTURE_OK )
{
printf( "buffered image found. Flush successful.\n" );
}
else if( error == FLYCAPTURE_TIMEOUT )
{
printf( "no flush required! (normal behaviour)\n" );
}
else
{
HANDLE_ERROR( "flycaptureGrabImage2()", error );
}
error = flycaptureStop( context );
HANDLE_ERROR( "flycaptureStop()", error );
//
// Start camera. This is done after setting the trigger so that
// excess images isochronously streamed from the camera don't fill up
// the internal buffers.
//
printf( "Starting camera.\n" );
error = flycaptureStart(
context,
FLYCAPTURE_VIDEOMODE_ANY,
FLYCAPTURE_FRAMERATE_ANY );
HANDLE_ERROR( "flycaptureStart()", error );
//
// Set the grab timeout so that calls to flycaptureGrabImage2 will return
// after TIMEOUT milliseconds if the trigger hasn't fired.
//
error = flycaptureSetGrabTimeoutEx( context, TIMEOUT );
HANDLE_ERROR( "flycaptureSetGrabTimeoutEx()", error );
printf( "This program will quit after %d images are grabbed.\n", IMAGES );
#ifndef SOFTWARE_TRIGGER_CAMERA
printf( "Trigger the camera by sending a trigger pulse to GPIO%d.\n",
iSource );
#endif
for( int iImage = 0; iImage < IMAGES; iImage++ )
{
#ifdef SOFTWARE_TRIGGER_CAMERA
#ifdef USE_SOFT_ASYNC_TRIGGER
//
// Check that the camera actually supports the PGR SOFT_ASYNC_TRIGGER
// method of software triggering
//
error = checkSoftwareTriggerPresence( context, SOFT_ASYNC_TRIGGER );
if( error == FLYCAPTURE_OK )
{
checkTriggerReady( context );
//
// Camera is now ready to be triggered, so generate software trigger
// by writing a '0' to bit 31
//
printf( "Press the Enter key to initiate a software trigger.\n" );
getchar();
error = flycaptureSetCameraRegister(
context, SOFT_ASYNC_TRIGGER, 0x80000000 );
HANDLE_ERROR( "flycaptureSetCameraRegister()", error );
}
else
{
printf( "SOFT_ASYNC_TRIGGER not implemented! Grab will timeout.\n" );
}
#else
//
// Check that the camera actually supports the DCAM SOFTWARE_TRIGGER
// method of software triggering
//
error = checkSoftwareTriggerPresence( context, SOFTWARE_TRIGGER );
if( error == FLYCAPTURE_OK )
{
error = checkTriggerReady( context );
//
// Camera is now ready to be triggered, so generate software trigger
// by writing a '1' to bit 0
//
printf( "Press the Enter key to initiate a software trigger.\n" );
getchar();
error = flycaptureSetCameraRegister(
context, SOFTWARE_TRIGGER, 0x80000000 );
HANDLE_ERROR( "flycaptureSetCameraRegister()", error );
}
else
{
printf( "SOFTWARE_TRIGGER not implemented! Grab will timeout.\n" );
}
#endif
#endif
//
// Do an image grab. This call will block until the camera
// is externally triggered.
//
error = flycaptureGrabImage2( context, &image );
if( error == FLYCAPTURE_TIMEOUT )
{
printf( "Grab #%d timed out after %d milliseconds.\n", iImage, TIMEOUT );
}
else if( error != FLYCAPTURE_OK )
{
HANDLE_ERROR( "flycaptureGrabImage2()", error );
}
else
{
printf( "Grab %d successful!\n", iImage );
}
}
//
// Stop the camera and destroy the context.
//
flycaptureStop( context );
flycaptureDestroyContext( context );
printf( "Done! (hit enter)" );
getchar();
return 0;
}
