使用pdftocairo工具将pdf文件转换为png图像

排版样例宏包使用辅助工具 TiKZ 插图

2019-11-04 18:48发布

站内文章 / 辅助工具

385 2

registor

男 |

私信

在LaTeX的实际使用中，有时需要将pdf格式的文件转换为png、jpg等图像格式。在[https://wenda.latexstudio.net/article-5051.html](https://wenda.latexstudio.net/article-5051.html "https://wenda.latexstudio.net/article-5051.html")中，给出了“**LaTeX(TiKZ)转换为图像**”的一个很好的方法。通过查阅其[https://github.com/iruletheworld/latex2img](https://github.com/iruletheworld/latex2img "https://github.com/iruletheworld/latex2img")中的使用说明链接[https://latex2img.readthedocs.io/zh_CN/latest/](https://latex2img.readthedocs.io/zh_CN/latest/ "https://latex2img.readthedocs.io/zh_CN/latest/")，发现该方案主要使用了texlive自带`standalone`文档类和`pdftocairo`工具实现。由于该方案基于Windows平台下的批处理方式(`*.bat`文件)实现，为简化操作并摆脱平台依赖，在此，将`pdftocairo`工具独立出来，并直接使用`standalone`文档类参数实现转换。

## `pdftocairo`工具
`pdftocairo`是一个将pdf文件转换为图像的工具，该工具支持将pdf转换为png、jpeg、tiff、ps、eps、svg等格式的图像。

例如，可以在命令行使用`pdftocairo -r 600 -png demo.pdf`命令将demo.pdf文件转换为分辨率为600PPI的名称为`demo-1.png`的png图像文件。

## 使用`standalone`文档类参数实现转换
如果使用`standalone`文档类，则可以直接在其参数中指定转换方式，直接编译`*.tex`LaTeX源文件就可以同时得到pdf文件和转换后的图像文件。

实现转换的文档类参数代码可以是：
```tex
\documentclass[margin=5pt,
  convert,
  convert={
    outext=.png,
    command=\unexpanded{
      pdftocairo -r 600 -png \infile % 将生成的pdf文件转换为png图像
    }
  }
]{standalone}
```
### 转换`TikZ`绘图
以下代码实现将`TikZ`绘图转换为png图像：
```tex
\documentclass[margin=5pt,
  convert,
  convert={
    outext=.png,
    command=\unexpanded{
      pdftocairo -r 600 -png \infile % 将生成的pdf文件转换为png图像
    }
  }
]{standalone}

% 支持中文
\usepackage{ctex}
% 流程图绘制宏包
\usepackage{tikz-flowchart}

% 设置流程图绘制参数
\flowchartset{
  proc fill color = orange!10, % 顺序处理框填充颜色(默认取白色)
  test fill color = green!30, % 判断框填充颜色(默认取白色)
  io fill color = blue!30, % 输入/输出框填充颜色(默认取白色)
  term fill color = red!30, % 开始/结束框填充颜色(默认取白色)
  proc text width = 6em, % 顺序处理框宽度(默认取8em)
}

\begin{document}
  \begin{tikzpicture}
    % 布置结点单元
    \node [term] (st) {开始};
    \node [proc, join] (p1) {\verb|int divisor|};       
    \node [test, join] (t1) {\verb|n <= 1|};
    \node [proc, ] (p2) {\verb|divisor = 2|};
    % 可以根据需要多带带指定结点文字宽度
    \node [test, text width = 10em, join] (t2) {\verb|divisor * divisor <= n|};
    \node [test, text width = 8em] (t3) {\verb|n % divisor == 0|};
    \node [proc, text width = 6em] (p3) {\verb|divisor++|};
    \node [term, below = 1.6 of p3] (end) {结束};
    \node [proc, left = 4.8 of t2] (p4) {\verb|return 0|};
    \node [proc, right = 3.5 of p3] (p5) {\verb|return 0|};
    \node [proc, right = 5.8 of t3] (p6) {\verb|return 1|};

% 布置用于连接的坐标结点，同时为其布置调试标记点。
    \node [coord] (c1) at ($(p2.south)!0.5!(t2.north)$)  {}; \cmark{1}
    \node [coord, below = 0.25 of p3] (c2)  {}; \cmark{2}
    \node [coord, above = 0.5 of end] (c3) {};  \cmark{3}
    \node [coord, left = 0.5 of t2] (ct) {};  \cmark{t}
    \node [coord] (c4) at (c3 -| p5)  {}; \cmark{4}
    \node [coord] (c5) at (c2 -| ct)  {}; \cmark{5}
        
    % 判断框连线，每次绘制时，先绘制一个带有一个固定
    % 位置标注的路径(path)，然后再绘制箭头本身(arrow)。
    \path (t1.south) -- node [near start, right] {$N$} (p2.north);
    \draw [norm] (t1.south) -- (p2.north);
    \path (t1.west) -| node [near start, above] {$Y$} (p4.north);
    \draw [norm] (t1.west) -| (p4.north);
        
    \path (t2.south) -- node [near start, right] {$Y$} (t3.north);
    \draw [norm] (t2.south) -- (t3.north);
    \path (t2.east) -| node [near start, above] {$N$} (p6.north);
    \draw [norm] (t2.east) -| (p6.north);
        
    \path (t3.south) -- node [near start, right] {$N$} (p3.north);
    \draw [norm] (t3.south) -- (p3.north);
    \path (t3.east) -| node [near start, above] {$Y$} (p5.north);
    \draw [norm] (t3.east) -| (p5.north);

% 其它连线
    \draw [norm](p3.south) |- (c5) |- (c1);
    \draw [norm](p4.south) |- (c3);
    \draw [norm](p4.south) |- (c3) -- (end);
    \draw [norm](p5.south) -- (c4);
    \draw [norm](p6.south) |- (c3);
    \draw [norm](p6.south) |- (c3) -- (end);
  \end{tikzpicture}
\end{document}
```
转换结果为：

### 转换`tabular`表格
以下代码实现将`tabular`表格转换为png图像：
```tex
\documentclass[margin=5pt,
  convert,
  convert={
    outext=.png,
    command=\unexpanded{
      pdftocairo -r 600 -png \infile % 将生成的pdf文件转换为png图像
    }
  }
]{standalone}

% 支持中文
\usepackage{ctex}

\begin{document}
    % 用minipage实现段落排版
  \begin{minipage}{1.8in}
    \begin{table}[!htp]
      \centering
      \caption{测试表格}
      \begin{tabular}{cccc}
        \hline
        序号 & 姓名 & 性别 & 年龄\\\hline
        1 & 张三 & 男 & 38\\\hline
        2 & 李四 & 女 & 26\\\hline
        3 & 王五 & 男 & 18\\\hline
      \end{tabular}    
    \end{table}    
  \end{minipage}
\end{document}
```
转换结果为：
<center>
<img  src="https://pics.latexstudio.net/data/images/201911/8ebe24d8bd9e86d.png" width=40% />
</center>

### 转换普通文本
以下代码实现将普通文本转换为png图像：
```tex
\documentclass[margin=5pt,
  convert,
  convert={
    outext=.png,
    command=\unexpanded{
      pdftocairo -r 600 -png \infile % 将生成的pdf文件转换为png图像
    }
  }
]{standalone}

% 支持中文
\usepackage{ctex}
\usepackage{zhlipsum}

\begin{document}
  % 用minipage实现段落排版
  \begin{minipage}{4in}
    \setlength{\parindent}{2em}
    \setlength{\parskip}{3ex plus 0.5ex minus 0.2ex}
    \zhlipsum[1]
  \end{minipage}
\end{document}

```
转换结果为：
<center>
<img  src="https://pics.latexstudio.net/data/images/201911/81ff07decd373ca.png" width=80% />
</center>

## `pdftocairo`工具详细说明
关于`pdftocairo`工具的使用细节，可以在命令行通过`pdftocairo --help`命令查看其使用说明：
```shell
pdftocairo version 0.80.0
Copyright 2005-2019 The Poppler Developers - http://poppler.freedesktop.org
Copyright 1996-2011 Glyph & Cog, LLC
Usage: pdftocairo [options] <PDF-file> [<output-file>]
  -png                     : generate a PNG file
  -jpeg                    : generate a JPEG file
  -jpegopt <string>        : jpeg options, with format <opt1>=<val1>[,<optN>=<valN>]*
  -tiff                    : generate a TIFF file
  -tiffcompression <string>: set TIFF compression: none, packbits, jpeg, lzw, deflate
  -ps                      : generate PostScript file
  -eps                     : generate Encapsulated PostScript (EPS)
  -pdf                     : generate a PDF file
  -svg                     : generate a Scalable Vector Graphics (SVG) file
  -f <int>                 : first page to print
  -l <int>                 : last page to print
  -o                       : print only odd pages
  -e                       : print only even pages
  -singlefile              : write only the first page and do not add digits
  -r <fp>                  : resolution, in PPI (default is 150)
  -rx <fp>                 : X resolution, in PPI (default is 150)
  -ry <fp>                 : Y resolution, in PPI (default is 150)
  -scale-to <int>          : scales each page to fit within scale-to*scale-to pixel box
  -scale-to-x <int>        : scales each page horizontally to fit in scale-to-x pixels
  -scale-to-y <int>        : scales each page vertically to fit in scale-to-y pixels
  -x <int>                 : x-coordinate of the crop area top left corner
  -y <int>                 : y-coordinate of the crop area top left corner
  -W <int>                 : width of crop area in pixels (default is 0)
  -H <int>                 : height of crop area in pixels (default is 0)
  -sz <int>                : size of crop square in pixels (sets W and H)
  -cropbox                 : use the crop box rather than media box
  -mono                    : generate a monochrome image file (PNG, JPEG)
  -gray                    : generate a grayscale image file (PNG, JPEG)
  -transp                  : use a transparent background instead of white (PNG)
  -antialias <string>      : set cairo antialias option
  -icc <string>            : ICC color profile to use
  -level2                  : generate Level 2 PostScript (PS, EPS)
  -level3                  : generate Level 3 PostScript (PS, EPS)
  -origpagesizes           : conserve original page sizes (PS, PDF, SVG)
  -paper <string>          : paper size (letter, legal, A4, A3, match)
  -paperw <int>            : paper width, in points
  -paperh <int>            : paper height, in points
  -nocrop                  : don't crop pages to CropBox
  -expand                  : expand pages smaller than the paper size
  -noshrink                : don't shrink pages larger than the paper size
  -nocenter                : don't center pages smaller than the paper size
  -duplex                  : enable duplex printing
  -opw <string>            : owner password (for encrypted files)
  -upw <string>            : user password (for encrypted files)
  -q                       : don't print any messages or errors
  -v                       : print copyright and version info
  -h                       : print usage information
  -help                    : print usage information
  --help                   : print usage information
  -?                       : print usage information
```

Happy LaTeXing!

2条评论

registor

1楼 · 2019-11-04 19:30

专栏中的图片不知何故，左右被裁边了，实际转换的图中，未发生裁边现象。

6人赞回复1

啸行

2楼 · 2019-11-05 08:52

好东西啊

4人赞回复0

使用pdftocairo工具将pdf文件转换为png图像

Ta的文章更多 >>

热门文章

使用pdftocairo工具将pdf文件转换为png图像

Ta的文章 更多 >>

热门文章

举报内容

检举类型

检举原因

检举说明(必填)

打开微信“扫一扫”，打开网页后点击屏幕右上角分享按钮

Ta的文章更多 >>