乳胶到图像| 通过 .NET 为 Python 提供 Aspose.TeX
python的aspose.tex为我们提供了将乳胶文件转换为各种光栅图像格式的功能。
将乳胶转换为PNG
现在,让我们研究Python代码,该代码提供了将乳胶转换为PNG格式的最直接方法。
将 ASPOSE_TEX_INPUT_FILE 设置为 LaTeX 文件路径,将 ASPOSE_TEX_OUTPUT_DIR 设置为输出目录,或修改示例中的路径。默认值为 hello-world.ltx 和 output。请先应用许可证。示例在主文档所在目录查找其他输入文件,并以非交互方式处理。
许可证
1# Convert LaTeX to PNG.
2import os
3from pathlib import Path
4from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
5from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
6from aspose.tex.presentation.image import ImageDevice, PngSaveOptions
7
8# Set these paths to your LaTeX document and output directory.
9input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
10output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
11if not input_file.is_file():
12 raise FileNotFoundError(input_file)
13output_dir.mkdir(parents=True, exist_ok=True)
14
15# Use the Object LaTeX format and resolve additional inputs beside the main file.
16options = TeXOptions.console_app_options(TeXConfig.object_latex)
17options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
18options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
19options.interaction = Interaction.NONSTOP_MODE
20options.terminal_out = OutputMemoryTerminal()
21options.save_options = PngSaveOptions()
22device = ImageDevice(True)
23job_result = TeXJob(str(input_file), device, options).run()首先,我们需要使用 console_app_options() 方法创建 Texoptions类的实例。不用担心名称,这只是创建实例的静态方法。此方法将 TexConfig类的 Object_Latex实例,它非常适合转换 latex文件。此配置设置了对象Tex引擎以加载对象乳胶格式并准备好处理乳胶文件。对象乳胶格式基本与 乳胶格式相同,但是它使用 Object tex特定基本来定义页面指标。
第一个必需的选项是 output_working_directory,它指定 TeX 输出的保存位置。如果您感兴趣,可以了解更多关于 Aspose.TeX for Python 中输出目录的概念。在本例中,我们利用 OutputFileSystemDirectory 类将输出写入特定目录或文件夹。
第二个选项是 SaveOptions类的实例,该实例负责管理 对象模型到所需格式的转换。在这种情况下,由于我们将乳胶转换为png,因此我们使用 pngsaveoptions类实例,它允许我们指定输出图像的分辨率。
接下来,我们创建一个 Texjob类的实例。在这种情况下,由于我们要转换存储在文件系统中的乳胶文件,因此我们使用 constructor的此版本 。我们需要为文件提供完整的路径,否则,引擎将在当前目录(即脚本的工作目录)中寻找它,并且可能找不到它。但是,可以省略“ .tex”扩展,因为发动机会自动将其附加。构造函数的第二个参数是 设备类的实例。由于我们将乳胶转换为png,因此这是一个 Imagedevice类实例,这对于所有受支持的图像格式都是常见的。最后,我们将准备好的转换选项作为最后一个参数。
现在,剩下的就是 运行工作。
示例将终端输出保存在 OutputMemoryTerminal 中。输出目录还包含 .log 日志。转换成功时,日志类似如下内容;版本信息可能不同:
1This is ObjectTeX, Version 3.1415926-1.0 (Aspose.TeX 21.8)
2entering extended mode
3
4(<input_directory>\hello-world.ltx
5LaTeX2e <2011/06/27>
6(article.cls
7Document Class: article 2007/10/19 v1.4h Standard LaTeX document class
8(size10.clo))
9No file hello-world.aux.
10[1]
11(<output_directory>\hello-world.aux) )
12Output written on hello-world.png (1 page).
13Transcript written on hello-world.log.引擎工作的结果可以在我们指定的输出目录中找到。这将包括成绩单文件,最重要的是,主输出PNG图像文件。
编写主要输出PNG文件的另一种方法
还有一种替代方法可以将图像数据作为字节数组的数组获取,其中第二维中的每个数组代表单独的页面的图像数据。
1# Convert LaTeX to PNG and save each page from the returned byte arrays.
2import os
3from pathlib import Path
4from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
5from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
6from aspose.tex.presentation.image import ImageDevice, PngSaveOptions
7
8# Set these paths to your LaTeX document and output directory.
9input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
10output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
11if not input_file.is_file():
12 raise FileNotFoundError(input_file)
13output_dir.mkdir(parents=True, exist_ok=True)
14
15# Use the Object LaTeX format and resolve additional inputs beside the main file.
16options = TeXOptions.console_app_options(TeXConfig.object_latex)
17options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
18options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
19options.interaction = Interaction.NONSTOP_MODE
20options.terminal_out = OutputMemoryTerminal()
21save_options = PngSaveOptions()
22save_options.device_writes_images = False
23options.save_options = save_options
24device = ImageDevice(True)
25job_result = TeXJob(str(input_file), device, options).run()
26
27# Write the returned PNG page bytes yourself.
28for index, page_bytes in enumerate(device.result, start=1):
29 (output_dir / f"page-{index}.png").write_bytes(page_bytes)示例先在 PngSaveOptions 上设置 device_writes_images = False,再将其赋给 options.save_options。返回的各页字节数据分别保存为 page-1.png、page-2.png 等,因此设备不会生成重复的 PNG 文件。
关于输入选项
如果我们的主输入文件需要依赖项,例如基本 LaTeX 系统或受支持的软件包中未包含的软件包,我们需要设置
required_input_directory 选项,设置方式类似于设置 output_working_directory 选项,并将依赖项放置在该目录中。依赖项可以根据需要组织到子目录中。如果我们需要在排版过程中包含文件,例如外部图形文件,我们还需要将
input_working_directory 设置为这些文件的存储位置。我们还可以将主输入文件放置在输入目录中,并向 TeXJob 构造函数传入相对路径;如果主输入文件位于根目录中,则无需指定任何路径。还有关于 Aspose.TeX 中的
输入目录概念 的更多详细信息以及所提供的实现描述。
还可以在这里学习 其他TEX职位选项。
您还可以探索用于 LaTeX 到 PNG 转换的免费 web 应用程序,该应用程序是使用 Aspose.TeX for .NET API 开发的。
下面,我们将简要说明乳胶转换为其他受支持的光栅图像格式,而不会介入太多细节,因为没有显着差异。唯一的变化在于转换选项中 save_options属性的类型。
将乳胶转换为JPG
1# Convert LaTeX to JPEG.
2import os
3from pathlib import Path
4from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
5from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
6from aspose.tex.presentation.image import ImageDevice, JpegSaveOptions
7
8# Set these paths to your LaTeX document and output directory.
9input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
10output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
11if not input_file.is_file():
12 raise FileNotFoundError(input_file)
13output_dir.mkdir(parents=True, exist_ok=True)
14
15# Use the Object LaTeX format and resolve additional inputs beside the main file.
16options = TeXOptions.console_app_options(TeXConfig.object_latex)
17options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
18options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
19options.interaction = Interaction.NONSTOP_MODE
20options.terminal_out = OutputMemoryTerminal()
21options.save_options = JpegSaveOptions()
22device = ImageDevice(True)
23job_result = TeXJob(str(input_file), device, options).run()您还可以探索免费的 用于 LaTeX 到 TIFF 转换的 Web 应用程序,它是使用 Aspose.TeX for .NET API 开发的。
将乳胶转换为tiff
1# Convert LaTeX to TIFF.
2import os
3from pathlib import Path
4from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
5from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
6from aspose.tex.presentation.image import ImageDevice, TiffSaveOptions
7
8# Set these paths to your LaTeX document and output directory.
9input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
10output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
11if not input_file.is_file():
12 raise FileNotFoundError(input_file)
13output_dir.mkdir(parents=True, exist_ok=True)
14
15# Use the Object LaTeX format and resolve additional inputs beside the main file.
16options = TeXOptions.console_app_options(TeXConfig.object_latex)
17options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
18options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
19options.interaction = Interaction.NONSTOP_MODE
20options.terminal_out = OutputMemoryTerminal()
21options.save_options = TiffSaveOptions()
22device = ImageDevice(True)
23job_result = TeXJob(str(input_file), device, options).run()您还可以探索免费的 用于 LaTeX 到 TIFF 转换的 Web 应用程序,它是使用 Aspose.TeX for .NET API 开发的。
将乳胶转换为BMP
1# Convert LaTeX to BMP.
2import os
3from pathlib import Path
4from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
5from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
6from aspose.tex.presentation.image import ImageDevice, BmpSaveOptions
7
8# Set these paths to your LaTeX document and output directory.
9input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
10output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
11if not input_file.is_file():
12 raise FileNotFoundError(input_file)
13output_dir.mkdir(parents=True, exist_ok=True)
14
15# Use the Object LaTeX format and resolve additional inputs beside the main file.
16options = TeXOptions.console_app_options(TeXConfig.object_latex)
17options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
18options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
19options.interaction = Interaction.NONSTOP_MODE
20options.terminal_out = OutputMemoryTerminal()
21options.save_options = BmpSaveOptions()
22device = ImageDevice(True)
23job_result = TeXJob(str(input_file), device, options).run()您还可以探索免费的 用于 LaTeX 到 BMP 转换的 Web 应用程序,它是使用 Aspose.TeX for .NET API 开发的。
将乳胶转换为SVG
另一种支持的目标格式是 SVG。 **可伸缩矢量图形(SVG)**是一种基于XML的矢量图像格式,用于定义二维图形。它支持互动性和动画。
SVG图像存储在XML文本文件中,并以矢量图形格式定义。这意味着svg的图像可以缩小大小而不会失去质量,并且svg文件本身可以被搜索,索引,脚本编写和压缩。 XML文本文件可以使用文本编辑器或矢量图形编辑器创建和编辑,并且可以由最常用的Web浏览器渲染。
Aspose.SVGAPI提供了一系列功能,用于使用svg,例如创建,加载,编辑和转换svg文档。
将乳胶转换为SVG与 转换为栅格图像格式一样简单,唯一的区别是 save_options必须设置为 svgsaveoptions类的实例,并且必须将设备更改为svgdevice。
1# Convert LaTeX to SVG.
2import os
3from pathlib import Path
4from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
5from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
6from aspose.tex.presentation.svg import SvgDevice, SvgSaveOptions
7
8# Set these paths to your LaTeX document and output directory.
9input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
10output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
11if not input_file.is_file():
12 raise FileNotFoundError(input_file)
13output_dir.mkdir(parents=True, exist_ok=True)
14
15# Use the Object LaTeX format and resolve additional inputs beside the main file.
16options = TeXOptions.console_app_options(TeXConfig.object_latex)
17options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
18options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
19options.interaction = Interaction.NONSTOP_MODE
20options.terminal_out = OutputMemoryTerminal()
21options.save_options = SvgSaveOptions()
22device = SvgDevice()
23job_result = TeXJob(str(input_file), device, options).run()您还可以探索免费的 用于 LaTeX 到 SVG 转换的 Web 应用程序,它是使用 Aspose.TeX for .NET API 开发的。