דירוג המשלוח של LaTeX ל- PNG הוא דרישה נפוצה עבור מסמכי האינטרנט, בסיסי הידע והיישומים המתמטיים. Aspose.TEX עבור .NET מספקת API פשוט להמיר .tex מאמר זה מראה ממיר קובץ יחיד מינימלי ותחנת צינור חזקה שאתה יכול לרדת לכל יישום .NET.
דרישות
- .NET 6 או מאוחר יותר
- חבילה של NuGet:
Aspose.TeX - מקורות LaTeX המורכבים מתחת למנוע Object LaTex המשמש על ידי Aspose.TEX
ASPOSE.TEX תצוגה TeXOptions.ConsoleAppOptions(TeXConfig.ObjectLaTeX), ImageDevice, ו PngSaveOptions כדי לייצר PNG ייצור.
מינימום ההמרה: קובץ LaTeX אחד ל- PNG
דוגמה זו הופכת hello-world.ltx (או .tex) כדי PNG בתיקיה היציאה.המכשיר כותב את קבצי התמונה ישירות.
// File: Program.cs
// NuGet: Aspose.TeX
using System;
using System.IO;
using Aspose.TeX;
class Program
{
static void Main()
{
var inputFile = Path.GetFullPath("hello-world.tex"); // or .ltx
var outputDir = Path.GetFullPath("out-png");
Directory.CreateDirectory(outputDir);
// 1) Create conversion options for Object LaTeX
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectLaTeX);
// 2) Choose where to write output files
options.OutputWorkingDirectory = new OutputFileSystemDirectory(outputDir);
// 3) Save as PNG (you can set resolution if required)
var png = new PngSaveOptions
{
// Resolution = 300 // uncomment to render at 300 DPI
};
options.SaveOptions = png;
// 4) Run the job. ImageDevice writes PNG files into the output directory.
var device = new ImageDevice();
new TeXJob(inputFile, device, options).Run();
Console.WriteLine("PNG written to: " + outputDir);
}
}
זה עוקב אחר הדפוס המסומן: יצירת TeXOptionsסאט OutputWorkingDirectoryסאט PngSaveOptionsלאחר מכן לרוץ א TeXJob עם אחד ImageDevice.
תגית: Batch Conversion .tex קבצים במעבדה
גרסת ה-Batch סורקת תיעוד כניסה ומפנה כל אחד מהם. .tex זה גם מראה כיצד לשלוט היכן תלויות וגרפיקה הכוללת נרשמים.
// File: BatchLatexToPng.cs
// NuGet: Aspose.TeX
using System;
using System.IO;
using Aspose.TeX;
public static class BatchLatexToPng
{
public static int Run(string inputDir, string outputDir, int? dpi = null)
{
if (!Directory.Exists(inputDir))
{
Console.Error.WriteLine("Input directory not found: " + inputDir);
return 1;
}
Directory.CreateDirectory(outputDir);
// Configure conversion options once and reuse
var options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectLaTeX);
// Where to read auxiliary inputs (e.g., included images)
options.InputWorkingDirectory = new InputFileSystemDirectory(inputDir);
// Where to read extra required packages (if you supply them)
// options.RequiredInputDirectory = new InputFileSystemDirectory(Path.Combine(inputDir, "texmf"));
// Where to write PNG, log, aux, etc.
options.OutputWorkingDirectory = new OutputFileSystemDirectory(outputDir);
// PNG save options (set DPI if needed)
var png = new PngSaveOptions();
if (dpi.HasValue) png.Resolution = dpi.Value;
options.SaveOptions = png;
int ok = 0, err = 0;
var device = new ImageDevice(); // will write images to OutputWorkingDirectory
foreach (var texPath in Directory.GetFiles(inputDir, "*.tex", SearchOption.AllDirectories))
{
try
{
// Optional: set a job name so output files have predictable names
options.JobName = Path.GetFileNameWithoutExtension(texPath);
new TeXJob(texPath, device, options).Run();
Console.WriteLine("OK " + Path.GetRelativePath(inputDir, texPath));
ok++;
}
catch (Exception ex)
{
Console.WriteLine("ERR " + Path.GetRelativePath(inputDir, texPath) + " | " + ex.Message);
err++;
}
}
Console.WriteLine($"Done. Success: {ok}, Failed: {err}");
return err == 0 ? 0 : 2;
}
}
נקודות מפתח לעבודה ב-Batch:
- שימוש
InputWorkingDirectoryעבור נכסים כגון\includegraphics{img.png}. - שימוש
RequiredInputDirectoryאם אתה חייב לספק חבילות נוספות LaTeX מחוץ למערכת מובנית. - סדרה
JobNameכדי להשפיע על תוצאות filenames לפי מסמך.
לצלם תמונות בזיכרון במקום לכתוב קבצים
אם אתה מעדיף לשדרג בייטים PNG בעצמך, תן למכשיר להטביע אותם על ידי הפוך קבצים ישירים כתובים.
using System;
using System.IO;
using Aspose.TeX;
static void ConvertToStreams(string inputFile, string outputDir)
{
Directory.CreateDirectory(outputDir);
var options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectLaTeX);
var png = new PngSaveOptions { DeviceWritesImages = false };
options.SaveOptions = png;
var device = new ImageDevice();
new TeXJob(inputFile, device, options).Run();
for (int i = 0; i < device.Result.Length; i++)
{
var pageBytes = device.Result[i];
var outPath = Path.Combine(outputDir, $"page-{i + 1}.png");
File.WriteAllBytes(outPath, pageBytes);
}
}
זה מראה את “דרך חלופית” מסומנת לכתוב את הקבצים PNG היציאה העיקרית.
פתרון בעיות וטיפים
- הפתרון *: הגדלת
PngSaveOptions.Resolutionעבור נוסחאות חזקות יותר בתמונות מסך רשת או נכסים הדפסה.
- הפתרון *: הגדלת
- תלויות**: לשים חבילות מותאמות אישית והכנסות בכתובת המפורטת על ידי
RequiredInputDirectoryוInputWorkingDirectory.
- תלויות**: לשים חבילות מותאמות אישית והכנסות בכתובת המפורטת על ידי
- תגית: Set
options.JobNameעבור שמות קבצי היציאה צפויים ב- batch runs. - Logging: המנוע כותב תסריט
.logלמדריך היציאה, אשר מועיל לדיבוג של חבילות חסרות ושגיאות LaTeX.
מתי לבחור פורמטים אחרים
PNG הוא אידיאלי לפרסום אינטרנט ו- UI. אם אתה זקוק לייצוא וקטור עבור זומם אינסופי או טקסט קטן בקנה מידה, לעבור ל- SVG באמצעות SvgSaveOptions ואחד SvgDevice, או ל- PDF עבור מסמכים משולבים.הזרימת ההמרה נשארת זהה.
עם דפוסים אלה, אתה יכול אוטומטי LaTeX ל- PNG בקנה מידה ב- .NET תוך שמירה על שליטה מלאה על הרזולוציה, התיקיות וניהול הקבצים.