2021.2

Table Of Contents
Note
An image with an unknown file extension is represented by a red cross in the output, but
no error is logged unless the image refers to a local file that does not exist on disk.
Image file extensions that the software recognizes are: AFP, BMP, EPS, GIF, JPG/JPEG,
PCL, PDF, PNG, PS, SVG, and TIF/TIFF.
Positioning, scaling and rotating the background
After a background has been selected, it can be positioned, scaled and rotated, using
properties of the background object; see "background" on page1426.
To position the background, for example, set the section's background.position:
activeSection.background.position = MediaPosition.FIT_TO_MEDIA;
For all possible positions, see "MediaPosition" on page1442.
Setting a page range in script
When a PDF that serves as a dynamic section background has multiple pages, you can specify
a range of pages to be used, in a control script.
Put the number of the first page in the range in the section's background.start field and the last
page in background.end.
The following script sets the page range from 2 to 5:
merge.template.contexts.PRINT.sections['Policy'].background.start =
2;
merge.template.contexts.PRINT.sections['Policy'].background.end =
5;
Setting a page range automatically sets background.allPages to false (see "background" on
page1426).
On the other hand, when you first define a page range and then set background.allPages to
true, this disables the page range.
Page 923