LIsis::AcquireMulti

#include "Ltwrappr.h"

virtual L_INT LIsis::AcquireMulti(pszBaseFileName, uFlags=0, nFormat=FILE_TIF, bMultiPageFile=TRUE, pnPagesDiscarded=NULL)

Starts a multipage ISIS scan. Each page will be saved in the specified format in either a multipage file, or as individual files.

This function is available in the Document/Medical Toolkits.

Returns

Comments

If bMultiPageFile is TRUE, the scanned pages will be saved as pages in a multipage file. If bMultiPageFile is FALSE, each scanned page will be saved to an individual file. Filenames are created by concatenating the string in pszBaseFileName with the page number. By default, the numbering will begin with "0001" and will be incremented with each page scanned ("0002","0003", ... ). Each file will be saved according to the format indicated in nFormat. If a file already exists, for example "Page0002", it will be overwritten. The user can control the number of digits used in numbering the filenames by including asterisks '*' in the filename, before the extension. For example, passing "c:\temp\isis\test**.tif" for pszBaseFileName indicates to use only two digits in the filenames (test04.tif), while passing "c:\temp\isis\test*****.tif" for pszBaseFileName indicates to use only five digits in the filenames (test00001.tif). If no asterisks are included, the default of four digits will be used (test0003.tif). You must override LIsis::AcquireMultiCallBack if you want to process each image instead of or in addition to saving the page to disk.

If uFlags is not set, the ISIS user interface will not be activated and the function will only scan the image, using the current scanner driver tags.

Required DLLs and Libraries

See Also

Example

// define user ISIS class 
class LUserIsis : public LIsis
{
   LEAD_DECLAREOBJECT(LUserIsis);
public:
   LUserIsis();
   LUserIsis(HWND hWnd,LBitmapBase L_FAR* pBitmap);
   virtual ~LUserIsis();
   virtual L_INT AcquireMultiCallBack(L_INT32 nPage,L_CHAR L_FAR* pszFileName);
};

LEAD_IMPLEMENTOBJECT(LUserIsis);

// constructor and destructor 
LUserIsis::LUserIsis()
{

}

LUserIsis::LUserIsis(HWND hWnd,LBitmapBase L_FAR* pBitmap)
{

}

LUserIsis::~LUserIsis()
{

}
L_INT LUserIsis::AcquireMultiCallBack(L_INT32 nPage,L_CHAR L_FAR* pszFileName)
{
   /* user receives a bitmap here, when he calls the AcquireMulti function .
      for example he can display it or free it */

   return SUCCESS ;
}

L_INT MyFunction(HWND hWnd, LBitmapBase *pBitmap)
{  
   LUserIsis   UserIsis ;
   L_CHAR      szDriverName[255];
   L_INT       nRet = 0 ;

   memset(szDriverName,0,sizeof(szDriverName));

   if (UserIsis.IsAvailable() != TRUE)
   {
      MessageBox( hWnd, "Isis is not available", "Isis Error", MB_OK) ;
      return FAILURE ;
   }

   nRet = UserIsis.Select(szDriverName) ;
   if (UserIsis.LoadDriver(szDriverName) == SUCCESS)
   {
      L_INT32     lWidth ;
      L_INT32     lLength ;
      L_INT       nMaxPages = 1 ;

      UserIsis.GetTagLong(TAG_IMAGEWIDTH, &lWidth);
      UserIsis.GetTagLong(TAG_IMAGELENGTH, &lLength);

      lWidth += 20 ;
      lLength += 20 ;

      UserIsis.SetTagLong(TAG_IMAGEWIDTH, lWidth);
      UserIsis.SetTagLong(TAG_IMAGELENGTH, lLength);

      nRet = UserIsis.SetTagShort(TAG_SCANAHEAD, TAG_SCANAHEAD_YES);
      if(nRet == SUCCESS)
      {
         UserIsis.GetTagShort(TAG_MAXPAGES, &nMaxPages);
         UserIsis.SetTagShort(TAG_SCANAHEAD_MAXPAGES, (L_INT)(nMaxPages/2));
      }

      nRet = UserIsis.SetScanOptions() ;

      UserIsis.SetBitmap(pBitmap) ;

      UserIsis.AcquireMulti("Isis_TIF.TIF",ISIS_SHOWUI) ;
   }

   UserIsis.UnloadDriver() ;

   return SUCCESS ;
}