\includegraphics

Синопсисы для пакета graphics:

\includegraphics{filename}
\includegraphics[urx,ury]{filename}
\includegraphics[llx,lly][urx,ury]{filename}
\includegraphics*{filename}
\includegraphics*[urx,ury]{filename}
\includegraphics*[llx,lly][urx,ury]{filename}

Синопсисы для пакета graphicx:

\includegraphics{filename}
\includegraphics[key-value list]{filename}
\includegraphics*{filename}
\includegraphics*[key-value list]{filename}

Включить графический файл. Звёздочка в записи \includegraphics* обрезает графику до указанного размера, в то время как в незамеченной форме любая часть графика, которая находится за пределами указанного размера, накладывается поверх окружающего пространства.

Это

\usepackage{graphicx}  % in preamble
  ...
\begin{center}
  \includegraphics{plot.pdf}
\end{center}

включит в документ график в plot.pdf, центрированный и в его номинальном размере. Вы также можете указать путь к файлу, как в \includegraphics{graphics/plot.pdf}. Чтобы указать список расположений для поиска файла, см. \graphicspath.

Если в имени файла есть пробелы, поместите его в двойные кавычки. Пример: \includegraphics{"sister picture.jpg"}.

Команда \includegraphics{filename} определяет тип графика, разбивая filename по первой точке. Вы можете вместо этого использовать filename без точки, как в \includegraphics{turing}, и затем LaTeX пытается последовательность расширений, таких как .png и .pdf до тех пор, пока не найдёт файл с этим расширением (см. \DeclareGraphicsExtensions).

Если имя файла содержит точки перед расширением, вы можете скрыть их с помощью фигурных скобок, как в \includegraphics{{plot.2018.03.12.a}.pdf}. Или, если вы используете пакет graphicx, то вы можете использовать опции type и ext; см. ниже. Эта и другие проблемы с именами файлов также обрабатываются пакетом grffile.

Этот пример помещает графику в среду figure, чтобы LaTeX мог переместить её на следующую страницу, если поместить её на текущую страницу неудобно (см. figure).

\begin{figure}
  \centering
  \includegraphics[width=3cm]{lungxray.jpg}
  \caption{The evidence is overwhelming: don't smoke.}  \label{fig:xray}
\end{figure}

Это помещает график, который не будет плавать, так что он обязательно появится в этой точке документа, даже если заставит LaTeX растянуть текст или прибегнуть к пустым областям на странице. Он будет центрирован и будет иметь заголовок.

\usepackage{caption}  % in preamble
  ...
\begin{center}
  \includegraphics{pix/nix.png}
  \captionof{figure}{The spirit of the night} \label{pix:nix} % optional
\end{center}

Этот пример помещает рамку с графиком рядом с одной имеющей текст, с вертикальным центрированием обоих.

\newcommand*{\vcenteredhbox}[1]{\begin{tabular}{@{}c@{}}#1\end{tabular}}
  ...
\begin{center}
  \vcenteredhbox{\includegraphics[width=0.4\textwidth]{plot}}
  \hspace{1em}
  \vcenteredhbox{\begin{minipage}{0.4\textwidth}
                   \begin{displaymath}
                     f(x)=x\cdot \sin (1/x)
                   \end{displaymath}
                 \end{minipage}}
\end{center}

Если вы используете пакет graphics, то единственные опции связаны с размером графика (но см. \rotatebox и \scalebox). Когда присутствует один необязательный аргумент, он [urx,ury] и он даёт координаты правого верхнего угла изображения, как пару TeX-размеров (см. Единицы длины). Если единицы опущены, они по умолчанию bp. В этом случае предполагается, что нижний левый угол изображения находится в (0,0). Если присутствуют два необязательных аргумента, то ведущий из них [llx,lly], указывая координаты нижнего левого угла изображения. Таким образом, \includegraphics[1in,0.618in]{...} требует, чтобы график был размещён так, чтобы он имел ширину 1 дюйм и высоту 0,618 дюйма, а его начало находилось в (0,0).

Пакет graphicx предоставляет вам ещё много опций. Укажите их в формате ключ-значение, как здесь.

\begin{center}
  \includegraphics[width=1in,angle=90]{lion}
  \hspace{2em}
  \includegraphics[angle=90,width=1in]{lion}
\end{center}

Опции читаются слева направо. Так, первый график выше делается шириной в один дюйм, а затем поворачивается, тогда как второй поворачивается, а затем делается шириной в один дюйм. Таким образом, если график не является идеально квадратным, то у них в итоге будут разные ширины и высоты.

Есть много опций. Основные из них перечислены первыми.

Обратите внимание, что график помещается LaTeX в рамку, которая традиционно называется его границей обводки (отличается от описанной ниже PostScript BoundingBox). Печатаемая область графика может выходить за пределы этой рамки или находиться внутри неё, но когда LaTeX составляет страницу, он собирает рамки, и это рамка, выделенная для графика.

width

График будет показан так, чтобы его граница обводки имела эту ширину. Пример: \includegraphics[width=1in]{plot}. Вы можете использовать стандартные TeX-размеры (см. Единицы длины), а также удобны \linewidth, или в документе с двумя колонками \columnwidth (см. Параметры макета страницы). Например, используя пакет calc, вы можете сделать график на 1 см уже, чем ширина текста, с помощью \includegraphics[width=\linewidth-1.0cm]{hefferon.jpg}.

height

График будет показан так, чтобы его граница обводки имела эту высоту. Вы можете использовать стандартные TeX-размеры (см. Единицы длины), а также удобны \pageheight и \textheight (см. Параметры макета страницы). Например, команда \includegraphics[height=0.25\textheight]{godel} сделает график на четверть высоты текстовой области.

totalheight

График будет показан так, чтобы его граница обводки имела эту высоту плюс глубину. Это отличается от высоты, если график был повернут. Например, если он был повернут на -90 градусов, то он будет иметь нулевую высоту, но большую глубину.

keepaspectratio

Если установлено значение true, или просто указано как здесь

\includegraphics[...,keepaspectratio,...]{...}

и вы укажете в качестве опций как width и height (или totalheight), то LaTeX сделает график как можно больше без искажений. То есть, LaTeX будет гарантировать, что график не будет шире, чем width, и не выше, чем height (или totalheight).

scale

Множитель масштабирования графика. Чтобы сделать график в два раза больше его номинального размера, введите \includegraphics[scale=2.0]{...}. Это число может быть любым значением; число между 0 и 1 уменьшит график, а отрицательное число отобразит его отражённым.

angle

Повернуть график. Угол принимается в градусах и против часовой стрелки. График поворачивается вокруг его origin; см. эту опцию. Для полного описания того, как набирается повернутый материал, см. \rotatebox.

origin

Точка графика, относительно которой происходит поворот. Возможные значения — любые строки, содержащие одну или две из: l для слева, r для справа, b для снизу, c для центра, t для сверху и B для базовой линии. Таким образом, ввод команды \includegraphics[angle=180,origin=c]{moon} перевернёт картинку вверх ногами относительно центра картинки, а команда \includegraphics[angle=180,origin=lB]{LeBateau} перевернёт картинку вверх ногами относительно её левой базовой линии. (Символ c даёт горизонтальный центр в bc или tc, но даёт вертикальный центр в lc или rc.) Значение по умолчанию — lB.

Для поворота относительно произвольной точки см. \rotatebox.

Это менее используемые опции.

viewport

Выбрать подобласть графика для отображения. Принимает четыре аргумента, разделенных пробелами и заданных в TeX-размерах, как в \includegraphics[.., viewport=0in 0in 1in 0.618in]{...}. При отсутствии единицы размеры по умолчанию — точки, bp. Они принимаются относительно начала отсчёта, заданного границей обводки. См. также опцию trim.

trim

Указывает части графика, которые не следует показывать. Принимает четыре аргумента, разделенные пробелами, заданные в TeX-размерах, как в \includegraphics[.., trim= 0in 0.1in 0.2in 0.3in, ...]{...}. Они указывают на количество графика, не подлежащее отображению, то есть LaTeX обрежет картинку на 0 дюймов слева, 0,1 дюйма снизу, 0,2 дюйма справа и 0,3 дюйма сверху. См. также опцию viewport.

clip

Если установлено значение true, или просто указано как здесь

\includegraphics[...,clip,...]{...}

то график обрезается до границы обводки. Это то же самое, что и использование звёздочного варианта команды, \includegraphics*[...]{...}.

page

Указать номер страницы многостраничного PDF-файла. Значение по умолчанию — page=1.

pagebox

Указывает, какую границу обводки использовать для PDF-файлов из mediabox, cropbox, bleedbox, trimbox, или artbox. PDF-файлы не имеют границы обводки, которая есть у PostScript-файлов, но могут указывать до четырёх предопределённых прямоугольников. MediaBox задаёт границы физического носителя. CropBox — это область, в которой содержимое страницы обрезается при отображении. BleedBox — это область, в которой содержимое страницы должно быть обрезано в процессе производства. TrimBox — это предполагаемые размеры готовой страницы. ArtBox — это объём осмысленного содержания страницы. Драйвер установит размер изображения на основе CropBox, если он присутствует, иначе не будет использовать ни один из других, при этом порядок предпочтения будет определяться драйвером. MediaBox всегда присутствует.

interpolate

Включить или выключить интерполяцию растровых изображений просмотрщиком. Может быть установлено с помощью interpolate=true или просто указано как здесь.

\includegraphics[...,interpolate,...]{...}

quiet

Не записывать информацию в журнал. Вы можете установить это с помощью quiet=true или просто указать это с помощью \includegraphics[...,quiet,...]{...},

draft

Если вы установите это с помощью draft=true или просто укажете это с помощью

\includegraphics[...,draft,...]{...}

то график не будет отображаться в документе, что, возможно, сэкономит чернила цветного принтера. Вместо этого LaTeX поместит пустую рамку нужного размера с напечатанным в ней именем файла.

Эти опции относятся к границе обводки для файлов Encapsulated PostScript графики, которые имеют размер, указанный строкой %%BoundingBox в файле. Она имеет четыре значения, дающие координаты нижней x, нижней y, верхней x и верхней y. Единицы — PostScript-точки, эквивалентные TeX-точкам, 1/72 дюйма. Например, если в файле .eps есть строка %%BoundingBox 10 20 40 80 то его естественный размер — 30/72 дюйма в ширину и 60/72 дюйма в высоту.

bb

Укажите область изображения. Аргумент имеет четыре значения, разделённые пробелами, как в \includegraphics[.., bb= 0in 0in 1in 0.618in]{...}. Обычно \includegraphics автоматически считывает координаты рамки из файла EPS, поэтому этот параметр полезен только в случае отсутствия рамки в файле или если нужно её изменить.

bbllx, bblly, bburx, bbury

Установить границы области. Эти четыре параметра устарели, но сохранены для совместимости со старыми пакетами.

natwidth, natheight

Альтернатива для bb. Установка

\includegraphics[...,natwidth=1in,natheight=0.618in,...]{...}

эквивалентна установке bb=0 0 1in 0.618in.

hiresbb

Если установлено значение true, или указано явно, как в

\includegraphics[...,hiresbb,...]{...}

то LaTeX будет искать строки %%HiResBoundingBox вместо строк %%BoundingBox. (Строки BoundingBox используют только натуральные числа, а строки HiResBoundingBox — десятичные; оба используют единицы, эквивалентные большим точкам TeX, 1/72 дюйма.) Чтобы переопределить предыдущую настройку true, можно установить её значение в false.

Следующие параметры позволяют пользователю переопределить метод LaTeX выбора типа графики на основе расширения файла. Например, \includegraphics[type=png,ext=.xxx,read=.xxx]{lion} будет обрабатывать файл lion.xxx как lion.png. Дополнительную информацию см. в \DeclareGraphicsRule.

type

Указать тип графического файла.

ext

Указать расширение графического файла. Используйте только вместе с параметром type.

read

Указать расширение файла для чтения. Используйте только вместе с параметром type.

command

Указать команду, которая будет применена к этому файлу. Используйте только вместе с параметром type. См. Параметры командной строки для обсуждения возможности запуска внешних команд с помощью \write18.