set_multipage_burst

Edit online

Forces multipage TIFF images to be split into single pages during ingestion.

Member of namespace

mvscan

Syntax

bool set_multipage_burst (bool bBurst)

Parameters

bBurst
Type: bool
Nonzero to force bursting of TIFF image files. Default = 0, no bursting.

Parameters

bBurst : A Boolean value that enables or disables bursting multipage image files during ingestion.

True: Any multipage TIFF file is separated into multiple pages in the batch, one per image.

False: One page is output per input file. This is the default if the action is not called.

Returns

Always True.

Level

Batch level.

Details

Enables splitting or bursting multipage source image files into one image per page in the batch. For this action to take effect, it must be called before the Scan action.

Only multipage TIF files will be split. Other types will be ingested as-is.

Example:
set_types(".tif")
set_multipage_burst(1)
scan()

If the scan action in this sequence encounters a multipage .tif file, it reads each one into the current batch as a separate image, thereby bursting the multipage file into individual images.