Trabajar con degradado en PostScript | .NETO

Agregar degradado en documento PS

En este artículo, consideramos las formas en que se puede utilizar un degradado en documentos PS.

El degradado es una transición suave de un color a otro. Se utiliza para hacer que los dibujos dibujados sean más realistas. Como el degradado es un tipo de pintura, se espera que en .NET se implemente como una subclase de System.Drawing.Brush. En realidad, la plataforma .NET tiene dos de estos pinceles:

• Sistema.Dibujo.LinearGradientBrush
• Sistema.Drawing.PathGradientBrush

Para configurar la pintura o un trazo en PsDocument debemos pasar un objeto de la clase System.Drawing.Brush para una pintura y un objeto de System.Drawing.Pen para aplicar un trazo. métodos respectivos. La biblioteca Aspose.Page para .NET procesa todas las subclases de System.Drawing.Brush que ofrece la plataforma .NET. Estos son System.Drawing.SolidBrush, System.Drawing.TextureBrush, System.Drawing.LinearGradientBrush, System.Drawing.PathGradientBrush y *System.Drawing.HatchBrush *. La clase System.Drawing.Pen no se puede ampliar porque está sellada, pero contiene System.Drawing.Brush como propiedad y, por lo tanto, la biblioteca Aspose.Page para .NET también puede usar un conjunto completo de pinceles también para dibujar líneas y delinear formas y texto.

Para pintar objetos gráficos con un degradado en la biblioteca Aspose.Page para .NET es necesario crear System.Drawing.LinearGradientBrush o System.Drawing.PathGradientBrush y pasarlo a SetPaint () o uno de los métodos FillText() o FillAndStrokeText() que aceptan System.Drawing.Brush como parámetro.

Para delinear objetos gráficos con un degradado en Aspose.Page para la biblioteca .NET, alguien debe crear System.Drawing.LinearGradientBrush o System.Drawing.PathGradientBrush, luego crear System.Drawing. Rotula con este pincel y, finalmente, pásalo a SetStroke() o a uno de los métodos OutlineText() o FillAndStrokeText() que acepte *System.Drawing.Pen. * como parámetro.

En el siguiente ejemplo, demostramos cómo rellenar una forma y un texto y delinear el texto con un degradado.

Un algoritmo para pintar objetos gráficos con un degradado en un nuevo documento PS incluye los siguientes pasos:

1. Cree una secuencia de salida para el archivo PS resultante.
2. Cree PsSaveOptions.
3. Cree PsDocument con el flujo de salida ya creado y guarde las opciones.
4. Cree la ruta gráfica o la fuente necesaria según el objeto que vayamos a rellenar o delinear.
5. Cree un objeto de System.Drawing.LinearGradientBrush o System.Drawing.PathGradientBrush dependiendo de la forma deseada de un degradado.
6. Establezca la transformación necesaria en este pincel.
7. Establezca el pincel de degradado como pintura actual en PsDocument.
8. Rellene la ruta de los gráficos con la pintura actual o rellene un texto. Si utilizamos uno de los métodos para rellenar el texto que acepta System.Drawing.Brush como parámetro, se puede ignorar el punto anterior.
9. Cierra la página.
10. Guarde el documento.

Si necesitamos trazar (delinear) objetos gráficos con un degradado en lugar de los últimos 4 puntos, lo siguiente será:8. Cree el objeto System.Drawing.Pen con el pincel de degradado.

9. Establezca este lápiz como trazo actual en PsDocument.

10. Delinee la ruta de los gráficos con el trazo actual o delinee el texto. Si utilizamos uno de los métodos para delinear el texto que acepta System.Drawing.Pen como parámetro, se puede ignorar el punto anterior.

11. Cierra la página.

12. Guarde el documento.
    

Ofrecemos 5 fragmentos de código que demuestran el uso de diferentes gradientes.

En este fragmento de código creamos un degradado lineal horizontal a partir de dos colores, rellenamos un rectángulo, rellenamos un texto y delineamos un texto con este degradado.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "HorizontalGradient_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

    float offsetX = 200;
    float offsetY = 100;
    float width = 200;
    float height = 100;

    //Create a graphics path from the first rectangle
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(new RectangleF(offsetX, offsetY, width, height));

    //Create linear gradient brush with the rectangle as bounds, start and end colors
    LinearGradientBrush brush = new LinearGradientBrush(new RectangleF(0, 0, width, height), Color.FromArgb(150, 0, 0, 0),
        Color.FromArgb(50, 40, 128, 70), 0f);
    //Create a transform for the brush. X and Y scale component must be equal to the width and the height of the rectangle respectively.
    //Translation components are offsets of the rectangle
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Set  the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

    //Fill the rectangle
    document.Fill(path);

    //Fill the text with the gradient
    Font font = new Font("Arial", 96, FontStyle.Bold);
    document.FillAndStrokeText("ABC", font, 200, 300, brush, new Pen(new SolidBrush(Color.Black), 2));

		//Set current stroke
		document.SetStroke(brush, 5);
    //Outline text with the gradient
    document.OutlineText("ABC", font, 200, 400);

    //Close current page
    document.ClosePage();

    //Save the document
    document.Save();
}

Para Linux, MacOS y otros sistemas operativos distintos de Windows, ofrecemos utilizar nuestro paquete Nuget Aspose.Page.Drawing. Utiliza el backend Aspose.Drawing en lugar de la biblioteca del sistema System.Drawing.

Así que importe el espacio de nombres Aspose.Page.Drawing en lugar de System.Drawing. En los fragmentos de código anteriores y siguientes se utilizará Aspose.Page.Drawing.RectangleF en lugar de System.Drawing.RectangleF, se utilizará Aspose.Page.Drawing.Drawing2D.GraphicsPath en lugar de System.Drawing.Drawing2D.GraphicsPath y así sucesivamente. Nuestros ejemplos de código en GitHub contienen todas las sustituciones necesarias.

El resultado de ejecutar este código aparece como

En este fragmento de código creamos un degradado lineal vertical a partir de 5 colores y rellenamos un rectángulo con este degradado.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "VerticalGradient_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

    float offsetX = 200;
    float offsetY = 100;
    float width = 200;
    float height = 100;

    //Create graphics path from the first rectangle
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(new RectangleF(offsetX, offsetY, width, height));

    //Create an array of interpolation colors
    Color[] colors = { Color.Red, Color.Green, Color.Blue, Color.Orange, Color.DarkOliveGreen };
    float[] positions = { 0.0f, 0.1873f, 0.492f, 0.734f, 1.0f };
    ColorBlend colorBlend = new ColorBlend();
    colorBlend.Colors = colors;
    colorBlend.Positions = positions;

    //Create linear gradient brush with the rectangle as bounds, start and end colors
    LinearGradientBrush brush = new LinearGradientBrush(new RectangleF(0, 0, width, height), Color.Beige, Color.DodgerBlue, 0f);
    //Set interpolation colors
    brush.InterpolationColors = colorBlend;
    //Create a transform for the brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
    //Translation components are offsets of the rectangle
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Rotate the graphics state to get colors change in vertical direction from up to down
    brushTransform.Rotate(90);
    //Set the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

    //Fill the rectangle
    document.Fill(path);

    //Close current page
    document.ClosePage();

    //Save the document
    document.Save();
}

Aquí viene el resultado

En este fragmento de código creamos un degradado lineal diagonal a partir de 2 colores y rellenamos un rectángulo con este degradado.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "DiagonaGradient_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

    float offsetX = 200;
    float offsetY = 100;
    float width = 200;
    float height = 100;

    //Create a graphics path from the first rectangle
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(new RectangleF(offsetX, offsetY, width, height));

    //Create linear gradient brush with the rectangle as bounds, start and end colors
    LinearGradientBrush brush = new LinearGradientBrush(new RectangleF(0, 0, width, height), Color.FromArgb(255, 255, 0, 0),
        Color.FromArgb(255, 0, 0, 255), 0f);

    //Create a transform for brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
    //Translation components are offsets of the rectangle        
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Rotate the gradient, than scale and translate to get visible a color transition in required rectangle
    brushTransform.Rotate(-45);
    float hypotenuse = (float)System.Math.Sqrt(200 * 200 + 100 * 100);
    float ratio = hypotenuse / 200;
    brushTransform.Scale(-ratio, 1);
    brushTransform.Translate(100 / brushTransform.Elements[0], 0);

    //Set the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

    //Fill the rectangle
    document.Fill(path);

    //Close current page
    document.ClosePage();

    //Save the document
    document.Save();
}

Aquí viene el resultado

En este fragmento de código creamos un degradado radial a partir de 2 colores y rellenamos un círculo con este degradado.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "RadialGradient1_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

    float offsetX = 200;
    float offsetY = 100;
    float width = 200;
    float height = 200;

    //Create a graphics path from the rectangle bounds
    RectangleF bounds = new RectangleF(offsetX, offsetY, width, height);
    GraphicsPath path = new GraphicsPath();
    path.AddEllipse(bounds);

    //Create and fill color blend object
    Color[] colors = { Color.White, Color.White, Color.Blue };
    float[] positions = { 0.0f, 0.2f, 1.0f };
    ColorBlend colorBlend = new ColorBlend();
    colorBlend.Colors = colors;
    colorBlend.Positions = positions;

    GraphicsPath brushRect = new GraphicsPath();
    brushRect.AddRectangle(new RectangleF(0, 0, width, height));

    //Create path gradient brush with the rectangle as bounds
    PathGradientBrush brush = new PathGradientBrush(brushRect);
    //Set interpolation colors
    brush.InterpolationColors = colorBlend;
    //Create a transform for the brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
    //Translation components are offsets of the rectangle
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Set the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

    //Fill the rectangle
    document.Fill(path);

    //Close current page
    document.ClosePage();

    //Save the document
    document.Save();
}

el resultado

En este fragmento de código creamos un degradado radial a partir de 6 colores y rellenamos un rectángulo con este degradado.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "RadialGradient2_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();

    // Create new 1-paged PS Document
    PsDocument document = new PsDocument(outPsStream, options, false);

    float offsetX = 200;
    float offsetY = 100;
    float width = 200;
    float height = 200;

    //Create a graphics path from the rectangle bounds
    RectangleF bounds = new RectangleF(offsetX, offsetY, width, height);
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(bounds);

    //Create and fill color blend object
    Color[] colors = { Color.Green, Color.Blue, Color.Black, Color.Yellow, Color.Beige, Color.Red };
    float[] positions = { 0.0f, 0.2f, 0.3f, 0.4f, 0.9f, 1.0f };
    ColorBlend colorBlend = new ColorBlend();
    colorBlend.Colors = colors;
    colorBlend.Positions = positions;

    GraphicsPath brushRect = new GraphicsPath();
    brushRect.AddRectangle(new RectangleF(0, 0, width, height));

    //Create path gradient brush with the rectangle as bounds
    PathGradientBrush brush = new PathGradientBrush(brushRect);
    //Set interpolation colors
    brush.InterpolationColors = colorBlend;
    //Create a transform for the brush. X and Y scale component must be equal to width and height of the rectangle correspondingly.
    //Translation components are offsets of the rectangle
    Matrix brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Set the transform
    brush.Transform = brushTransform;

    //Set the paint
    document.SetPaint(brush);

    //Fill the rectangle
    document.Fill(path);

    //Close current page
    document.ClosePage();

    //Save the document
    document.Save();
}

el resultado

Consulte cómo trabajar con degradados en documentos PS en Java.

Puede descargar ejemplos y archivos de datos desde GitHub.