869
edits
Changes
Jump to navigation
Jump to search
m
< [[Graphics]] | [[Combinations]] | [[File Formats|Supported Media File Formats]] | [[Including pages from PDF documents]] | [[Animation]] | [[Downsampling]] >
''Note: This option only works with PDF files!''
If either <tt>width</tt> or <tt>height</tt> is specified, then the <tt>scale</tt> key has no effect.
= [[Floating Objects]] =
Floats are numbered and placed by ConTeXt, with a configurable (and optional) caption.
<texcode>
\placefigure[place]{My Caption}{\externalfigure[myone]}
</texcode>
<tt>place</tt> is one of:
left, right, here, top, bottom, inleft, inright, inmargin, margin, page, opposite, always, force, tall
You get ''no'' caption with <tt>none</tt>.
You get a table of figures with {{cmd|showexternalfigures}}<code>[alternative=a]</code>. Alternatives (styles) a, b and c are predefined.
The second brackets of {{cmd|placefigure}} can contain any command, e.g. {{cmd|getbuffer}}.
You find more about floats ([[Floating Objects]]) in the manual.
= See Also =
* [[Animation]]
* [[Example photo page layout]]
* [[Graphical_text_manipulation|scaling, rotating, mirroring, clipping]]
{{Getting started navbox}}
→Image Scaling
= Usage =
* '''JPEG 2000''': File extension <tt>.jp2</tt>
* '''JBIG''' or '''JBIG2''': File extension <tt>.jbig</tt>, <tt>.jbig2</tt>, or <tt>.jb2</tt>
An old page (2010), gives details on supported [[File Formats|file formats]]
== Image Conversion ==
The conversion generates a PDF file with prefix <tt>m_k_i_v_</tt> and a suffix <tt>.pdf</tt> added to the name of the original file. The result is cached, and the conversion is rerun if the timestamp of the original file is newer than that of the converted file.
It is possible to change the converter used with the following code:
<pre>
\startluacode
local function converter(oldname, newname, resolution)
if not resolution or resolution == "" then
resolution = 50
end
os.execute(string.format(
'convert -density %ix%i "%s" "%s"',
resolution, resolution, oldname, newname)
)
end
-- Set the PDF and default TIFF converters to the above function.
figures.converters.tif.pdf = converter
figures.converters.tif.default = converter
\stopluacode
\starttext
% Substitute any TIFF here.
\externalfigure[cow.tiff]
\stoptext
</pre>
See also: https://source.contextgarden.net/tex/context/base/mkiv/grph-inc.lua
== Interaction ==
By default, the interactive elements of the included PDF file are discarded. To enable the interactive elements of the included PDF file, use
<texcode>\externalfigure[filename.pdf][interaction=yes]</texcode>
For further reading, don't forget [[Including pages from PDF documents]].
== Image Directory ==
== Inline Images ==
Embedding inline images via base64 encoding using the memstream function (supports epdf onlypdf and png streams):
<texcode>
\stopluacode
</texcode>
= Transformations =
== Image Scaling ==
{{ note | If either <tt>width</tt> or <tt>height</tt> is specified, then the <tt>scale</tt> key has no effect. }}
To scale an image use the <tt>scale</tt> key: <tt>scale=1000</tt> corresponds to the original dimensions of the image, <tt>scale=500</tt> scales the image to 50% of the original size, <tt>scale=1500</tt> scales the images to 150% of the original size, and so on. For example:
<texcode>\externalfigure[logo.pdf][scale=500]</texcode>
scales the image to 50% of its size.
Use <tt>\setupexternalfigures</tt> to set the scale of all images. For example, to scale all images to be twice their original size, use:
<texcode>\setupexternalfigures[scale=2000]</texcode>
In addition, the <tt>xscale</tt> and <tt>yscale</tt> keys scale the image in only one dimension. For example:
<texcode>\clip[nx=3,ny=3,x=2,y=2]
{\externalfigure[logo.pdf]}</texcode>
In PDF files, it is possible to specify different size information in PDF headers MediaBox, TrimBox, CropBox, and ArtBox. To clip to one of these sizes, use
<texcode>\externalfigure[logo.pdf][size=art]</texcode>
Other options are: `none` (detault), `media` for MediaBox, `crop` for CropBox, `trim` for TrimBox, and `art` for ArtBox.
= Troubleshooting =
ConTeXt includes a Perl script <tt>pdftrimwhite</tt> that removes extra white space at the borders of a PDF file. To run this script:
<pre>mtxrun --script pdftrimwhite <em>[flags] input output</em></pre>
The most important flag is <tt>--offset=dimen</tt>, which keeps some extra space around the trimmed image.
= Movies =
</nowiki></pre>
[[Category:Graphics]]
