Instruction manual

// Acquire one frame
el_Acquire (BoardId, EL_SNAP);
do {
...;
} while( el_TestAcq( BoardId ) || Timeout-- );
5.2.36. el_TestFrameCount
long
el_TestFrameCount ( long BoardId );
DESCRIPTION: Returns contents of the frame-counter. el_TestFrameCount is used to determine the
currently used acquisition buffer during a running sequence acquisition. It is ensured that the frame count
returned specifies the frame which is present in memory. Consequently, el_TestFrameCount can be used
to pick a single frame out of a big image sequence during acquisition easily.
RETURN VALUE:
modulo 255 of the number of the last completly acquired frame if OK
-1 if Error. See el_GetErrorCode for details.
CAVEATS: The counter is incremented by every transfered frame.
After an el_Acquire command this 8 bit counter is set to 0. Immediately after the completion of the first
image the counter value is increased to 1 and for every following image the value is increased until 255
has been reached. With the end of the following image the counter is reset to 0. Due to this behavior a
sequence length equal to a power-of-two is recommended because then the actual image number can be
obtained by a simple modulo operation.
5.2.37. el_WaitAcqEnd
long
el_WaitAcqEnd ( long BoardId );
DESCRIPTION: Wait until acquisition is finished.
RETURN VALUE:
0 if OK
-1 if ERROR. See el_GetErrorCode for details.
Single buffer acquisition
A single snap was triggered with acquisition mode EL_SNAP. Then el_WaitAcqEnd returns after the
frame was transferred into memory.
Image sequence acquisition:
A single sequence acquisition was triggered with acquisition mode EL_SNAP. Then el_WaitAcqEnd
returns after the last frame of the sequence was transferred to memory. See also: Sequences
CAVEATS: This function looks at the end of the DMA transfer of data into data memory and not directly to
the camera's frame timing. It returns only when the DMA transfer of frames is finished and the acquisition
79