Capturing Image Data

This short section shows how to capture and display a live image together with the output of some statistical information with this interface on Windows®.

The complete source code can be found in the examples section: ContinuousCapture.c (for the GenICam™ interface please refer to ContinuousCaptureGenICam.c instead).

First the library is initialized and a device is opened:

#define END_APPLICATION \
  printf( "Press any key to end the application.\n" ); \
  getch(); \
  return 0; \
 
// try to initialize the library.
if( ( result = DMR_Init( &hDMR ) ) != DMR_NO_ERROR )
{
  printf( "DMR_Init failed (code: %d)\n", result );
  END_APPLICATION;
}
 
// try to get access to the first recognized device in the system
if( ( result = DMR_GetDevice( &hDevice, dmdsmSerial, "*", 0, '*' ) ) != DMR_NO_ERROR )
{
  printf( "DMR_GetDevice failed (code: %d)\n", result );
  END_APPLICATION;
}
 
// switch to GenICam interface layout if supported by the device. This is the recommended interface layout for new applications using GenICam compliant devices. It is also the default interface layout used by ImpactControlCenter and usually results in access to a richer feature set.
if( ( hPropInterfaceLayout = getDeviceProp( hDevice , "InterfaceLayout" ) ) != INVALID_ID )
{
    setPropI( hPropInterfaceLayout, dilGenICam, 0 );
}
 
// try to initialize this device
if( ( result = DMR_OpenDevice( hDevice, &hDriverInterface ) ) != DMR_NO_ERROR )
{
  printf( "DMR_OpenDevice failed (code: %d)\n", result );
  END_APPLICATION;
}

In any thread function the handle to the device (HDEV) and the handle to the devices interface (HDRV) can now be used to capture images:

while( ( result = DMR_ImageRequestSingle( hDriverInterface, 0, 0 ) ) == DMR_NO_ERROR );
if( result != DEV_NO_FREE_REQUEST_AVAILABLE )
{
  printf( "DMR_ImageRequestSingle: Unexpected error(code: %d(%s))\n", result, DMR_ErrorCodeToString( result ) );
}
 
while( !s_boTerminated )
{
  result = DMR_ImageRequestWaitFor( hDriverInterface, 500, 0, &requestNr );
  if( result == DMR_NO_ERROR )
  {
    if( ( result = DMR_GetImageRequestBuffer( hDriverInterface, requestNr, &pIB ) ) == DMR_NO_ERROR )
    {
      // display the captured image using some kind of display function
 
      // inform the driver, that this request buffer is no longer needed by the user
      DMR_ImageRequestUnlock( hDriverInterface, requestNr );
      // request the next image
      DMR_ImageRequestSingle( hDriverInterface, 0, 0 );
    }
    else
    {
      printf( "DMR_GetImageRequestBuffer: ERROR! Code %d\n", result );
    }
  }
  else
  {
    printf( "DMR_ImageRequestWaitFor: ERROR! Code %d\n", result );
  }
}