Trabajar con transformaciones en archivos PS | Pitón

Transformar un contenido en documento PS

Este artículo explora cómo aplicar varias transformaciones: traducción, escalado, rotación y corte a una ruta rectangular agregada a un PsDocument.

Hemos dividido un único fragmento de código en varias secciones: el principio, el final y cada transformación individualmente. En PostScript, las transformaciones siempre se realizan dentro de un estado de gráficos delimitado por los operadores “gsave” y “grestore”. Por lo tanto, nuestro PsDocument incluye métodos como “write_graphics_save()” y “write_graphics_restore()” para establecer y restablecer estos estados de gráficos. Entre estos métodos, se puede agregar cualquier contenido, incluidos estados de gráficos anidados, lo que permite transformaciones o recortes. Estas transformaciones afectan sólo a los estados de los gráficos anidados y no afectan a los externos. Sin embargo, si se realiza una transformación sin utilizar los métodos “write_graphics_save()” y “write_graphics_restore()”, afectará el estado de los gráficos del nivel superior y todo el contenido dentro del PsDocument estará sujeto a esta transformación.

El algoritmo para aplicar cualquier transformación al contenido de un documento desde cero implica los siguientes pasos:

1. Cree una secuencia de salida para el archivo PS resultante.
2. Cree PsSaveOptions.
3. Cree PsDocument con el flujo de salida ya creado y las opciones de guardado.
4. Guarde un estado de gráficos. Cuando creamos un nuevo estado de gráficos, el estado de gráficos anterior se colocó en una pila de estados de gráficos.
5. Aplicar las transformaciones necesarias: traslación, escala, rotación, corte o cualquier combinación de ellas. En nuestro código, mostramos la influencia de cada componente de transformación por separado y al final 3 a la vez.
6. Agregue el contenido necesario que se requiere para transformar. En nuestro caso, creamos un reaccionarángulo aspose.pydrawing.GraphicsPath y luego lo completamos. Creamos un rectángulo antes de cualquier transformación y simplemente lo rellenamos después de cada transformación en el estado de gráficos actual.
7. Restaure el estado de los gráficos para volver al estado anterior donde las transformaciones aplicadas no afectan. En nuestro caso, es un estado de gráficos de nivel superior.

En este fragmento de código, iniciamos la creación de un PsDocument usando un flujo de salida y PsSaveOptions. Luego realizamos una traducción del estado de los gráficos de nivel superior a las coordenadas (100, 100) para compensar el primer rectángulo. Finalmente, generamos el primer rectángulo.

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

Consulte cómo trabajar con transformaciones en el documento PS en .NET, Java.

El resultado de ejecutar este código es

Puede descargar ejemplos y archivos de datos desde GitHub.