> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/latex/ru/drugie-temy/28-inserting-images-es.md). # Вставка изображений es Изображения — важнейшие элементы в большинстве научных документов. LaTeX предоставляет несколько вариантов для работы с изображениями и позволяет сделать их именно такими, как вам нужно. В этой статье объясняется, как включать изображения в наиболее распространённых форматах, как делать их меньше или больше и как добавлять ссылки на изображения внутри документа. ## Введение Ниже приведён пример того, как импортировать изображение в LaTeX. ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{ {images/} } \begin{document} Вселенная огромна и кажется однородной, в крупных масштабах, повсюду, куда ни посмотри. \includegraphics{universe} Сверху изображена галактика \end{document} ``` ![InsertingImagesEx1.png](/files/f21a16d17932aeca45b8bd9eff5764b9b28cdfc9) В LaTeX нет возможности самостоятельно обрабатывать изображения, поэтому необходимо импортировать пакет **graphicx**. Чтобы использовать этот пакет, добавьте следующую строку в преамбулу вашего документа ```latex \usepackage{graphicx} ``` Команда `\graphicspath{ {images/} }` сообщает LaTeX, что изображения сохранены в папке с именем *images* в текущем каталоге. Команда `\includegraphics{universe}` отвечает за включение изображения в документ. Здесь, *universe* это имя файла изображения без расширения; поэтому *universe.PNG* преобразуется в *universe*. Имя файла изображения не должно содержать пробелов или нескольких знаков пунктуации. Примечание: *Можно указать расширение файла, но рекомендуется* опустить его. Если расширение опущено, LaTeX будет искать все поддерживаемые форматы. Подробнее см. раздел [Создание изображений высокого и низкого разрешения](#generando-imgenes-en-alta-y-baja-resolucin). [Открыть пример в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Путь к папке с изображениями При работе с документом, содержащим несколько изображений, один из способов поддерживать проект в порядке — хранить их в отдельной папке. В примере из введения это достигается с помощью команды `\graphicspath{ {images/} }` которая сообщает LaTeX, что изображения нужно искать в папке *images*. Путь является *относительным* к текущему рабочему каталогу. Путь к папке может быть ***относительным*** (рекомендуется), если папка находится в том же каталоге, что и основной .tex-файл, или в одном из подкаталогов, либо может быть ***абсолютным*** если требуется указать путь точно. Например: ```latex %Абсолютный путь в формате Windows: \graphicspath{ {c:/user/images/} } %Абсолютный путь в Unix-подобном формате (Linux, OsX) \graphicspath{ {/home/user/images/} } ``` Заметьте, что эта команда требует завершающей прямой косой черты `/` в конце и что путь должен быть заключён в две пары фигурных скобок. Также можно задать несколько путей, если вы сохранили изображения более чем в одной папке для лучшей организации. Например, если есть две папки, одна под названием *images1* и другая *images2*, используйте команду ```latex \graphicspath{ {images1/}{images2/} } ``` Если путь не указан, LaTeX будет искать изображения в текущей папке, где сохранён .tex-файл. [Открыть пример в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Изменение размера и поворот изображения Если при импорте изображения в LaTeX требуется задать дополнительные параметры для изменения ширины, высоты, положения и т. д. изображения, это можно сделать с помощью следующего синтаксиса: ```latex Overleaf — отличный профессиональный инструмент для онлайн-редактирования, поделиться проектами \LaTeX и создавать их резервные копии. Также предлагает весьма объёмную справочную документацию. \includegraphics[scale=1.5]{lion-logo} ``` ![InsertingImagesEx2.png](/files/00f4c7fa584dc05c98c3599e04f936e45cdb1aa0) Команда `\includegraphics[scale=1.5]{lion-logo}` включает изображение *lion-logo* в документ, дополнительный параметр `scale=1.5` масштабирует изображение до 1.5 от его исходного размера. Также можно изменить размер изображения до заданной высоты и ширины. ```latex Overleaf — отличный профессиональный инструмент для онлайн-редактирования, поделиться проектами \LaTeX и создавать их резервные копии. Также предлагает весьма объёмную справочную документацию. \includegraphics[width=3cm, height=4cm]{lion-logo} ``` ![InsertingImagesEx3.png](/files/1029b2610846b91e3fbab49237e0bccfa752190a) Как вы, вероятно, уже догадались, параметры в квадратных скобках `[width=3cm, height=4cm]` задают ширину и высоту изображения. Можно использовать [разные единицы](#gua-de-referencia) измерения в этих параметрах. Если задан только параметр *ширина*, высота будет масштабироваться пропорционально, чтобы сохранить пропорции изображения. Также можно задать размер изображения относительно других элементов в документе. Например, если вы хотите, чтобы изображение имело ту же ширину, что и текст: ```latex Overleaf — отличный профессиональный инструмент для онлайн-редактирования, поделиться проектами \LaTeX и создавать их резервные копии. Также предлагает весьма объёмную справочную документацию. \includegraphics[width=\textwidth]{universe} ``` ![InsertingImagesEx5.png](/files/88c5f88b48ddf3e370340070a5067bd509ad813f) Вместо `\textwidth` можно использовать любую другую из единиц, которые LaTeX включает по умолчанию: *\columnsep, \linewidth, \textheight, \paperheight, etc*. Смотрите [справочное руководство](#gua-de-referencia) для более подробного описания единиц. Ещё одна очень распространённая возможность при вставке изображений в документ — поворот. В LaTeX это очень просто: ```latex Overleaf — отличный профессиональный инструмент для онлайн-редактирования, поделиться проектами \LaTeX и создавать их резервные копии. Также предлагает весьма объёмную справочную документацию. \includegraphics[scale=1.2, angle=45]{lion-logo} ``` ![InsertingImagesEx4.png](/files/0e3135be3466ec19ef2c3a35de203e1944569a47) Параметр `angle=45` поворачивает изображение на 45 градусов против часовой стрелки. Чтобы повернуть изображение по часовой стрелке, используйте отрицательное число. [Откройте пример в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Размещение изображения В предыдущем разделе было объяснено, как вставить изображение в ваш документ, но иногда сочетание изображений и текста в документе может получиться не так, как вы ожидали. Чтобы изменить это, необходимо использовать новую среду: ```latex В следующем примере рисунок будет размещён прямо под этим предложением. \begin{figure}[h] \includegraphics[width=8cm]{Plot} \end{figure} ``` ![InsertingImagesEx6.png](/files/fd03512f86cafe7bbe6d95d992f2ef636613b959) Среда `figure` используется для отображения изображений как плавающих элементов внутри документа. Это означает, что достаточно поместить изображение внутрь среды *figure* и вам больше не нужно беспокоиться о том, где оно появится: LaTeX разместит его так, чтобы оно идеально вписалось в поток документа. Хотя сначала это звучит очень хорошо, иногда хочется иметь больше контроля над тем, где будут появляться изображения. Дополнительный параметр можно использовать для задания позиционирования рисунка. В примере, `begin{figure}[h]`, параметр в квадратных скобках задаёт положение рисунка *здесь* (здесь, на английском). Ниже приведена таблица со списком возможных значений позиции. | Параметр | Положение | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | h | Задаёт положение плавающего элемента «здесь». То есть примерно в том же месте, где он появляется в коде (однако позиционирование не всегда точно) | | t | Вставляет рисунок в начало страницы. | | b | Вставляет рисунок в конец страницы. | | p | Вставляет плавающие элементы на отдельную страницу, содержащую только рисунки. | | ! | Переопределяет параметры, которые LaTeX использует для определения «хорошего» положения изображения. | | H | Размещает плавающий элемент точно в том же месте, где он указан в коде; требуется импортировать пакет `float`. В некоторой степени это эквивалентно h!. | В следующем примере можно увидеть изображение, которое появляется в начале документа, хотя код, который его создаёт, находится в конце документа. ```latex На этом рисунке вы видите столбчатую диаграмму, которая показывает результаты опроса, в котором были задействованы некоторые важные данные, изученные с течением времени. \begin{figure}[t] \includegraphics[width=8cm]{Plot} \centering \end{figure} ``` ![InsertingImagesEx7.png](/files/bd230662b31087103248bd41a642e5631d26eb14) Дополнительная команда `\centering` отвечает за центрирование изображения. Значение выравнивания по умолчанию — по левому краю. Также можно обтекать текстом рисунок. Когда документ содержит небольшие изображения, это делает текст визуально лучше. ```latex \begin{wrapfigure}{r}{0.25\textwidth} %этот рисунок будет справа \centering \includegraphics[width=0.25\textwidth]{mesh} \end{wrapfigure} Существует несколько способов построить функцию двух переменных, в зависимости от того, какая информация вам интересна. Например, если вы хотите увидеть сетку функции, чтобы было проще видеть производную, можно использовать такой график, как слева. \begin{wrapfigure}{l}{0.25\textwidth} \centering \includegraphics[width=0.25\textwidth]{contour} \end{wrapfigure} С другой стороны, если вас интересуют только определённые значения, можно использовать контурный график, можно использовать контурный график, вы график, можно использовать контурный график, можно контурный график, можно использовать контурный график, можно использовать контурный график, как слева. С другой стороны, если вас интересуют только определённые значения, можно использовать контурный график, можно использовать контурный график, вы график, можно использовать контурный график, можно контурный график, можно использовать контурный график, можно использовать контурный график, как тот, что слева. ``` ![InsertingImagesEx8.png](/files/a9bd7f51baedeee5770127b09c0e979c0d403f2b) Чтобы команды в примере работали, необходимо импортировать пакет **wrapfig**. Добавьте в преамбулу строку ```latex \usepackage{wrapfig} ``` После импорта пакета можно использовать среду *wrapfigure* с помощью команды `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`. Заметьте, что у среды есть два дополнительных параметра в фигурных скобках. Ниже код объясняется подробнее. **{l}** Задаёт выравнивание рисунка. Используйте l для левого края и r для правого. Более того, если используется класс book или другой подобный, вместо l и r можно использовать o для внешнего края и i для внутреннего края страницы. **{0.25\textwidth}** Это задаёт ширину контейнера, в котором находится изображение. Это не ширина самого изображения; её следует задавать в команде includegraphics. В примере используются относительные единицы, но можно использовать и обычные единицы (cm, mm, in и т. д.). Смотрите руководство по справке для списка возможных единиц. **\centering** Как уже объяснялось ранее, в предыдущем примере изображение будет центрировано относительно контейнера, в котором оно находится, а не относительно страницы. Для более полной информации о размещении изображений см. статью [Размещение изображений и таблиц](/latex/ru/risunki-i-tablicy/02-positioning-images-and-tables.md) [Открыть пример в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Добавление меток, подписей и ссылок Возможность добавлять подписи с кратким описанием изображения и метки, которые затем можно использовать для ссылки на изображение, очень полезна при работе с очень длинными документами. ### Подписи Начнём с примера, как добавить подпись: ```latex \begin{figure}[h] \caption{Пример параметрического графика ($\sin (x), \cos(x), x$)} \centering \includegraphics[width=0.5\textwidth]{spiral} \end{figure} ``` ![InsertingImagesEx9.png](/files/ccf3ad706cf0bb7555c47234a9e0c37d556a7c31) Это очень просто: достаточно добавить команду `\caption{Некоторая подпись}` и внутри фигурных скобок написать текст, который нужно показать. Место, где будет напечатана подпись, зависит от того, куда вставлена команда; если она находится над командой *includegraphics* то подпись появится над изображением; если же она находится под этой командой, подпись появится в нижней части рисунка. Подписи также можно размещать рядом с рисунками. Пакет **sidecap** позволяет использовать код, очень похожий на предыдущий пример, для добавления текста. ```latex \documentclass{article} \usepackage[rightcaption]{sidecap} \usepackage{graphicx} %пакет для управления изображениями \graphicspath{ {images/} } \begin{SCfigure}[0.5][h] \caption{Пример параметрического графика. Эта подпись будет справа} \includegraphics[width=0.6\textwidth]{spiral} \end{SCfigure} ``` ![InsertingImagesEx10.png](/files/11f487da7f35d8d67e001de039b4c970acbf19a2) В этом примере есть две новые команды: **\usepackage\[rightcaption]{sidecap}** Как вы, вероятно, уже знаете, эта команда импортирует пакет с именем sidecap, но у неё есть дополнительный параметр: rightcaption. Именно этот параметр задаёт место, где печатается подпись. В данном случае — справа от изображения; также можно использовать leftcaption, чтобы переместить подпись влево. В документах, использующих классы книжного типа, дополнительно можно применять параметры outercaption и innercaption, чтобы печатать подпись с внешней или внутренней стороны относительно края страницы. **\begin{SCfigure}\[0.5]\[h] \end{SCfigure}** Определяет среду, аналогичную figure. Первый параметр — это ширина подписи относительно размера изображения. Второй параметр h выполняет ту же функцию, что и в среде figure. См. раздел о размещении изображений для получения дополнительной информации. При желании можно добиться более продвинутой настройки формата подписей. См. [дополнительные материалы](#lecturas-adicionales) для получения дополнительных ссылок. ### Метки и перекрёстные ссылки Рисунки, как и многие другие элементы в документе LaTeX (формулы, таблицы, графики и т. д.), можно ссылочно упоминать из текста. Это очень просто: достаточно добавить метку к среде *figure* или *SCfigure*, а затем использовать эту метку для ссылки на рисунок. ```latex \begin{figure}[h] \centering \includegraphics[width=0.25\textwidth]{mesh} \caption{Хороший график} \label{fig:mesh1} \end{figure} Как вы можете видеть на рисунке \ref{fig:mesh1}, функция возрастает около 0. Также на странице \pageref{fig:mesh1} находится тот же пример. ``` ![InsertingImagesEx11.png](/files/3e5ddba3cafe106bb9beb20426b386f9e8080203) В этом примере есть три команды, создающие перекрёстные ссылки. **\label{fig:mesh1}** Задаёт метку для рисунка. Поскольку метки можно использовать для разных типов элементов документа, хорошей практикой является использование префикса, такого как fig:, как в примере. **\ref{fig:mesh1}** Эта команда выводит номер, присвоенный рисунку. Номера генерируются автоматически и обновляются, если позже перед тем, на который есть ссылка, вставляется другой рисунок. **\pageref{fig:mesh1}** Выводит номер страницы, на которой появляется изображение, на которое указывает метка. Команда `\caption` команда, добавляющая подпись, обязательна, чтобы можно было добавить метку и ссылаться на рисунок. Ещё одна важная возможность в LaTeX — автоматическое создание *списка рисунков*. Это легко сделать с помощью: ```latex \listoffigures ``` ![InsertingImagesEx12.png](/files/2e211c6ba054f3daec317f5936c7afb127a0e0f0) Эта команда работает только с рисунками, у которых есть подпись, поскольку она используется для формирования списка. В предыдущем примере перечислены изображения, использованные в этой статье. Важное примечание: *При использовании перекрёстных ссылок в LaTeX проект нужно компилировать дважды, иначе ссылки, ссылки на страницы и список рисунков не будут работать*. [Открыть пример в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Создание изображений высокого и низкого разрешения Пока что, когда мы вводим имя файла изображения в команду *\includegraphics* мы опускаем расширение файла. Однако это не обязательно, хотя и может быть очень полезно. Если расширение опущено, LaTeX будет искать любой поддерживаемый тип изображения в заранее заданном каталоге изображений; поиск будет выполняться в определённом порядке, который можно изменить. Это очень полезно при переходе от черновой версии документа к финальной. В черновике (пока вы пишете статью, книгу, отчёт и т. д.) желательно использовать изображения низкого разрешения (обычно в формате .png), чтобы документ компилировался быстрее. В финальной версии, напротив, предпочтительнее включать изображения высокого разрешения, чтобы получить документ высокого качества. Этого можно добиться следующим образом: * Не указывать расширение файла в команде *\includegraphics*, и * указывая порядок расширений в преамбуле Так, если у вас есть две версии одного и того же изображения, например venndiagram.pdf (в высоком разрешении) и venndiagram.png (в низком разрешении), можно добавить следующую строку в преамбулу, пока вы пишете и отлаживаете документ — ```latex \DeclareGraphicsExtensions{.png,.pdf} ``` Приведённая выше команда гарантирует, что если найдены два изображения с одинаковым именем, но разными расширениями, будет использован файл .png, а если по какой-то причине этот файл исчезнет, версия в pdf будет следующим вариантом. После того как документ написан, чтобы использовать только версию высокого разрешения, следует изменить строку, определяющую расширение, на: ```latex \DeclareGraphicsExtensions{.pdf,.png} ``` Можно даже улучшить описанную выше технику: можно попросить LaTeX генерировать изображения .png низкого разрешения во время компиляции документа, если PDF заранее не был преобразован в PNG. Для этого нужно включить в преамбулу следующее после `\usepackage{graphicx}`. ```latex \usepackage{epstopdf} \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile} \DeclareGraphicsExtensions{.png,.pdf} ``` Если venndiagram2.pdf существует, но venndiagram2.png — нет, файл vendiagramm2-pdf-converted-to.png будет создан и загружен вместо него. Команда *convert #1* отвечает за преобразование Если выбрать этот метод, следует иметь в виду пару вещей: * Чтобы автоматическое преобразование работало, необходимо запускать *pdflatex* с опцией `--shell-escape`. * Для финальной версии не забудьте закомментировать строку `\epstopdfDeclareGraphicsRule`, чтобы загружались только изображения высокого разрешения. Также не забудьте изменить порядок приоритета. [Открыть пример в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Справочное руководство **Единицы и меры в LaTeX** | Сокращение | Определение | | ------------ | ------------------------------------------------------ | | pt | Пункт — единица длины по умолчанию. Примерно 0,3515 мм | | mm | миллиметр | | cm | сантиметр | | в | дюйм | | ex | высота **x** с текущим шрифтом | | em | ширина **m** с текущим шрифтом | | \columnsep | расстояние между колонками | | \columnwidth | ширина колонки | | \linewidth | ширина строки в текущей среде | | \paperwidth | ширина бумаги | | \paperheight | высота бумаги | | \textwidth | ширина текста | | \textheight | высота текста | | \unitlength | единицы длины в среде *picture* | **О типах изображений, которые можно использовать в LaTeX** **latex** Если документ компилируется командой latex, можно использовать только изображения в формате EPS, который является векторным форматом. **pdflatex** Если документ компилируется командой pdflatex для создания PDF, то можно использовать несколько типов изображений — ``` JPG: лучший вариант для вставки фотографий PNG: лучший вариант для вставки диаграмм (если по какой-либо причине вы не можете использовать векторную графику) и снимков экрана PDF: несмотря на привычное использование PDF для документов, в целом PDF может состоять всего из одного изображения, которое затем можно импортировать. EPS: изображения EPS можно включать с помощью пакета epstopdf (пакет нужно только установить на компьютере; после установки не требуется никаких дополнительных команд в файле .tex) ``` **Векторная графика или растровые изображения?** Изображения можно включать либо в формате растровых изображений, либо в виде векторной графики. В целом об этом можно не беспокоиться, но если у вас есть выбор формата, следует помнить, что для векторной графики лучше всего сохранять её в формате PDF или EPS, тогда как для растровых изображений рекомендуются форматы JPG или PNG. Это связано с тем, что растровое изображение внутри файла в формате PDF или EPS требует много места для хранения. [Открыть пример в Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Дополнительные материалы Для получения дополнительной информации см.: * [Размещение изображений и таблиц](/latex/ru/risunki-i-tablicy/02-positioning-images-and-tables.md) * [Списки таблиц и рисунков](/latex/ru/risunki-i-tablicy/03-lists-of-tables-and-figures.md) * [Односторонние и двусторонние документы](/latex/ru/formatirovanie/08-single-sided-and-double-sided-documents.md) * [Длины в LaTeX](/latex/ru/formatirovanie/01-lengths-in-latex.md) * [**floatrow** пакет для расширенного управления подписями плавающих элементов (таблиц и рисунков)](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf) * [**sidecap** документация пакета, для подписей рисунков сбоку](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf) * [**epstopdf** документация пакета (преобразование PDF в EPS)](https://www.google.com/url?sa=t\&rct=j\&q=\&esrc=s\&source=web\&cd=3\&cad=rja\&ved=0CEEQFjAC\&url=http%3A%2F%2Fmirror.hmc.edu%2Fctan%2Fmacros%2Flatex%2Fcontrib%2Foberdiek%2Fepstopdf.pdf\&ei=N4v2UpK7D4eHqQHz2IDACg\&usg=AFQjCNG9CxIXjrbc22kl-8QweEXeEauFew\&sig2=qamKo3qpid8CEqzsHhpIrQ\&bvm=bv.60983673,d.aWM) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/latex/ru/drugie-temy/28-inserting-images-es.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.