कॉन्फ़िगरेशन विकल्प संदर्भ

कॉन्फ़िगरेशन विकल्प संदर्भ

अधिकांश लोडिंग, सहेजने, और रूपांतरण संचालन Aspose.PDF FOSS में .NET के लिए एक *Options ऑब्जेक्ट जो उस ऑपरेशन के व्यवहार को कॉन्फ़िगर करता है। LoadOptions and SaveOptions इस परिवार के दो अमूर्त मूल हैं: प्रत्येक फॉर्मेट-विशिष्ट लोडर (HtmlLoadOptions, MdLoadOptions, TxtLoadOptions, SvgLoadOptions) से व्युत्पन्न होता है LoadOptions, और प्रत्येक फॉर्मेट-विशिष्ट राइटर (PdfSaveOptions, HtmlSaveOptions, SvgSaveOptions) से व्युत्पन्न होता है SaveOptions. यह पृष्ठ समझाता है कि परिवार कैसे एक साथ फिट होता है और उन विकल्प वर्गों का दस्तावेज़ीकरण करता है जो पहले कवर नहीं किए गए हैं। परिवर्तन और अनुकूलन गाइड।

LoadOptions के साथ दस्तावेज़ लोड करना

प्रत्येक *LoadOptions उपवर्ग LoadOptions बेस क्लास से WarningHandler, WarningHandlerName, DisableFontLicenseVerifications, और LoadFormat को विरासत में प्राप्त करता है, फिर अपने स्रोत फ़ॉर्मेट के विशिष्ट गुण जोड़ता है।

// HTML: resolve relative images/CSS against a base path
var htmlOptions = new HtmlLoadOptions("assets/");
htmlOptions.IsEmbedFonts = true;
using var htmlDoc = new Document("input.html", htmlOptions);

// Markdown: apply custom CSS while rendering to PDF
var mdOptions = new MdLoadOptions();
mdOptions.CssStyles = "body { font-family: sans-serif; }";
using var mdDoc = new Document("input.md", mdOptions);

// Plain text: control the rendered font size
var txtOptions = new TxtLoadOptions();
txtOptions.FontSize = 11;
using var txtDoc = Document.Open("input.txt", txtOptions);

// SVG: let the page size follow the artwork dimensions
var svgOptions = new SvgLoadOptions();
svgOptions.AdjustPageSize = true;
using var svgDoc = new Document("input.svg", svgOptions);

PdfSaveOptions के साथ PDF में सहेजना

PdfSaveOptions PDF के रूप में Document को पुनः लिखते समय फ़ॉन्ट हैंडलिंग और अस्थायी-फ़ाइल स्थान को नियंत्रित करता है। यह साझा SaveOptions बेस से CloseResponse, SaveFullPath, WarningHandler, CacheGlyphs, और SaveFormat को विरासत में प्राप्त करता है।

using var doc = Document.Open("input.pdf");

var pdfOptions = new PdfSaveOptions();
pdfOptions.DefaultFontName = "Arial";
pdfOptions.TempPath = "temp/";

doc.Save("output.pdf", pdfOptions);

HTML और SVG में निर्यात

HtmlSaveOptions और SvgSaveOptions दोनों UnifiedSaveOptions से व्युत्पन्न होते हैं। रूपांतरण गाइड में कवर किए गए इमेज/फ़ॉन्ट/लेआउट नियंत्रणों के अलावा, HtmlSaveOptions आपको दस्तावेज़ फ़्लेवर और पेजिनेशन रणनीति चुनने की भी अनुमति देता है, जबकि SvgSaveOptions पूरी तरह से विरासत में मिले SaveOptions/UnifiedSaveOptions सदस्यों पर निर्भर करता है।

using var doc = Document.Open("input.pdf");

// Fixed-layout HTML5 output, split one file per page
var htmlOptions = new HtmlSaveOptions(HtmlDocumentType.Html5, fixedLayout: true);
htmlOptions.SplitIntoPages = true;
htmlOptions.ImageResolution = 150;
htmlOptions.Title = "Converted Document";
doc.Save("output.html", htmlOptions);

// SVG export configured through the shared SaveOptions members
var svgOptions = new SvgSaveOptions();
svgOptions.SaveFullPath = false;
doc.Save("output.svg", svgOptions);

Document.Convert के साथ एक-चरण रूपांतरण

Document.Convert एक ही स्थैतिक कॉल में स्रोत LoadOptions और गंतव्य SaveOptions को एक साथ स्वीकार करता है, जिससे आप फ़ॉर्मेट्स के बीच रूपांतरण कर सकते हैं बिना मैन्युअल रूप से Document को खोलें, बदलें और नष्ट करें।

var loadOptions = new HtmlLoadOptions();
var saveOptions = new PdfSaveOptions();

Document.Convert("input.html", loadOptions, "output.pdf", saveOptions);

पाठ निष्कर्षण विकल्प

TextExtractionOptions नियंत्रित करता है कि TextAbsorber (और TextDevice) निकाले गए पाठ को कैसे स्वरूपित करता है, यह इस बात से स्वतंत्र है कि निष्कर्षण कौन सा एब्जॉर्बर या डिवाइस क्लास करता है।

using var doc = Document.Open("input.pdf");

var extractionOptions = new TextExtractionOptions(TextFormattingMode.Raw);
extractionOptions.ScaleFactor = 1.0;
extractionOptions.IgnoreResourceFontErrors = true;

var absorber = new TextAbsorber(extractionOptions);
doc.Pages[1].Accept(absorber);

string text = absorber.Text;

OptimizationOptions के साथ आउटपुट का अनुकूलन

OptimizationOptions फ़ाइल आकार कम करने के लिए एक अलग, फ़ॉर्मेट-स्वतंत्र तंत्र है। इसे Document.OptimizeResources के माध्यम से लागू किया जाता है, न कि *SaveOptions क्लास के द्वारा, इसलिए इसे किसी भी सहेजने के पथ के साथ जोड़ा जा सकता है।

using var doc = Document.Open("input.pdf");

var optimizationOptions = new OptimizationOptions();
optimizationOptions.RemoveUnusedObjects = true;
optimizationOptions.CompressObjects = true;
optimizationOptions.SubsetFonts = true;
optimizationOptions.ImageCompressionOptions.CompressImages = true;
optimizationOptions.ImageCompressionOptions.ImageQuality = 80;

doc.OptimizeResources(optimizationOptions);
doc.Save("optimized.pdf");

टिप्स और सर्वोत्तम प्रथाएँ

• हर *LoadOptions और *SaveOptions उपवर्ग WarningHandler/WarningHandlerName को विरासत में लेता है - पुनर्प्राप्त योग्य निदान को कैप्चर करने के लिए दोनों को साथ में सेट करें।
• फ़ॉर्मेट-विशिष्ट *LoadOptions/*SaveOptions इंस्टेंस को पसंद करें, बजाय एक्सटेंशन-आधारित फ़ॉर्मेट अनुमान पर निर्भर रहने के, विशेष रूप से जब फ़ाइल पाथ की बजाय स्ट्रीम के साथ काम कर रहे हों।
• एक बार के रूपांतरण के लिए Document.Convert(srcFileName, loadOptions, dstFileName, saveOptions) का उपयोग करें, बजाय एक Document को मैन्युअल रूप से खोलने और फिर सेव करने के।
• OptimizationOptions *SaveOptions परिवार से स्वतंत्र है - लक्ष्य फ़ॉर्मेट की परवाह किए बिना आउटपुट को संकुचित करने के लिए OptimizeResources को Save से पहले कॉल करें।
• जब समान सेटिंग्स लागू हों, तो कई दस्तावेज़ों में एक ही विकल्प इंस्टेंस को पुनः उपयोग करें, प्रत्येक बार इसे पुनः निर्माण करने के बजाय।

सामान्य समस्याएँ

FAQ

LoadOptions और SaveOptions में क्या अंतर है?

LoadOptions गैर-PDF स्रोत प्रारूप (HTML, Markdown, text, SVG) से दस्तावेज़ को पढ़ने का कॉन्फ़िगरेशन करता है; SaveOptions यह निर्धारित करता है कि एक Document को आउटपुट प्रारूप (PDF, HTML, SVG) में कैसे लिखा जाए। प्रत्येक फ़ॉर्मेट-विशिष्ट विकल्प क्लास ठीक इन दो मूल क्लासों में से एक से व्युत्पन्न होती है।

क्या मूल PDF खोलते समय मुझे LoadOptions निर्धारित करने की आवश्यकता है?

नहीं। Document.Open और Document कंस्ट्रक्टर मूल PDF इनपुट के लिए साधारण फ़ाइल पथ या स्ट्रीम को स्वीकार करते हैं। *LoadOptions उपवर्ग केवल तब आवश्यक होते हैं जब HTML, Markdown, text, या SVG जैसे गैर-PDF स्रोत प्रारूप को आयात किया जाता है।

क्या मैं कई Save कॉल्स में एक ही SaveOptions इंस्टेंस को पुन: उपयोग कर सकता हूँ?

हां। एक विकल्प इंस्टेंस केवल एक साधारण कॉन्फ़िगरेशन ऑब्जेक्ट है; यह प्रति-दस्तावेज़ स्थिति नहीं रखता, इसलिए वही PdfSaveOptions या HtmlSaveOptions इंस्टेंस कई दस्तावेज़ों के लिए Save को पास किया जा सकता है जो समान सेटिंग्स साझा करते हैं।

OptimizationOptions फ़ॉर्मेट-विशिष्ट SaveOptions क्लासों से कैसे अलग है?

OptimizationOptions को Document.OptimizeResources द्वारा उपयोग किया जाता है, जो सहेजने से अलग एक चरण है। यह अप्रयुक्त ऑब्जेक्ट्स/स्ट्रीम्स को हटाता है और छवियों को स्थान पर पुनः संपीड़ित करता है, और इसे किसी भी *SaveOptions उपवर्ग के साथ Save को कॉल करने से पहले लागू किया जा सकता है।

क्या प्रत्येक स्रोत/लक्ष्य फ़ॉर्मेट में दोनों LoadOptions और SaveOptions क्लासें होती हैं?

आवश्यक रूप से सममित नहीं है। उदाहरण के लिए, Markdown और सादा पाठ वर्तमान में आयात के लिए MdLoadOptions/TxtLoadOptions उजागर करते हैं लेकिन कोई मिलते-जुलते *SaveOptions समकक्ष नहीं है, जो यह दर्शाता है कि प्रत्येक स्वरूप रूपांतरण के लिए किस दिशा में समर्थित है।

API Reference सारांश

यह भी देखें

• परिवर्तन और अनुकूलन
• Aspose.PDF for .NET Enterprise Product
• Aspose.PDF for .NET — Enterprise Documentation