2022.2

Field Type Description
scale
NumberorObject SetthesizeofthePDFbackgroundasapercentageoftheoriginalimage.Acceptedvaluesare:
l
Anumericvalue.
l
Astringcontaininganumberandpercentagecharacter:"<number>%".
l
Anobjectwithtwoproperties,"x"and"y",withnumericvalues:"{x:100,y:100}".Ifx
andyaredifferenttheimagewillbestretched.
source
"BackgroundResource"on
page1294
SetthesourceofthePDFbackground(NONE,Datamapper,PDFResource).
SettingthebackgroundtoNONEdoesnotresetanyotheroption,suchastheposition
andscaleofthebackground.
start
Number ThestartpageofthePDFtouseasabackgroundforthesection.
top
Measurement ThetopoffsetofthePDFbackground(onlywhenabsolutepositioningisselected).
url
String ThelocationofthePDFtouseasabackgroundforthesection.ThreedifferentformsofURLsaresup-
ported:
l
Arelativepathtoanimageresource;thisalwaysstartswith"images/".Forafile
namedbackground.pdf,storedinsidethetemplateresources,theURLwouldbe
images/background.pdf.
l
AURL(eitherfile:,http:,orhttps:).Thecompletesyntaxforanexternalfile
is:file://<host>/<path>.Ifthehostis"localhost",itcanbeomitted,resulting
infile:///<path>,forexample:file:///c:/resources/images/image.jpg.
l
AnabsoluteWindows-stylepath.
ArelativepathandaURLareexpectedtobeURLencoded.Forexample,aspaceneedstobe
encodedas%20.
AnabsoluteWindows-stylepathdoesnotneedtobeURLencoded,butinJavaScriptanyback-
slashesinaStringneedtobedouble-escaped:"C:\\Images\\Image.pdf".
ThisscriptsetsabackgroundonaPrintsectionusingabsolutepositioning.
var activeSection = merge.template.contexts.PRINT.sections['Section 1'];
activeSection.background.source = BackgroundResource.RESOURCE_PDF;
activeSection.background.url = "images/somepage.pdf";
activeSection.background.position = MediaPosition.ABSOLUTE;
activeSection.background.left = "10mm";
activeSection.background.top = "10mm";
YoucouldreplacethelastthreelinesofthepreviousscriptbythefollowinglinetoscalethePrintsec-
tionbackgroundtoMediasize:
activeSection.background.position = MediaPosition.FIT_TO_MEDIA;
Tip: Formoreexamples,see"ControlScript:SettingaPrintsection'sbackground"onpage845.
Page 1287