LaTeX 数式のレンダリング | Python via .NET

PNG に LaTeX 数式をレンダリングする

必要に応じて、 このトピックのAPIリファレンスセクションをご覧ください。実際、LaTeX数式レンダリング機能を理解するには、まず例を挙げるのが最も効果的です。以下に例を示します。

ASPOSE_TEX_OUTPUT_DIR に出力ディレクトリを指定するか、既定の output フォルダーを使用してください。LaTeX コードはすべて例に含まれているため、外部入力ファイルは不要です。事前にライセンスを適用してください。 ライセンス.

# Render a highlighted LaTeX math formula to PNG.
import os
from pathlib import Path
from aspose.pydrawing import Color
from aspose.tex.features import PngMathRenderer, PngMathRendererOptions

# 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 = PngMathRendererOptions()
options.resolution = 150
# Specify the preamble.
options.preamble = r"""\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}
\usepackage{color}"""
# Specify the scaling factor 300%.
options.scale = 3000
# Leave space around the rendered fragment.
options.margin = 5
# Specify the foreground color.
options.text_color = Color.black
# 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 formula image.
with (output_dir / "math-formula.png.log").open("wb") as log_stream, \
        (output_dir / "math-formula.png").open("wb") as stream:
    options.log_stream = log_stream
    # Run rendering.
    size = PngMathRenderer().render(r"""\begin{equation*}
e^x = x^{\color{red}0} + x^{\color{red}1} + \frac{x^{\color{red}2}}{2} + \frac{x^{\color{red}3}}{6} + \cdots = \sum_{n\geq 0} \frac{x^{\color{red}n}}{n!}
\end{equation*}""", stream, options)

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

詳細を見ていきましょう。まず、TeX/LaTeXタイプッティングに似た レンダリングオプションオブジェクトを初期化します。このオブジェクトには、必要な出力画像解像度の指定が含まれています。

次に、プリアンブルを指定します。デフォルトのプリアンブルは次のとおりです。

\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}

これは、標準的なLaTeXに比べて数式のサポートが強化されています。例えば、提供されているコード例に示すように、colorパッケージをインクルードすることで、数式内のハイライト表示をカスタマイズできます。

scale = 3000 で 300% に拡大し、margin = 5 でフラグメントの周囲に余白を設けます。PNG の例では resolution = 150 DPI を使用します。

次の2つのオプションは、前景色と背景色を決定します。数式の中でカスタムハイライトの影響を受けない部分は、text_colorカラーで表示されます。

この例ではバイナリファイルストリームを log_stream に設定し、math-formula.png と同じ場所に math-formula.png.log を保存します。with 文が両方のストリームを自動的に閉じます。

show_terminal はコンソールへの端末出力を制御します。例では False に設定していますが、ログはファイルに書き込まれます。

実際のレンダリング処理は MathRenderer.render() メソッドによって実行され、数式のサイズをポイント単位で返します。

第2引数は画像用に開いたバイナリ出力ストリームです。第3引数はレンダリングオプションです。

最後に、MathRenderer.render() メソッドが呼び出され、オプションが3番目の引数として渡されます。数式の LaTeX コードは1番目の引数として提供されます。

最後の行ではエラーレポート、またはレポートが空なら No rendering errors. を表示し、その後に幅と高さをポイント単位で表示します。

レンダリングの結果は次のとおりです。

これは、LaTeX 数式レンダリング 機能の最も一般的で幅広い応用例です。

また、 Aspose.TeX for .NET API の実装機能を活用した無料の Webアプリもお試しください。

SVG に LaTeX 数式をレンダリングする

同様に、同じ方法でLaTeXの数式をSVG形式に変換できます。

# Render a highlighted LaTeX math formula to SVG.
import os
from pathlib import Path
from aspose.pydrawing import Color
from aspose.tex.features import SvgMathRenderer, SvgMathRendererOptions

# 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 = SvgMathRendererOptions()
# Specify the preamble.
options.preamble = r"""\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}
\usepackage{color}"""
# Specify the scaling factor 300%.
options.scale = 3000
# Leave space around the rendered fragment.
options.margin = 5
# Specify the foreground color.
options.text_color = Color.black
# 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 formula image.
with (output_dir / "math-formula.svg.log").open("wb") as log_stream, \
        (output_dir / "math-formula.svg").open("wb") as stream:
    options.log_stream = log_stream
    # Run rendering.
    size = SvgMathRenderer().render(r"""\begin{equation*}
e^x = x^{\color{red}0} + x^{\color{red}1} + \frac{x^{\color{red}2}}{2} + \frac{x^{\color{red}3}}{6} + \cdots = \sum_{n\geq 0} \frac{x^{\color{red}n}}{n!}
\end{equation*}""", stream, options)

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

この例では同じ出力ディレクトリに math-formula.svg とログ math-formula.svg.log を作成します。

違いは以下のとおりです。

• PngMathRendererOptions クラスの代わりに、 SvgMathRendererOptions クラスを使用します。
• 解像度は指定しません。
• PngMathRenderer クラスの代わりに、 SvgMathRenderer クラスを使用します。

結果は以下のとおりです。

Aspose.TeX for .NET API の実装機能を活用した無料の Web アプリ もお試しください。