logo
Helpful resources ▼
  Nuget   Pricing   Buy

LaTeX 图形 | \includegraphics 命令

实际上，LaTeX 图形有两个值得一提的方面：

前者在原始 LaTeX 及其宏包中支持有限。它通过 TeX 的垂直和水平规则实现。原因是原始 LaTeX 基于原始 TeX 引擎，该引擎的主要输出为 DVI 格式，这不适合描述直线、曲线或二进制光栅图像数据。但能够输出为支持图形的格式（如 pdfTeX 输出为 PDF）的引擎也可以使用与格式相关的宏包或宏包功能来处理图形。后者的图形由于相同原因在基本 LaTeX 中不受支持。我们将在下文讨论图形嵌入功能。

LaTeX graphics 宏包和 \includegraphics 命令

谈到 LaTeX 图形的嵌入时，首先想到的是 \includegraphics 命令。它在 graphics 宏包中定义，你应在导言区提及该宏包以启用其功能。

1\usepackage{graphics}

如果你的排版系统默认未配置使用例如 pdfTeX，你应指定相应的选项，以强制宏包使用所需的 driver 文件：

1\usepackage[pdftex]{graphics}

driver 文件是宏包的一部分，用于实现宏包命令与特定格式低层 TeX 扩展原语之间的接口。Aspose.TeX 的 LaTeX 图形支持已配置为使用其自带的 driver，因此无需指定 driver 选项。

现在，包含 PNG 图像的最简单方式是输入：

1\includegraphics{sample-image.png}

其中 sample-image.png 是你想要包含的文件名。你甚至可以省略扩展名。graphics 宏包包含支持格式的定义列表。搜索文件时，它会遍历该列表并包含找到的第一个匹配文件。

你也可以使用绝对或相对路径指定完整文件名：

1\includegraphics{d:/sample-image.png} % absolute path
2\includegraphics{./sample-image.png} % relative to the current directory
3\includegraphics{../img/sample-image.png} % relative to the directory containing the current one

另一种指定图形文件位置的方法是在调用 \includegraphics 之前使用 \graphicspath 命令定义一系列备选路径：

1\graphicspath{{d:/img}{c:/img}{d:/work/img}}

缩放图形

LaTeX graphics 宏包提供了用于操作内容的命令。因此，你可以按如下方式缩放包含的图形（实际上，任何由 TeX/LaTeX 代码描述的内容）：

1\scalebox{.5}{\includegraphics{sample-image.png}} % scales both width and height by 0.5
2\scalebox{.5}[1.5]{\includegraphics{sample-image.png}} % scales the width and height by 0.5 and 1.5 respectively

调整图形大小

这与缩放类似，但你需要指定所需的尺寸而不是缩放因子：

1\resizebox{10mm}{!}{\includegraphics{sample-image.png}} % changes the width to 10mm preserving the proportions
2\resizebox{20mm}{10mm}{\includegraphics{sample-image.png}} % changes both width and height independently

旋转图形

1\rotatebox{25}{\includegraphics{sample-image.png}} % rotates the image by 25 degrees counterclockwise

LaTeX graphicx 宏包

LaTeX graphicx 宏包提供了 key=value 接口用于内容变换。要启用其功能，你应在导言区提及它：

1\usepackage{graphicx}
2\usepackage[pdftex]{graphicx} % with the driver option

你可以组合以下任何选项，但请注意顺序很重要。

Graphics viewport

1\includegraphics[viewport=10 10 280 220]{sample-image.png} % sets the viewport with the lower left corner
2                                                           % at the point (10, 10) (coincides with (0, 0)
3                                                           % of the box) and dimensions 280x220pt
4\includegraphics[viewport=10 10 250 220,clip]{sample-image.png} % the same, but the image is clipped by the viewport

缩放图形

1\includegraphics[scale=.5]{sample-image.png} % scales both width and height by 0.5

调整图形大小

1\includegraphics[width=15mm]{sample-image.png} % changes the width to 15mm preserving the proportions
2\includegraphics[height=15mm,width=25mm]{sample-image.png} % changes both width and height independently

旋转图形

1\includegraphics[angle=10]{sample-image.png} % rotates the image by 10 degrees counterclockwise

要了解更多关于 graphics 宏包捆绑功能的信息，请参阅文档 此处和 此处。

你还可以查看基于 Aspose.TeX for .NET API 构建的免费转换 Web 应用。

传统的 graphics 与现代 graphicx 语法对比

尽管这两个宏包共享底层的核心引擎，但它们代表了维护 LaTeX 内容时截然不同的两种范式。

操作传统的 graphics 宏包现代 graphicx 宏包
基础图像插入\includegraphics{sample-image.png}\includegraphics{sample-image.png}
等比例缩放\scalebox{0.5}{\includegraphics{sample-image.png}}\includegraphics[scale=0.5]{sample-image.png}
非等比例缩放（X/Y 轴独立）\scalebox{0.5}[1.5]{\includegraphics{sample-image.png}}（需使用嵌套包装或扩展宏包）
按尺寸调整大小\resizebox{10mm}{!}{\includegraphics{sample-image.png}}\includegraphics[width=10mm]{sample-image.png}
独立调整两个维度的尺寸\resizebox{20mm}{10mm}{\includegraphics{sample-image.png}}\includegraphics[width=25mm, height=15mm]{sample-image.png}
旋转\rotatebox{25}{\includegraphics{sample-image.png}}\includegraphics[angle=25]{sample-image.png}
视口裁剪 (Viewport clipping)支持通过底层参数覆盖边界框（Bounding Box）\includegraphics[viewport=10 10 280 220, clip]{sample-image.png}

graphicx 键值对（key-value）方式的优势

  1. 原生支持多种变换的组合： 使用 graphicx，可以在单个命令中同时应用缩放、旋转和裁剪，无需嵌套宏。

  2. 明确保持纵横比： 通过设置 keepaspectratio=true 参数并配合明确的宽度或高度限制，用户可在避免图像失真的同时，无需手动计算缩放比例。

  3. 提升自动化生成场景下的可维护性： 在编写程序或脚本（例如基于 Aspose.TeX for .NET 的应用）来动态生成或解析 LaTeX 源文件时，构建结构化的“键值对”属性字符串，远比解析并插入嵌套的宏包装器更不容易出错。

LaTeX I/O 嵌入式LaTeX软件包