Trabalhar com Clips em PostScript | .NET

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 .NET pode ser atribuído de três formas:

• por System.Drawing.Drawing2D.GraphicsPath, que pode 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 .NET oferece a primeira e a segunda forma de recorte. No exemplo abaixo, obtemos um círculo System.Drawing.Drawing2D.GraphicsPath de um retângulo 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 .NET, 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 um círculo System.Drawing.Drawing2D.GraphicsPath a partir do retângulo.
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.

// 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(OutputDir + outputFileName, options, false);

//Create graphics path from the rectangle
GraphicsPath rectanglePath = new GraphicsPath();
rectanglePath.AddRectangle(new RectangleF(0, 0, 300, 200));

////////////////////////////////////// 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
GraphicsPath circlePath = new GraphicsPath();
circlePath.AddEllipse(new RectangleF(50, 0, 200, 200));

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

//Set paint in the current graphics state
document.SetPaint(new SolidBrush(Color.Blue));

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

//Restore graphics state to the previus (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);

Pen pen = new Pen(new SolidBrush(Color.Blue), 2);
pen.DashStyle = DashStyle.Dash;

document.SetStroke(pen);

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

Para Linux, MacOS e outros sistemas operativos não Windows, oferecemos a utilização do nosso pacote NuGet Aspose.Page.Drawing. Utiliza o backend Aspose.Drawing em vez da biblioteca de sistema System.Drawing.

Assim, importe o namespace Aspose.Page.Drawing em vez do namespace System.Drawing. No trecho de código acima, será utilizado Aspose.Page.Drawing.Rectangle em vez de System.Drawing.Rectangle, Aspose.Page.Drawing.Drawing2D.GraphicsPath em vez de System.Drawing.Drawing2D.GraphicsPath e assim por diante. Os nossos exemplos de código no GitHub contêm todas as substituições necessárias.

Veja como trabalhar com recortes em documentos PS em Java.

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

No próximo exemplo, obtemos um tipo de letra que recorta 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 .NET, neste exemplo, seguimos os seguintes passos:

1. Criar 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 fonte.
6. Defina um recorte com texto e a fonte.
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(OutputDir + outputFileName, options, false);

//Create graphics path from the rectangle
GraphicsPath rectanglePath = new GraphicsPath();
rectanglePath.AddRectangle(new RectangleF(0, 0, 300, 200));

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

Pen pen = new Pen(new SolidBrush(Color.Blue), 2);
pen.DashStyle = DashStyle.Dash;
int fontSize = 120;
System.Drawing.Font font = new System.Drawing.Font("Arial", fontSize, FontStyle.Bold);

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

//Set paint in the current graphics state
document.SetPaint(new SolidBrush(Color.Blue));

document.Fill(rectanglePath);

document.WriteGraphicsRestore();

document.Translate(100, 100);

document.SetStroke(pen);
//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();

Para Linux, MacOS e outros sistemas operativos não Windows, oferecemos a utilização do nosso pacote NuGet Aspose.Page.Drawing. Utiliza o backend Aspose.Drawing em vez da biblioteca de sistema System.Drawing.

Assim, importe o namespace Aspose.Page.Drawing em vez do System.Drawing. No excerto de código acima, será utilizado Aspose.Page.Drawing.Rectangle em vez de System.Drawing.Rectangle, Aspose.Page.Drawing.Drawing2D.GraphicsPath será utilizado em vez de System.Drawing.Drawing2D.GraphicsPath e assim por diante. Os nossos exemplos de código no GitHub contêm todas as substituições necessárias.

Veja como trabalhar com clips em documentos PS em Java.

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

Pode descarregar exemplos e ficheiros de dados do GitHub.