Changing page size

If the page size changes (that is, the result page size is different from the source page size), you can specify whether the page contents should be scaled and how the original page is anchored.

By default, page contents are not scaled. If the page size increases, white space is added around the original page. If the page size decreases, the page contents are cropped to the new page size (possibly resulting in some visible content being hidden).

To modify the default behavior, you can specify true for the attributes scaleUp and scaleDown. scaleUp applies only when the page size has increased in both dimensions, and scaleDown applies only when the page size has decreased in at least one dimension.

If the new specified page is larger than the previous size in one dimension but smaller in the other and scaleDown is true, scaling is performed. scaleUp never results in content being cropped; cropping can occur only if the page size has been reduced and scaleDown is false.

Scaling never alters the aspect ratio of the page’s contents. If performed, scaling is always the same in the horizontal and vertical dimensions. If the new page size has a different aspect ratio from the previous page size, the scale factor will be the largest that enables the page contents to fit. In the other, non-critical dimension, either more of page’s contents will be made visible, or white space will be added.

The horizontalAnchor and verticalAnchor attributes determine where extra white space (or previously hidden content) appears if the page size increases. They also determine how cropping occurs if the page size decreases and scaling is not performed.

For example, if you specify a page size of 8.5 x 14 inches, any source pages that were 8.5 x 11 inches will grow vertically. The default value for verticalAnchor is Middle, which means that the old page size is centered vertically compared to the new size and white space appears equally at the top and bottom. If you set verticalAnchor to Top or Bottom, the white space is added at the bottom or top, respectively. The same applies for horizontalAnchor, which can be set to Center (the default), Left, or Right.

By contrast, if the vertical dimension is decreased (say from 14 to 11) and verticalAnchor is Middle, the page is cropped equally at top and bottom. If verticalAnchor is Bottom, the top of the page is anchored to the new top and all cropping is done at the top, as in the example and the figures below.

Example: Decreasing the page size

<PDF result="newdoc">

	<PageSize width="8.5in" height="11in"

		verticalAnchor="Bottom/>

	<PDF source="doc1"/>

	<PDF source="doc2"/>

</PDF>

Current page: http://livedocs.adobe.com/livecycle/es/sdkHelp/programmer/sdkHelp/assemblePDFPage_properties.102.4.html