You are here: Section Rules Reference > Section Rules Summary > AddMultiPageTIFF

AddMultiPageTIFF

Note

Beginning with version 11.3, the AddMultiPageTIFF rule was replaced by the AddMultiPageBitmap rule. If the system comes across the AddMultiPageTIFF rule, it auto ma ti ally runs the AddMultiPageBitmap rule.

Use this section level rule to include multiple TIFF images contained in a single TIFF file in a form set. The first TIFF in the file is inserted on the triggering form/section. Subsequent TIFF images trigger additional pages which are appended to the form after the page which contains the first TIFF image.

This rule can also extract TIFF, JPEG, or bitmap images from PDF files. For instance, if you have a PDF file that includes scanned images, typically in TIFF format, you can use this rule to extract those images from the PDF file.

Note

For more information on using this rule to extract TIFF, JPEG, or bitmaps images from PDF files, see Using the Type Option.

Syntax

AddMultiPageTIFF (Options)

For the Options parameter, you have these options:

Option	Description
Opt	(Optional) Enter Yes to indicates this rule is optional and you do not want error messages generated if the file naming parameters fail to produce a valid name. The default is No. This option lets you use multiple named parameters. The first parameter that provides a TIFF file name is used, but if the name of the TIFF file returned by the search criteria is blank, the system ignores it and does not generate an error. Make this option the first rule parameter.
DAL(script name)	Enter the name of the DAL script you want to execute to return the name of the TIFF file you want to import. You must enter the name of a script file or DAL library routine. Do not include DAL statements.
File(file name)	Enter the name and path of the TIFF file to import.
GVM(variable name)	Enter the GVM variable name that contains the name and path of the TIFF file. The GVM variable data is mapped by some other means before this rule is executed.
SRCH(search criteria name data)	The name and path of the TIFF file is contained in a record in the file specified by the ExtrFile option in the Data control group. The search criteria are one or more comma-delimited data pairs, offsets, and character strings, used to as the search mask to find the record in the file you specified. The name data is a comma-delimited data pair that defines the offset and length of the file name in the record defined by the search criteria. Separate the search criteria and name data by a space.
Embed	(Optional) Include Embed to add the image data in the NA file. This is necessary when the file that contains the scanned images is temporary and you need to archive the NA/POL information. Upon retrieval, if you have not embedded the bitmap information directly into the form set, you will not be able to view or reprint the original images. The default is No. Keep in mind that embedding bitmap data can make the resulting NA file much larger and also affects the size of the archives generated.
Only (Odd or Even)	By default, all images in the multipage TIFF file are included. Only include this option to specify that you want only the odd or even numbered images. You can use this option to reduce the size of the output when you know blank pages are included in the scanned images on every other page. Choose Odd when you know that the first image is not blank. This includes images 1, 3, 5, and so on. Choose Even to start with the second image. This includes images 2, 4, 6, and so on. If you include both Only (Odd) and Only (Even), you exclude all images.
IN(top,left)	(Optional) Specifies the coordinate for the top-left corner of the bitmaps, in inches.
MM(top,left)	(Optional) Specifies the coordinate for the top-left corner of the bitmaps, in millimeters.
Top(top,left)	(Optional) Specifies the coordinate for the top-left corner of the bitmaps, in FAP units (2400 per inch).
Type	(Optional) Enter T (TIFF) or P (PDF). If you omit this option, the system first looks for TIFF files. If it cannot find a TIFF file, it looks for a PDF file. Including this option will speed processing. You can also include this option if the target directory contains both TIFF and PDF files.

Keep in mind:

The system supports these types of TIFF images:

Type	Description
Type 1	uncompressed
Type 2	Huffman
Type 3	CCITT group 3 FAX
Type 4	CCITT group 4 FAX
Type 5	LZW
Type 32773	Packbits

You can only include one of the section positioning parameters, Top, In, or MM. The value specified is relative to the FAP file's origin as specified by a SetOrigin. If there are more than one positioning parameters, subsequent definitions override prior ones.

If you omit the positioning parameters, the default top/left coordinate is taken from the margin defined for the FAP file. If the FAP file is not loaded and the margins are unknown, the default is 0,0 (aligned with the top of the section).

If either the LoadFAPBitmap option or the Embed parameter are set to Yes, the bitmap is loaded into memory. If neither are enabled, the system opens the TIFF file to get the bitmap size, resolution, and number or pages, but the bitmap data is not loaded. The system then assumes all of the bitmap images will be the same size as the first image in the file.

For single step mode, set the LoadFAPBitmap option to Yes.

If you include several options that serve similar purposes, the last one to provide a result is used.
You can specify several AddMultiPageTIFF rules, as shown here, but realize that each subsequent rule reuses the document pages added by previous rules. For instance, suppose you have declared two rules. The first has a 4-page TIFF. The second has a 5-page TIFF.

After executing the two rules, there will be five pages in the form. The first four pages will have two images each (one from the first rule and one from the second) and the final page will contain the last image from the 5-page TIFF.

Be aware that the placement of those bitmap images on the page can make them overlap.

Note

This rule supports long file names on 32-bit Windows operating systems.