Operacije sadržaja

Operacije sadržaja

PDF stranice se renderuju sekvencom operatora pohranjenih u sadržajnom toku.
Aspose.PDF FOSS for .NET izlaže ove operatore kroz OperatorCollection
na svakom Page, i pruža ContentStreamBuilder za konstruisanje novog
sadržaja programatski.

Čitanje operatora sadržajnog toka

Svaki Page ima Contents svojstvo koje vraća OperatorCollection. Iterirajte kroz njega da pregledate svakog operatora.

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

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

Izgradnja tokova sadržaja

ContentStreamBuilder pruža fluent API za konstruisanje sekvenci operatora content‑stream, uključujući upravljanje grafičkim stanjem, konstrukciju putanja, ispis teksta i podešavanja boja.

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

Grafičko stanje

GraphicsState prati trenutnu matricu transformacije, stanje teksta i vrednosti boja dok se operatori izvršavaju. Ključne operacije:

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

Operatori boje

SetColor i SetColorStroke postavljaju boje popunjavanja i konture respektivno. Oni prihvataju RGB, CMYK ili komponente u sivoj skali.

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

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

Operateri teksta

ShowText renderuje tekstualni niz na trenutnoj tekstualnoj poziciji koristeći trenutni font i veličinu iz grafičkog stanja.

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

SetTextMatrix pozicionira tekst definisanjem transformacione matrice za tekst prostor.

Prošireno grafičko stanje

ExtGState контролише напредна својства рендеровања као што су fill и stroke алфа (прозирност) и blend mode.

Saveti i najbolje prakse

• Uvek uparite SaveState / RestoreState (ili q / Q operatore) kako biste izbegli oštećenje steka grafičkog stanja.
• Koristite ContentStreamBuilder za novi sadržaj umesto ručnog konstruisanja objekata operatora.
• Pregledajte OperatorCollection samo za čitanje pre izmene — neočekivane sekvence operatora mogu izazvati probleme u renderovanju.
• Operatori boje moraju odgovarati trenutnom prostoru boja (RGB, CMYK ili grayscale).
• Koristite SetAdvancedColor za obrasce i ICC‑bazirane prostore boja.

Česti problemi

ČPP

Šta je PDF sadržajni tok?

Tok sadržaja je niz operatora koji opisuju kako da se prikaže stranica — crtanje putanja, postavljanje teksta, podešavanje boja i upravljanje grafičkim stanjem.

Могу ли да додам нови садржај на постојећу страницу?

Da. Pristupite page.Contents i dodajte nove operatore, ili koristite
ContentStreamBuilder da konstrušete sekvencu i dodate je.

Kako da učinim tekst transparentnim?

Koristite ExtGState da postavite alfa vrednost popunjavanja (ca) na vrednost između 0 (potpuno prozirno) i 1 (potpuno neprovidno).

Sažetak API reference

Види такође

• Aspose.PDF for .NET Enterprise Product