Trabajar con transparencia en un archivo PS | Pitón

Agregar transparencia en el documento PS

Agregar transparencia a documentos PS es bastante desafiante ya que PostScript no admite inherentemente la transparencia al pintar objetos de gráficos vectoriales. Sin embargo, las imágenes translúcidas se pueden representar mediante una combinación de píxeles totalmente transparentes y totalmente opacos, a menudo denominados máscaras.

Aspose.Page para Python vía .NET proporciona un método para agregar imágenes transparentes a documentos PS. Para pintar gráficos vectoriales como formas o texto, empleamos una técnica conocida como “pseudotransparencia”. Esto implica aclarar colores con un componente Alfa de menos de 255 mezclando los componentes Rojo, Verde y Azul con un Alfa de uno. Si bien la “pseudotransparencia” no ofrece una verdadera visibilidad de las capas debajo de las capas transparentes, crea la ilusión de transparencia, especialmente cuando la capa inferior es blanca.

Agregar imagen transparente al documento PS

Como se mencionó anteriormente, Aspose.Page para Python a través de la biblioteca .NET ofrece el método add_transparent_image() para agregar imágenes transparentes a documentos PS. Este método distingue si la imagen es completamente opaca, completamente transparente o translúcida. Si la imagen es completamente opaca, se agrega usando el método add_image(). Si es completamente transparente, no se agrega nada. Para imágenes translúcidas, se agrega como una máscara de imagen PostScript.

En el siguiente ejemplo, ilustramos la distinción entre agregar una imagen transparente en un documento PS usando add_image() y add_transparent_image(). Para visualizar la imagen blanca translúcida, hemos colocado un gran rectángulo rojo debajo de las imágenes.

Para agregar una imagen a un nuevo PsDocument usando Aspose.Page para Python a través de la biblioteca .NET, seguimos estos pasos:

1. Cree una secuencia de salida para el archivo PS resultante.
2. Cree un objeto PsSaveOptions con las opciones predeterminadas.
3. Cree un PsDocument de 1 página con un flujo de salida ya creado y opciones para guardar.
4. Cree un nuevo estado de gráficos.
5. Cree aspose.pydrawing.Bitmap a partir de un archivo de imagen.
6. Crea la transformación necesaria para la imagen.
7. Agregue la imagen a PsDocument como una imagen completamente opaca (usando el método add_image()) si estamos seguros de que la imagen es opaca o agregue una como imagen transparente (usando el método add_transparent_image()) si no estamos seguros de que la imagen sea opaca.
8. Salga del estado de gráficos actual al nivel superior.
9. Cierra la página.
10. Guarde el documento.

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

Ver cómo trabajar con transparencia en un documento PS en .NET, Java.

El resultado de ejecutar este código es

Agregar un objeto de gráficos vectoriales transparentes

Anteriormente escribimos que esta solución API utiliza un algoritmo de palidez para formas y texto transparentes, al que llamamos “pseudotransparencia”. En el siguiente ejemplo demostramos una diferencia entre dos formas pintadas con el mismo color, pero en la primera forma no tiene el componente Alfa y en el segundo caso tiene el componente Alfa.

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

Vea cómo trabajar con transparencia en documentos PS en .NET, Java.

El resultado de ejecutar este código es

Puede descargar ejemplos y archivos de datos desde GitHub.