Робота з прозорістю в PostScript | .NET

Додайте прозорість у документ PS

PostScript не підтримує прозорість при малюванні векторних графічних об’єктів. Проте напівпрозорі (частково прозорі) зображення можна візуалізувати як набір повністю прозорих і повністю непрозорих пікселів. Такі зображення називаються масками.

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

“Псевдопрозорість” – це процес блідості кольорів, які мають альфа-компонент менше 255. Його досягають спеціальним змішуванням червоного, зеленого та синього компонентів з альфа-1.

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

Додайте прозоре зображення в документ PS

Як ми вже писали раніше, прозорі зображення можна додавати до PS-документа як маски, і бібліотека Aspose.Page для .NET пропонує для цієї мети метод AddTransparentImage(). Цей метод визначає, чи є зображення повністю непрозорим, повністю прозорим чи напівпрозорим. Якщо воно повністю непрозоре, воно додається як непрозоре зображення в методі AddImage(), якщо воно повністю прозоре, воно не додається до документа взагалі, якщо це напівпрозоре зображення, воно додається як зображення PostScript маска.

У прикладі нижче ми демонструємо різницю між додаванням прозорого зображення в документ PS за допомогою AddImage() і AddTransparentImage(). Щоб побачити біле напівпрозоре зображення, ми встановлюємо небілий колір тла сторінки.

Щоб додати будь-яке зображення до нового PsDocument за допомогою бібліотеки Aspose.Page для .NET у цьому прикладі, ми виконуємо такі дії:

1. Створіть вихідний потік для отриманого файлу PS.
2. Створіть об’єкт PsSaveOptions із параметрами за замовчуванням. Змініть колір фону, якщо це потрібно.
3. Створіть 1-сторінковий 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. У наведеному вище та наступному фрагментах коду Aspose.Page.Drawing.Bitmap використовуватиметься замість System.Drawing.Bitmap, Aspose.Page.Drawing.Drawing2D.Matrix використовуватиметься замість System.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 і 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.