Image Export

In addition to exporting scanned documents as PDF, you can also retrieve the pages of the currently scanned document as image files (JPG).

Initialization

Initialize the Docutain SDK for iOS as described here.

Export scanned pages as image files

Write images to local files

In order to write the currently scanned pages to local JPG files, you can use the Document.writeImage method. Pass the page you want to export as JPG and the target path where to save it. If you want to export all pages as JPG, you can get the number of pages via Document.pageCount() and loop through all pages like in the follwing example:

//...
//scan a document
//...

let paths = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)
let pageCount = Document.pageCount()
for page in 1 ... pageCount {
    let path = paths[0].appendingPathComponent("Image_\(page).jpg")
    let savedPath = Document.writeImage(page: page, fileUrl: path)
}

Get images as NSData

You also have the possibility to get the images as NSData:

//...
//scan a document
//...

let pageCount = Document.pageCount()
for page in 1 ... pageCount {
    let data = Document.getImage(page: page)
}

PageSourceType

When getting the images as NSData, you can define a PageSourceType.

//...
//scan a document
//...

let pageCount = Document.pageCount()
for page in 1 ... pageCount {
    let data = Document.getImage(page: page, pageSourceType: .cutFilter)
}

You have the following options:

• PageSourceType.cutFilter This is the default value if you do not provide any. The image will be the cut and filtered image which is the one the user sees when finishing the scan process.

• PageSourceType.cutOnly This will give you the cut but unfiltered image. If you for example use the image for further processing in your own OCR pipeline which uses custom filter operations, this option might improve your OCR results as opposed to PageSourceType.cutFilter. But this is no general rule and highly depends on your pipeline.

• PageSourceType.original This will give you the uncut, unfiltered image as it was provided by the camera.