Trabalhar com Clipes em Ficheiro PS | Java

Adicionar Clip em Documento PS

Um clipe num documento PS é um caminho que delimita o conteúdo do estado gráfico atual que será apresentado no visualizador ou editor PS. O conteúdo que ficar para além dos limites será recortado.

Um caminho de recorte em Java pode ser atribuído de três formas:

• por qualquer classe implementada java.awt.Shape que possa conter quaisquer formas fechadas;
• por contorno de texto;
• por imagem bicolor de 1 bpp (bits por pixel) como máscara de stencil;

Neste momento, a biblioteca Aspose.Page para Java oferece a primeira e a segunda formas de recorte. 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 a biblioteca Aspose.Page para Java, 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 java.awt.geom.Ellipse2D).
6. Defina um clipe com este percurso.
7. Defina uma pintura para o estado gráfico atual do PsDocument.
8. Preencha o percurso retangular com a pintura 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 the PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "Clipping_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create a new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a rectangle
Shape rectangle = new Rectangle2D.Float(0, 0, 300, 200);

//Set the paint in the upper level graphics state
document.setPaint(Color.BLUE);

//Save the  graphics state to return back to this state after the transformation
document.writeGraphicsSave();

//Displace the current graphics state on 100 points to the right and 100 points to the bottom.
document.translate(100, 100);

//Create a circle shape
Shape circle = new Ellipse2D.Float(50, 0, 200, 200);

//Add clipping by the circle to the current graphics state
document.clip(circle);

//Fill the rectangle in the current graphics state (with clipping)
document.fill(rectangle);

//Restore the graphics state to the previus (upper) level
document.writeGraphicsRestore();

//Displace the upper-level graphics state on 100 points to the right and 100 points to the bottom.
document.translate(100, 100);

BasicStroke stroke = new BasicStroke(2,
        BasicStroke.CAP_BUTT,
        BasicStroke.JOIN_MITER,
        10.0f, new float []{5.0f}, 0.0f);

document.setStroke(stroke);

//Draw the rectangle in the current graphics state (has no clipping) above the clipped rectangle
document.draw(rectangle);

//Close the current page
document.closePage();
//Save the document
document.save();

Veja como trabalhar com recortes em documentos PS em .NET.

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

No próximo exemplo, obtemos um tipo de letra utilizado para recortar um retângulo preenchido a azul com o contorno do texto.

Para adicionar um recorte por texto ao novo PsDocument com a biblioteca Aspose.Page para Java, neste exemplo, seguimos os seguintes passos:

1. Crie um fluxo de saída para o ficheiro PS resultante.
2. Crie o 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 fonte.
6. Defina um recorte com o texto e o tipo de letra.
7. Defina uma pintura para o estado gráfico atual do PsDocument.
8. Preencha o percurso do retângulo com a pintura atual.
9. Saia do estado gráfico atual para o nível superior.
10. Translação 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 output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "Clipping_outPS.ps");
//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create a new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

//Create a rectangle
Shape rectangle = new Rectangle2D.Float(0, 0, 300, 200);

//Set paint in the upper-level graphics state
document.setPaint(Color.BLUE);

//Save graphics state to return back to this state after the transformation
document.writeGraphicsSave();

//Displace current graphics state on 100 points to the right and 100 points to the bottom.
document.translate(100, 100);

int fontSize = 120;
Font font = new Font("Arial", Font.BOLD, fontSize);

//Clip rectangle by text's outline
document.clipText("ABC", font, 20, fontSize + 10);		
document.fill(rectangle);

//Restore graphics state to the previous (upper) level
document.writeGraphicsRestore();

//Displace upper-level graphics state on 100 points to the right and 100 points to the bottom.
document.translate(100, 100);

BasicStroke stroke = new BasicStroke(2,
        BasicStroke.CAP_BUTT,
        BasicStroke.JOIN_MITER,
        10.0f, new float []{5.0f}, 0.0f);

document.setStroke(stroke);

//Draw the rectangle in the current graphics state (has no clipping) above the clipped rectangle
document.draw(rectangle);

//Close the current page
document.closePage();
//Save the document
document.save();

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

O resultado da execução deste código aparece como

Pode descarregar exemplos e ficheiros de dados do GitHub.