Changes

Jump to navigation Jump to search
some more information
</cd:parameter>
<cd:parameter name="label">
<cd:paramdoc>internal name</cd:paramdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:parameter>
<cd:parameter name="page">
<cd:paramdoc>Page number of PDF.</cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
</cd:parameter>
<cd:parameter name="object">
<cd:paramdoc>Reuse this image file as an object, i.e. embed it only once in PDF if it’s used several times? </cd:paramdoc>
<cd:constant default="yes" type="yes"></cd:constant>
<cd:constant type="no"></cd:constant>
</cd:parameter>
<cd:parameter name="method">
<cd:paramdoc>force a file type (and processing), e.g. if there are different versions</cd:paramdoc>
<cd:constant type="pdf"></cd:constant>
<cd:constant type="mps"></cd:constant>
<cd:constant type="gif"></cd:constant>
<cd:constant type="tif"></cd:constant>
<cd:constant type="mov">is removed from LMTX</cd:constant>
<cd:constant type="buffer"></cd:constant>
<cd:constant type="tex"></cd:constant>
<cd:constant type="cld"></cd:constant>
<cd:constant type="auto">strips suffix and uses "order"</cd:constant>
</cd:parameter>
<cd:parameter name="controls">
<cd:paramdoc>Show media controls (for movies)</cd:paramdoc>
<cd:constant type="yes"></cd:constant>
<cd:constant default="yes" type="no"></cd:constant>
</cd:parameter>
<cd:parameter name="resolution">
<cd:paramdoc>Set the image resolution (after scaling) for automatic downsampling</cd:paramdoc> <cd:constant type="cd:number">dpi</cd:constant>
</cd:parameter>
<cd:parameter name="color">
<cd:paramdoc>Colorize the image. Works only with some greyscale pictures (no channels, no additional tables, ...?) and only with toned (<tt>p=</tt>) or [[Spot_Colors|spot colors]]. Use with <cd:iref name="object" type="no"/></cd:paramdoc> <cd:constant type="cd:color">color name</cd:constant>
</cd:parameter>
<cd:parameter name="cmyk">
<cd:paramdoc>Force CMYK conversion</cd:paramdoc>
<cd:constant type="yes"></cd:constant>
<cd:constant default="yes" type="no"></cd:constant>
</cd:parameter>
<cd:parameter name="arguments">
<cd:paramdoc>used for converters</cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
</cd:parameter>
<cd:parameter name="factor">
<cd:paramdoc>If both <tt>width</tt> and <tt>height</tt> are set, the <tt>factor</tt> is important. If <cd:iref name="factor"/> is empty, the image is deformed accordingly.</cd:paramdoc> <cd:constant type="fit">aspect ratio is kept, the image is scaled to the smaller (fitted) variant</cd:constant>
<cd:constant type="broad"></cd:constant>
<cd:constant type="max">aspect ratio is kept, the image is scaled to the bigger (oversized) variant</cd:constant>
<cd:constant type="auto"></cd:constant>
<cd:constant type="default"></cd:constant>
</cd:parameter>
<cd:parameter name="maxwidth">
<cd:paramdoc>maximum width</cd:paramdoc>
<cd:constant type="cd:dimension"></cd:constant>
</cd:parameter>
<cd:parameter name="maxheight">
<cd:paramdoc>maximum height</cd:paramdoc>
<cd:constant type="cd:dimension"></cd:constant>
</cd:parameter>
</cd:parameter>
<cd:parameter name="scale">
<cd:paramdoc>1000 is original size (100%); to get 72%, use scale=720.</cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
</cd:parameter>
</cd:parameter>
<cd:parameter name="lines">
<cd:paramdoc>Height in lines</cd:paramdoc>
<cd:constant type="cd:number"></cd:constant>
</cd:parameter>
<cd:constant type="test"></cd:constant>
<cd:constant type="frame"></cd:constant>
<cd:constant type="empty">don’t include actual image (“draft mode”)</cd:constant>
</cd:parameter>
<cd:parameter name="foregroundcolor">
<cd:paramdoc>probably synonymous to "color"</cd:paramdoc>
<cd:constant type="cd:color"></cd:constant>
</cd:parameter>
</cd:parameter>
<cd:parameter name="background">
<cd:paramdoc>like {{cmd|setupframed}}</cd:paramdoc>
<cd:constant type="color"></cd:constant>
<cd:constant type="foreground"></cd:constant>
</cd:parameter>
<cd:parameter name="frame">
<cd:paramdoc>Show frame around image. Most(?) options of {{cmd|setupframed}} are usable!</cd:paramdoc>
<cd:constant type="on"></cd:constant>
<cd:constant default="yes" type="off"></cd:constant>
</cd:parameter>
<cd:parameter name="backgroundcolor">
<cd:paramdoc>like {{cmd|setupframed}}, used if <tt>background=color</tt></cd:paramdoc>
<cd:constant type="cd:color"></cd:constant>
</cd:parameter>
</cd:parameter>
<cd:parameter name="interaction">
<cd:paramdoc>How to handle the interaction (links etc.) of included PDFs – default is to disable all of them.</cd:paramdoc> <cd:constant type="yes">keep all(?)</cd:constant> <cd:constant type="all">keep all</cd:constant> <cd:constant default="yes" type="none">disable all</cd:constant> <cd:constant type="reference">keep references</cd:constant> <cd:constant type="layer">keep PDF layers (viewer layers, optional content groups)</cd:constant> <cd:constant type="bookmark">keep bookmarks</cd:constant>
</cd:parameter>
<cd:parameter name="bodyfont">
</cd:parameter>
<cd:parameter name="size">
<cd:paramdoc>Use specified box of PDF (MediaBox, CropBox, TrimBox, ArtBox). (No BleedBox?)</cd:paramdoc>
<cd:constant type="none"></cd:constant>
<cd:constant type="media"></cd:constant>
</cd:parameter>
<cd:parameter name="cache">
<cd:paramdoc>Set location of cache for conversions</cd:paramdoc>
<cd:constant type="cd:path"></cd:constant>
</cd:parameter>
</cd:parameter>
<cd:parameter name="display">
<cd:paramdoc>alternative figure, e.g. lowres; used with movie and 3D contents, probably obsolete</cd:paramdoc>
<cd:constant type="cd:file"></cd:constant>
</cd:parameter>
<cd:parameter name="conversion">
<cd:paramdoc>see {{src|grph-con.lua}}.<tt>conversion=mp</tt> activates internal processing of [[SVG]] via [[MetaPost]]</cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="crossreference">
<cd:paramdoc></cd:paramdoc>
<cd:constant type="yes">use counter for referencing</cd:constant>
<cd:constant type="no"></cd:constant>
<cd:constant type="cd:number"></cd:constant>
</cd:parameter>
<cd:parameter name="transform">
<cd:paramdoc>Rotation in 90˚ steps (otherwise use {{cmd|rotate}}); does not always work (?) `orientation=90|180|270` works</cd:paramdoc>
<cd:constant default="yes" type="auto"></cd:constant>
<cd:constant type="cd:number"></cd:constant>
</cd:parameter>
<cd:parameter name="userpassword">
<cd:paramdoc>Access to encrypted PDFs</cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="ownerpassword">
<cd:paramdoc>Access to encrypted PDFs</cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
</cd:command>
</cd:variants>
<cd:description><!-- There are a few more options that are missing in the long description of interface files: * '''orientation''': rotation (in LMTX arbitrary angles, in MkIV only 90˚steps)* '''minwidth/minheight'''* '''strut''': strut=none also avoids the command goes here -->\noindent; otherwise we're in hmode when blank happens and we get a lineskip</cd:description>
<cd:examples><cd:example title=""><texcode>
\setupexternalfigures
<cd:seealso>
<cd:commandref name="defineexternalfigure" originator="system"></cd:commandref>
<cd:source filecommandref name="grph-inc.mkvi" originator="systemexternalfigure"></cd:sourcecommandref>
<cd:wikipage originator="system" page="Category:Graphics"></cd:wikipage>
<cd:commandref namesource file="externalfiguregrph-inc.mkvi" originator="system">MkIV source</cd:source><cd:source file="grph-inc.mkxl">LMTX source</cd:source><cd:source file="grph-con.lua">conversions source</cd:source><cd:wikipage page="Using_Graphics"></cd:commandrefwikipage></cd:seealso>
</cd:commandgroup>

Navigation menu