Operațiuni de conținut

Operațiuni de conținut

Paginile PDF sunt redate printr-o secvență de operatori stocați într-un flux de conținut.
Aspose.PDF FOSS for .NET expune acești operatori prin OperatorCollection
pe fiecare Page și oferă ContentStreamBuilder pentru construirea de conținut nou programatic.

Citirea operatorilor de flux de conținut

Fiecare Page are o proprietate Contents care returnează un OperatorCollection. Iteraţi‑l pentru a inspecta fiecare operator.

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

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

Construirea fluxurilor de conținut

ContentStreamBuilder oferă un API fluent pentru construirea secvențelor de operatori ai fluxului de conținut, inclusiv gestionarea stării grafice, construcția de căi, ieșirea de text și setările de culoare.

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

Stare grafică

GraphicsState urmărește matricea de transformare curentă, starea textului și valorile de culoare pe măsură ce operatorii sunt executați. Operații cheie:

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

Operatori de culoare

SetColor și SetColorStroke setează culorile de umplere și contur, respectiv. Ele acceptă componente RGB, CMYK sau în tonuri de gri.

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

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

Operatori de text

ShowText redă un șir de text la poziția curentă a textului utilizând fontul și dimensiunea curente din starea grafică.

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

SetTextMatrix poziționează textul prin definirea unei matrici de transformare pentru spațiul de text.

Stare grafică extinsă

ExtGState controlează proprietăți avansate de redare, cum ar fi fill și stroke alpha (transparență) și modul de amestecare.

Sfaturi și cele mai bune practici

• Întotdeauna asociați SaveState / RestoreState (sau operatorii q / Q) pentru a evita coruperea stivei stării grafice.
• Utilizați ContentStreamBuilder pentru conținut nou în loc să construiți manual obiecte operator.
• Inspectați OperatorCollection în mod read‑only înainte de a modifica — secvențele de operatori neașteptate pot provoca probleme de redare.
• Operatorii de culoare trebuie să corespundă spațiului de culoare curent (RGB, CMYK sau tonuri de gri).
• Utilizați SetAdvancedColor pentru spații de culoare de tip model și bazate pe ICC.

Probleme comune

Întrebări frecvente

Ce este un flux de conținut PDF?

Un flux de conținut este o secvență de operatori care descriu cum să se redea o pagină — trasarea căilor, plasarea textului, setarea culorilor și gestionarea stării grafice.

Pot adăuga conținut nou la o pagină existentă?

Da. Accesați page.Contents și adăugați operatori noi, sau folosiți
ContentStreamBuilder pentru a construi o secvență și a o adăuga.

Cum pot face textul transparent?

Utilizați ExtGState pentru a seta alfa de umplere (ca) la o valoare între 0 (complet transparent) și 1 (complet opac).

Rezumat al Referinței API

Vezi și

• Aspose.PDF pentru .NET Produs Enterprise