Inhaltsoperationen

Inhaltsoperationen

PDF-Seiten werden durch eine Sequenz von Operatoren gerendert, die in einem Inhaltsstrom gespeichert sind.
Aspose.PDF FOSS for .NET stellt diese Operatoren über OperatorCollection
auf jedem Page bereit und bietet ContentStreamBuilder zum programmatischen Erstellen neuer
Inhalte.

Lesen von Content-Stream-Operatoren

Jedes Page hat eine Contents‑Eigenschaft, die ein OperatorCollection zurückgibt. Iterieren Sie es, um jeden Operator zu inspizieren.

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

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

Erstellen von Inhalts‑Streams

ContentStreamBuilder bietet eine fluent API zur Erstellung von Content-Stream-Operatorsequenzen, einschließlich Grafikzustandsverwaltung, Pfadkonstruktion, Textausgabe und Farbeinstellungen.

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

Grafikstatus

GraphicsState verfolgt die aktuelle Transformationsmatrix, den Textzustand und die Farbwerte, während Operatoren ausgeführt werden. Schlüsseloperationen:

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

Farboperatoren

SetColor und SetColorStroke setzen die Füll‑ bzw. Kontur‑Farben. Sie akzeptieren RGB‑, CMYK‑ oder Graustufen‑Komponenten.

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

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

Textoperatoren

ShowText rendert eine Textzeichenfolge an der aktuellen Textposition unter Verwendung der aktuellen Schriftart und Größe aus dem Grafikstatus.

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

SetTextMatrix positioniert Text, indem eine Transformationsmatrix für den Textbereich definiert wird.

Erweiterter Grafikzustand

ExtGState steuert erweiterte Rendering‑Eigenschaften wie Füll‑ und Strich‑Alpha (Transparenz) und Mischmodus.

Tipps und bewährte Verfahren

• Verwenden Sie stets SaveState / RestoreState (oder q / Q‑Operatoren), um eine Beschädigung des Grafik‑Zustands‑Stacks zu vermeiden.
• Verwenden Sie ContentStreamBuilder für neue Inhalte, anstatt Operator‑Objekte manuell zu erstellen.
• Prüfen Sie OperatorCollection schreibgeschützt, bevor Sie Änderungen vornehmen – unerwartete Operator‑Sequenzen können Rendering‑Probleme verursachen.
• Farboperatoren müssen dem aktuellen Farbraum entsprechen (RGB, CMYK oder Graustufen).
• Verwenden Sie SetAdvancedColor für Muster‑ und ICC‑basierte Farbräume.

Häufige Probleme

FAQ

Was ist ein PDF‑Inhaltsstrom?

Ein Inhaltsstrom ist eine Sequenz von Operatoren, die beschreiben, wie man eine Seite rendert — Pfade zeichnen, Text platzieren, Farben festlegen und den Grafikzustand verwalten.

Kann ich einer bestehenden Seite neuen Inhalt hinzufügen?

Ja. Greifen Sie auf page.Contents zu und fügen Sie neue Operatoren hinzu, oder verwenden Sie ContentStreamBuilder, um eine Sequenz zu erstellen und anzuhängen.

Wie mache ich Text transparent?

Verwenden Sie ExtGState, um den Füll‑Alpha (ca) auf einen Wert zwischen 0 (vollständig transparent) und 1 (vollständig undurchsichtig) zu setzen.

API-Referenzübersicht

Siehe auch

• Aspose.PDF für .NET Enterprise-Produkt