File indexing completed on 2024-11-24 04:34:43
0001 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 0002 <html> 0003 <!-- This document is an unofficial reference manual for LaTeX, a 0004 document preparation system, version of November 2018. 0005 0006 This manual was originally translated from LATEX.HLP v1.0a in the 0007 VMS Help Library. The pre-translation version was written by 0008 George D. Greenwade of Sam Houston State University. The 0009 LaTeX 2.09 version was written by Stephen Gilmore. The 0010 LaTeX2e version was adapted from this by Torsten Martinsen. Karl 0011 Berry made further updates and additions, and gratefully acknowledges 0012 using Hypertext Help with LaTeX, by Sheldon Green, and 0013 LaTeX Command Summary (for LaTeX 2.09) by 0014 L. Botway and C. Biemesderfer (published by the TeX Users 0015 Group as TeXniques number 10), as reference material. We also 0016 gratefully acknowledge additional material appearing in 0017 latex2e-reference by Martin Herbert Dietze. (From these references no 0018 text was directly copied.) 0019 0020 Copyright 2007, 2008, 2009, 2010, 2011, 2012, 2013, 0021 2014, 2015, 2016, 2017, 2018 Karl Berry. 0022 0023 Copyright 1988, 1994, 2007 Stephen Gilmore. 0024 0025 Copyright 1994, 1995, 1996 Torsten Martinsen. 0026 0027 Permission is granted to make and distribute verbatim copies of 0028 this manual provided the copyright notice and this permission notice 0029 are preserved on all copies. 0030 0031 0032 Permission is granted to copy and distribute modified versions of this 0033 manual under the conditions for verbatim copying, provided that the entire 0034 resulting derived work is distributed under the terms of a permission 0035 notice identical to this one. 0036 0037 Permission is granted to copy and distribute translations of this manual 0038 into another language, under the above conditions for modified versions. --> 0039 <!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> 0040 <head> 0041 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 0042 <title>\includegraphics (LaTeX2e unofficial reference manual (November 2018))</title> 0043 0044 <meta name="description" content="\includegraphics (LaTeX2e unofficial reference manual (November 2018))"> 0045 <meta name="keywords" content="\includegraphics (LaTeX2e unofficial reference manual (November 2018))"> 0046 <meta name="resource-type" content="document"> 0047 <meta name="distribution" content="global"> 0048 <meta name="Generator" content="makeinfo"> 0049 <link href="index.html#Top" rel="start" title="Top"> 0050 <link href="IndexDocument.html#Index" rel="index" title="Index"> 0051 <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> 0052 <link href="Commands-for-graphics.html#Commands-for-graphics" rel="up" title="Commands for graphics"> 0053 <link href="_005crotatebox.html#g_t_005crotatebox" rel="next" title="\rotatebox"> 0054 <link href="Commands-for-graphics.html#Commands-for-graphics" rel="prev" title="Commands for graphics"> 0055 <style type="text/css"> 0056 <!-- 0057 /* $Id: latex2e.css 690 2018-09-15 15:20:19Z jimhefferon $ 0058 Minor css for latexrefman. Public domain. 0059 Originally written by Jim Hefferon and Karl Berry, 2018. */ 0060 0061 /* So you can style for yourself */ 0062 @import url("/css/latexreflocal.css"); 0063 0064 0065 0066 a.summary-letter {text-decoration: none} 0067 blockquote.indentedblock {margin-right: 0em} 0068 blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} 0069 blockquote.smallquotation {font-size: smaller} 0070 div.display {margin-left: 3.2em} 0071 div.example {margin-left: 3.2em} 0072 div.lisp {margin-left: 3.2em} 0073 div.smalldisplay {margin-left: 3.2em} 0074 div.smallexample {margin-left: 3.2em} 0075 div.smalllisp {margin-left: 3.2em} 0076 kbd {font-style: oblique} 0077 pre.display {font-family: inherit} 0078 pre.format {font-family: inherit} 0079 pre.menu-comment {font-family: serif} 0080 pre.menu-preformatted {font-family: serif} 0081 pre.smalldisplay {font-family: inherit; font-size: smaller} 0082 pre.smallexample {font-size: smaller} 0083 pre.smallformat {font-family: inherit; font-size: smaller} 0084 pre.smalllisp {font-size: smaller} 0085 span.nolinebreak {white-space: nowrap} 0086 span.roman {font-family: initial; font-weight: normal} 0087 span.sansserif {font-family: sans-serif; font-weight: normal} 0088 ul.no-bullet {list-style: none} 0089 BODY { 0090 margin-top: 1em; 0091 margin-left: 1em; /* auto results in two-digit <ol> lost off left */ 0092 margin-right: 1em; 0093 margin-bottom: 1em; 0094 /* the idea is to use the whole window, unless it is ridiculously 0095 wide, probably with too-small fonts, too. */ 0096 max-width: 64em; 0097 } 0098 0099 /* Because we want @math{... @code ...} to be upright, not slanted, 0100 and Texinfo won't fix it. */ 0101 code {font-style:normal; font-family:monospace; } 0102 0103 /* We put a link to our own home page at the bottom. */ 0104 div.referenceinfo {font-size:small;} 0105 0106 --> 0107 </style> 0108 0109 0110 </head> 0111 0112 <body lang="en"> 0113 <a name="g_t_005cincludegraphics"></a> 0114 <div class="header"> 0115 <p> 0116 Next: <a href="_005crotatebox.html#g_t_005crotatebox" accesskey="n" rel="next">\rotatebox</a>, Up: <a href="Commands-for-graphics.html#Commands-for-graphics" accesskey="u" rel="up">Commands for graphics</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="IndexDocument.html#Index" title="Index" rel="index">Index</a>]</p> 0117 </div> 0118 <hr> 0119 <a name="g_t_005cincludegraphics-1"></a> 0120 <h4 class="subsection">22.3.1 <code>\includegraphics</code></h4> 0121 0122 <a name="index-graphics-2"></a> 0123 <a name="index-graphics-package-2"></a> 0124 <a name="index-including-graphics"></a> 0125 <a name="index-importing-graphics"></a> 0126 <a name="index-EPS-files-1"></a> 0127 <a name="index-JPEG-files-1"></a> 0128 <a name="index-JPG-files-1"></a> 0129 <a name="index-PDF-graphic-files-1"></a> 0130 <a name="index-PNG-files-1"></a> 0131 <a name="index-_005cincludegraphics"></a> 0132 0133 <p>Synopses for <samp>graphics</samp> package: 0134 </p> 0135 <div class="example"> 0136 <pre class="example">\includegraphics{<var>filename</var>} 0137 \includegraphics[<var>urx</var>,<var>ury</var>]{<var>filename</var>} 0138 \includegraphics[<var>llx</var>,<var>lly</var>][<var>urx</var>,<var>ury</var>]{<var>filename</var>} 0139 \includegraphics*{<var>filename</var>} 0140 \includegraphics*[<var>urx</var>,<var>ury</var>]{<var>filename</var>} 0141 \includegraphics*[<var>llx</var>,<var>lly</var>][<var>urx</var>,<var>ury</var>]{<var>filename</var>} 0142 </pre></div> 0143 0144 <p>Synopses for <samp>graphicx</samp> package: 0145 </p> 0146 <div class="example"> 0147 <pre class="example">\includegraphics{<var>filename</var>} 0148 \includegraphics[<var>key-value list</var>]{<var>filename</var>} 0149 \includegraphics*{<var>filename</var>} 0150 \includegraphics*[<var>key-value list</var>]{<var>filename</var>} 0151 </pre></div> 0152 0153 <p>Include a graphics file. The starred form <code>\includegraphics*</code> will 0154 clip the graphic to the size specified, while for the unstarred form any 0155 part of the graphic that is outside the box of the specified size will 0156 over-print the surrounding area. 0157 </p> 0158 <p>This 0159 </p> 0160 <div class="example"> 0161 <pre class="example">\usepackage{graphicx} % in preamble 0162 ... 0163 \begin{center} 0164 \includegraphics{plot.pdf} 0165 \end{center} 0166 </pre></div> 0167 0168 <p>will incorporate into the document the graphic in <samp>plot.pdf</samp>, 0169 centered and at its nominal size. You can also give a path to the file, 0170 as with <code>\includegraphics{graphics/plot.pdf}</code>. To specify a list 0171 of locations to search for the file, see <a href="_005cgraphicspath.html#g_t_005cgraphicspath">\graphicspath</a>. 0172 </p> 0173 <p>If your filename includes spaces then put it in double quotes. An example 0174 is <code>\includegraphics{"sister picture.jpg"}</code>. 0175 </p> 0176 <p>The <code>\includegraphics{<var>filename</var>}</code> command decides on the 0177 type of graphic by splitting <var>filename</var> on the first dot. You can 0178 use <var>filename</var> with no dot, as in <code>\includegraphics{turing}</code> 0179 and then LaTeX tries a sequence of extensions such as <code>.png</code> and 0180 <code>.pdf</code> until it finds a file with that extension 0181 (see <a href="_005cDeclareGraphicsExtensions.html#g_t_005cDeclareGraphicsExtensions">\DeclareGraphicsExtensions</a>). 0182 </p> 0183 <p>If your file name contains dots before the extension then you can hide 0184 them with curly braces, as in 0185 <code>\includegraphics{{plot.2018.03.12.a}.pdf}</code>. Or, if you use 0186 the <samp>graphicx</samp> package then you can use the options <code>type</code> and 0187 <code>ext</code>; see below. This and other filename issues are also handled 0188 with the package <samp>grffile</samp>. 0189 </p> 0190 <p>This example puts a graphic in a figure environment so LaTeX can 0191 move it to the next page if fitting it on the current page is awkward 0192 (see <a href="figure.html#figure">figure</a>). 0193 </p> 0194 <div class="example"> 0195 <pre class="example">\begin{figure} 0196 \centering 0197 \includegraphics[width=3cm]{lungxray.jpg} 0198 \caption{The evidence is overwhelming: don't smoke.} \label{fig:xray} 0199 \end{figure} 0200 </pre></div> 0201 0202 <p>This places a graphic that will not float, so it is sure to appear at 0203 this point in the document even if makes LaTeX stretch the text or 0204 resort to blank areas on the page. It will be centered and will have a 0205 caption. 0206 </p> 0207 <div class="example"> 0208 <pre class="example">\usepackage{caption} % in preamble 0209 ... 0210 \begin{center} 0211 \includegraphics{pix/nix.png} 0212 \captionof{figure}{The spirit of the night} \label{pix:nix} % optional 0213 \end{center} 0214 </pre></div> 0215 0216 <p>This example puts a box with a graphic side by side with one having 0217 text, with the two vertically centered. 0218 </p> 0219 <div class="example"> 0220 <pre class="example">\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}} 0221 ... 0222 \begin{center} 0223 \vcenteredhbox{\includegraphics[width=0.4\textwidth]{plot}} 0224 \hspace{1em} 0225 \vcenteredhbox{\begin{minipage}{0.4\textwidth} 0226 \begin{displaymath} 0227 f(x)=x\cdot \sin (1/x) 0228 \end{displaymath} 0229 \end{minipage}} 0230 \end{center} 0231 </pre></div> 0232 0233 <p>If you use the <samp>graphics</samp> package then the only options involve the 0234 size of the graphic (but see <a href="_005crotatebox.html#g_t_005crotatebox">\rotatebox</a> and <a href="_005cscalebox.html#g_t_005cscalebox">\scalebox</a>). 0235 When one optional argument is present then it is 0236 <code>[<var>urx</var>,<var>ury</var>]</code> and it gives the coordinates of the top 0237 right corner of the image, as a pair of TeX dimensions (see <a href="Units-of-length.html#Units-of-length">Units of length</a>). If the units are omitted they default to <code>bp</code>. In 0238 this case, the lower left corner of the image is assumed to be at (0,0). 0239 If two optional arguments are present then the leading one is 0240 <code>[<var>llx</var>,<var>lly</var>]</code>, specifying the coordinates of the image’s 0241 lower left. Thus, <code>\includegraphics[1in,0.618in]{...}</code> calls for 0242 the graphic to be placed so it is 1 inch wide and 0.618 inches 0243 tall and so its origin is at (0,0). 0244 </p> 0245 <p>The <samp>graphicx</samp> package gives you many more options. Specify them 0246 in a key-value form, as here. 0247 </p> 0248 <div class="example"> 0249 <pre class="example">\begin{center} 0250 \includegraphics[width=1in,angle=90]{lion} 0251 \hspace{2em} 0252 \includegraphics[angle=90,width=1in]{lion} 0253 \end{center} 0254 </pre></div> 0255 0256 <p>The options are read left-to-right. So the first graphic above is made 0257 one inch wide and then rotated, while the second is rotated and then 0258 made one inch wide. Thus, unless the graphic is perfectly square, the 0259 two will end with different widths and heights. 0260 </p> 0261 <p>There are many options. The primary ones are listed first. 0262 </p> 0263 <p>Note that a graphic is placed by LaTeX into a box, which is 0264 traditionally referred to as its bounding box (distinct from the 0265 PostScript BoundingBox described below). The graphic’s printed area may 0266 go beyond this box, or sit inside this box, but when LaTeX makes up a 0267 page it puts together boxes and this is the box allocated for the 0268 graphic. 0269 </p> 0270 <dl compact="compact"> 0271 <dd><a name="includegraphics-width"></a></dd> 0272 <dt><code>width</code></dt> 0273 <dd><p>The graphic will be shown so its bounding box is this width. An example 0274 is <code>\includegraphics[width=1in]{plot}</code>. You can use the standard 0275 TeX dimensions (see <a href="Units-of-length.html#Units-of-length">Units of length</a>) and also convenient is 0276 <code>\linewidth</code>, or in a two-column document, <code>\columnwidth</code> 0277 (see <a href="Page-layout-parameters.html#Page-layout-parameters">Page layout parameters</a>). An example is that by using the 0278 <samp>calc</samp> package you can make the graphic be 1 cm narrow than 0279 the width of the text with 0280 <code>\includegraphics[width=\linewidth-1.0cm]{hefferon.jpg}</code>. 0281 </p> 0282 </dd> 0283 <dt><code>height</code></dt> 0284 <dd><a name="includegraphics-height"></a><p>The graphic will be shown so its bounding box is this height. You can 0285 use the standard TeX dimensions (see <a href="Units-of-length.html#Units-of-length">Units of length</a>), and also 0286 convenient are <code>\pageheight</code> and <code>\textheight</code> (see <a href="Page-layout-parameters.html#Page-layout-parameters">Page layout parameters</a>). For instance, the command 0287 <code>\includegraphics[height=0.25\textheight]{godel}</code> will make the 0288 graphic a quarter of the height of the text area. 0289 </p> 0290 </dd> 0291 <dt><code>totalheight</code></dt> 0292 <dd><a name="includegraphics-totalheght"></a><p>The graphic will be shown so its bounding box has this height plus 0293 depth. This differs from the height if the graphic was rotated. For 0294 instance, if it has been rotated by -90 then it will have zero height 0295 but a large depth. 0296 </p> 0297 </dd> 0298 <dt><code>keepaspectratio</code></dt> 0299 <dd><a name="includegraphics-keepaspectratio"></a><p>If set to <code>true</code>, or just specified as here 0300 </p> 0301 <div class="example"> 0302 <pre class="example"><code>\includegraphics[...,keepaspectratio,...]{...}</code> 0303 </pre></div> 0304 0305 <p>and you give as options both <code>width</code> and <code>height</code> (or 0306 <code>totalheight</code>), then LaTeX will make the graphic is as large as 0307 possible without distortion. That is, LaTeX will ensure that neither 0308 is the graphic wider than <code>width</code> nor taller than <code>height</code> (or 0309 <code>totalheight</code>). 0310 </p> 0311 </dd> 0312 <dt><code>scale</code></dt> 0313 <dd><p>Factor by which to scale the graphic. To make a graphic twice its 0314 nominal size, enter <code>\includegraphics[scale=2.0]{...}</code>. This 0315 number may be any value; a number between 1 and 0 will shrink the 0316 graphic and a negative number will reflect it. 0317 </p> 0318 </dd> 0319 <dt><code>angle</code></dt> 0320 <dd><p>Rotate the graphic. The angle is taken in degrees and counterclockwise. 0321 The graphic is rotated about its <code>origin</code>; see that option. For a 0322 complete description of how rotated material is typeset, 0323 see <a href="_005crotatebox.html#g_t_005crotatebox">\rotatebox</a>. 0324 </p> 0325 </dd> 0326 <dt><code>origin</code></dt> 0327 <dd><p>The point of the graphic about which the rotation happens. Possible 0328 values are any string containing one or two of: <code>l</code> for left, 0329 <code>r</code> for right, <code>b</code> for bottom, <code>c</code> for center, <code>t</code> 0330 for top, and <code>B</code> for baseline. Thus, entering the command 0331 <code>\includegraphics[angle=180,origin=c]{moon}</code> will turn the 0332 picture upside down about that picture’s center, while the command 0333 <code>\includegraphics[angle=180,origin=lB]{LeBateau}</code> will turn its 0334 picture upside down about its left baseline. (The character <code>c</code> 0335 gives the horizontal center in <code>bc</code> or <code>tc</code>, but gives the 0336 vertical center in <code>lc</code> or <code>rc</code>.) The default is <code>lB</code>. 0337 </p> 0338 <p>To rotate about an arbitrary point, see <a href="_005crotatebox.html#g_t_005crotatebox">\rotatebox</a>. 0339 </p> 0340 </dd> 0341 </dl> 0342 0343 <p>These are lesser-used options. 0344 </p> 0345 <dl compact="compact"> 0346 <dd><a name="includegraphics-viewport"></a></dd> 0347 <dt><code>viewport</code></dt> 0348 <dd><p>Pick out a subregion of the graphic to show. Takes four arguments, 0349 separated by spaces and given in TeX dimensions, as with 0350 <code>\includegraphics[.., viewport=0in 0in 1in 0.618in]{...}</code>. The 0351 dimensions default to big points, <code>bp</code>. They are taken 0352 relative to the origin specified by the bounding box. See also the 0353 <code>trim</code> option. 0354 </p> 0355 <a name="includegraphics-trim"></a></dd> 0356 <dt><code>trim</code></dt> 0357 <dd><p>Gives parts of the graphic to not show. Takes four arguments, separated 0358 by spaces, that are given in TeX dimensions, as with 0359 <code>\includegraphics[.., trim= 0in 0.1in 0.2in 0.3in, ...]{...}</code>. 0360 These give the amounts of the graphic not to show, that is, LaTeX 0361 will crop the picture by 0 inches on the left, 0.1 inches on 0362 the bottom, 0.2 inches on the right, and 0.3 inches on the 0363 top. See also the <code>viewport</code> option. 0364 </p> 0365 <a name="includegraphics-clip"></a></dd> 0366 <dt><code>clip</code></dt> 0367 <dd><p>If set to <code>true</code>, or just specified as here 0368 </p> 0369 <div class="example"> 0370 <pre class="example">\includegraphics[...,clip,...]{...} 0371 </pre></div> 0372 0373 <p>then the graphic is cropped to the bounding box. This is the same as 0374 using the starred form of the command, 0375 <code>\includegraphics*[...]{...}</code>. 0376 </p> 0377 <a name="includegraphics-page"></a></dd> 0378 <dt><code>page</code></dt> 0379 <dd><p>Give the page number of a multi-page PDF file. The default is 0380 <code>page=1</code>. 0381 </p> 0382 <a name="includegraphics-pagebox"></a></dd> 0383 <dt><code>pagebox</code></dt> 0384 <dd><p>Specifies which bounding box to use for PDF files from among 0385 <code>mediabox</code>, <code>cropbox</code>, <code>bleedbox</code>, <code>trimbox</code>, or 0386 <code>artbox</code>. PDF files do not have the BoundingBox that PostScript 0387 files have, but may specify up to four predefined rectangles. The 0388 MediaBox gives the boundaries of the physical medium. The CropBox is the 0389 region to which the contents of the page are to be clipped when 0390 displayed. The BleedBox is the region to which the contents of the page 0391 should be clipped in production. The TrimBox is the intended dimensions 0392 of the finished page. The ArtBox is the extent of the page’s meaningful 0393 content. The driver will set the image size based on CropBox if 0394 present, otherwise it will not use one of the others, with a 0395 driver-defined order of preference. MediaBox is always present. 0396 </p> 0397 <a name="includegraphics-interpolate"></a></dd> 0398 <dt><code>interpolate</code></dt> 0399 <dd><p>Enable or disable interpolation of raster images by the viewer. Can be 0400 set with <code>interpolate=true</code> or just specified as here. 0401 </p> 0402 <div class="example"> 0403 <pre class="example">\includegraphics[...,interpolate,...]{...} 0404 </pre></div> 0405 0406 <a name="includegraphics-quiet"></a></dd> 0407 <dt><code>quiet</code></dt> 0408 <dd><p>Do not write information to the log. You can set it with 0409 <code>quiet=true</code> or just specified it with 0410 <code>\includegraphics[...,quite,...]{...}</code>, 0411 </p> 0412 <a name="includegraphics-draft"></a></dd> 0413 <dt><code>draft</code></dt> 0414 <dd><p>If you set it with <code>draft=true</code> or just specify it with 0415 </p> 0416 <div class="example"> 0417 <pre class="example">\includegraphics[...,draft,...]{...} 0418 </pre></div> 0419 0420 <p>then the graphic will not appear in the document, possibly saving color 0421 printer ink. Instead, LaTeX will put an empty box of the correct 0422 size with the filename printed in it. 0423 </p> 0424 </dd> 0425 </dl> 0426 0427 <p>These options address the bounding box for Encapsulated PostScript 0428 graphic files, which have a size specified with a line 0429 <code>%%BoundingBox</code> that appears in the file. It has four values, 0430 giving the lower <em>x</em> coordinate, lower <em>y</em> coordinate, upper 0431 <em>x</em> coordinate, and upper <em>y</em> coordinate. The units are 0432 PostScript points, equivalent to TeX’s big points, 1/72 inch. 0433 For example, if an <samp>.eps</samp> file has the line <code>%%BoundingBox 10 0434 20 40 80</code> then its natural size is 30/72 inch wide by 0435 60/72 inch tall. 0436 </p> 0437 <dl compact="compact"> 0438 <dd><a name="includegraphics-bb"></a></dd> 0439 <dt><code>bb</code></dt> 0440 <dd><p>Specify the bounding box of the displayed region. The argument is four 0441 dimensions separated by spaces, as with <code>\includegraphics[.., bb= 0442 0in 0in 1in 0.618in]{...}</code>. Usually <code>\includegraphics</code> reads the 0443 BoundingBox numbers from the EPS file automatically, so this option is 0444 only useful if the bounding box is missing from that file or if you want 0445 to change it. 0446 </p> 0447 <a name="includegraphics-bbllx"></a><a name="includegraphics-bblly"></a><a name="includegraphics-bburx"></a><a name="includegraphics-bbury"></a></dd> 0448 <dt><code>bbllx, bblly, bburx, bbury</code></dt> 0449 <dd><p>Set the bounding box. These four are obsolete, but are retained for 0450 compatibility with old packages. 0451 </p> 0452 <a name="includegraphics-natwidth"></a><a name="includegraphics-natheight"></a></dd> 0453 <dt><code>natwidth, natheight</code></dt> 0454 <dd><p>An alternative for <code>bb</code>. Setting 0455 </p> 0456 <div class="example"> 0457 <pre class="example">\includegraphics[...,natwidth=1in,natheight=0.618in,...]{...} 0458 </pre></div> 0459 0460 <p>is the same as setting <code>bb=0 0 1in 0.618in</code>. 0461 </p> 0462 <a name="includegraphics-hiresbb"></a></dd> 0463 <dt><code>hiresbb</code></dt> 0464 <dd><p>If set to <code>true</code>, or just specified as with 0465 </p> 0466 <div class="example"> 0467 <pre class="example">\includegraphics[...,hiresbb,...]{...} 0468 </pre></div> 0469 0470 <p>then LaTeX will look for <code>%%HiResBoundingBox</code> lines instead of 0471 <code>%%BoundingBox</code> lines. (The <code>BoundingBox</code> lines use only 0472 natural numbers while the <code>HiResBoundingBox</code> lines use decimals; 0473 both use units equivalent to TeX’s big points, 1/72 inch.) To 0474 override a prior setting of <code>true</code>, you can set it to <code>false</code>. 0475 </p> 0476 </dd> 0477 </dl> 0478 0479 <p>These following options allow a user to override LaTeX’s method of 0480 choosing the graphic type based on the filename extension. An example 0481 is that <code>\includegraphics[type=png,ext=.xxx,read=.xxx]{lion}</code> 0482 will read the file <samp>lion.xxx</samp> as though it were 0483 <samp>lion.png</samp>. For more on these, see <a href="_005cDeclareGraphicsRule.html#g_t_005cDeclareGraphicsRule">\DeclareGraphicsRule</a>. 0484 </p> 0485 <dl compact="compact"> 0486 <dd><a name="includegraphics-type"></a></dd> 0487 <dt><code>type</code></dt> 0488 <dd><p>Specify the graphics type. 0489 </p> 0490 <a name="includegraphics-ext"></a></dd> 0491 <dt><code>ext</code></dt> 0492 <dd><p>Specify the graphics extension. 0493 Only use this in conjunction with the option <code>type</code>. 0494 </p> 0495 <a name="includegraphics-read"></a></dd> 0496 <dt><code>read</code></dt> 0497 <dd><p>Specify the file extension of the read file. 0498 Only use this in conjunction with the option <code>type</code>. 0499 </p> 0500 <a name="includegraphics-command"></a></dd> 0501 <dt><code>command</code></dt> 0502 <dd><p>Specify a command to be applied to this file. Only use this in 0503 conjunction with the option <code>type</code>. See <a href="Command-line-options.html#Command-line-options">Command line options</a> 0504 for a discussion of enabling the <code>\write18</code> functionality to run 0505 external commands. 0506 </p> 0507 </dd> 0508 </dl> 0509 0510 0511 0512 0513 <hr/><div class='referenceinfo'> <a href='https://latexref.xyz/'> <i>Unofficial LaTeX2e reference manual</i></a></div> 0514 </body> 0515 </html>