Innholdsoperasjoner

Innholdsoperasjoner

PDF‑sider gjengis av en sekvens av operatorer lagret i en innholdstrøm.
Aspose.PDF FOSS for .NET eksponerer disse operatorene gjennom OperatorCollection
på hver Page, og gir ContentStreamBuilder for å konstruere nytt
innhold programmatisk.

Lese innholdsstrøm-operatorer

Hver Page har en Contents‑egenskap som returnerer en OperatorCollection. Iterer den for å inspisere hver operator.

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

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

Bygge innholdstrømmer

ContentStreamBuilder gir et flytende API for å konstruere innholdsstrøm-operatorsekvenser inkludert grafikk-tilstandshåndtering, baneoppretting, tekstutskrift og fargeinnstillinger.

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

Grafisk tilstand

GraphicsState sporer den nåværende transformasjonsmatrisen, teksttilstanden og fargeverdiene mens operatorer utføres. Nøkkeloperasjoner:

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

Fargeoperatorer

SetColor og SetColorStroke setter henholdsvis fyll- og strekfarger. De godtar RGB-, CMYK- eller gråskala‑komponenter.

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

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

Tekstoperatorer

ShowText gjengir en tekststreng på den nåværende tekstposisjonen ved å bruke den nåværende skrifttypen og størrelsen fra grafikktilstanden.

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

SetTextMatrix posisjonerer tekst ved å definere en transformasjonsmatrise for tekstrom.

Utvidet grafisk tilstand

ExtGState kontrollerer avanserte gjengivelsesegenskaper som fyll og strek alfa (gjennomsiktighet) og blandingsmodus.

Tips og beste praksis

• Par alltid SaveState / RestoreState (eller q / Q-operatorer) for å unngå å korrumpere grafikktilstandsstakken.
• Bruk ContentStreamBuilder for nytt innhold i stedet for å manuelt konstruere operatorobjekter.
• Undersøk OperatorCollection skrivebeskyttet før du endrer den — uventede operatorkombinasjoner kan forårsake gjengivelsesproblemer.
• Fargeoperatorer må samsvare med det gjeldende fargerommet (RGB, CMYK eller gråskala).
• Bruk SetAdvancedColor for mønster- og ICC‑baserte fargerom.

Vanlige problemer

Ofte stilte spørsmål

Hva er en PDF-innholdstrøm?

En innholdstrøm er en sekvens av operatorer som beskriver hvordan man gjengir en side — tegner baner, plasserer tekst, setter farger og håndterer grafikktilstand.

Kan jeg legge til nytt innhold på en eksisterende side?

Ja. Åpne page.Contents og legg til nye operatorer, eller bruk ContentStreamBuilder for å konstruere en sekvens og legge den til.

Hvordan gjør jeg teksten gjennomsiktig?

Bruk ExtGState for å sette fyll‑alfa (ca) til en verdi mellom 0 (fullt gjennomsiktig) og 1 (fullt ugjennomsiktig).

API-referansesammendrag

Se også

• Aspose.PDF for .NET Enterprise-produkt