49
‘true’ or r ‘false’ (or no value, , which h is equivalent t to o ‘true’). . (Default:
booklet=false)
picturecommand Declares s picturecommandswhichareexecutedonevery
pagewithinapictureenvironmentwiththebasepoint at thelowerleft
cornerofthepage.(Thebasepointdoesnotchangeifthepageisrotated,
e.g.bythelandscapeoption.) (Default:picturecommand=fg)
picturecommand* Like e picturecommand, , but t with the e restriction n that
picturecommand*executes itspicturecommands onlyontheveryrst
page.(Default: picturecommand*=fg)
pagetemplate Bydefaulttherstinsertedpagewillbeusedasatemplate.
Thismeansthatallfurtherpagesarescaledsuchthattheymatchwithin
thecontourofthisrstpage.Thisoptionallowstodeclareanotherpage
tobeusedasatemplate;whichisonlyusefulifa
PDF
documentcontains
dierentpagesizesorpageorientations.Theargumentshouldbeapage
number. (Default:pagetemplate=hfirst t inserted pagei)
templatesize This s option is similar to the pagetemplate option, , but t its
arguments specify y the size of f the e template directly. . Its s syntax x is:
templatesize={hwidthi}{hheighti}Note: Thetwolengthsshouldbe e a
bitlargerthandesired,tokeepawayfromroundingerrors.
(Default: templatesize=hsize e of f the e first inserted pagei)
rotateoversize Thisoptionallows s torotateoversizedpages. . E.g. . pages s in
landscapeorientationare oversizedrelatively totheir portrait counter-
part, becausetheydo notmatchwithinthe contourof aportrait page
withoutrotatingthem. Bydefaultoversizedpagesarescaleandarenot
rotated. Either‘true’or‘false’(ornovalue,whichisequivalentto‘true’).
(Default: rotateoversize=false)
doublepages Inserts every page twice. . This s is useful l for r 2-upprinting, , if
onewantstocutthestackofpaperafterwardstogettwocopies. Either
‘true’ or r ‘false’ (or no value, , which h is equivalent t to o ‘true’). . (Default:
doublepages=false)
doublepagestwist Whereas withdoublepagesthecuttingedge is onceon
theinnersideandonesontheouterside,doublepagestwist turnsthe
pages such, , that t the e cutting edge is s always s onthe inner r side. . Either
‘true’ or r ‘false’ (or no value, , which h is equivalent t to o ‘true’). . (Default:
doublepagestwist=false)
doublepagestwistodd Turnsthepagessuch,thatthecuttingedgeisalways
ontheouterside. Either‘true’or‘false’(ornovalue,whichisequivalent
to‘true’). (Default: doublepagestwistodd=false)
doublepagestwist* Likedoublepagestwistbutfordoublesideprinting.Ei-
ther‘true’or‘false’(ornovalue,whichisequivalentto‘true’).(Default:
doublepagestwist*=false)
doublepagestwistodd* Like e doublepagestwistodd but for double side
printingEither‘true’or‘false’(ornovalue,whichisequivalentto‘true’).
(Default: doublepagestwistodd*=false)
duplicatepages Duplicateseachpagentimes,withnbeingtheargumentto
thisoption.(Default:duplicatepages=2)
5
C# TWAIN - Specify Size and Location to Scan foreach (TwainStaticFrameSizeType frame in frames) { if (frame == TwainStaticFrameSizeType.LetterUS) { this.device.FrameSize = frame; break; } } }.
break apart pdf; pdf split and merge C# TWAIN - Acquire or Save Image to File RasterEdge.XDoc.PDF.dll. if (device.Compression != TwainCompressionMode.Group4) device.Compression = TwainCompressionMode.Group3; break; } } acq.FileTranfer
acrobat split pdf; pdf split pages
61
Miscellaneousoptions:
lastpage In
DVI
mode pdfpages cannot t determine e the number of f pages of
theincludeddocument. Sothisoptionissuitabletospecifythenumber
of pages. . This s option is only y used d in
DVI
mode andhas s no meaning
inanyother mode. . Theargumentshouldbeapage e number. . (Default:
lastpage=1)
Hypertextoptions:
link Insertedpagesbecomeatarget t ofahyperlink. . Thenameofthelinkis
‘hfilenamei.hpage numberi’. . Thelenameextensionofhlenameimust
not bestripped. Either‘true’or‘false’(ornovalue,whichisequivalent
to‘true’). (Default: link=false)
linkname Changesthedefaultlinknamecreatedbytheoptionlink.Instead
ofhlenamei thevalueofthis optionis used. . E.g. . linkname=mylink
producesthelinknames‘mylink.hpage numberi’.
thread Combines s insertedpagestoanarticlethread. . Either‘true’or‘false’
(ornovalue,whichisequivalentto‘true’).(Default: thread=false)
threadname Several threads are distinguished by their threadnames. . By
default the threadname is equal l to the lename e (plus lename e exten-
sion), but t it can be changed d with this s option. . This s is useful l if the
same le is insertedtwice or more times andshouldnot t be e combined
to one single thread. . Or r the other way round if pages s from dier-
ent documents should be combined to one single thread. . (Default:
threadname=hfilename.exti)
linktodoc Letstheinsertedpagesbehyperlinkstothedocumentfromwhich
theywereextracted. Notethat t the
PDF
-Viewerwillnotndthele,if
hlenamei hasnot lenameextension(.pdf). . Either r ‘true’or‘false’(or
novalue,whichisequivalentto‘true’). (Default: linktodoc=false)
Additionalhypertextoptions:
linkt Species,howtheviewerdisplaysalinkedpage. . Thisoptionchanges
thedefaultbehavior oftheoptionlink. . Possiblevaluesare: Fit,FitH
htopi,FitV hlefti,FitB,FitBH htopi,FitBV hlefti,andRegion.
See [2]foradetails descriptionof these
PDF
destinations. The e region
destinationwasaddedbypdfpagesandisnotareal
PDF
destinations.It
scalesapagesuchthattheincludedpagetsexactlyintothewindowof
the
PDF
viewer.
Notethatnot alloftheseoptions are supportedby allT
E
X-engines or
drivers,respectively. (Default: linkfit=fit)
linktodoct Bydefaulttheoptionlinktodocopensthepagein‘FitinWin-
dow’view. Anotherviewcanbespeciedwiththisoption.Possiblevalues
arethelegal
PDF
tokens:/FitHhtopi,/FitVhlefti,etc.(See[2]formore
details.) (Default:linktodocfit=/Fit)
newwindow By y default optionlinktodoc opens a newwindow. . Thiscan
bechangedwithoptionnewwindow. Either‘true’or‘false’(ornovalue,
whichisequivalentto‘true’).(Default: newwindow=true)
6
47
linklename Sets the e name (withpath) of the le to be linkedto by the
option linktodoc. . You u will l hardly ever r need d this s option. . (Default:
linkfilename=hfilename.exti)
Experimentaloptions: (Syntaxmaychangeinfutureversions!)
addtotoc Adds anentry tothetable of contents. . Thisoptionrequiresve
arguments,separatedbycommas:
addtotoc=fhpage numberi,hsectioni,hleveli,hheadingi,hlabelig
hpagenumberi: Pagenumberoftheinsertedpage.
hsectioni: LAT
E
Xsectioningname{e.g.,section,subsection,...
hleveli: Number,denotingdepthofsection{e.g.,1forsectionlevel,2for
subsectionlevel,...
hheadingi: Titleinsertedinthetableofcontents.
hlabeli: Nameofthelabel. . This s labelcanbereferredtowith\refand
\pageref.
Note:Theorderoftheveargumentsmustnotbemixed.Otherwiseyou
willgetverystrangeerrormessages.
Theaddtotocoptionaccepts multiplesets of theabovementionedve
arguments,allseparatedbycommas. Thesetsmustbesortedsuchthat
thehpagenumberisareinascendingorder. (Strictlyspeakingtheymust
havethesameorderasthepagenumbersspeciedbythepagesoption.)
Theproperrecursivedenitionoftheaddtotocoptionis:
addtotoc=fhtoc-listig
htoc-listi!hpagenumberi,hsectioni,hleveli,hheadingi,hlabeli[,htoc-listi]
addtolist Addsanentrytothelistofgures,thelistoftables,oranyother
list(e.g.from
oat.sty). . Thisoptionrequiresfourarguments,separated
bycommas:
addtolist=fhpage numberi,htypei,hheadingi,hlabelig
hpagenumberi: Pagenumberoftheinsertedpage.
htypei: Nameofa
oatingenvironment.(figure,table,etc.)
hheadingi: TitleinsertedintoLoF,LoT,etc.
hlabeli: Nameofthelabel. . This s labelcanbereferredtowith\refand
\pageref.
Likeaddtotoc,addtolistacceptsmultiplesetsoftheabovementioned
fourarguments,allseparatedbycommas.Theproperrecursivedenition
is:
addtolist=fhlof-listig
hlof-listi!hpagenumberi,htypei,hheadingi,hlabeli[,hlof-listi]
survey Creates s asurveyofthose pagesofthedocument,whicharemarked
with\AddToSurvey. (\AddToSurveyisasimplecommandwithnoargu-
ments. It t just writes out labels to o the .aux le.) ) This s optionmay be
usedwhenpreparingslidestocreateasurveyofonly‘nished’pages{if
pagesarebuildupincrementally.
Tousethisoptionaspecialsequenceofproductionstepsmustbeobeyed.
Hereisasmallexample:
7
49
--- slides.tex ---
\documentclass{article}
\usepackage[draft,enable-survey]{pdfpages}
\begin{document}
... some e text t ...
\AddToSurvey
... some e text t ...
\includepdf[survey,nup=2x2]{slides-tmp.pdf}
\end{document}
This is theoutlineof adocument,calledslides.tex. . Runit t through
pdfLaTeXseveraltimesuntilallcross-referencesaresolved. (LAT
E
Xwill
produceawarning,ifcross-referencesarenotsolved,yet.) Nowcopythe
leslides.pdftoslides-tmp.pdfandrenamedraft(packageoption
ofpdfpages) to o final. . Thenext t andnal runthroughpdfLaTeX will
actuallyinsertthedesiredpages,whereastheformerrunswithdraftdid
justinsertblankpages. Theinsertedpagesarehyperlinktotheorignial
pages.
Experienceduserswouldcertainlycall
pdflatex ’\PassOptionsToPackage{final}{pdfpages} \input{slides}’
insteadofexchangingdraftforfinal.
Either‘true’or‘false’(ornovalue,whichisequivalentto‘true’).(Default:
survey=false)
survey-nolink Sameasoptionsurveyexceptthattheinsertedpagesdonot
becomehyperlinks.Thisoptionmaybeusedtocreateanexternalsurvey.
Tocontinuetheexampleabove(slides.tex),itisnowpossibletocreate
handoutsofthe‘nished’slidesasanexternaldocument.
\documentclass{article}
\usepackage{xr}
\externaldocument{slides}
\usepackage[enable-survey]{pdfpages}
\begin{document}
\includepdf[survey-nolink, nup=1x2]{slides.pdf}
\end{document}
Either‘true’or‘false’(ornovalue,whichisequivalentto‘true’).(Default:
survey-nolink=false)
xr-prex Adjustsaprextothelabels\includepdfislookingfor.Thename
oftheprexmustbethesameasthenameoftheoptionalargumentof
\externaldocument.(Default: xr-prefix=fg)
Internallythecommand\includepdfmakesuseofthe\includegraphicscom-
mandfromthegraphicx(actuallygraphics)package.Henceitispossibletouse
alltheoptionsof\includegraphics,too. Optionswhicharenotinterpretedby
\includepdfarepasseddirectlyto\includegraphics.
Especiallythe‘trim’and‘clip’optionsof\includegraphicsarequiteuseful,
ifonlypartsofapageshouldbeinserted.(Maybetocutotheheaderandfooter
oftheinsertedpages.) Justusethe‘trim’and‘clip’optionsasiftheywereoptions
of\includepdf.Theywillbepassedto\includegraphicsinternally.
8
23
-
delx
-
delx
6
?
dely
6
?
dely
-
6
ox
oy
physicalsheetofpaper
delta=hdelxihdelyi
logicalpages
offset=hoxihoyi
centeredposition
Figure1: Layout
9
45
Insertspagesofseveralexternal
PDF
documents.
\includepdfmerge
\includepdfmerge[hkey=vali]{hle-page-listi}
hkey=vali
{Acommaseparatedlistofoptionsusingthe
hkeyi=hvalueisyntax.
hle-page-listi{hlenamei[,hpagespeci][,hle-page-listi]
Acommaseparatedlistoflenamesandoptional
hpagespecispeciers.Ahpagespecicanbeeverything
theoptionpagesaccepts. Leadingandtrailingspaces
ofitemsinthelistisstripped.
The\includepdfmergecommandusesthesameoptionsas\includepdfwith
oneexception.Theoptionpageshasnomeaningfor\includepdfmerge.Instead
the hpagespeci specier isusedtospecifywhichpages shouldbeinserted. . The
hpagespecispecieracceptsthesamevaluesasthepagesoption.Ifnohpagespeci
specierisgiven,onlytherstpagewillbeinserted.
Examples: Tocreateakindofsummaryofthree
PDF
documents,itmightbe
nice toinsert just the rst page of eachdocument andtoprovide links to the
originaldocuments:
\includepdfmerge[nup=1x3, landscape, linktodoc]
{doc1.pdf, doc2.pdf, doc3.pdf}
But sometimes thetitle page ofa a document t is not the rst page. . Soit t would
bemorepleasant toinsert the titlepageofeachdocumentthantherst page.
Thiscanbedonewiththehpagespecispecier. Thefollowingexampleinsertsthe
secondpageofdoc1.pdf andthethirdpageofdoc2.pdf anddoc3.pdf:
\includepdfmerge[nup=1x3, landscape, linktodoc]
{doc1.pdf, 2, doc2.pdf, 3, doc3.pdf, 3}
Hereisanexampleofmorecomplexhpagespecispeciers:
\includepdfmerge[nup=1x3, landscape, linktodoc]
{doc1.pdf, 1-3,
doc2.pdf, 3, 5, 9,
doc3.pdf, 3-5, 7}
Ifyouneedthesameoptions for \includepdfallthetime,it is possible tode-
\includepdfset
neglobaloptionswith\includepdfset. Theargumentof f \includepdfset is
acomma separatedlist t of options, usingthe hkeyi=hvaluei syntax. . These e op-
tionsareprocessedeachtime\includepdfiscalled.Localoptions(passedasan
optionalargumentdirectlyto\includepdf)areoverwritingglobaloptions:
\includepdfset{hglobaloptionsi}
\includepdf[hlocaloptionsi]{pdf-file}
10
Documents you may be interested
Documents you may be interested
