7. The processing chain 82
7.3 FLUSH
When the acquisition is interrupted before a whole set of lines has been acquired, you can still use the
ush operation to retrieve a “partial” frame, in which the missing lines are replaced by dummy lines.
Dummy lines are black in monochrome modes and green in color ones.
The acquisition can be interrupted by user through the device.Acquisition = false command or
when external triggers are missing.
A ush operation can be invoked by software, automatically (auto-ush) when a programmable timeout
expires or by a selectable external input.
7.3.1 Flush Usage Examples
Example Code 7.9 | Congure external input to perform a ush operation
// Check if flush is available.
if (device.FrameCombinerAvailable)
{
// Check if external flush is available.
if (device.FrameCombinerExternalFlushAvailable)
{
// Configure Input port 1 as Flush Input on the rising edge.
device.FrameCombinerExternalFlushInput = 1;
// Enables External Flush.
device.FrameCombinerExternalFlushEnabled = true;
}
}
Example Code 7.10 | Set a ush timeout to 1s
// Check if flush is available.
if (device.FrameCombinerAvailable)
{
// Configure 1000 ms timeout.
UnitInfo unit = device.FrameCombinerTimeoutUnitInfo;
device.FrameCombinerTimeout = (uint)(1.0 / unit.Factor);
}
Example Code 7.11 | Software ush
// Check if flush is available.
if (device.FrameCombinerAvailable)
// Software flush.
device.FrameCombinerFlush();