Trabalhar com Clipes em Ficheiro PS | Python

Adicionar Clip em Documento PS

Num documento PS, um clipe é um limite definido por um caminho que restringe a visibilidade do conteúdo dentro do estado gráfico atual nos visualizadores ou editores PS. Qualquer conteúdo que se estenda para além deste limite será truncado.

Em Python, os caminhos de recorte podem ser atribuídos de três formas:

• Utilizando qualquer classe implementada em aspose.pydrawing.GraphicsPath, capaz de conter formas fechadas.;
• Utilizando um contorno de texto;
• Empregando uma imagem de 1 bpp (bits por pixel) e 2 cores como máscara de stencil.

Atualmente, a biblioteca Aspose.Page para Python via .NET suporta o primeiro e o segundo método de recorte. No exemplo abaixo, criámos uma forma circular como caminho de recorte e utilizámo-la para recortar um retângulo preenchido a azul dentro do mesmo estado gráfico.

No exemplo abaixo, obtemos uma forma circular como caminho de recorte e recortamos um retângulo preenchido a azul no mesmo estado gráfico.

Para adicionar um clip ao novo PsDocument com o Aspose.Page para Python através da biblioteca .NET, neste exemplo, seguimos os seguintes passos:

1. Crie um fluxo de saída para o ficheiro PS resultante.
2. Crie um objeto PsSaveOptions com as opções padrão.
3. Crie um PsDocument de 1 página com um fluxo de saída já criado e opções de guardar.
4. Crie um novo estado gráfico.
5. Crie uma forma circular (objeto aspose.pydrawing.GraphicsPath).
6. Defina um clipe com este percurso.
7. Defina uma pintura para o estado gráfico atual do PsDocument.
8. Preencha o percurso do retângulo com a tinta atual.
9. Saia do estado gráfico atual para o nível superior.
10. Transfira para o local do retângulo preenchido.
11. Trace com uma linha tracejada os limites do mesmo retângulo acima do preenchido para mostrar os limites do retângulo preenchido recortado.
12. Feche a página.
13. Guarde o documento.

# Create an output stream for PostScript document
with open(data_dir + "Clipping_outPS.ps", "wb") as out_ps_stream:
    # Create the save options with default values
    options = PsSaveOptions()
    
    # Create new 1-paged PS Document
    document = PsDocument(out_ps_stream, options, False)
    
    # Create a graphics path from the rectangle
    rectange_path = aspose.pydrawing.drawing2d.GraphicsPath()
    rectange_path.add_rectangle(aspose.pydrawing.RectangleF(0, 0, 300, 200))
    
    ##################################### Clipping by the shape //////////////////////////////////////////////////////////////////////
    
    # 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 100 points to the right and 100 points to the bottom.
    document.translate(100, 100)
    
    # Create a graphics path from the circle
    circle_path = aspose.pydrawing.drawing2d.GraphicsPath()
    circle_path.add_ellipse(aspose.pydrawing.RectangleF(50, 0, 200, 200))
    
    # Add clipping by circle to the current graphics state
    document.clip(circle_path)
    
    # Set the paint in the current graphics state
    document.set_paint(aspose.pydrawing.SolidBrush(aspose.pydrawing.Color.blue))
    
    # Fill the rectangle in the current graphics state (with clipping)
    document.fill(rectange_path)
    
    # Restore the graphics state to the previus (upper) level
    document.write_graphics_restore()
    
    # Displace the upper level graphics state on 100 points to the right and 100 points to the bottom.
    document.translate(100, 100)
    
    pen = aspose.pydrawing.Pen(aspose.pydrawing.SolidBrush(aspose.pydrawing.Color.blue))
    pen.width = float(2)
    pen.dash_style = aspose.pydrawing.drawing2d.DashStyle.DASH
    
    document.set_stroke(pen)
    
    # Draw the rectangle in the current graphics state (has no clipping) above clipped rectangle
    document.draw(rectange_path)
    
    ########################################################################################################################
    
    # Close the current page
    document.close_page()
    
    # Save the document
    document.save()

Veja como trabalhar com clips em documentos PS em . NET, Java.

O resultado da execução deste código é

Pode descarregar exemplos e ficheiros de dados do GitHub.