You are here: Section Rules Reference > Section Rules Summary > AddMultiPageBitmap > Using the Scale Option

Using the Scale Option

The Scale option resizes the loaded graphics, maintaining the aspect ratio (height to width), so the graphic fits within the provided height and width dimensions. If you only provide the height or width, the system sizes the graphic to fit that dimension and automatically calculates the other dimension to preserve the aspect ratio. For example (assuming the imported graphic is originally 8 ½” x 11”), this rule...

AddMultiPageBitmap SRCH(1,AddMultiPageBitmap,40,.\tif_srch 40,19), SCALE(4in)

tells the system to scale the graphic so that it is 4 inches high and 3.09 inches wide. This rule...

AddMultiPageBitmap SRCH(1,AddMultiPageBitmap,40,.\tif_srch 40,19),SCALE(4in,3in)

tells the system to scale the graphic to 3.88 inches tall and 3 inches wide, because if it scaled the height to be 4 inches, while maintaining the aspect ratio, the width would exceed the specified 3 inches. This rule...

AddMultiPageBitmap SRCH(1,AddMultiPageBitmap,40,.\tif_srch 40,19),SCALE(,5in)

tells the system to scale the graphic to 6.47 inches tall and 5 inches wide.

Keep in mind...

If you omit the height, you must include a comma (,) as a placeholder.
If no units, such as inches (in) or millimeters (mm), are provided, the system assumes your entry is in FAP units (2400 per inch).
Do not include both the Scale and Crop options. If you include both options, the system ignores the Crop option and only uses the Scale option.