L_ISISAcquireMulti

#include "l_bitmap.h"
#include "ltisi.h"

L_INT EXT_FUNCTION L_ISISAcquireMulti(hWnd, pszBaseFileName, uFlags, nFormat, bMultiPageFile, pnPagesDiscarded, pfnCallback, pUserData)

Starts a multi-page ISIS scan. Each page will be saved in the specified format in either a multi-page 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 multi-page 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 supply a callback function in pfnCallback in order to process the images as they are scanned, instead of, or in addition to, saving them to file(s).

Required DLLs and Libraries

Platforms

Windows 95 / 98 / Me, Windows 2000 / XP.

See Also

Example

For complete sample code, refer to the FRAME.C module of the DEMO example.

/* global variables */
L_BOOL fKillProgress;
L_BOOL fInTwain;
HINSTANCE hInst;
HWND hWndFrame;

/* ISISCALLBACK function declaration */
L_INT L_EXPORT ISISCallBack( pBITMAPHANDLE pBitmap, L_INT32 nPage, L_CHAR L_FAR* pszFilename, L_VOID L_FAR * pUserData );

static L_VOID ISISAcquireMulti(L_VOID)
{
   L_CHAR buf[2*_MAX_PATH];
   HCURSOR hCursor;
   HMENU hMenu;
   L_INT nRet;
   L_INT nSaveFormat;
   static OPENFILENAME OpenFileName;
   static L_CHAR szFileName[_MAX_PATH] = "";
   static L_BOOL bSaveMulti = TRUE;
   FILESAVEPARM ISISFSParm;
   L_INT nMaxPages=1;
   L_INT nPagesDiscarded;
   FILESAVEFORMAT Formats[1];

   OpenFileName.lStructSize       = sizeof(OPENFILENAME);
   OpenFileName.lpstrInitialDir   = NULL;
   OpenFileName.lpstrTitle        = "Select Base Filename";
   OpenFileName.nFilterIndex      = 0;

   OpenFileName.lpstrFile         = szFileName;
   OpenFileName.nMaxFile          = sizeof(szFileName);
   OpenFileName.lpstrFileTitle    = ISISFSParm.szFileName;
   OpenFileName.nMaxFileTitle     = sizeof(ISISFSParm.szFileName);

   OpenFileName.Flags             = 0;

   ISISFSParm.uSaveMulti = bSaveMulti;

   /* add some formats */
   Formats[0].nFormat     = FS_LEAD24;
   Formats[0].uSubFormats = 0;   /* get the name of the file(s) to save */

   nRet = L_DlgSave( hWndFrame,
                         &OpenFileName,
                         &ISISFSParm,
                         DLG_FS_MULTIPAGE,
                          (FILESAVEFORMAT L_FAR*)&Formats,
                         nSaveFormat,
                         NULL, NULL );

   if(nRet != SUCCESS)
      return;

   bSaveMulti = ISISFSParm.uSaveMulti;
   nSaveFormat = ISISFSParm.nFormat;

   hCursor = SetCursor (LoadCursor (NULL, IDC_WAIT));
   hMenu = GetSystemMenu (hWndFrame, FALSE);
   EnableMenuItem (hMenu, SC_CLOSE, FALSE);
   fInTwain = TRUE;

   nRet = L_ISISLoadDriver(NULL);

   if(nRet == SUCCESS)
   {
      /* let's set the ScanAhead to 1/2 the max. # of pages the ADF can hold for SPEED */
      nRet = L_ISISSetTagShort(TAG_SCANAHEAD, TAG_SCANAHEAD_YES);
      if(nRet == SUCCESS)
      {
         nRet=L_ISISGetTagShort(TAG_MAXPAGES, &nMaxPages);
         nRet=L_ISISSetTagShort(TAG_SCANAHEAD_MAXPAGES, (L_INT)(nMaxPages/2));
      }

      /* try setting scanner compression to match file output type */
      switch(nSaveFormat)
      {
         case FILE_CCITT:
            nRet=L_ISISSetTagShort (TAG_COMPRESSION, TAG_COMPRESSION_MG3);
            break;
         case FILE_CCITT_GROUP3_1DIM:
            nRet=L_ISISSetTagShort(TAG_COMPRESSION, TAG_COMPRESSION_G3);
            break;
         case FILE_CCITT_GROUP4:
            nRet=L_ISISSetTagShort(TAG_COMPRESSION, TAG_COMPRESSION_G4);
            break;
         case FILE_TIFLZW:
            nRet=L_ISISSetTagShort(TAG_COMPRESSION, TAG_COMPRESSION_LZW);
            break;
         case FILE_TIF_PACKBITS:
            nRet=L_ISISSetTagShort(TAG_COMPRESSION, TAG_COMPRESSION_32771);
            break;
         default:
            nRet=L_ISISSetTagShort(TAG_COMPRESSION, TAG_COMPRESSION_NONE);
            break;
      }

      nRet = L_ISISAcquireMulti (hWndFrame,
                                 szFileName,
                                 ISIS_SHOWUI,
                                 nSaveFormat,
                                 bSaveMulti,
                                 &nPagesDiscarded,
                                 ISISCallBack,
                                 NULL);
      L_ISISUnloadDriver();
   }
   EnableMenuItem (hMenu, SC_CLOSE, TRUE);
   fInTwain = FALSE;
   SetCursor (hCursor);
   if (nRet == ERROR_USER_ABORT)
   {
      wsprintf(buf, "Scanning canceled; %d pages ScannedAhead but aborted!", nPagesDiscarded );
      MessageBox(hWndFrame, buf, "ISIS Acquire Multi", MB_OK);
      wsprintf(buf, "Image(s) acquired to file(s): %s", szFileName);
      MessageBox(hWndFrame, buf, "ISIS Acquire Multi", MB_OK);
   }
   else if (nRet != SUCCESS)
      L_FileError (hWndFrame, nRet, "ISIS Acquire Multi", "");
   else
   {
      wsprintf(buf, "Image(s) acquired to file(s): %s", szFileName);
      MessageBox(hWndFrame, buf, "ISIS Acquire Multi", MB_OK);
   }
   return;
}

L_INT L_EXPORT ISISCallBack( pBITMAPHANDLE pBitmap, L_INT32 nPage, L_CHAR L_FAR* pszFilename, L_VOID L_FAR * pUserData ) 
{
   UNREFERENCED_PARAMETER(pBitmap);
   MSG msg;

   while (PeekMessage (&msg, NULL, 0, 0, PM_REMOVE))
   {
      if(msg.message == WM_KEYDOWN)
      {
         if(msg.wParam == VK_ESCAPE)
         {
            fKillProgress = TRUE;
            MessageBox(NULL, "ISIS Scanning Canceled!", "Stop", MB_OK);
         }
      }
      TranslateMessage (&msg);
      DispatchMessage (&msg);
   }

   if (fKillProgress)
      return (ERROR_USER_ABORT);
   else
      return (SUCCESS);
}