ラテックスフィギュアレンダリング| Java用のAspose.TeX

出力ドキュメントページのその場所に関係なく、ラテックスファイルから個別にレンダリングされたピース、または *“figure”*として、いくつかのコンテンツ(図面、書き込み、プロットなど)を抽出することができます。たとえば、インターネット上での出版物のイラストが当てはまります。私たちのAPIはタスクを支援します。 PNGとSVGの2つの使用可能なターゲット形式があります。ラテックス数学の式レンダリングのように。また、ラテックスフィギュアレンダリングは[ラテックス数学式レンダリング]の一般化であることに注意する必要があります(1)。

ラテックスフィギュアをPNGにレンダリングする方法

また、式レンダリングと同様に、例から始めます。ここにあります：

// Create rendering options setting the image resolution to 150 dpi.
PngFigureRendererOptions options = new PngFigureRendererOptions();
options.setResolution(150);
// Specify the preamble.
options.setPreamble("\\usepackage{pict2e}");
// Specify the scaling factor 300%.
options.setScale(3000);
// Specify the background color.
options.setBackgroundColor(Color.WHITE);
// Specify the output stream for the log file.
options.setLogStream(new ByteArrayOutputStream());
// Specify whether to show the terminal output on the console or not.
options.showTerminal(true);

// Create the output stream for the figure image.
final OutputStream stream = new FileOutputStream(Utils.getOutputDirectory() + "text-and-formula.png");
try {
    // Run rendering.
    com.aspose.tex.Size2D size = new PngFigureRenderer().render("\\setlength{\\unitlength}{0.8cm}\r\n" +
    "\\begin{picture}(6,5)\r\n" +
    "\\thicklines\r\n" +
    "\\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$}\r\n" +
    "\\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}$}\r\n" +
    "\\end{picture}", stream, options);
    
    // Show other results.
    System.out.println(options.getErrorReport());
    System.out.println();
    System.out.println("Size: " + size.getWidth() + "x" + size.getHeight()); // Dimensions of the resulting image.
} finally {
    if (stream != null)
        stream.close();
}

まず、 レンダリングオプションインスタンスを作成します。ここでは、出力画像解像度を指定します。

次に、前文を指定します。ラテックスフィギュアレンダリングにはデフォルトのプリアンブルはありません。たとえば、 pict2eラテックスパッケージを使用してプロットされたグラフィックをレンダリングする必要がある場合は、preambleで指定する必要があります。

\usepackage{pict2e}

次に、レンダラーに出力を300％スケーリングするよう指示します。

次のオプションは、背景色を定義します。数学の式レンダリングとは異なり、色は完全にラテックスコードの制御下にあると仮定するため、前景の色を指定しません。実際、背景色もそうですので、これは単なる便利なオプションです。

例の次の行はあまり意味がありません。ログ出力をストリームに向けることができることを示しています。

また、最後のオプション「showterminal」を使用すると、ターミナル出力の書き込みをコンソールに切り替えることができます。

実際にレンダリングを実行する方法は figurerenderer.render()です。フィギュアのサイズをポイントで返します。

画像が記述されるストリームは、2番目の引数としてメソッドによって受け入れられます。次にストリームを作成します。

そして最後に、 figurerenderer.render()メソッド自体を3番目の引数として渡すオプションを呼び出します。図のラテックスコードは、最初の引数として渡されます。

この例の最後の行には、図のレンダリングの2つのアーティファクトが印刷されています。図のサイズと簡単なエラーレポート(エラーがある場合)。

レンダリングの結果です。

これは、LaTexフィギュアレンダリング機能の最も一般的なユースケースです。

ラテックスフィギュアをSVGにレンダリングする方法

ほぼ同じように、ラテックスフィギュアをSVG形式にレンダリングできます。

// Create rendering options.
SvgFigureRendererOptions options = new SvgFigureRendererOptions();
// Specify the preamble.
options.setPreamble("\\usepackage{pict2e}");
// Specify the scaling factor 300%.
options.setScale(3000);
// Specify the background color.
options.setBackgroundColor(Color.WHITE);
// Specify the output stream for the log file.
options.setLogStream(new ByteArrayOutputStream());
// Specify whether to show the terminal output on the console or not.
options.showTerminal(true);

// Create the output stream for the figure image.
final OutputStream stream = new FileOutputStream(Utils.getOutputDirectory() + "text-and-formula.svg");
try {
    // Run rendering.
    com.aspose.tex.Size2D size = new SvgFigureRenderer().render("\\setlength{\\unitlength}{0.8cm}\r\n" +
    "\\begin{picture}(6,5)\r\n" +
    "\\thicklines\r\n" +
    "\\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$}\r\n" +
    "\\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}$}\r\n" +
    "\\end{picture}", stream, options);
    
    // Show other results.
    System.out.println(options.getErrorReport());
    System.out.println();
    System.out.println("Size: " + size.getWidth() + "x" + size.getHeight()); // Dimensions of the resulting image.
} finally {
    if (stream != null)
        stream.close();
}

違いは次のとおりです。

• pngfigurerenderereroptionsの代わりに svgfigurerenderereroptionsクラスを使用します。
• 解決策は指定しません。
• pngfigurerendererの代わりに svgfigurerendererクラスを使用します。

これが結果です：