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.

// Demonstrates clipping by shape and clipping by text in PS document.
String outputFileName = "ApplyClipByShape_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create new 1-paged PS Document
PsDocument document = new PsDocument(getOutputDir() + outputFileName, options, false);

//Create graphics path from the rectangle
GeneralPath rectanglePath = new GeneralPath();
rectanglePath.append(new Rectangle2D.Float(0, 0, 300, 200), false);

////////////////////////////////////// Clipping by shape ///////////////////////////////

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

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

//Create graphics path from the circle
GeneralPath circlePath = new GeneralPath();
circlePath.append(new Ellipse2D.Float(50, 0, 200, 200), false);

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

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

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

//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);

//Create dashed stroke similar to Pen with DashStyle.Dash
float[] dash = new float[] { 5.0f };
BasicStroke stroke = new BasicStroke(2.0f, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER, 10.0f, dash, 0.0f);

document.setStroke(stroke);

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

//Close 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.

// Demonstrates clipping by text in PS document.
String outputFileName = "ApplyClipByText_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create new 1-paged PS Document
PsDocument document = new PsDocument(getOutputDir() + outputFileName, options, false);

//Create graphics path from the rectangle
GeneralPath rectanglePath = new GeneralPath();
rectanglePath.append(new Rectangle2D.Float(0, 0, 300, 200), false);

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

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

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

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

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

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

document.fill(rectanglePath);

document.writeGraphicsRestore();

document.translate(100, 100);

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

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

//Close 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.