Работа с прозрачностью в PostScript | .NET

Добавить прозрачность в документ PS

PostScript не поддерживает прозрачность при рисовании объектов векторной графики. Однако полупрозрачные (частично прозрачные) изображения можно визуализировать как набор полностью прозрачных и полностью непрозрачных пикселей. Такие изображения называются масками.

Библиотека Aspose.Page для .NET предлагает метод, который добавляет прозрачное изображение в документ PS. Что касается рисования векторной графики: фигур или текста, мы предлагаем “псевдопрозрачность”.

«Псевдопрозрачность» — это процесс обесцвечивания цветов, у которых альфа-компонент меньше 255. Это достигается путем специфического смешивания красного, зеленого и синего компонентов с альфа-компонентом.

“Псевдопрозрачность”, конечно, не позволяет увидеть нижний цветной слой из-под верхнего прозрачного слоя, но создает иллюзию прозрачности, если нижний слой белый.

Добавить прозрачное изображение в документ PS

Как мы писали ранее, прозрачные изображения можно добавлять в документ PS в качестве маски, и библиотека Aspose.Page для .NET предлагает для этой цели метод AddTransparentImage(). Этот метод определяет, является ли изображение полностью непрозрачным, полностью прозрачным или полупрозрачным. Если оно полностью непрозрачное, оно добавляется как непрозрачное изображение в методе AddImage(), если оно полностью прозрачное, оно вообще не добавляется в документ, если это полупрозрачное изображение, оно добавляется как изображение PostScript. маска.

В примере ниже мы демонстрируем разницу между добавлением прозрачного изображения в документ PS с помощью AddImage() и AddTransparentImage(). Чтобы увидеть белое полупрозрачное изображение, мы устанавливаем небелый цвет фона страницы.

Чтобы добавить любое изображение в новый PsDocument с помощью библиотеки Aspose.Page для .NET в этом примере, мы выполняем следующие шаги:

1. Создайте выходной поток для полученного PS-файла.
2. Создайте объект PsSaveOptions с параметрами по умолчанию. Если необходимо, измените цвет фона.
3. Создайте одностраничный PsDocument с уже созданным потоком вывода и сохраните параметры.
4. Создайте новое графическое состояние.
5. Создайте Растровое изображение из файла изображения.
6. Создайте необходимое преобразование изображения.
7. Добавьте изображение в PsDocument как полностью непрозрачное изображение (с помощью метода AddImage()), если мы уверены, что изображение непрозрачное, или добавьте его как прозрачное изображение (с помощью метода AddTransparentImage()). если мы не уверены, что изображение непрозрачно.
8. Выход из текущего состояния графики на верхний уровень.
9. Закройте страницу.
10. Сохраните документ.

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "AddTransparentImage_outPS.ps", FileMode.Create))
{
    //Create save options with A4 size
    PsSaveOptions options = new PsSaveOptions();
    //Set page's background color to see white image on it's own transparent background
    options.BackgroundColor = Color.FromArgb(211, 8, 48);

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


    document.WriteGraphicsSave();
    document.Translate(20, 100);

    //Create a bitmap from translucent image file
    using (Bitmap image = new Bitmap(dataDir + "mask1.png"))
    {
        //Add this image to the document as usual opaque RGB image
        document.DrawImage(image, new Matrix(1, 0, 0, 1, 100, 0), Color.Empty);
    }

    //Again create a bitmap from the same image file
    using (Bitmap image = new Bitmap(dataDir + "mask1.png"))
    {
        //Add this image to the document as transparent image
        document.DrawTransparentImage(image, new Matrix(1, 0, 0, 1, 350, 0), 255);
    }

    document.WriteGraphicsRestore();

    //Close current page
    document.ClosePage();

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

Для Linux, MacOS и других операционных систем, отличных от Windows, мы предлагаем использовать наш пакет Nuget Aspose.Page.Drawing. Он использует серверную часть Aspose.Drawing вместо системной библиотеки System.Drawing.

Поэтому импортируйте пространство имен Aspose.Page.Drawing вместо System.Drawing. В приведенном выше и последующих фрагментах кода вместо System.Drawing.Bitmap будет использоваться Aspose.Page.Drawing.Bitmap, вместо System.Drawing.Drawing2D.Matrix будет использоваться Aspose.Page.Drawing.Drawing2D.Matrix и т. д. . Наши примеры кода на GitHub содержат все необходимые замены.

См. работу с прозрачностью в документе PS в Java.

Результат запуска этого кода следующий

Добавление прозрачного объекта векторной графики

Ранее мы писали, что библиотека Aspose.Page для .NET использует алгоритм очистки прозрачных фигур и текста, который мы назвали “псевдопрозрачностью”. В примере ниже мы демонстрируем разницу между двумя фигурами, окрашенными в один и тот же цвет, но в первой фигуре без компонента «Альфа», а во втором случае — с компонентом «Альфа».

//Create an output stream for PostScript document
using (Stream outPsStream = new FileStream(dataDir + "ShowPseudoTransparency_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 = 50;
    float offsetY = 100;
    float width = 200;
    float height = 100;

///////////////////////////////// Create a rectangle with opaque gradient fill /////////////////////////////////////////////////////////
    GraphicsPath path = new GraphicsPath();
    path.AddRectangle(new RectangleF(50, 100, 200, 100));

    LinearGradientBrush opaqueBrush = new LinearGradientBrush(new RectangleF(0, 0, 200, 100), Color.FromArgb(0, 0, 0),
        Color.FromArgb(40, 128, 70), 0f);
    Matrix brushTransform = new Matrix(200, 0, 0, 100, 50, 100);
    opaqueBrush.Transform = brushTransform;
    Aspose.Page.EPS.GradientBrush gradientBrush = new GradientBrush(opaqueBrush);
    gradientBrush.WrapMode = WrapMode.Clamp;

    document.SetPaint(gradientBrush);
    document.Fill(path);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

    offsetX = 350;

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

    //Create linear gradient brush colors which transparency are not 255, but 150 and 50. So it are translucent.
    LinearGradientBrush translucentBrush = 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.
    brushTransform = new Matrix(width, 0, 0, height, offsetX, offsetY);
    //Set the transform
    translucentBrush.Transform = brushTransform;
    
    //Set the paint
    document.SetPaint(translucentBrush);
    //Fill the rectangle
    document.Fill(path);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

    //Close current page
    document.ClosePage();

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

См. работу с прозрачностью в документах PS в Java и C++.

Результат запуска этого кода выглядит так:

Вы можете загрузить примеры и файлы данных с сайта GitHub.