Travailler avec des transformationsdans PS | Python

Transformer un contenu dans un document PS

Cet article explique comment appliquer diverses transformations : translation, mise à l’échelle, rotation et cisaillement à un chemin rectangulaire ajouté à un PsDocument.

Nous avons divisé un seul extrait de code en plusieurs sections : le début, la fin et chaque transformation individuellement. En PostScript, les transformations sont toujours effectuées dans un état graphique délimité par les opérateurs “gsave” et “grestore”. Par conséquent, notre PsDocument inclut des méthodes telles que “write_graphics_save()” et “write_graphics_restore()” pour établir et réinitialiser ces états graphiques. Entre ces méthodes, n’importe quel contenu, y compris les états graphiques imbriqués, peut être ajouté, permettant des transformations ou un découpage. Ces transformations affectent uniquement les états graphiques imbriqués et n’impactent pas les états externes. Cependant, si une transformation est effectuée sans utiliser les méthodes “write_graphics_save()” et “write_graphics_restore()”, elle affecte l’état graphique du niveau supérieur et tout le contenu du PsDocument est soumis à cela. transformation.

L’algorithme permettant d’appliquer toute transformation au contenu d’un document à partir de zéro implique les étapes suivantes :

1. Créez un flux de sortie pour le fichier PS résultant.
2. Créez PsSaveOptions.
3. Créez PsDocument avec le flux de sortie déjà créé et enregistrez les options.
4. Enregistrez un état graphique. Au fur et à mesure que nous créions un nouvel état graphique, l’état graphique précédent a été placé dans une pile d’états graphiques.
5. Appliquez les transformations nécessaires : translation, échelle, rotation, cisaillement ou toute combinaison de ceux-ci. Dans notre code, nous montrons l’influence de chaque composant de transformation séparément et 3 à la fois au final.
6. Ajoutez le contenu nécessaire à la transformation. Dans notre cas, nous avons créé un réactangle aspose.pydrawing.GraphicsPath puis l’avons rempli. Nous avons créé un rectangle avant toute transformation et l’avons simplement rempli après chaque transformation dans l’état graphique actuel.
7. Restaurez l’état graphique pour revenir à l’état précédent où les transformations appliquées n’affectent pas. Dans notre cas, il s’agit d’un état graphique de niveau supérieur.

Dans cet extrait de code, nous lançons la création d’un PsDocument à l’aide d’un flux de sortie et de PsSaveOptions. Nous effectuons ensuite une traduction de l’état graphique de niveau supérieur vers les coordonnées (100, 100) pour décaler le premier rectangle. Enfin, nous générons le premier rectangle.

data_dir = Util.get_data_dir_working_with_canvas()

# Create an output stream for the PostScript document
with open(data_dir + "Transformations_outPS.ps", "wb") as out_ps_stream:
    # Create save options with default values
    options = PsSaveOptions()
    
    # Create a new 1-paged PS Document
    document = PsDocument(out_ps_stream, options, False)
    
    document.translate(100, 100)
    
    # Create a graphics path from the rectangle
    path = aspose.pydrawing.drawing2d.GraphicsPath()
    path.add_rectangle(aspose.pydrawing.RectangleF(0, 0, 150, 100))
    
    ##################################### No transformations ###############################################################
    # Set the paint in the graphics state on upper level
    document.set_paint(aspose.pydrawing.SolidBrush(aspose.pydrawing.Color.orange))
    
    # Fill the first rectangle that is on the upper level graphics state and is without any transformations.
    document.fill(path)
    ########################################################################################################################
      
    
    ##################################### Translation ######################################################################
    
    # Save the graphics state in order to return back to this state after the transformation
    document.write_graphics_save()
    
    # Displace the current graphics state on 250 to the right. So we add a translation component to the current transformation.
    document.translate(250., 0.)
    
    # Set the paint in the current graphics state
    document.set_paint(aspose.pydrawing.SolidBrush(aspose.pydrawing.Color.blue))
    
    # Fill the second rectangle in the current graphics state (has translation transformation)
    document.fill(path)
    
    # Restore the graphics state to the previus (upper) level
    document.write_graphics_restore()
    ########################################################################################################################
    
    
    # Displace on 200 to the bottom.
    document.translate(0., 200.)
    
    ##################################### Scaling ##########################################################################
    # Save graphics state in order to return back to this state after transformation
    document.write_graphics_save()
    
    # Scale the current graphics state on 0.5 in X axis and on 0.75f in Y axis. So we add a scale component to the current transformation.
    document.scale(0.5, 0.75)
    
    # Set the paint in the current graphics state
    document.set_paint(aspose.pydrawing.SolidBrush(aspose.pydrawing.Color.red))
    
    # Fill the third rectangle in the current graphics state (has scale transformation)
    document.fill(path)
    
    # Restore the graphics state to the previus (upper) level
    document.write_graphics_restore()
    #####################################################################################################################
    
    
    # Displace the upper level graphics state on 250 to the right.
    document.translate(250., 0.)
    
    
    ##################################### Rotation ######################################################################
    #Save graphics state in order to return back to this state after transformation
    document.write_graphics_save()
    
    # Rotate the current graphics state on 45 degrees around the origin of the current graphics state (350, 300). So we add a rotation component to the current transformation.
    document.rotate(float(45))
    
    # Set the paint in the current graphics state
    document.set_paint(aspose.pydrawing.SolidBrush(aspose.pydrawing.Color.green))
    
    # Fill the fourth rectangle in the current graphics state (has rotation transformation)
    document.fill(path)
    
    # Restore the graphics state to the previus (upper) level
    document.write_graphics_restore()
    #####################################################################################################################
    
    
    # Returns the upper level graphics state back to the left and displace on 200 to the bottom.
    document.translate(-250., 200.)
    
    
    ##################################### Shearing ######################################################################
    # Save the graphics state in order to return back to this state after the transformation
    document.write_graphics_save()
    
    # Shear the current graphics state. So we add shear component to the current transformation.
    document.shear(0.1, 0.2)
    
    # Set the paint in the current graphics state
    document.set_paint(aspose.pydrawing.SolidBrush(aspose.pydrawing.Color.pink))
    
    # Fill the fifth rectangle in the current graphics state (has shear transformation)
    document.fill(path)
    
    # Restore the graphics state to the previus (upper) level
    document.write_graphics_restore()
    #####################################################################################################################
    
    
    # Displace the upper level graphics state on 250 to the right.
    document.translate(250., 0.)
    
    
    ##################################### Complex transformation ########################################################
    # Save the graphics state in order to return back to this state after the transformation
    document.write_graphics_save()
    
    # Transform the current graphics state with the complex transformation. So we add the translation, scale and rotation components to the current transformation.
    document.transform(aspose.pydrawing.drawing2d.Matrix(1.2, -0.965925, 0.258819, 1.5, 0., 50.))
    
    # Set the paint in the current graphics state
    document.set_paint(aspose.pydrawing.SolidBrush(aspose.pydrawing.Color.aquamarine))
    
    # Fill the sixth rectangle in the current graphics state (has complex transformation)
    document.fill(path)
    
    # Restore graphics state to the previus (upper) level
    document.write_graphics_restore()
    #####################################################################################################################
    
    
    # Returns the upper level graphics state back to the left and displace on 200 to the bottom.
    document.translate(-250., 200.)
    
    
    ##################################### Again no transformation ########################################################
    # Demonstrates that current graphics state's color is orange that was set up at the beginning of the code. 
    # Fill the seventh rectangle in the current graphics state (has no transformation)
    document.fill(path)
    #####################################################################################################################
    
    # Close the current page
    document.close_page()
    
    # Save the document
    document.save()

Voir comment travailler avec des transformations dans un document 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.