iText - Desenhando um Arco

Neste capítulo, veremos como desenhar um arco em um documento PDF usando a biblioteca iText.

Desenhando um arco em um PDF

Você pode criar um documento PDF vazio instanciando o Documentclasse. Ao instanciar esta classe, você precisa passar por umPdfDocument objeto como um parâmetro para seu construtor.

Para desenhar um arco em um PdfDocument, instancie o PdfCanvas classe do pacote com.itextpdf.kernel.pdf.canvas e criar um arco usando o arc() método desta classe.

A seguir estão as etapas para desenhar um arco em um documento PDF.

Etapa 1: Criação de um objeto PdfWriter

o PdfWriterclasse representa o DocWriter para um PDF. Esta classe pertence ao pacotecom.itextpdf.kernel.pdf. O construtor desta classe aceita uma string, representando o caminho do arquivo onde o PDF será criado.

Instancie a classe PdfWriter passando um valor de string (representando o caminho onde você precisa criar um PDF) para seu construtor, conforme mostrado abaixo.

// Creating a PdfWriter 
String dest = "C:/itextExamples/drawingArc.pdf"; 
PdfWriter writer = new PdfWriter(dest);

Quando o objeto deste tipo é passado para um PdfDocument (classe), cada elemento adicionado a este documento será gravado no arquivo especificado.

Etapa 2: Criação de um objeto PdfDocument

o PdfDocumentclass é a classe que representa o documento PDF no iText. Esta classe pertence ao pacotecom.itextpdf.kernel.pdf. Para instanciar esta classe (no modo de escrita), você precisa passar um objeto da classePdfWriter para seu construtor.

Instancie a classe PdfDocument passando o objeto PdfWriter para seu construtor, conforme mostrado abaixo.

// Creating a PdfDocument  
PdfDocument pdfDoc = new PdfDocument(writer);

Depois que um objeto PdfDocument é criado, você pode adicionar vários elementos como página, fonte, anexo de arquivo e manipulador de eventos usando os respectivos métodos fornecidos por sua classe.

Etapa 3: Criação do objeto Documento

o Document classe do pacote com.itextpdf.layouté o elemento raiz ao criar um PDF autossuficiente. Um dos construtores desta classe aceita um objeto da classe PdfDocument.

Instancie o Document classe passando o objeto da classe PdfDocument criado nas etapas anteriores, conforme mostrado abaixo.

// Creating a Document   
Document document = new Document(pdfDoc);

Etapa 4: Criação de um objeto PdfCanvas

Crie um novo PdfPage classe usando o addNewPage() método do PdfDocument classe.

Instancie o PdfCanvas objeto do pacote com.itextpdf.kernel.pdf.canvas passando o criado acima PdfPage objeto ao construtor desta classe, como mostrado abaixo.

// Creating a new page 
PdfPage pdfPage = pdfDoc.addNewPage();           

// Creating a PdfCanvas object 
PdfCanvas canvas = new PdfCanvas(pdfPage);

Etapa 5: desenhando o arco

Desenhe o arco usando o arc() método do Canvas classe e preencha-a usando o fill() método, conforme mostrado abaixo.

// Drawing an arc 
canvas.arc(50, 50, 300, 545, 0, 360);   

// Filling the arc 
canvas.fill();

Etapa 6: Fechando o Documento

Feche o documento usando o close() método do Document classe, conforme mostrado abaixo.

// Closing the document 
document.close();

Exemplo

O programa Java a seguir demonstra como desenhar um arco em um documento PDF usando a biblioteca iText.

Ele cria um documento PDF com o nome drawingArc.pdf, desenha um arco nele e o salva no caminho C:/itextExamples/

Salve este código em um arquivo com o nome DrawingArc.java.

import com.itextpdf.kernel.color.Color; 
import com.itextpdf.kernel.pdf.PdfDocument; 
import com.itextpdf.kernel.pdf.PdfPage; 
import com.itextpdf.kernel.pdf.PdfWriter; 
import com.itextpdf.kernel.pdf.canvas.PdfCanvas; 
import com.itextpdf.layout.Document;  

public class DrawingArc {
   public static void main(String args[]) throws Exception {
      // Creating a PdfWriter
      String dest = "C:/itextExamples/drawingArc.pdf";
      PdfWriter writer = new PdfWriter(dest);      

      // Creating a PdfDocument object
      PdfDocument pdfDoc = new PdfDocument(writer);

      // Creating a Document object
      Document doc = new Document(pdfDoc);

      // Creating a new page
      PdfPage pdfPage = pdfDoc.addNewPage();

      // Creating a PdfCanvas object
      PdfCanvas canvas = new PdfCanvas(pdfPage);

      // Drawing an arc
      canvas.arc(50, 50, 300, 545, 0, 360);

      // Filling the arc
      canvas.fill();              

      // Closing the document
      doc.close();
      
      System.out.println("Object drawn on pdf successfully");       
   }     
}

Compile e execute o arquivo Java salvo no prompt de comando usando os seguintes comandos -

javac DrawingArc.java 
java DrawingArc

Após a execução, o programa acima cria um documento PDF, exibindo a seguinte mensagem.

Object drawn on pdf successfully

Se você verificar o caminho especificado, poderá encontrar o documento PDF criado, conforme mostrado abaixo.