iText - Desenhando um Círculo

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

Desenhando um Círculo 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 círculo em um PdfDocument, instancie o PdfCanvas classe do pacote com.itextpdf.kernel.pdf.canvas e invocar o circle() método desta classe.

A seguir estão as etapas para desenhar um círculo 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/drawingCircle.pdf"; 
PdfWriter writer = new PdfWriter(dest);

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

Etapa 2: Criar 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 PdfDocumentclasse. Instancie oPdfCanvas objeto do pacote com.itextpdf.kernel.pdf.canvas passando o 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 Definir a cor

Defina a cor do círculo usando o setColor() método do Canvas classe, conforme mostrado abaixo.

// Setting color to the circle 
Color color = Color.GREEN; 
canvas.setColor(color, true);

Etapa 6: Desenhar o Círculo

Desenhe um círculo invocando o circle() método do Canvas, como mostrado abaixo.

// creating a circle 
canvas.circle(300, 400, 200);

Etapa 7: 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 círculo em um documento PDF usando a biblioteca iText. Ele cria um documento PDF com o nomedrawingCircle.pdf, desenha um círculo nele e o salva no caminho C:/itextExamples/

Salve este código em um arquivo com o nome DrawingCircle.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 DrawingCircle {      
   public static void main(String args[]) throws Exception {           
      // Creating a PdfWriter       
      String dest = "C:/itextExamples/drawingCircle.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);  
      
      // Setting color to the circle
      Color color = Color.GREEN;       
      canvas.setColor(color, true);              
      
      // creating a circle
      canvas.circle(300, 400, 200);
      
      // Filling the circle       
      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 comandos a seguir.

javac DrawingCircle.java 
java DrawingCircle

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.