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

在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} ``` 转换结果为： ### 转换普通文本 以下代码实现将普通文本转换为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} ``` 转换结果为： ## `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] [] -png : generate a PNG file -jpeg : generate a JPEG file -jpegopt : jpeg options, with format =[,=]* -tiff : generate a TIFF file -tiffcompression : 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 : first page to print -l : 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 : resolution, in PPI (default is 150) -rx : X resolution, in PPI (default is 150) -ry : Y resolution, in PPI (default is 150) -scale-to : scales each page to fit within scale-to*scale-to pixel box -scale-to-x : scales each page horizontally to fit in scale-to-x pixels -scale-to-y : scales each page vertically to fit in scale-to-y pixels -x : x-coordinate of the crop area top left corner -y : y-coordinate of the crop area top left corner -W : width of crop area in pixels (default is 0) -H : height of crop area in pixels (default is 0) -sz : 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 : set cairo antialias option -icc : 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 : paper size (letter, legal, A4, A3, match) -paperw : paper width, in points -paperh : 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 : owner password (for encrypted files) -upw : 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!