iText - La clase Image - ¿Como agregar una imagen a un PDF? - ¿Como cambiarle el tamaño a una imagen con iText? - ¿Como rotar una imagen con iText?

Hola hace tiempo comencé esta sección de iText pero por fuerzas mayores no la puede continuar lo ultimo que vimos era como generar un tabla con iText, hoy vamos a ver imágenes en iText.

iText - La clase Image 

La clase Image (com.itextpdf.text.Image) es una clase abstracta, por lo cual como toda clase abstracta no se puede puede instanciar directamente, dicha clase se hereda de la clase Rectangle. Contiene todos los métodos necesarios para utilizar imágenes en iText.

Actualmente soporta muchos tipos diferentes de imágenes que luego ampliaremos, también es importante aclarar que para la manipulación de cada tipo de imagen tiene una clase relacionada en la cual contiene los métodos y propiedades necesarias para poder manipular la imagen.

iText - Image formatos Soportados

iText soporta los siguientes formatos de imagen:

Formatos soportados por iText JPEG, JPEG2000, GIF, PNG, BMP, WMF, TIFF, y JBIG2

iText - Clases relacionadas a los tipos de Image

iText al soportar diferentes tipos de imágenes posee una clase por cada uno, para realizar un tratamiento particular de datos. Tabla de clases relacionadas a los tipos de Image.

Tabla comparativas de clases relacionadas con los diferentes tipos de imágenes.

iText - Image - ¿Como insertar una imagen con iText? - ¿Como agregar una imagen a un PDF?

Vamos a dar por sabido, ya que todos son lectores habituales de este blog  (???) que previamente han abierto ya el documento y han puesto el path del pdf si no es asi pasar por aca.

Primero tenemos que obtener una instancia de la clase Image (com.itextpdf.text.Image) pero como es una clase abstracta debemos obtener una instancia mediante el método getInstance() pasandole por argumento la url/path de las imágenes, en nuestro caso "C:/Blog/Itext/images/00.jpg".

Image imagen = Image.getInstance("C:/Blog/Itext/images/00.jpg");

Finalmente tenemos que agregar esta imagen al documento:

documento.add(imagen);

Resultados:

Código completo:

package com.java.white.box.itext.images;
import java.io.FileOutputStream;
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Image;
import com.itextpdf.text.pdf.PdfWriter;

/**
 * @author nconde
 */
public class Main {

 /**
  * @param args
  */
 public static void main(String[] args) {

  // Por defecto es A4
  Document documento = new Document();
  try {
   // Obtenemos una instancia de un objeto PDFWriter
   PdfWriter.getInstance(documento, new FileOutputStream("pba.pdf"));
   documento.open();
  
   // Obtenemos una instancia de un objeto Image
   // pasandole por parametro la imagen.
                 Image imagen = Image.getInstance("C://Blog/Itext/images/00.jpg");
         
                        //Agregamos la imagen al documento.
                  documento.add(imagen);
 
   documento.close();

  } catch (DocumentException ex) {
   // Atrapamos excepciones concernientes al documentoo.
  } catch (java.io.IOException ex) {
   // Atrapamos excepciones concernientes al I/O.
  }
 }
}

iText - ¿Como cambiarle el tamaño a una imagen con iText?

Para modificar el tamaño de la imagen se utilizan los siguientes métodos:

• scaleAbsoluteWidth(): Recibe un float donde el mismo es el tamaño de ancho horizontal asignado a la imagen.   (Hablando de porcentaje)
• scaleAbsoluteHeight(): Recibe un float donde el mismo es el tamaño de alto vertical asignado a la imagen.  (Hablando de porcentaje)
• scalePercent(): Recibe un float donde el mismo es el porcentaje en el cual aplicara el ancho y alto de la imagen.
• scaleToFit(): Recibe dos float, definir el máximo de las dimensiones de la imagen. Si la relación de anchura / altura difiere de la relación de aspecto de la imagen, ya sea el ancho o la altura, será menor que el correspondiente parámetro de este método.
• scaleAbsolute: Tenemos 2 firmas una que recibe un solo float y otra que recibe dos float, escalar la imagen a un ancho absoluto y una altura absoluta.

Ya habiendo explicado los tipos de modificadores de tamaño de las imágenes comencemos.

Vamos a dar por sabido, ya que todos son lectores habituales de este blog  (???) que previamente han abierto ya el documento y han puesto el path del pdf si no es asi pasar por aca.

Primero tenemos que obtener una instancia de la clase Image (com.itextpdf.text.Image) pero como es una clase abstracta debemos obtener una instancia mediante el método getInstance() pasandole por argumento la url/path de las imágenes, en nuestro caso "C:/Blog/Itext/images/00.jpg".

Image imagen = Image.getInstance("C:/Blog/Itext/images/00.jpg");

Ahora para darle un tamaño de 20 por ciento:

imagen.scaleAbsoluteWidth(20f);

Finalmente tenemos que agregar esta imagen al documento:

documento.add(imagen);

Resultados:

Código completo:

package com.java.white.box.itext.images;
import java.io.FileOutputStream;
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Image;
import com.itextpdf.text.pdf.PdfWriter;

/**
 * @author usuario
 */
public class Main {

 /**
  * @param args
  */
 public static void main(String[] args) {

  // Por defecto es A4
  Document documento = new Document();

  try {
   // Obtenemos una instancia de un objeto PDFWriter
   PdfWriter.getInstance(documento, new FileOutputStream("Eje.pdf"));
   documento.open();
  
   // Obtenemos una instancia de un objeto Image
   // pasandole por parametro la imagen.
                 Image imagen = Image.getInstance("C:/images/00.jpg");
         
                 //Asignamos un 20 porciento de ancho.
                 imagen.scaleAbsoluteWidth(20f);
         
                        //Agregamos la imagen al documento.
                  documento.add(imagen);
 
   documento.close();

  } catch (DocumentException ex) {
   // Atrapamos excepciones concernientes al documentoo.
  } catch (java.io.IOException ex) {
   // Atrapamos excepciones concernientes al I/O.
  }
 }
}

iText - Image - ¿Como cambiar el borde de una imagen con iText?

Vamos a dar por sabido, ya que todos son lectores habituales de este blog  (???) que previamente han abierto ya el documento y han puesto el path del pdf si no es asi pasar por aca.

Primero tenemos que obtener una instancia de la clase Image (com.itextpdf.text.Image) pero como es una clase abstracta debemos obtener una instancia mediante el método getInstance() pasandole por argumento la url/path de las imágenes, en nuestro caso "C:/Blog/Itext/images/00.jpg".

Image imagen = Image.getInstance("C:/Blog/Itext/images/00.jpg");

Ahora vamos asignarle el tipo de borde, en nuestro caso sera el borde en todas sus cara es decir un rectángulo, para asignar el borde de utiliza el método setBorder():

imagen.setBorder(Image.BOX);

Luego asignamos el ancho del borde, con el método setBorderWidth():

imagen.setBorderWidth(10);

Luego para asignar el color se utiliza el método setBorderColor():

imagen.setBorderColor(BaseColor.RED);

Finalmente tenemos que agregar esta imagen al documento:

documento.add(imagen);

Resultados:

Código completo:

package com.java.white.box.itext.images;
import java.io.FileOutputStream;
import com.itextpdf.text.BaseColor;
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Image;
import com.itextpdf.text.pdf.PdfWriter;

/**
 * @author nconde
 */
public class Main {

 /**
  * @param args
  */
 public static void main(String[] args) {

  // Por defecto es A4
  Document documento = new Document();

  try {
   // Obtenemos una instancia de un objeto PDFWriter
   PdfWriter.getInstance(documento, new FileOutputStream("Ej4.pdf"));
   documento.open();
  
   // Obtenemos una instancia de un objeto Image
   // pasandole por parametro la imagen.
                 Image imagen = Image.getInstance("C:/images/00.jpg");
                  
                 //Asignamos el tipo de borde
                 imagen.setBorder(Image.BOX);
         
                //Asignamos el ancho del borde
                imagen.setBorderWidth(10);
         
                //Asignamos el color del borde
                imagen.setBorderColor(BaseColor.RED);
         
                       //Agregamos la imagen al documento.
                documento.add(imagen);
 
         documento.close();

  } catch (DocumentException ex) {
   // Atrapamos excepciones concernientes al documentoo.
  } catch (java.io.IOException ex) {
   // Atrapamos excepciones concernientes al I/O.
  }
 }
}

iText - Image - ¿Como rotar una imagen con iText? 

Vamos a dar por sabido, ya que todos son lectores habituales de este blog  (???) que previamente han abierto ya el documento y han puesto el path del pdf si no es asi pasar por aca.

Primero tenemos que obtener una instancia de la clase Image (com.itextpdf.text.Image) pero como es una clase abstracta debemos obtener una instancia mediante el método getInstance() pasandole por argumento la url/path de las imágenes, en nuestro caso "C:/Blog/Itext/images/00.jpg".

Image imagen = Image.getInstance("C:/Blog/Itext/images/00.jpg");

Ahora para rotar la imagen utilizaremos el metodo setRotationDegrees() el cual recibe un float, dicho método rotara la imagen en sentido contrario de las agujas del reloj, en nuestro ejemplo lo rotaremos 30 grados.

imagen.setRotationDegrees(30);

Finalmente tenemos que agregar esta imagen al documento:

documento.add(imagen);

Resultados:

Código completo:

package com.java.white.box.itext.images;
import java.io.FileOutputStream;
import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Image;
import com.itextpdf.text.pdf.PdfWriter;

/**
 * @author nconde
 */
public class Main {

 /**
  * @param args
  */
 public static void main(String[] args) {

  // Por defecto es A4
  Document documento = new Document();

  try {
   // Obtenemos una instancia de un objeto PDFWriter
   PdfWriter.getInstance(documento, new FileOutputStream("Eje.pdf"));
   documento.open();
  
   // Obtenemos una instancia de un objeto Image
   // pasandole por parametro la imagen.
                 Image imagen = Image.getInstance("C:/Blog/Itext/images/00.jpg");
         
                 //Asignamos una rotacion de 30 grados
                 imagen.setRotationDegrees(30);
         
                        //Agregamos la imagen al documento.
                 documento.add(imagen);
 
   documento.close();

  } catch (DocumentException ex) {
   // Atrapamos excepciones concernientes al documentoo.
  } catch (java.io.IOException ex) {
   // Atrapamos excepciones concernientes al I/O.
  }
 }
}