Travailler avec la transparence dans le fichier PS | Python

Ajouter de la transparence dans le document PS

L’ajout de transparence aux documents PS est assez difficile car PostScript ne prend pas automatiquement en charge la transparence lors de la peinture d’objets graphiques vectoriels. Cependant, les images translucides peuvent être représentées par une combinaison de pixels entièrement transparents et entièrement opaques, souvent appelés masques.

Aspose.Page pour Python via .NET fournit une méthode pour ajouter des images transparentes aux documents PS. Pour peindre des graphiques vectoriels tels que des formes ou du texte, nous utilisons une technique connue sous le nom de “pseudo-transparence”. Cela implique d’éclaircir les couleurs avec un composant Alpha inférieur à 255 en mélangeant les composants rouge, vert et bleu avec un Alpha de un. Bien que la “pseudo-transparence” n’offre pas une véritable visibilité sous les calques transparents, elle crée l’illusion de transparence, en particulier lorsque le calque inférieur est blanc.

Ajouter une image transparente au document PS

Comme mentionné précédemment, Aspose.Page pour Python via la bibliothèque .NET propose la méthode add_transparent_image() pour ajouter des images transparentes aux documents PS. Cette méthode permet de déterminer si l’image est totalement opaque, entièrement transparente ou translucide. Si l’image est entièrement opaque, elle est ajoutée à l’aide de la méthode add_image(). S’il est entièrement transparent, il n’est pas ajouté du tout. Pour les images translucides, il est ajouté sous forme de masque d’image PostScript.

Dans l’exemple ci-dessous, nous illustrons la distinction entre l’ajout d’une image transparente dans un document PS en utilisant à la fois add_image() et add_transparent_image(). Pour visualiser l’image blanche translucide, nous avons placé un grand rectangle rouge sous les images.

Pour ajouter une image à un nouveau PsDocument à l’aide d’Aspose.Page pour Python via la bibliothèque .NET, nous suivons ces étapes :

1. Créez un flux de sortie pour le fichier PS résultant.
2. Créez un objet PsSaveOptions avec les options par défaut.
3. Créez un PsDocument d’une page avec un flux de sortie déjà créé et enregistrez les options.
4. Créez un nouvel état graphique.
5. Créez aspose.pydrawing.Bitmap à partir d’un fichier image.
6. Créez la transformation nécessaire pour l’image.
7. Ajoutez l’image à PsDocument en tant qu’image entièrement opaque (en utilisant la méthode add_image()) si nous sommes sûrs que l’image est opaque ou ajoutez-en une en tant qu’image transparente (en utilisant la méthode add_transparent_image()) si nous ne sommes pas sûrs que l’image soit opaque.
8. Quittez l’état graphique actuel pour passer à celui du niveau supérieur.
9. Fermez la page.
10. Enregistrez le document.

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

Voir comment travailler avec la transparence dans un document PS dans .NET, Java.

Le résultat de l’exécution de ce code est

Ajout d’un objet graphique vectoriel transparent

Plus tôt, nous avons écrit que cette solution API utilise un algorithme de pâleur pour les formes et le texte transparents, que nous avons appelé “pseudo-transparence”. Dans l’exemple suivant, nous démontrons une différence entre deux formes peintes avec la même couleur, mais dans la première forme, elle est sans le composant Alpha et dans le second cas, elle a le composant.

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

Voir Travailler avec la transparence dans les documents PS dans .NET, Java.

Le résultat de l’exécution de ce code est

Vous pouvez télécharger des exemples et des fichiers de données à partir de GitHub.