Метаданни и утилитетни услуги

Метаданни и утилитетни услуги

Метаданни и утилитетни услуги

Aspose.PDF FOSS for .NET includes utility classes for metadata access, coordinate geometry, image collections, and page-level artifacts. These building blocks support higher-level operations throughout the library.


Метаданни за 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 и X MP използват стандартните префикси в пространството на имената.
  • Rectangle координатите са в PDF потребителски пространствени единици (1/72 инча), с произход от долната лява страна.
  • Използване на: Matrix за аффини преобразувания: трансляция, ротация, скалиране и резене.
  • XmpValue Поддържа типове на струни, цели числа, двойно число, дата и масиви.
  • Артефактите са структурни елементи те не се появяват в преминаванията на дърветата за достъпност.

Общи проблеми

ИзданиеПричина за товаРемонтиране
Не е намерен ключ за метаданни.Ключът използва различен префикс на пространство за имена.Избройте всички ключове първо, за да намерите правилната префикс.
Координатите на правоъгълника изглеждат обърнати.PDF произходът е от долната лява страна, а не от горната лева.Съответно коригирайте координатите на Y.
Снимка е празна.Изображенията са във формата XObjects, не директно ресурси на страницата.Проверка. XFormCollection за ресурсите на вградени изображения

FAQ

Как да прочета заглавието на документа от метаданните?

Достъп до информация doc.Metadata["dc:title"] за имота Dublin Core.

Мога ли да добавя артефакт с водна марка?

Да, да създадем… Artifact с тип Watermark и да го добавим на страницата.

Каква координатна система използва “Правоъгълникът”?

PDF потребителско пространство: произход в долната лява част, единици от 1/72 инч. Стандартна страница на US Letter е 612 х 792 единица.


Снимка на API референтна информация

Клас / методОписание на състоянието
MetadataXMP речник на метаданните за документа
XmpValueТип обертвач за стойности на свойствата XMP
RectangleОпределяща кутия, подредена към оста (llx, lly, urx и ury)
Rectangle.ContainsPointПробване дали точка се намира в рамките на правоъгълника
Matrix2D affine transformation matrix
Matrix.TranslateСъздаване на матрица за превод
PageCollectionПоръчано събиране на страници с индексиране, основаващо се на 1
XImageCollectionИзточник на изображения в страница
XImageЕднообразно вградено изображение с цветно разпознаване на типа
ArtifactЕлемент на страница, който не съдържа (водолейка, заглавие, краища)
Artifact.SetPageNumberReplacementStringШаблон за артефакти с номера на страници

Вижте също:

 Български