使用Python调用ImageMagick的convert命令转换LaTeX PDF为PNG出错

错误信息 #

Invalid Parameter - C:\Users\twill\AppData\Local\Temp\tmpdxeaziux\tikz_figure.png
Traceback (most recent call last):
File "c:/Users/twill/OneDrive/Documents/GitHub/Programming/Python/clipboard.py", line 50, in 
image = Image.open(image_file)
File "C:\Users\twill\AppData\Local\Programs\Python\Python38-32\lib\site-packages\PIL\Image.py", line 2878, in open
fp = builtins.open(filename, "rb")
FileNotFoundError: [Errno 2] No such file or directory: 'C:\Users\twill\AppData\Local\Temp\tmpdxeaziux\tikz_figure.png'

问题场景 #

Python项目中，需要将LaTeX的TikZ代码片段生成图像并在tkinter窗口显示，卡在使用ImageMagick的convert命令将LaTeX生成的PDF转换为PNG图像步骤。

示例代码 #

from PIL import Image
import tempfile
import subprocess
import os

# TikZ代码
latex_expr = r'''
\tdplotsetmaincoords{60}{110}
\begin{tikzpicture}[scale=2,line join=bevel,tdplot_main_coords,%
fill opacity=.5]
\tdplotsetpolarplotrange{0}{360}{0}{360}
\tdplotsphericalsurfaceplot[parametricfill]{72}{36}%
{1+(1/5)*sin(6*\tdplottheta)*sin(5*\tdplotphi)}{black}{\tdplotphi}%
{\path[color=black,thick,->] (0,0,0)
-- (1,0,0) node[anchor=north east]{};}%
{\path[color=black,thick,->] (0,0,0)
-- (0,1,0) node[anchor=north west]{};}%
{\path[color=black,thick,->] (0,0,0)
-- (0,0,1) node[anchor=south]{};}%
\end{tikzpicture}
'''

temp_dir = tempfile.mkdtemp()
latex_file = os.path.join(temp_dir, "tikz_figure.tex")
pdf_file = os.path.join(temp_dir, "tikz_figure.pdf")
image_file = os.path.join(temp_dir, "tikz_figure.png")

latex_doc = r'''
\documentclass{article}
\usepackage{pgfplots}
\usepackage{tikz-3dplot}
\pgfplotsset{compat=1.18}
\begin{document}
''' + latex_expr + r'''
\end{document}
'''

# 保存TikZ代码到临时LaTeX文件
with open(latex_file, 'w') as f:
    f.write(latex_doc)

# 编译LaTeX生成PDF
subprocess.call(['pdflatex', '-output-directory=' + temp_dir, latex_file])

# 将PDF转换为PNG
subprocess.call(['convert', pdf_file, image_file])

# 打开并显示图像
image = Image.open(image_file)

解决办法 #

1. 解决Windows下convert命令冲突问题 #

Windows系统自带一个convert.exe（用于转换磁盘格式），会和ImageMagick的convert命令重名，导致执行的不是ImageMagick工具，出现Invalid Parameter错误。

解决方式二选一：

• 使用ImageMagick的新命令magick替代convert，修改转换代码：

  subprocess.call(['magick', pdf_file, image_file])
  

• 指定ImageMagick的convert.exe完整路径，比如：

  subprocess.call([r'C:\Program Files\ImageMagick-7.1.1-Q16-HDRI\convert.exe', pdf_file, image_file])
  

  路径根据你的ImageMagick安装目录调整。

2. 确保LaTeX编译成功生成PDF #

• 检查编译输出：用subprocess.check_output替代subprocess.call，捕获编译日志，排查是否有LaTeX包缺失或语法错误：

  try:
      output = subprocess.check_output(['pdflatex', '-output-directory=' + temp_dir, '-quiet', latex_file], stderr=subprocess.STDOUT, text=True)
      print(output)
  except subprocess.CalledProcessError as e:
      print("LaTeX编译出错:", e.output)
  

• 多次编译：TikZ的3D图形可能需要多次编译才能正确生成，可连续调用两次pdflatex：

  subprocess.call(['pdflatex', '-output-directory=' + temp_dir, '-quiet', latex_file])
  subprocess.call(['pdflatex', '-output-directory=' + temp_dir, '-quiet', latex_file])
  

• 确认依赖包：确保系统LaTeX环境已安装tikz-3dplot、pgfplots等所需包。

3. 添加文件存在检查与错误处理 #

在打开图像前，先检查PNG文件是否生成，避免FileNotFoundError：

if os.path.exists(image_file):
    image = Image.open(image_file)
else:
    print(f"错误：未找到图像文件 {image_file}")
    # 可添加临时目录清理、错误提示等逻辑

修复后的完整示例代码 #

from PIL import Image
import tempfile
import subprocess
import os

# TikZ代码
latex_expr = r'''
\tdplotsetmaincoords{60}{110}
\begin{tikzpicture}[scale=2,line join=bevel,tdplot_main_coords,%
fill opacity=.5]
\tdplotsetpolarplotrange{0}{360}{0}{360}
\tdplotsphericalsurfaceplot[parametricfill]{72}{36}%
{1+(1/5)*sin(6*\tdplottheta)*sin(5*\tdplotphi)}{black}{\tdplotphi}%
{\path[color=black,thick,->] (0,0,0)
-- (1,0,0) node[anchor=north east]{};}%
{\path[color=black,thick,->] (0,0,0)
-- (0,1,0) node[anchor=north west]{};}%
{\path[color=black,thick,->] (0,0,0)
-- (0,0,1) node[anchor=south]{};}%
\end{tikzpicture}
'''

temp_dir = tempfile.mkdtemp()
latex_file = os.path.join(temp_dir, "tikz_figure.tex")
pdf_file = os.path.join(temp_dir, "tikz_figure.pdf")
image_file = os.path.join(temp_dir, "tikz_figure.png")

latex_doc = r'''
\documentclass{article}
\usepackage{pgfplots}
\usepackage{tikz-3dplot}
\pgfplotsset{compat=1.18}
\begin{document}
''' + latex_expr + r'''
\end{document}
'''

# 保存TikZ代码到临时LaTeX文件
with open(latex_file, 'w') as f:
    f.write(latex_doc)

# 编译LaTeX生成PDF（两次编译确保图形正确）
try:
    subprocess.check_output(['pdflatex', '-output-directory=' + temp_dir, '-quiet', latex_file], stderr=subprocess.STDOUT, text=True)
    subprocess.check_output(['pdflatex', '-output-directory=' + temp_dir, '-quiet', latex_file], stderr=subprocess.STDOUT, text=True)
except subprocess.CalledProcessError as e:
    print("LaTeX编译失败：", e.output)
    exit(1)

# 检查PDF是否生成
if not os.path.exists(pdf_file):
    print("错误：未生成PDF文件")
    exit(1)

# 将PDF转换为PNG（使用magick命令）
try:
    subprocess.check_output(['magick', pdf_file, image_file], stderr=subprocess.STDOUT, text=True)
except subprocess.CalledProcessError as e:
    print("ImageMagick转换失败：", e.output)
    exit(1)

# 打开并显示图像
if os.path.exists(image_file):
    image = Image.open(image_file)
    image.show()  # 测试显示
else:
    print(f"错误：未找到生成的PNG文件 {image_file}")

# 可选：清理临时文件
# import shutil
# shutil.rmtree(temp_dir)

内容的提问来源于stack exchange，提问作者user21322925