Renderização de figuras de LaTeX | Python via .NET

Em determinadas situações, pode ser necessário extrair conteúdo específico de um arquivo de LaTeX como uma peça renderizada independente, comumente referida como uma figura, sem nenhuma conexão com o layout da página. Isso pode ser útil, por exemplo, ao criar ilustrações para uma publicação on -line. Nossa API permite que você faça isso. Os formatos de destino para renderizar os números são PNG e SVG, assim como com o recurso de renderização de fórmula matemática do LATEX. Vale a pena notar que Renderização de figuras de LaTeX é um recurso mais geral em comparação com renderização de fórmula matemática do LATEX.

Renderizando uma figura de LaTeX para png

Se necessário, primeiro dê uma olhada na seção de referência da API para este tópico. Semelhante à renderização da fórmula, começaremos com um exemplo. Aqui está:

Defina ASPOSE_TEX_OUTPUT_DIR como o diretório de saída ou use a pasta padrão output. Todo o código LaTeX está incluído nos exemplos; não são necessários arquivos de entrada externos. Aplique uma licença primeiro. Licenciamento.

# Render a LaTeX figure with a triangle and formulas to PNG.
import os
from pathlib import Path
from aspose.pydrawing import Color
from aspose.tex.features import PngFigureRenderer, PngFigureRendererOptions

# Set an output directory, or use the default output folder.
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

# Create rendering options setting the image resolution to 150 dpi.
options = PngFigureRendererOptions()
options.resolution = 150
# Specify the preamble.
options.preamble = r"\usepackage{pict2e}"
# Specify the scaling factor 300%.
options.scale = 3000
# Leave space around the rendered fragment.
options.margin = 5
# Specify the background color.
options.background_color = Color.white
# Specify whether to show the terminal output on the console or not.
options.show_terminal = False

# Create binary streams for the rendering log and figure image.
with (output_dir / "text-and-formula.png.log").open("wb") as log_stream, \
        (output_dir / "text-and-formula.png").open("wb") as stream:
    options.log_stream = log_stream
    # Run rendering.
    size = PngFigureRenderer().render(r"""\setlength{\unitlength}{0.8cm}
\begin{picture}(6,5)
\thicklines
\put(1,0.5){\line(2,1){3}} \put(4,2){\line(-2,1){2}} \put(2,3){\line(-2,-5){1}} \put(0.7,0.3){$A$} \put(4.05,1.9){$B$} \put(1.7,2.95){$C$}
\put(3.1,2.5){$a$} \put(1.3,1.7){$b$} \put(2.5,1.05){$c$} \put(0.3,4){$F=\sqrt{s(s-a)(s-b)(s-c)}$} \put(3.5,0.4){$\displaystyle s:=\frac{a+b+c}{2}$}
\end{picture}""", stream, options)

# Show other results.
print(options.error_report or "No rendering errors.")
print()
print(f"Size: {size.width}x{size.height}")

Para começar, criamos uma instância da classe Opções do renderizador de figuras do LATEX, onde especificamos simultaneamente a resolução da imagem de saída.

Em seguida, precisamos especificar o preâmbulo. Ao contrário da renderização de fórmula matemática do LATEX, não há preâmbulo padrão para renderização de figuras de LaTeX. Portanto, se você está planejando renderizar gráficos criados usando o pacote pict2e LATEX, por exemplo, precisará especificá -lo no preâmbulo:

\usepackage{pict2e}

Definimos scale = 3000 para uma escala de 300% e margin = 5 para deixar espaço ao redor do fragmento. O exemplo PNG usa resolution = 150 DPI.

A próxima opção determina a cor do fundo. Ao contrário da renderização da fórmula matemática, não precisamos especificar uma cor de primeiro plano, pois assumimos que as cores são totalmente controladas pelo código do LATEX. Da mesma forma, a cor do plano de fundo também é controlada pelo código do LATEX; portanto, essa opção é simplesmente fornecida por conveniência.

O exemplo atribui um fluxo de arquivo binário a log_stream e salva o registro como text-and-formula.png.log ao lado de text-and-formula.png. A instrução with fecha ambos os fluxos automaticamente.

show_terminal controla a saída do terminal no console. Os exemplos o definem como False; o registro continua sendo gravado no arquivo.

O método responsável por renderizar a figura é FigureRenderer.render(). Ele retorna o tamanho da figura em pontos.

O segundo argumento é o fluxo de saída binário aberto para a imagem. O terceiro fornece as opções de renderização.

Por fim, invocamos o método FigureRenderer.render(), passando as opções como o terceiro argumento. O código do LATEX da figura é fornecido como o primeiro argumento.

As últimas linhas mostram o relatório de erros, ou No rendering errors. quando ele está vazio, seguido da largura e da altura em pontos.

Aqui está o resultado da renderização.

Isso representa o caso de uso mais geral para o recurso de renderização de figuras de LaTeX.

Renderizando uma figura de LaTeX para SVG

Da mesma forma, também podemos renderizar uma figura de LaTeX no formato SVG.

# Render a LaTeX figure with a triangle and formulas to SVG.
import os
from pathlib import Path
from aspose.pydrawing import Color
from aspose.tex.features import SvgFigureRenderer, SvgFigureRendererOptions

# Set an output directory, or use the default output folder.
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

# Create rendering options.
options = SvgFigureRendererOptions()
# Specify the preamble.
options.preamble = r"\usepackage{pict2e}"
# Specify the scaling factor 300%.
options.scale = 3000
# Leave space around the rendered fragment.
options.margin = 5
# Specify the background color.
options.background_color = Color.white
# Specify whether to show the terminal output on the console or not.
options.show_terminal = False

# Create binary streams for the rendering log and figure image.
with (output_dir / "text-and-formula.svg.log").open("wb") as log_stream, \
        (output_dir / "text-and-formula.svg").open("wb") as stream:
    options.log_stream = log_stream
    # Run rendering.
    size = SvgFigureRenderer().render(r"""\setlength{\unitlength}{0.8cm}
\begin{picture}(6,5)
\thicklines
\put(1,0.5){\line(2,1){3}} \put(4,2){\line(-2,1){2}} \put(2,3){\line(-2,-5){1}} \put(0.7,0.3){$A$} \put(4.05,1.9){$B$} \put(1.7,2.95){$C$}
\put(3.1,2.5){$a$} \put(1.3,1.7){$b$} \put(2.5,1.05){$c$} \put(0.3,4){$F=\sqrt{s(s-a)(s-b)(s-c)}$} \put(3.5,0.4){$\displaystyle s:=\frac{a+b+c}{2}$}
\end{picture}""", stream, options)

# Show other results.
print(options.error_report or "No rendering errors.")
print()
print(f"Size: {size.width}x{size.height}")

Este exemplo cria text-and-formula.svg e o registro text-and-formula.svg.log no mesmo diretório de saída.

As diferenças são:

• Em vez de usar a classe pngfigureReRoptions, utilizamos a classe svgfigureReRoptions.
• Não precisamos especificar a resolução.
• Em vez de usar a classe pngfigurerenderer, utilizamos a classe svgfigurerenderer.

Aqui está o resultado: