3,899
edits
Changes
Jump to navigation
Jump to search
Created page with "Documentation for \filterpages"
<cd:commandgroup name="filterpages" xmlns:cd="http://wiki.contextgarden.net/commanddoc/20200807">
<cd:shortdesc>The command <tt>\filterpages</tt> is used to insert pages from another PDF file
</cd:shortdesc>
<cd:variants>
<cd:command category="graphics" file="page-sel.mkvi" interfacedate="2020-07-14T09:24" interfacefile="i-pageselection.xml" keywords="structure" level="document" name="filterpages" variantnumber="1">
<cd:arguments>
<cd:keywords ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:file"></cd:constant>
</cd:keywords>
<cd:keywords list="yes" ordinal="2">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="even">Select even pages (actual pdf page 2, 4, 6, etc.)</cd:constant>
<cd:constant type="odd">Select odd pages (actual pdf page 1, 3, 5, etc.)</cd:constant>
<cd:constant type="cd:number">Select a single page. Can be combined with other single pages or page ranges.</cd:constant>
<cd:constant method="range" prefix="cd:number" type="cd:number">Select a range of pages. Can be combined with other single pages or page ranges.</cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="3">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:parameter name="width">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:dimension">Rescales the included page(s) to this width</cd:constant>
</cd:parameter>
<cd:parameter name="n">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:number">Number of pages (does not actually work currently)</cd:constant>
</cd:parameter>
<cd:parameter name="category">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:name">A category that is passed on to {{cmd|externalfigure}}. See that command for further explanation.</cd:constant>
</cd:parameter>
</cd:assignments>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>Insert pages from another PDF file as pages in the current document. One can cherry-pick specific pages or page ranges.
Please note that the inserted pages will be placed on your ConTeXt pages like a new "layer", or floating object. This means that your existing headers, footers, crop marks will still be printed on top of or behind the inserted pages.
If you want to insert pages as completely independent pages between your existing ConTeXt pages, use {{cmd|startpagefigure}}.
</cd:description>
<cd:examples><cd:example title="">Insert page 1, and 3 through 6, of <code>file.pdf</code>:
<texcode>
\filterpages[file.pdf][1,3,4:6][width=18cm]
</texcode></cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:source file="page-sel.mkvi" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Graphics"></cd:wikipage>
<cd:wikipage originator="system" page="Keywords:Structure"></cd:wikipage>
<cd:commandref name="copypages">to insert pages from 1 to 'n' from another PDF</cd:commandref>
<cd:commandref name="insertpages">to insert pages from 1 to 'n' from another PDF, with extra blank pages at specific locations</cd:commandref>
<cd:commandref name="startpagefigure">to insert a figure as a separate page</cd:commandref></cd:seealso>
</cd:commandgroup>
<cd:shortdesc>The command <tt>\filterpages</tt> is used to insert pages from another PDF file
</cd:shortdesc>
<cd:variants>
<cd:command category="graphics" file="page-sel.mkvi" interfacedate="2020-07-14T09:24" interfacefile="i-pageselection.xml" keywords="structure" level="document" name="filterpages" variantnumber="1">
<cd:arguments>
<cd:keywords ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:file"></cd:constant>
</cd:keywords>
<cd:keywords list="yes" ordinal="2">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="even">Select even pages (actual pdf page 2, 4, 6, etc.)</cd:constant>
<cd:constant type="odd">Select odd pages (actual pdf page 1, 3, 5, etc.)</cd:constant>
<cd:constant type="cd:number">Select a single page. Can be combined with other single pages or page ranges.</cd:constant>
<cd:constant method="range" prefix="cd:number" type="cd:number">Select a range of pages. Can be combined with other single pages or page ranges.</cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="3">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:parameter name="width">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:dimension">Rescales the included page(s) to this width</cd:constant>
</cd:parameter>
<cd:parameter name="n">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:number">Number of pages (does not actually work currently)</cd:constant>
</cd:parameter>
<cd:parameter name="category">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="cd:name">A category that is passed on to {{cmd|externalfigure}}. See that command for further explanation.</cd:constant>
</cd:parameter>
</cd:assignments>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>Insert pages from another PDF file as pages in the current document. One can cherry-pick specific pages or page ranges.
Please note that the inserted pages will be placed on your ConTeXt pages like a new "layer", or floating object. This means that your existing headers, footers, crop marks will still be printed on top of or behind the inserted pages.
If you want to insert pages as completely independent pages between your existing ConTeXt pages, use {{cmd|startpagefigure}}.
</cd:description>
<cd:examples><cd:example title="">Insert page 1, and 3 through 6, of <code>file.pdf</code>:
<texcode>
\filterpages[file.pdf][1,3,4:6][width=18cm]
</texcode></cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:source file="page-sel.mkvi" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Graphics"></cd:wikipage>
<cd:wikipage originator="system" page="Keywords:Structure"></cd:wikipage>
<cd:commandref name="copypages">to insert pages from 1 to 'n' from another PDF</cd:commandref>
<cd:commandref name="insertpages">to insert pages from 1 to 'n' from another PDF, with extra blank pages at specific locations</cd:commandref>
<cd:commandref name="startpagefigure">to insert a figure as a separate page</cd:commandref></cd:seealso>
</cd:commandgroup>
