Работа с прозрачностью в PS-файле | Питон

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

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

Aspose.Page для Python через .NET предоставляет метод добавления прозрачных изображений в документы PS. Для рисования векторной графики, такой как фигуры или текст, мы используем технику, известную как ** «псевдопрозрачность»**. Это предполагает осветление цветов с альфа-компонентом менее 255 путем смешивания красного, зеленого и синего компонентов с альфа-компонентом, равным единице. Хотя “псевдопрозрачность” не обеспечивает истинную видимость слоев под прозрачными слоями, она создает иллюзию прозрачности, особенно когда нижний слой белый.

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

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

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

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

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

# The path to the documents directory.
data_dir = Util.get_data_dir_working_with_transparency()

# Create an output stream for the PostScript document
with open(data_dir + "AddTransparentImage_outPS.ps", "wb") as out_ps_stream:
    # Create the save options with the A4 size
    options = PsSaveOptions()
    # Set the page's background color to see a white image on it's own transparent background
    options.background_color = aspose.pydrawing.Color.from_argb(211, 8, 48)
    
    # Create a new 1-paged PS Document
    document = PsDocument(out_ps_stream, options, False)
    
    
    document.write_graphics_save()
    document.translate(20, 100)
    
    # Create a bitmap from the translucent image file
    with aspose.pydrawing.Bitmap(data_dir + "mask1.png") as image:
        # Add this image to the document as a regular opaque RGB image
        document.draw_image(image, aspose.pydrawing.drawing2d.Matrix(1., 0., 0., 1., 100., 0.), aspose.pydrawing.Color())
    
    # Create another bitmap from the same image file
    with aspose.pydrawing.Bitmap(data_dir + "mask1.png") as image:
        # Add this image to the document as a transparent image
        document.draw_transparent_image(image, aspose.pydrawing.drawing2d.Matrix(1., 0., 0., 1., 350., 0.), 255)
    
    document.write_graphics_restore()
    
    # Close the current page
    document.close_page()
    
    #Save the document
    document.save()

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

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

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

Ранее мы писали, что это API-решение использует алгоритм очистки прозрачных фигур и текста, который мы назвали “псевдопрозрачностью”. В следующем примере мы демонстрируем разницу между двумя фигурами, окрашенными в один и тот же цвет, но в первой фигуре нет альфа-компонента, а во втором случае есть этот компонент.

# The path to the documents directory.
data_dir = Util.get_data_dir_working_with_transparency()

# Create an output stream for the PostScript document
with open(data_dir + "ShowPseudoTransparency_outPS.ps", "wb") as out_ps_stream:
    # Create the save options with A4 size
    options = PsSaveOptions()
    
    # Create a new 1-paged PS Document
    document = PsDocument(out_ps_stream, options, False)
    
    offset_x = 50.
    offset_y = 100.
    width = 200.
    height = 100.
    
    ################################ Create a rectangle with the opaque gradient fill #######################################################
    path = aspose.pydrawing.drawing2d.GraphicsPath()
    path.add_rectangle(aspose.pydrawing.RectangleF(offset_x, offset_y, width, height))
    
    opaque_brush: aspose.pydrawing.drawing2d.LinearGradientBrush = \
        GraphicsFactory.create_linear_gradient_brush_by_rect_and_angle(aspose.pydrawing.RectangleF(0, 0, 200, 100), aspose.pydrawing.Color.from_argb(0, 0, 0),
    aspose.pydrawing.Color.from_argb(40, 128, 70), 0)
    brush_transform = aspose.pydrawing.drawing2d.Matrix(width, 0., 0., height, offset_x, offset_y)
    opaque_brush.transform = brush_transform
    gradient_brush = GradientBrush(opaque_brush)
    gradient_brush.wrap_mode = aspose.pydrawing.drawing2d.WrapMode.CLAMP
    
    document.set_paint(gradient_brush)
    document.fill(path)
    ####################################################################################################################################
    
    offset_x = 350.
    
    ################################ Create a rectangle with the translucent gradient fill ###################################################
    # Create a graphics path from the first rectangle
    path = aspose.pydrawing.drawing2d.GraphicsPath()
    path.add_rectangle(aspose.pydrawing.RectangleF(offset_x, offset_y, width, height))
    
    # Create linear gradient brush colors which transparency are not 255, but 150 and 50. So it are translucent.
    translucent_brush: aspose.pydrawing.drawing2d.LinearGradientBrush = \
        GraphicsFactory.create_linear_gradient_brush_by_rect_and_angle(aspose.pydrawing.RectangleF(0, 0, width, height),
                                                                       aspose.pydrawing.Color.from_argb(150, 0, 0, 0),
    aspose.pydrawing.Color.from_argb(50, 40, 128, 70), 0)
    # Create a transform for brush.
    brush_transform = aspose.pydrawing.drawing2d.Matrix(width, 0., 0., height, offset_x, offset_y)
    # Set the transform
    translucent_brush.transform = brush_transform
    # Create a GradientBrush object containing the linear gradient brush
    gradient_brush = GradientBrush(translucent_brush)
    gradient_brush.wrap_mode = aspose.pydrawing.drawing2d.WrapMode.CLAMP
    # Set the paint
    document.set_paint(gradient_brush)
    # Fill the rectangle
    document.fill(path)
    ####################################################################################################################################
    
    # Close the current page
    document.close_page()
    
    # Save the document
    document.save()

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

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

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