मेटाडेटा और उपयोगिताएँ
मेटाडेटा और उपयोगिताएँ
Aspose.PDF FOSS for .NET में मेटाडेटा एक्सेस, समन्वय ज्यामिति, इमेज कलेक्शन, और पेज-लेवल आर्टिफैक्ट्स के लिए यूटिलिटी क्लासेज शामिल हैं। ये बिल्डिंग ब्लॉक्स पूरी लाइब्रेरी में उच्च-स्तरीय ऑपरेशन्स को सपोर्ट करते हैं।
XMP मेटाडेटा
Metadata एक दस्तावेज़ पर XMP मेटाडेटा स्ट्रीम तक पहुंच प्रदान करता है। मानक या कस्टम XMP प्रॉपर्टीज़ को पढ़ें और लिखें।
using var doc = Document.Open(pdfBytes);
// Read existing metadata
foreach (var entry in doc.Metadata)
{
Console.WriteLine($"{entry.Key}: {entry.Value}");
}
// Set a custom property
doc.Metadata.Add("xmp:CustomProp", new XmpValue("custom value"));
doc.Save("with-metadata.pdf");समन्वय ज्यामिति
Rectangle और Matrix का उपयोग API में स्थितिकरण और रूपांतरण के लिए व्यापक रूप से किया जाता है।
var rect = new Rectangle(72, 700, 300, 720);
bool inside = rect.ContainsPoint(150, 710);
// Transformation matrix (translate by 100, 200)
var matrix = new Matrix(1, 0, 0, 1, 100, 200);पृष्ठ संग्रह संचालन
PageCollection अनुक्रमण, पुनरावृत्ति, और विज़िटर‑पैटर्न स्वीकृति का समर्थन करता है।
using var doc = Document.Open(pdfBytes);
for (int i = 1; i <= doc.Pages.Count; i++)
{
var page = doc.Pages[i];
}छवि संग्रह
XImageCollection पृष्ठ के संसाधनों में एम्बेड की गई छवियों का प्रबंधन करता है। XImage छवि गुणों का निरीक्षण करने के लिए विधियाँ प्रदान करता है।
var images = doc.Pages[1].Resources.Images;
foreach (var img in images)
{
Console.WriteLine($"Color type: {img.GetColorType()}");
}आर्टिफैक्ट्स
Artifact गैर‑सामग्री तत्वों जैसे वॉटरमार्क, हेडर और फुटर को दर्शाता है। पृष्ठ क्रमांक और सजावटी तत्वों के लिए आर्टिफैक्ट्स का उपयोग करें।
var artifact = new Artifact(ArtifactType.Watermark);
artifact.SetPageNumberReplacementString("Page {0}");टिप्स और सर्वोत्तम प्रथाएँ
- XMP मेटाडेटा कुंजियाँ Dublin Core और XMP विशिष्टताओं का पालन करती हैं — मानक नेमस्पेस प्रीफ़िक्स का उपयोग करें।
Rectangleनिर्देशांक PDF उपयोगकर्ता-स्थान इकाइयों (1/72 इंच) में हैं, मूल बिंदु नीचे-बाएँ पर है।- एफ़ाइन ट्रांसफ़ॉर्मेशन के लिए
Matrixका उपयोग करें: अनुवाद, घूर्णन, स्केलिंग, और शीयरिंग। XmpValueस्ट्रिंग, इंटीजर, डबल, डेट, और एरे प्रकारों का समर्थन करता है।- आर्टिफैक्ट संरचनात्मक तत्व हैं — वे एक्सेसिबिलिटी ट्री ट्रैवर्सल में प्रकट नहीं होते।
सामान्य समस्याएँ
| समस्या | कारण | समाधान |
|---|---|---|
| मेटाडाटा कुंजी नहीं मिली | कुंजी अलग नेमस्पेस प्रीफ़िक्स का उपयोग करती है | सही प्रीफ़िक्स खोजने के लिए पहले सभी कुंजियों की सूची बनाएं |
| आयत के निर्देशांक उल्टे लगते हैं | PDF मूल बॉटम-लेफ़्ट है, टॉप-लेफ़्ट नहीं | Y निर्देशांक को तदनुसार समायोजित करें |
| इमेज संग्रह खाली है | इमेजेज फॉर्म XObjects में हैं, सीधे पेज रिसोर्सेज में नहीं | नेस्टेड इमेज रिसोर्सेज के लिए XFormCollection देखें |
अक्सर पूछे जाने वाले प्रश्न
मैं मेटाडेटा से दस्तावेज़ शीर्षक को कैसे पढ़ूँ?
डब्लिन कोर शीर्षक प्रॉपर्टी के लिए doc.Metadata["dc:title"] एक्सेस करें।
क्या मैं वॉटरमार्क आर्टिफैक्ट जोड़ सकता हूँ?
हाँ। Artifact को प्रकार Watermark के साथ बनाएं और इसे पृष्ठ में जोड़ें।
Rectangle किस निर्देशांक प्रणाली का उपयोग करता है?
PDF उपयोगकर्ता-स्थान: उत्पत्ति नीचे-बाएँ पर, इकाइयाँ 1/72 इंच की। एक मानक US Letter पृष्ठ 612 x 792 इकाइयों का होता है।
API रेफ़रेंस सारांश
| Class / Method | Description |
|---|---|
Metadata | दस्तावेज़ पर XMP मेटाडेटा शब्दकोश |
XmpValue | XMP प्रॉपर्टी मानों के लिए टाइप्ड रैपर |
Rectangle | एक्सिस-एलाइन्ड बाउंडिंग बॉक्स (llx, lly, urx, ury) |
Rectangle.ContainsPoint | जाँचें कि कोई बिंदु आयत के भीतर स्थित है या नहीं |
Matrix | 2D अफाइन ट्रांसफ़ॉर्मेशन मैट्रिक्स |
Matrix.Translate | एक ट्रांसलेशन मैट्रिक्स बनाएं |
PageCollection | 1-आधारित इंडेक्सिंग के साथ क्रमबद्ध पेज संग्रह |
XImageCollection | पेज पर इमेज संसाधन |
XImage | रंग-प्रकार पहचान के साथ एकल एम्बेडेड इमेज |
Artifact | गैर-सामग्री पेज तत्व (वॉटरमार्क, हेडर, फुटर) |
Artifact.SetPageNumberReplacementString | पेज-नंबर कलाकृतियों के लिए टेम्पलेट |