Rotar imágenes programáticamente es una necesidad frecuente al crear generadores de vistas previas, editores de fotos o flujos de trabajo de documentos. Conholdate.Total for Java ofrece un SDK robusto que hace que la manipulación de imágenes sea sencilla en aplicaciones Java. En esta guía aprenderá cómo rotar archivos PNG y JPG, configurar los parámetros de rotación y conservar los metadatos mientras se mantiene alta la calidad de la imagen.

Preparación del entorno - Requisitos y configuración

Antes de comenzar, asegúrese de tener lo siguiente:

  • Java 17 o más reciente instalado.
  • Un IDE como IntelliJ IDEA o Eclipse.
  • Maven para la gestión de dependencias.

Agregue el repositorio Maven de Conholdate y la dependencia del SDK a su pom.xml:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

Descargue los binarios más recientes del SDK desde la página oficial de descarga: Conholdate.Total for Java Download. Una vez que se resuelvan las dependencias, está listo para escribir código que rota imágenes.

Rotar imagen en Java: guía paso a paso

Paso 1: Cargar rutas de origen y destino

Defina las ubicaciones de los archivos de entrada y salida. El SDK funciona con los formatos PNG y JPG.

String inputPath = "input.jpg";
String outputPath = "output_rotated.jpg";

Paso 2: Inicializar el controlador de conversión y las opciones

Cree los objetos centrales que impulsan el proceso de conversión.

ConversionHandler handler = new ConversionHandler();
ImageConvertOptions options = new ImageConvertOptions();

Paso 3: Establecer ángulo de rotación y color de fondo

Especifique cuántos grados girar la imagen y el color de relleno para las esquinas vacías.

options.setRotateAngle(90);               // Rotate 90 degrees clockwise
options.setBackgroundColor(Color.WHITE);  // Fill empty space with white

Paso 4: Configurar parámetros adicionales

Conserve los metadatos originales y defina la calidad JPEG cuando la salida sea JPG.

options.setPreserveMetadata(true);
options.setQuality(90); // JPEG quality (0‑100)

Paso 5: Ejecutar la rotación

Llame al método convert para aplicar la rotación y escribir el resultado.

handler.convert(inputPath, outputPath, options);
System.out.println("Image rotated successfully: " + outputPath);

Para obtener más detalles sobre la clase ConversionHandler, consulte la referencia oficial de la API.

Ejemplo completo de código: Rotar imagen en Java usando Conholdate.Total

El siguiente ejemplo muestra el flujo de trabajo completo para rotar un archivo de imagen.

Este ejemplo muestra cómo rotar una imagen JPG 90 grados y guardar el resultado.

import com.groupdocs.conversion.ConversionHandler;
import com.groupdocs.conversion.options.convert.ImageConvertOptions;
import java.awt.Color;

public class RotateImageExample {
    public static void main(String[] args) {
        String inputPath = "input.jpg";
        String outputPath = "output_rotated.jpg";

try (ConversionHandler handler = new ConversionHandler()) {
            ImageConvertOptions options = new ImageConvertOptions();
            // Rotation angle in degrees (positive = clockwise)
            options.setRotateAngle(90);
            // Background color for empty areas after rotation
            options.setBackgroundColor(Color.WHITE);
            // Preserve original metadata (EXIF, DPI, etc.)
            options.setPreserveMetadata(true);
            // Optional: for large images you can limit memory usage
            options.setQuality(90); // JPEG quality (0-100)

handler.convert(inputPath, outputPath, options);
            System.out.println("Image rotated successfully: " + outputPath);
        } catch (Exception e) {
            System.err.println("Error during image rotation:");
            e.printStackTrace();
        }
    }
}

Nota: Este ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Parámetros de rotación: opciones y configuraciones

El SDK ofrece varias opciones para afinar el proceso de rotación.

  • Rotate Angle - Determina cuántos grados se gira la imagen. Los valores positivos giran en sentido horario.
options.setRotateAngle(90);

  • Color de fondo - Establece el color de relleno para las esquinas vacías que aparecen después de la rotación. Use cualquier valor java.awt.Color.

  • Conservar metadatos - Cuando está habilitado, los datos EXIF, DPI y otros metadatos se conservan en el archivo de salida. Consulte la ImageConvertOptions API para obtener más detalles.

  • Calidad - Controla la calidad de compresión JPEG (0‑100). Los valores más altos conservan más detalle pero aumentan el tamaño del archivo.

Ajuste estas configuraciones para que coincidan con los requisitos de su aplicación, ya sea que necesite una salida PNG sin pérdida o resultados JPG de alta‑calidad.

Conclusión

Rotar imágenes en Java es sencillo cuando utilizas Conholdate.Total for Java. Esta guía te lleva a través de la configuración requerida, una implementación detallada paso a paso y las opciones clave de configuración que te permiten controlar el ángulo, el fondo, la preservación de metadatos y la calidad de salida. Recuerda obtener una licencia adecuada para implementaciones en producción; puedes explorar las opciones de precios en https://purchase.conholdate.com/pricing/total/family/ o obtener una licencia temporal para pruebas en https://purchase.conholdate.com/temporary-license/. Con el SDK integrado, puedes añadir una rotación de imágenes confiable a cualquier flujo de trabajo basado en Java.

Preguntas frecuentes

  • ¿Cómo rotar un archivo de imagen en Java usando Conholdate.Total?
    Utilice la clase ImageConvertOptions para establecer el ángulo de rotación deseado y luego llame a handler.convert(inputPath, outputPath, options) como se muestra en los ejemplos anteriores.

  • ¿Puedo rotar imágenes PNG y JPG con el mismo código?
    Sí, el SDK detecta automáticamente el formato de origen. Proporcione la extensión de archivo correcta en la ruta de entrada y el mismo código funciona tanto para PNG como para JPG.

  • ¿Qué opciones están disponibles para personalizar el proceso de rotación?
    Puede ajustar el ángulo de rotación, el color de fondo, la calidad de salida y elegir si desea conservar los metadatos. Consulte la ImageConvertOptions API para obtener la lista completa.

  • ¿Necesito una licencia para usar esta función en producción? Se requiere una licencia válida para uso en producción. Obtenga una licencia temporal para evaluación en https://purchase.conholdate.com/temporary-license/ o consulte los detalles completos de precios en https://purchase.conholdate.com/pricing/total/family/.

Leer más