Thanks for Downloading Dynamic Web TWAIN 30-Day Trial!

Your download will start shortly. If your download does not begin, click here to retry.

Document Saving

How to use a blank page as a separator?

Scenario

You are scanning in multiple documents with a blank page separating them and would like to save each set of documents separately.

Solution

In order to do this we will scan in all the sheets, then use IsBlankImageExpress to detect whether or not it is blank. If the sheet is blank we will then remove it from the buffer and save the previous set of sheets. In order to accomplish this task we are going to use the event OnPostAllTransfers, which fires after all scans are complete in order to check whether or not any pages are blank.

function Dynamsoft_OnReady() { 
    DWObject = Dynamsoft.DWT.GetWebTwain('dwtcontrolContainer'); // Get the Dynamic Web TWAIN object that is embeded in the div with id 'dwtcontrolContainer' 
    if (DWObject) { 
        DWObject.IfShowUI = false;
        DWObject.IfAutoDiscardBlankpages = false;
        DWObject.RegisterEvent('OnPostAllTransfers', CheckBlankPage); //Register the OnPostAllTransfers event that will be called after all scanning is complete 
    } 
}

function AcquireImage() {
    if (DWObject) {
        DWObject.SelectSource(function () {					
            var OnAcquireImageSuccess = function () {
                DWObject.CloseSource();
            };
            
            var OnAcquireImageFailure = function (ec, es) {
                DWObject.CloseSource();
                alert(es);
            };

            DWObject.OpenSource();
            DWObject.IfDisableSourceAfterAcquire = false;	// Scanner source will be disabled/closed automatically after the scan. 
            DWObject.AcquireImage(OnAcquireImageSuccess, OnAcquireImageFailure);
        }, function () {
            console.log('SelectSource failed!');
        });
    }
}

function OnSuccess() {
    console.log('successful');
}

function OnFailure(errorCode, errorString) {
    alert(errorString);
}

function CheckBlankPage() { //Function for checking a blank page, called when OnPostAllTransfers is triggered
    if (DWObject) { //Ensure there is a DWObject
        var startindex = 0; // Assume it starts from the first page in the buffer.
        for (var i = 0; i < DWObject.HowManyImagesInBuffer; i++) { //Go through each image in the buffer.
            if (DWObject.IsBlankImageExpress(i)) {
                DWObject.RemoveImage(i); // remove the blank page from the buffer.
                if (i != 0) {
                    var imageRecord = [];
                    i--; //decrement i for the removed image
                    var selectedCount = i - startindex + 1;

                    for (var j = 0; j < selectedCount; j++) { //loop to select all images from previous blank to current
                        imageRecord.push(j + startindex);
                    }

                    if (selectedCount > 0) { //save images as long as there are some in the selection
                        DWObject.SelectImages(imageRecord);
                        DWObject.IfShowFileDialog = true;
                        DWObject.SaveSelectedImagesAsMultiPagePDF("C:\\....", OnSuccess, OnFailure); //PLEASE CHANGE THIS FILE PATH (The first parameter)
                    }

                    startindex = i + 1; //set the start index for next search 1 higher than current page
                }
            } else if (i == DWObject.HowManyImagesInBuffer - 1) { //the last few images are not blank
                var selectedCount = i - startindex + 1; // set how many images are selected
                var imageRecord = [];

                for (var j = 0; j < selectedCount; j++) { //loop to select all images from previous blank to current
                    imageRecord.push(j + startindex);
                }

                if (selectedCount > 0) { //save images as long as there are some in the selection
                    DWObject.SelectImages(imageRecord);
                    DWObject.IfShowFileDialog = true;
                    DWObject.SaveSelectedImagesAsMultiPagePDF("C:\\...", OnSuccess, OnFailure); //PLEASE CHANGE THIS FILE PATH (The first parameter)
                }
            }
        }
    }
}

If your application is having a hard time detecting blank pages(there is some areas around the edge of the blank page with non-blank spots) or you are using coloured pages you may want to use the pages standard deviation instead. You may use the following Snippet instead.

Using Page Standard Deviation:

function CheckBlankPage(){ //Function for checking a blank page, called when OnPostAllTransfers is triggered 
    if(DWObject){//Ensure there is a DWObject 
        for(var i = 0; i < DWObject.HowManyImagesInBuffer;i++){//Go through each image in the buffer. 
            if(DWObject.IsBlankImageExpress(i)){}//Make Blank Image run, but do not use the result 
            if(DWObject.BlankImageCurrentStdDev < 15.0){//set a standard deviation for the program to use
                //......
            } 
        } 
    } 
}