Rotacionar imagens programaticamente é uma necessidade frequente ao criar geradores de visualização, editores de fotos ou fluxos de trabalho de documentos. Conholdate.Total for Java fornece um SDK robusto que torna a manipulação de imagens simples em aplicações Java. Neste guia, você aprenderá como rotacionar arquivos PNG e JPG, configurar parâmetros de rotação e preservar metadados mantendo alta qualidade de imagem.

Preparação do Ambiente - Pré-requisitos e Configuração

Antes de começar, certifique‑se de que você tem o seguinte:

  • Java 17 ou mais recente instalado.
  • Uma IDE como IntelliJ IDEA ou Eclipse.
  • Maven para gerenciamento de dependências.

Adicione o repositório Maven da Conholdate e a dependência do SDK ao seu 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>

Baixe os binários mais recentes do SDK na página oficial de download: Conholdate.Total for Java Download. Depois que as dependências forem resolvidas, você está pronto para escrever código que gira imagens.

Rotacionar Imagem em Java: Guia Passo a Passo

Etapa 1: Carregar caminhos de origem e destino

Defina os locais dos arquivos de entrada e saída. O SDK funciona com os formatos PNG e JPG.

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

Etapa 2: Inicializar Manipulador de Conversão e Opções

Crie os objetos principais que conduzem o processo de conversão.

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

Etapa 3: Definir Ângulo de Rotação e Cor de Fundo

Especifique quantos graus girar a imagem e a cor de preenchimento para os cantos vazios.

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

Etapa 4: Configurar parâmetros adicionais

Preserve os metadados originais e defina a qualidade JPEG quando a saída for JPG.

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

Etapa 5: Executar a rotação

Chame o método convert para aplicar a rotação e gravar o resultado.

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

Para obter mais detalhes sobre a classe ConversionHandler, consulte a referência oficial da API.

Exemplo de Código Completo: Rotacionar Imagem em Java Usando Conholdate.Total

O exemplo a seguir demonstra o fluxo de trabalho completo para girar um arquivo de imagem.

Este exemplo demonstra como girar uma imagem JPG em 90 graus e salvar o 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 exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Parâmetros de Rotação: Opções e Configurações

O SDK oferece várias opções para ajustar finamente o processo de rotação.

  • Rotate Angle - Determina quantos graus a imagem é girada. Valores positivos giram no sentido horário.
options.setRotateAngle(90);

  • Cor de Fundo - Define a cor de preenchimento para os cantos vazios que aparecem após a rotação. Use qualquer valor java.awt.Color.

  • Preservar Metadados - Quando habilitado, os dados EXIF , DPI e outros metadados são mantidos no arquivo de saída. Consulte a ImageConvertOptions API para obter mais detalhes.

  • Qualidade - Controla a qualidade da compressão JPEG (0‑100). Valores mais altos mantêm mais detalhes, mas aumentam o tamanho do arquivo.

Ajuste essas configurações para atender aos requisitos da sua aplicação, seja você precisar de saída PNG sem perdas ou resultados JPG de alta qualidade.

Conclusão

Rotacionar imagens em Java é simples quando você usa Conholdate.Total for Java. Este guia orienta você através da configuração necessária, uma implementação detalhada passo a passo e as principais opções de configuração que permitem controlar o ângulo, o plano de fundo, a preservação de metadados e a qualidade de saída. Lembre‑se de adquirir uma licença adequada para implantações em produção; você pode explorar as opções de preços em https://purchase.conholdate.com/pricing/total/family/ ou obter uma licença temporária para testes em https://purchase.conholdate.com/temporary-license/. Com o SDK integrado, você pode adicionar rotação de imagem confiável a qualquer fluxo de trabalho baseado em Java.

Perguntas Frequentes

  • Como faço para girar um arquivo de imagem em Java usando Conholdate.Total?
    Use a classe ImageConvertOptions para definir o ângulo de rotação desejado e, em seguida, chame handler.convert(inputPath, outputPath, options) conforme mostrado nos exemplos acima.

  • Posso girar imagens PNG e JPG com o mesmo código?
    Sim, o SDK detecta automaticamente o formato de origem. Forneça a extensão de arquivo correta no caminho de entrada e o mesmo código funciona tanto para PNG quanto para JPG.

  • Quais opções estão disponíveis para personalizar o processo de rotação?
    Você pode ajustar o ângulo de rotação, a cor de fundo, a qualidade de saída e escolher se deseja preservar os metadados. Consulte a ImageConvertOptions API para a lista completa.

  • Preciso de uma licença para usar este recurso em produção?
    É necessária uma licença válida para uso em produção. Obtenha uma licença temporária para avaliação em https://purchase.conholdate.com/temporary-license/ ou veja os detalhes completos de preços em https://purchase.conholdate.com/pricing/total/family/.

Leia Mais