Difference between revisions of "Command/setupexternalfigure"
< Command
Jump to navigation
Jump to search
(explain more options) |
|||
Line 38: | Line 38: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="method"> | <cd:parameter name="method"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <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="pdf"></cd:constant> | ||
<cd:constant type="mps"></cd:constant> | <cd:constant type="mps"></cd:constant> | ||
Line 56: | Line 56: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="controls"> | <cd:parameter name="controls"> | ||
− | <cd:paramdoc>Show media controls (for movies | + | <cd:paramdoc>Show media controls (for movies)</cd:paramdoc> |
<cd:constant type="yes"></cd:constant> | <cd:constant type="yes"></cd:constant> | ||
<cd:constant default="yes" type="no"></cd:constant> | <cd:constant default="yes" type="no"></cd:constant> | ||
Line 70: | Line 70: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="resolution"> | <cd:parameter name="resolution"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>Set the image resolution (after scaling) for automatic downsampling</cd:paramdoc> |
− | <cd:constant type="cd:number"></cd:constant> | + | <cd:constant type="cd:number">dpi</cd:constant> |
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="color"> | <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: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"></cd:constant> | + | <cd:constant type="cd:color">color name</cd:constant> |
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="cmyk"> | <cd:parameter name="cmyk"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>Force CMYK conversion</cd:paramdoc> |
<cd:constant type="yes"></cd:constant> | <cd:constant type="yes"></cd:constant> | ||
<cd:constant default="yes" type="no"></cd:constant> | <cd:constant default="yes" type="no"></cd:constant> | ||
Line 119: | Line 119: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="maxwidth"> | <cd:parameter name="maxwidth"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>maximum width</cd:paramdoc> |
<cd:constant type="cd:dimension"></cd:constant> | <cd:constant type="cd:dimension"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="maxheight"> | <cd:parameter name="maxheight"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>maximum height</cd:paramdoc> |
<cd:constant type="cd:dimension"></cd:constant> | <cd:constant type="cd:dimension"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
Line 159: | Line 159: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="lines"> | <cd:parameter name="lines"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>Height in lines</cd:paramdoc> |
<cd:constant type="cd:number"></cd:constant> | <cd:constant type="cd:number"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
Line 195: | Line 195: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="frame"> | <cd:parameter name="frame"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>Show frame around image. Most(?) options of {{cmd|setupframed}} are usable!</cd:paramdoc> |
<cd:constant type="on"></cd:constant> | <cd:constant type="on"></cd:constant> | ||
<cd:constant default="yes" type="off"></cd:constant> | <cd:constant default="yes" type="off"></cd:constant> | ||
Line 243: | Line 243: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="cache"> | <cd:parameter name="cache"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>Set location of cache for conversions</cd:paramdoc> |
<cd:constant type="cd:path"></cd:constant> | <cd:constant type="cd:path"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
Line 255: | Line 255: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="conversion"> | <cd:parameter name="conversion"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <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:constant type="cd:text"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
Line 276: | Line 277: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="userpassword"> | <cd:parameter name="userpassword"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>Access to encrypted PDFs</cd:paramdoc> |
<cd:constant type="cd:text"></cd:constant> | <cd:constant type="cd:text"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="ownerpassword"> | <cd:parameter name="ownerpassword"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>Access to encrypted PDFs</cd:paramdoc> |
<cd:constant type="cd:text"></cd:constant> | <cd:constant type="cd:text"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
Line 298: | Line 299: | ||
<cd:commandref name="defineexternalfigure" originator="system"></cd:commandref> | <cd:commandref name="defineexternalfigure" originator="system"></cd:commandref> | ||
<cd:source file="grph-inc.mkvi" originator="system"></cd:source> | <cd:source file="grph-inc.mkvi" originator="system"></cd:source> | ||
+ | <cd:source file="grph-con.lua">conversions</cd:source> | ||
<cd:wikipage originator="system" page="Category:Graphics"></cd:wikipage> | <cd:wikipage originator="system" page="Category:Graphics"></cd:wikipage> | ||
<cd:commandref name="externalfigure"></cd:commandref></cd:seealso> | <cd:commandref name="externalfigure"></cd:commandref></cd:seealso> | ||
</cd:commandgroup> | </cd:commandgroup> |
Revision as of 09:07, 11 August 2022
Contents
\setupexternalfigure
Summary
The command \setupexternalfigure sets up \externalfigure
Settings
\setupexternalfigure[...,...][...=...,...] | |
[...,...] | name |
width | dimension |
height | dimension |
label | name |
page | number |
object | yes no |
prefix | text |
method | pdf mps jpg png jp2 jbig svg eps gif tif mov buffer tex cld auto |
controls | yes no |
preview | yes no |
mask | none |
resolution | number |
color | color |
cmyk | yes no auto |
arguments | text |
repeat | yes no |
factor | fit broad max auto default |
hfactor | fit broad max auto default |
wfactor | fit broad max auto default |
maxwidth | dimension |
maxheight | dimension |
equalwidth | dimension |
equalheight | dimension |
scale | number |
xscale | number |
yscale | number |
s | number |
sx | number |
sy | number |
lines | number |
location | local global default |
directory | path |
option | test frame empty |
foregroundcolor | color |
reset | yes no |
background | color foreground name |
frame | on off |
backgroundcolor | color |
xmax | number |
ymax | number |
frames | on off |
interaction | yes all none reference layer bookmark |
bodyfont | dimension |
comment | command text |
size | none media crop trim art |
cache | path |
resources | path |
display | file |
conversion | text |
order | list |
crossreference | yes no number |
transform | auto number |
userpassword | text |
ownerpassword | text |
Option | Explanation | ||||||||
---|---|---|---|---|---|---|---|---|---|
page |
| ||||||||
object |
| ||||||||
method |
| ||||||||
controls |
| ||||||||
resolution |
| ||||||||
color |
| ||||||||
cmyk |
| ||||||||
factor |
| ||||||||
maxwidth |
| ||||||||
maxheight |
| ||||||||
scale |
| ||||||||
lines |
| ||||||||
location |
| ||||||||
directory |
| ||||||||
frame |
| ||||||||
size |
| ||||||||
cache |
| ||||||||
display |
| ||||||||
conversion |
| ||||||||
order |
| ||||||||
transform |
| ||||||||
userpassword |
| ||||||||
ownerpassword |
|
Description
Examples
Example 1
\setupexternalfigures [order={pdf,png,jpg}, location=global, directory={images}]