Metapodaci i alati

Метаподаци и алати

Aspose.PDF FOSS for .NET uključuje pomoćne klase za pristup metapodacima, koordinatnu geometriju, kolekcije slika i artefakte na nivou stranice. Ovi gradivni blokovi podržavaju operacije višeg nivoa širom biblioteke.

XMP metapodaci

Metadata na dokumentu pruža pristup XMP metapodatkovom toku. Čitajte i pišite standardna ili prilagođena XMP svojstva.

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");

Koordinatna geometrija

Rectangle i Matrix se koriste širom API-ja za pozicioniranje i transformaciju.

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);

Operacije kolekcije stranica

PageCollection podržava indeksiranje, iteraciju i prihvatanje visitor‑pattern.

using var doc = Document.Open(pdfBytes);

for (int i = 1; i <= doc.Pages.Count; i++)
{
    var page = doc.Pages[i];
}

Колекције слика

XImageCollection upravlja slikama ugrađenim u resurse stranice. XImage pruža metode za ispitivanje svojstava slike.

var images = doc.Pages[1].Resources.Images;
foreach (var img in images)
{
    Console.WriteLine($"Color type: {img.GetColorType()}");
}

Artefakti

Artifact predstavlja elemente koji nisu sadržaj, poput vodeni žigova, zaglavlja i podnožja. Koristite artefakte za numerisanje stranica i dekorativne elemente.

var artifact = new Artifact(ArtifactType.Watermark);
artifact.SetPageNumberReplacementString("Page {0}");

Saveti i najbolje prakse

• XMP metapodatkovni ključevi prate Dublin Core i XMP specifikacije — koristite standardne prefikse prostora imena.
• Rectangle koordinate su u PDF jedinicama korisničkog prostora (1/72 inča), sa poreklom u donjem levom uglu.
• Koristite Matrix za afinne transformacije: translaciju, rotaciju, skaliranje i nagnutost.
• XmpValue podržava tipove string, integer, double, date i array.
• Artefakti su strukturni elementi — ne pojavljuju se u pretragama stabla pristupačnosti.

Česti problemi

ČPP

Kako da pročitam naslov dokumenta iz metapodataka?

Pristup doc.Metadata["dc:title"] za svojstvo naslova Dublin Core.

Могу ли да додам артефакт воденог жига?

Da. Kreirajte Artifact tipa Watermark i dodajte ga na stranicu.

Koji koordinatni sistem koristi Rectangle?

PDF korisnički prostor: poreklo u donjem levom uglu, jedinice su 1/72 inča. Standardna US Letter stranica ima 612 × 792 jedinica.

Sažetak API referencije

Види такође

• Aspose.PDF for .NET Enterprise proizvod