Inhoudsoperaties

Inhoudsoperaties

PDF-pagina’s worden gerenderd door een reeks operators die zijn opgeslagen in een contentstream.
Aspose.PDF FOSS for .NET maakt deze operators beschikbaar via OperatorCollection
op elke Page, en biedt ContentStreamBuilder voor het programmatisch construeren van nieuwe
content.

Lezen van content-stream operatoren

Elke Page heeft een Contents eigenschap die een OperatorCollection retourneert. Itereer erdoor om elke operator te inspecteren.

using var doc = Document.Open(pdfBytes);
var page = doc.Pages[1];

foreach (var op in page.Contents)
{
    Console.WriteLine(op.ToString());
}

Inhoudsstromen bouwen

ContentStreamBuilder biedt een fluent API voor het construeren van content‑stream operatorreeksen, inclusief graphics‑state management, path construction, text output en color settings.

var builder = new ContentStreamBuilder();
builder.SaveState();
builder.SetFillColor(1.0, 0.0, 0.0);  // Red fill
builder.SetMatrix(1, 0, 0, 1, 72, 700); // Translate
// ... add drawing or text operators
builder.RestoreState();

Grafische status

GraphicsState houdt de huidige transformatie‑matrix, tekststatus en kleurwaarden bij terwijl operatoren worden uitgevoerd. Belangrijke bewerkingen:

var gs = new GraphicsState();
gs.Save();
gs.ConcatMatrix(new Matrix(1, 0, 0, 1, 100, 200));
gs.Restore();

Kleuroperatoren

SetColor en SetColorStroke stellen respectievelijk vul‑ en lijnkleuren in. Ze accepteren RGB‑, CMYK‑ of grijstintencomponenten.

// RGB fill color (blue)
var fill = new SetColor(0, 0, 1);

// RGB stroke color (red)
var stroke = new SetColorStroke(1, 0, 0);

Tekstoperatoren

ShowText rendert een tekststring op de huidige tekstpositie met het huidige lettertype en de grootte uit de grafische status.

var textOp = new ShowText("Hello, PDF!");

SetTextMatrix positioneert tekst door een transformatie‑matrix voor de tekstruimte te definiëren.

Uitgebreide grafische toestand

ExtGState regelt geavanceerde render‑eigenschappen zoals vul‑ en lijnalfa (transparantie) en mengmodus

Tips en Best Practices

• Koppel altijd SaveState / RestoreState (of q / Q operatoren) om te voorkomen dat de grafische statusstack wordt beschadigd.
• Gebruik ContentStreamBuilder voor nieuwe inhoud in plaats van handmatig operatorobjecten te construeren.
• Inspecteer OperatorCollection alleen-lezen voordat u wijzigt — onverwachte operatorreeksen kunnen renderingsproblemen veroorzaken.
• Kleuroperatoren moeten overeenkomen met de huidige kleurruimte (RGB, CMYK of grijswaarden).
• Gebruik SetAdvancedColor voor patroon- en ICC‑gebaseerde kleurruimtes.

Veelvoorkomende problemen

Veelgestelde vragen

Wat is een PDF-inhoudsstroom?

Een contentstream is een reeks operatoren die beschrijven hoe een pagina moet worden gerenderd — paden tekenen, tekst plaatsen, kleuren instellen en de grafische status beheren.

Kan ik nieuwe inhoud toevoegen aan een bestaande pagina?

Ja. Open page.Contents en voeg nieuwe operatoren toe, of gebruik
ContentStreamBuilder om een reeks te construeren en deze toe te voegen.

Hoe maak ik tekst transparant?

Gebruik ExtGState om de vulalfa (ca) in te stellen op een waarde tussen 0 (volledig transparant) en 1 (volledig ondoorzichtig).

API-referentieoverzicht

Zie ook

• Aspose.PDF for .NET Enterprise Product