Operaciones de contenido

Operaciones de contenido

Las páginas PDF se renderizan mediante una secuencia de operadores almacenados en un flujo de contenido.
Aspose.PDF FOSS for .NET expone estos operadores a través de OperatorCollection
en cada Page, y proporciona ContentStreamBuilder para construir nuevo
contenido de forma programática.

Lectura de operadores de flujo de contenido

Cada Page tiene una propiedad Contents que devuelve un OperatorCollection. Itera sobre ella para inspeccionar cada operador.

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

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

Construyendo flujos de contenido

ContentStreamBuilder proporciona una API fluida para construir secuencias de operadores de flujo de contenido que incluyen la gestión del estado gráfico, la construcción de rutas, la salida de texto y la configuración de colores.

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

Estado gráfico

GraphicsState rastrea la matriz de transformación actual, el estado del texto y los valores de color mientras se ejecutan los operadores. Operaciones clave:

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

Operadores de color

SetColor y SetColorStroke establecen los colores de relleno y trazo respectivamente. Aceptan componentes RGB, CMYK o en escala de grises.

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

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

Operadores de texto

ShowText representa una cadena de texto en la posición de texto actual usando la fuente y el tamaño actuales del estado gráfico.

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

SetTextMatrix posiciona texto definiendo una matriz de transformación para el espacio de texto.

Estado gráfico extendido

ExtGState controla propiedades avanzadas de renderizado como el relleno y el trazo alfa (transparencia) y el modo de fusión.

Consejos y mejores prácticas

• Siempre empareje SaveState / RestoreState (o los operadores q / Q) para evitar corromper la pila de estado gráfico.
• Utilice ContentStreamBuilder para contenido nuevo en lugar de construir manualmente objetos de operador.
• Inspeccione OperatorCollection en modo solo lectura antes de modificarlo — secuencias de operadores inesperadas pueden causar problemas de renderizado.
• Los operadores de color deben coincidir con el espacio de color actual (RGB, CMYK o escala de grises).
• Utilice SetAdvancedColor para patrones y espacios de color basados en ICC.

Problemas comunes

Preguntas frecuentes

¿Qué es una secuencia de contenido PDF?

Un flujo de contenido es una secuencia de operadores que describen cómo renderizar una página — dibujando rutas, colocando texto, estableciendo colores y gestionando el estado gráfico.

¿Puedo agregar contenido nuevo a una página existente?

Sí. Acceda page.Contents y añada nuevos operadores, o use ContentStreamBuilder para construir una secuencia y añadirla.

¿Cómo hago que el texto sea transparente?

Use ExtGState para establecer el alfa de relleno (ca) a un valor entre 0 (totalmente transparente) y 1 (totalmente opaco).

Resumen de referencia de API

Ver también

• Aspose.PDF para .NET Enterprise Product