Padroneggiare la firma e l’ottimizzazione delle immagini con GroupDocs.Signature per Java

Nel panorama digitale odierno, firmare i documenti in modo sicuro è essenziale. Che tu sia un professionista che autentica contratti o un privato che protegge immagini, disporre di funzionalità di firma affidabili è fondamentale. GroupDocs.Signature per Java Offre potenti funzionalità per creare firme tramite codice QR e ottimizzare le opzioni di salvataggio delle immagini in modo semplice. Questo tutorial ti guiderà attraverso l’utilizzo di queste funzionalità per una gestione efficace dei documenti.

Cosa imparerai:

  • Generazione di firme tramite codice QR sulle immagini.
  • Configurazione delle opzioni di salvataggio avanzate BMP, GIF, JPEG, PNG e TIFF.
  • Implementazione di GroupDocs.Signature per Java nei tuoi progetti.
  • Applicazioni pratiche di queste caratteristiche.

Assicuriamoci che tutto sia impostato correttamente!

Prerequisiti

Prima di addentrarci nei dettagli dell’implementazione, assicurati di avere:

Librerie e dipendenze richieste

Per utilizzare GroupDocs.Signature per Java, integra la sua libreria nel tuo progetto. Ecco come includerla in base al tuo sistema di build:

Esperto

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-signature</artifactId>
    <version>23.12</version>
</dependency>

Gradle

implementation 'com.groupdocs:groupdocs-signature:23.12'

In alternativa, puoi scarica direttamente l’ultima versione se la configurazione del progetto lo richiede.

Requisiti di configurazione dell’ambiente

  • Java Development Kit (JDK) installato e configurato correttamente.
  • Un IDE come IntelliJ IDEA o Eclipse per lo sviluppo del codice.

Prerequisiti di conoscenza

Si consiglia una conoscenza di base della programmazione Java. La familiarità con gli strumenti di build Maven/Gradle sarà utile ma non necessaria, poiché vi guideremo attraverso il processo di configurazione.

Impostazione di GroupDocs.Signature per Java

Per iniziare a lavorare con GroupDocs.Signature, segui questi passaggi:

  1. Installa la dipendenza: Aggiungi la dipendenza appropriata al tuo pom.xml O build.gradle file come mostrato sopra.
  2. Acquisizione della licenza:
    • Ottieni un prova gratuita per esplorare tutte le funzionalità della biblioteca.
    • Per un uso prolungato, si consiglia di acquistare una licenza o di richiederne una temporanea tramite il loro pagina di acquisto.

Inizializzazione e configurazione di base

Dopo aver impostato l’ambiente, inizializzare GroupDocs.Signature creando un’istanza di Signature classe. Ecco come:

import com.groupdocs.signature.Signature;

public class SignatureSetup {
    public static void main(String[] args) throws Exception {
        // Inizializza con un percorso file alla directory del tuo documento
        String filePath = "YOUR_DOCUMENT_DIRECTORY/sampleImage.jpg";
        Signature signature = new Signature(filePath);
        
        System.out.println("GroupDocs.Signature initialized successfully!");
    }
}

Guida all’implementazione

Ora che hai la configurazione necessaria, passiamo all’implementazione di funzionalità specifiche utilizzando GroupDocs.Signature per Java.

Creazione di firme con codice QR sulle immagini

Panoramica

Questa sezione ti guiderà nella generazione di una firma tramite codice QR su un documento immagine. È particolarmente utile per incorporare metadati o informazioni direttamente nelle immagini in modo non invasivo.

Passaggio 1: inizializzare l’oggetto firma

Per prima cosa, crea un Signature oggetto che punta al file di destinazione.

String filePath = "YOUR_DOCUMENT_DIRECTORY/sampleImage.jpg";
Signature signature = new Signature(filePath);
Passaggio 2: imposta le opzioni di firma del codice QR

Configura le opzioni per la firma con un codice QR. Potrai specificare dettagli come il contenuto e il posizionamento.

import com.groupdocs.signature.domain.qrcodes.QrCodeTypes;
import com.groupdocs.signature.options.sign.QrCodeSignOptions;

QrCodeSignOptions signOptions = new QrCodeSignOptions("JohnSmith");
signOptions.setEncodeType(QrCodeTypes.QR);
signOptions.setLeft(100);  // Posizione dal margine sinistro
signOptions.setTop(100);   // Posizione dal margine superiore
Fase 3: Firmare il documento

Infine, applica la firma con codice QR al tuo documento.

signature.sign("output/imageWithQR.jpg", signOptions);
System.out.println("QR Code Signature Applied Successfully!");

Configurazione delle opzioni avanzate di salvataggio delle immagini

Configurazione delle opzioni di salvataggio BMP

Questa configurazione consente di personalizzare il modo in cui le immagini vengono salvate in formato BMP. È possibile regolare compressione, risoluzione e altri parametri in base alle proprie esigenze.

import com.groupdocs.signature.options.saveoptions.imagessaveoptions.BmpSaveOptions;
import com.groupdocs.signature.domain.enums.BitmapCompression;

BmpSaveOptions bmpSaveOptions = new BmpSaveOptions();
bmpSaveOptions.setAddMissingExtenstion(true);
bmpSaveOptions.setCompression(BitmapCompression.Rgb);
bmpSaveOptions.setHorizontalResolution(7);
bmpSaveOptions.setVerticalResolution(7);
bmpSaveOptions.setBitsPerPixel(16);
bmpSaveOptions.setOverwriteExistingFiles(true);

Configurazione delle opzioni di salvataggio GIF

Quando si salvano le immagini come GIF, è possibile controllare aspetti quali il colore di sfondo e l’ordinamento della tavolozza.

import com.groupdocs.signature.options.saveoptions.imagessaveoptions.GifSaveOptions;

GifSaveOptions gifSaveOptions = new GifSaveOptions();
gifSaveOptions.setBackgroundColorIndex((byte) 2);
gifSaveOptions.setColorResolution((byte) 7);
gifSaveOptions.setDoPaletteCorrection(true);
gifSaveOptions.setTrailer(true);
gifSaveOptions.setInterlaced(false);
gifSaveOptions.setPaletteSorted(true);
gifSaveOptions.setPixelAspectRatio((byte) 24);
gifSaveOptions.setAddMissingExtenstion(true);

Configurazione delle opzioni di salvataggio JPEG

Ottimizza i salvataggi delle immagini JPEG con le impostazioni relative a qualità, tipo di colore e modalità di compressione.

import com.groupdocs.signature.options.saveoptions.imagessaveoptions.JpegSaveOptions;
import com.groupdocs.signature.domain.enums.JpegCompressionColorMode;
import com.groupdocs.signature.domain.enums.JpegCompressionMode;
import com.groupdocs.signature.domain.enums.JpegRoundingMode;

JpegSaveOptions jpegSaveOptions = new JpegSaveOptions();
jpegSaveOptions.setAddMissingExtenstion(true);
jpegSaveOptions.setBitsPerChannel((byte) 8);
jpegSaveOptions.setColorType(JpegCompressionColorMode.Rgb);
jpegSaveOptions.setComment("signed jpeg file");
jpegSaveOptions.setCompressionType(JpegCompressionMode.Lossless);
jpegSaveOptions.setQuality(100);
jpegSaveOptions.setSampleRoundingMode(JpegRoundingMode.Extrapolate);

Configurazione delle opzioni di salvataggio PNG

Con PNG puoi definire la profondità di bit e i livelli di compressione in base alle tue esigenze.

import com.groupdocs.signature.options.saveoptions.imagessaveoptions.PngSaveOptions;
import com.groupdocs.signature.domain.enums.PngColorType;
import com.groupdocs.signature.domain.enums.PngFilterType;

PngSaveOptions pngSaveOptions = new PngSaveOptions();
pngSaveOptions.setBitDepth((byte) 8);
pngSaveOptions.setColorType(PngColorType.Grayscale);
pngSaveOptions.setCompressionLevel(9);
pngSaveOptions.setFilterType(PngFilterType.Adaptive);
pngSaveOptions.setProgressive(true);
pngSaveOptions.setAddMissingExtenstion(true);

Configurazione delle opzioni di salvataggio TIFF

Per le immagini TIFF è possibile specificare il formato e altre impostazioni rilevanti.

import com.groupdocs.signature.options.saveoptions.imagessaveoptions.TiffSaveOptions;
import com.groupdocs.signature.domain.enums.TiffFormat;

TiffSaveOptions tiffSaveOptions = new TiffSaveOptions();
tiffSaveOptions.setExpectedTiffFormat(TiffFormat.TiffNoCompressionBw);
tiffSaveOptions.setAddMissingExtenstion(true);

Applicazioni pratiche

Casi d’uso nel mondo reale

  1. Firma del contratto: Incorpora i codici QR nelle immagini dei contratti per una verifica rapida.
  2. Materiali di marketing: Aggiungi informazioni sul marchio direttamente sui materiali promozionali utilizzando i codici QR.
  3. Archiviazione delle immagini: Ottimizza le impostazioni di salvataggio delle immagini per mantenere la qualità e ridurre le dimensioni del file durante l’archiviazione.