Metadáta a nástroje

Metadáta a nástroje

Aspose.PDF FOSS for .NET obsahuje pomocné triedy pre prístup k metadátam, koordinátovú geometriu, kolekcie obrázkov a artefakty na úrovni stránok. Tieto stavebné bloky podporujú operácie vyššej úrovne v celej knižnici.

XMP metadáta

Metadata v dokumente poskytuje prístup k XMP metadátovému prúdu. Čítajte a zapisujte štandardné alebo vlastné XMP vlastnosti.

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

Koordinátová geometria

Rectangle a Matrix sa používajú v celom API na umiestňovanie a transformáciu.

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

Operácie s kolekciou stránok

PageCollection podporuje indexovanie, iteráciu a akceptovanie vzoru návštevníka.

using var doc = Document.Open(pdfBytes);

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

Zbierky obrázkov

XImageCollection spravuje obrázky vložené do zdrojov stránky. XImage poskytuje metódy na kontrolu vlastností obrázkov.

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

Artefakty

Artifact predstavuje neobsahové prvky, ako sú vodoznaky, hlavičky a pätičky. Používajte artefakty pre číslovanie strán a dekoratívne prvky.

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

Tipy a osvedčené postupy

• Kľúče metadát XMP nasledujú špecifikácie Dublin Core a XMP — používajte štandardné predpony menného priestoru.
• Rectangle súradnice sú v jednotkách používateľského priestoru PDF (1/72 palca) s pôvodom vľavo dole.
• Použite Matrix pre afinné transformácie: posunutie, rotáciu, škálovanie a skosenie.
• XmpValue podporuje typy string, integer, double, date a array.
• Artefakty sú štrukturálne prvky — neobjavujú sa v prechodoch stromom prístupnosti.

Bežné problémy

Často kladené otázky

Ako načítam názov dokumentu z metadát?

Prístup k doc.Metadata["dc:title"] pre vlastnosť názvu Dublin Core.

Môžem pridať vodotlačový artefakt?

Áno. Vytvorte Artifact s typom Watermark a pridajte ho na stránku.

Aký súradnicový systém používa Rectangle?

PDF používateľský priestor: pôvod v ľavom dolnom rohu, jednotky 1/72 palca. Štandardná stránka US Letter má rozmery 612 x 792 jednotiek.

Zhrnutie referencie API

Pozri tiež

• Aspose.PDF pre .NET Enterprise Product