Support Support Home » Knowledge Base » Frame Burst Modes

Frame Burst Modes

Frame Burst Start

The Frame Burst Start mode allows to capture a defined number of frames in a quick succession after trigger pulse has been sent to the camera.

Feature parameters

xiApi parameters

Feature related parameters
XI_PRM_TRG_SOURCE = XI_TRG_SOFTWARE / XI_TRG_RISING_EDGE / XI_TRG_FALLING_EDGE
XI_PRM_TRG_SELECTOR = XI_TRG_SEL_FRAME_BURST_START
XI_PRM_ACQ_FRAME_BURST_COUNT = N

Sample code

// set trigger source
xiSetParamInt(h,XI_PRM_TRG_SOURCE,XI_TRG_SOFTWARE);
// set trigger selector
xiSetParamInt(h,XI_PRM_TRG_SELECTOR,XI_TRG_SEL_FRAME_BURST_START);
// set output
xiSetParamInt(h,XI_PRM_GPO_MODE,XI_GPO_EXPOSURE_PULSE);
// define and set the number of frames in a burst
#define N 3
xiSetParamInt(h,XI_PRM_ACQ_FRAME_BURST_COUNT,N);
// set the buffers queue size to at least N+1 so the images in one burst are not overwritten  
xiSetParamInt(h, XI_PRM_BUFFERS_QUEUE_SIZE, N+1);

xiStartAcquisition(h);

// endless loop

while (1)
{
   // activate trigger
   xiSetParamInt(h,XI_PRM_TRG_SOFTWARE,1);
   Sleep(1000); // wait 1 second
}
  • The order of setting the parameters is not mandatory.

GenICam reference (SFNC)

TriggerSelector = FrameBurstStart
FrameBurstCount = N

Timing Diagram

Timing diagram of the trigger and the output signal when Frame Burst Count is set to 3 and the GPO mode is set to Exposure Pulse.

Frame Burst Active

In the Frame Burst Active mode the duration of the burst is controlled by the length of the trigger pulse.

Feature parameters

xiApi parameters

Feature related parameters
XI_PRM_TRG_SOURCE = XI_TRG_SOFTWARE / XI_TRG_RISING_EDGE / XI_TRG_FALLING_EDGE
XI_PRM_TRG_SELECTOR = XI_TRG_SEL_FRAME_BURST_ACTIVE
  • The order of setting the parameters is not mandatory.

Sample code

Create application in the following way:

// set trigger source
xiSetParamInt(h,XI_PRM_TRG_SOURCE,XI_TRG_SOFTWARE);
// set trigger selector
xiSetParamInt(h,XI_PRM_TRG_SELECTOR,XI_TRG_SEL_FRAME_BURST_ACTIVE);
// set output
xiSetParamInt(h,XI_PRM_GPO_MODE,XI_GPO_EXPOSURE_PULSE);
// set exposure time to 20 ms
xiSetParamInt(h,XI_PRM_EXPOSURE,20000);
// enable acquisition
xiStartAcquisition();

// burst of frames in 1 sec intervals with a burst duration of 0.5 sec 

while(1)
{
   xiSetParamInt(h, XI_PRM_TRG_SOFTWARE, 1);
   Sleep(500); 
   xiSetParamInt(h, XI_PRM_TRG_SOFTWARE, 0);
   Sleep(500); 
}     

GenICam reference (SFNC)

TriggerSelector = FrameBurstActive

Timing Diagram

Timing diagram of the trigger and the output signal when trigger selector is set to Frame Burst Active and GPO mode is set to Exposure Pulse.

Multiple ROI