Working with Transformations in PS file | Python

Transform a content in PS Document

This article explores how to apply various transformations-translation, scaling, rotation, and shearing to a rectangle path added to a PsDocument.

We’ve broken down a single code snippet into multiple sections: the beginning, the end, and each transformation individually. In PostScript, transformations are always performed within a graphics state delimited by the “gsave” and “grestore” operators. Therefore, our PsDocument includes methods such as “write_graphics_save()” and “write_graphics_restore()” to establish and reset these graphics states. Between these methods, any content, including nested graphics states, can be added, allowing for transformations or clipping. These transformations affect only the nested graphics states and do not impact the outer ones. However, if a transformation is performed without using “write_graphics_save()” and “write_graphics_restore()” methods, it affects the graphics state of the upper level, and all content within the PsDocument is subjected to this transformation.

The algorithm for applying any transformation to a document’s content from scratch involves the following steps:

1. Create an output stream for the resulting PS file.
2. Create PsSaveOptions.
3. Create PsDocument with the already created output stream and save options.
4. Save a graphics state. As we created a new graphics state, the previous graphics state was put in a graphics states stack.
5. Apply necessary transformations: translation, scale, rotation, shear, or any combination of it. In our code, we show the influence of every transformation component separately and 3 ones at a time in the end.
6. Add necessary content that is required to transform. In our case, we created a reactangle aspose.pydrawing.GraphicsPath and then fill it. We created one rectangle before any transformations and just fill it after every transformation in the current graphics state.
7. Restore the graphics state to return back to the previous one where applied transformation(s) doesn’t affect. In our case, it is an upper-level graphics state.

In this code snippet, we initiate the creation of a PsDocument using an output stream and PsSaveOptions. We then perform a translation of the upper-level graphics state to the coordinates (100, 100) to offset the first rectangle. Finally, we generate the first 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()

See working with transformations in PS document in .NET, Java.

The result of running this code is

You can download examples and data files from GitHub.