Aggiungi sovrapposizione di testo a GIF usando REST in Java - Codice di esempio

Questo esempio dimostra come configurare una filigrana di testo e applicarla a ogni fotogramma di un file GIF.

import com.groupdocs.watermark.cloud.api.WatermarkApi;
import com.groupdocs.watermark.cloud.client.ApiException;
import com.groupdocs.watermark.cloud.client.Configuration;
import com.groupdocs.watermark.cloud.model.AddWatermarkRequest;
import com.groupdocs.watermark.cloud.model.AddWatermarkResponse;
import com.groupdocs.watermark.cloud.model.FileInfo;
import com.groupdocs.watermark.cloud.model.OutputFileInfo;
import com.groupdocs.watermark.cloud.model.TextWatermarkOptions;
import com.groupdocs.watermark.cloud.model.HorizontalAlignment;
import com.groupdocs.watermark.cloud.model.VerticalAlignment;

public class AddTextOverlayToGif {
    public static void main(String[] args) {
        // Initialize API configuration (replace with your actual clientId and clientSecret)
        Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(config);

// Prepare input file information
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.gif");          // Path to the source GIF in the storage
        inputFile.setStorageName("MyStorage");       // Optional: name of the storage

// Prepare output file information
        OutputFileInfo outputFile = new OutputFileInfo();
        outputFile.setFilePath("output.gif");        // Desired path for the watermarked GIF
        outputFile.setStorageName("MyStorage");      // Optional: name of the storage

// Configure text watermark options
        TextWatermarkOptions textOptions = new TextWatermarkOptions();
        textOptions.setText("Sample Watermark");
        textOptions.setFontFamily("Arial");
        textOptions.setFontSize(24.0);
        textOptions.setColor("#FF0000");             // Red color in HEX
        textOptions.setOpacity(0.5);                 // 50% opacity
        textOptions.setRotationAngle(0.0);
        textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
        textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
        textOptions.setPageRange("1-");               // Apply to all frames/pages

// Build the request
        AddWatermarkRequest request = new AddWatermarkRequest();
        request.setFileInfo(inputFile);
        request.setOutputFileInfo(outputFile);
        request.setOptions(textOptions);

try {
            // Execute the request
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (ApiException e) {
            System.err.println("Error while adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Sovrapporre testo su GIF con REST API usando cURL

Di seguito sono riportati i comandi cURL che eseguono la stessa operazione da un terminale. Illustrano l’intero flusso di lavoro REST: autenticazione, caricamento, aggiunta di filigrana e download.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Sostituisci YOUR_ACCESS_TOKEN nelle chiamate seguenti con il token restituito sopra.

# 2. Upload the source GIF to storage
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @path/to/local/input.gif

# 3. Add text overlay to the GIF
curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.gif", "storageName": "MyStorage" },
           "outputFileInfo": { "filePath": "output.gif", "storageName": "MyStorage" },
           "options": {
               "text": "Sample Watermark",
               "fontFamily": "Arial",
               "fontSize": 24,
               "color": "#FF0000",
               "opacity": 0.5,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Middle",
               "pageRange": "1-"
           }
         }'

# 4. Download the watermarked GIF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.gif" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o path/to/local/output.gif

Per ulteriori dettagli su corpi della richiesta e formati di risposta, consulta la documentazione ufficiale dell’API.

Analisi dell’aggiunta di testo sovrapposto a GIF usando REST in Java - Come funziona

1. Inizializza il client API - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") crea un oggetto di configurazione che contiene le tue credenziali. L’istanza WatermarkApi utilizza questa configurazione per firmare ogni richiesta.

Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(config);

2. Specifica i file di origine e destinazione - FileInfo e OutputFileInfo indicano al servizio dove leggere il GIF originale e dove scrivere il risultato. Entrambi possono fare riferimento a un nome di storage personalizzato.

   FileInfo inputFile = new FileInfo();
   inputFile.setFilePath("input.gif");
   inputFile.setStorageName("MyStorage");
   

3. Configura il watermark di testo - TextWatermarkOptions contiene tutte le proprietà visive: testo, carattere, dimensione, colore, opacità, rotazione e allineamento. Impostare pageRange su "1-" garantisce che ogni fotogramma della GIF animata riceva la sovrapposizione.

TextWatermarkOptions textOptions = new TextWatermarkOptions();
textOptions.setText("Sample Watermark");
textOptions.setFontFamily("Arial");
textOptions.setFontSize(24.0);
textOptions.setColor("#FF0000");
textOptions.setOpacity(0.5);
textOptions.setHorizontalAlignment(HorizontalAlignment.CENTER);
textOptions.setVerticalAlignment(VerticalAlignment.MIDDLE);
textOptions.setPageRange("1-");

4. Costruisci e invia la richiesta - AddWatermarkRequest raggruppa le informazioni del file e le opzioni. Chiamando watermarkApi.addWatermark(request) esegue l’operazione sul server e restituisce il percorso del file elaborato.

   AddWatermarkRequest request = new AddWatermarkRequest();
   request.setFileInfo(inputFile);
   request.setOutputFileInfo(outputFile);
   request.setOptions(textOptions);
   AddWatermarkResponse response = watermarkApi.addWatermark(request);
   

5. Gestire la risposta - La risposta contiene il percorso del file di output. In un’applicazione reale, di solito si scarica il file o si passa il percorso a un altro servizio.

Per un elenco completo di classi e proprietà, fare riferimento al riferimento API.

Installazione e configurazione GroupDocs.Watermark Cloud SDK per Java

Aggiungi la dipendenza Maven al tuo pom.xml (o l’equivalente voce Gradle). Questo include la versione 23.8 dell’SDK.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

Prerequisiti

• Java 8 o versioni successive
• Un account attivo di GroupDocs Cloud
• Client ID e Client Secret (disponibili nella dashboard di GroupDocs Cloud)

Esempio di configurazione

Configuration config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Scarica gli ultimi JAR dalla pagina di download. Per l’uso in produzione, applica una licenza valida ottenuta dalla pagina di licenza temporanea.

Conclusione

Aggiungere una sovrapposizione di testo a una GIF usando REST in Java diventa un’operazione ripetibile, lato server, grazie al GroupDocs.Watermark Cloud SDK for Java. L’SDK astrae le complessità della gestione dei fotogrammi animati, permettendoti di concentrarti sul contenuto dei tuoi sottotitoli o messaggi promozionali. Dopo aver integrato il codice di esempio o il flusso di lavoro cURL, puoi perfezionare stili di carattere, colori e opacità per adattarli al tuo brand. Ricorda di ottenere una licenza di produzione; i dettagli dei prezzi sono disponibili nella pagina del prodotto, e una licenza temporanea può essere ottenuta per i test tramite la temporary license page. Buona programmazione!

Domande frequenti

• Come aggiungere una sovrapposizione di testo a un GIF usando REST in Java quando il testo cambia per utente?
  Crea l’oggetto TextWatermarkOptions a runtime con la stringa specifica per l’utente, quindi invoca la stessa chiamata addWatermark. L’API elabora ogni richiesta in modo indipendente, quindi il contenuto dinamico è completamente supportato.

• Posso aggiungere sottotitoli a una GIF animata senza influire sulla velocità di animazione?
  Sì. Il watermark viene applicato a ogni fotogramma preservando il ritardo originale del fotogramma. Basta impostare pageRange su "1-" in modo che ogni fotogramma riceva la stessa sovrapposizione.

• Quali formati sono supportati per il colore del testo di sovrapposizione?
  L’SDK accetta codici colore HEX (ad esempio #FF0000) e i nomi colore standard HTML. Vedi il riferimento API per l’elenco completo.

• Ho bisogno di una licenza per sviluppo e test?
  Una licenza temporanea è sufficiente per la valutazione e i test. Per le distribuzioni in produzione, acquista una licenza completa dalla pagina del prodotto e applicala utilizzando l’API di licenza dell’SDK.

Leggi di più

• Aggiungi testo sovrapposto a una GIF usando l’API REST in C#
• Aggiungi filigrana alle immagini usando Java
• Aggiungi filigrana a Word in Java - Watermark Creator

Prerequisiti e Configurazione

Prima di iniziare, assicurati di avere quanto segue:

• Java 8 o versioni successive installato.
• Maven o Gradle per la gestione delle dipendenze.
• Un account GroupDocs Cloud con client ID e client secret.
• Accesso allo storage cloud dove risiederanno i file Excel.

Aggiungi la dipendenza Maven al tuo pom.xml (o lo snippet Gradle equivalente):

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Puoi scaricare gli ultimi JAR dalla pagina di download. Dopo aver aggiunto la dipendenza, crea un oggetto di configurazione con le tue credenziali:

String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";

Configuration config = new Configuration(clientId, clientSecret);
MergerApi mergerApi = new MergerApi(config);

Con il client pronto, puoi passare al flusso di lavoro di protezione con password.

Proteggi con password Excel tramite REST in Java: Guida passo passo

Passo 1: Carica il documento di origine

Definisci la posizione del file XLSX di origine nel tuo storage cloud.

FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.xlsx");   // source Excel file

Passo 2: Imposta il percorso di destinazione

Specifica dove verrà salvato il workbook protetto.

String outputPath = "output_protected.xlsx"; // destination file

Passo 3: Configura le opzioni di protezione con password

Crea un oggetto ProtectOptions, allega le informazioni del file, il percorso di output e la password desiderata.

ProtectOptions protectOptions = new ProtectOptions();
protectOptions.setFileInfo(inputFile);
protectOptions.setOutputPath(outputPath);
protectOptions.setPassword("MySecretPassword"); // desired password

Passo 4: Crea la richiesta di protezione del documento

Avvolgi le opzioni in un ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Passo 5: Esegui la richiesta e gestisci la risposta

Chiama il metodo API e gestisci eventuali errori.

try {
    mergerApi.protectDocument(request);
    System.out.println("Excel file has been password protected successfully.");
    System.out.println("Protected file stored at: " + outputPath);
} catch (ApiException e) {
    System.err.println("Error while protecting the Excel file:");
    System.err.println("Status Code: " + e.getCode());
    System.err.println("Message: " + e.getMessage());
}

Per ulteriori dettagli su ogni classe, fare riferimento al Riferimento API.

Esempio completo funzionante per proteggere Excel con password tramite REST in Java

Il codice seguente dimostra il processo completo dall’inizio alla fine.

import com.groupdocs.merger.cloud.ApiException;
import com.groupdocs.merger.cloud.Configuration;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.ProtectOptions;
import com.groupdocs.merger.cloud.model.requests.ProtectDocumentRequest;

public class ProtectExcelExample {
    public static void main(String[] args) {
        // Replace with your actual client credentials
        String clientId = "YOUR_CLIENT_ID";
        String clientSecret = "YOUR_CLIENT_SECRET";

// Initialize the API configuration
        Configuration config = new Configuration(clientId, clientSecret);
        MergerApi mergerApi = new MergerApi(config);

// Define input and output file locations (relative to the storage root)
        FileInfo inputFile = new FileInfo();
        inputFile.setFilePath("input.xlsx");          // source Excel file
        String outputPath = "output_protected.xlsx";  // destination file

// Set password protection options
        ProtectOptions protectOptions = new ProtectOptions();
        protectOptions.setFileInfo(inputFile);
        protectOptions.setOutputPath(outputPath);
        protectOptions.setPassword("MySecretPassword"); // desired password

// Build the request
        ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

try {
            // Execute the password protection operation
            mergerApi.protectDocument(request);
            System.out.println("Excel file has been password protected successfully.");
            System.out.println("Protected file stored at: " + outputPath);
        } catch (ApiException e) {
            System.err.println("Error while protecting the Excel file:");
            System.err.println("Status Code: " + e.getCode());
            System.err.println("Message: " + e.getMessage());
        }
    }
}

Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di usarlo nel tuo progetto, assicurati di aggiornare i percorsi dei file (input.xlsx, output_protected.xlsx) per corrispondere alle tue effettive posizioni dei file, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.

Proteggi la cartella di lavoro Excel tramite REST API usando cURL

Di seguito è un insieme di comandi cURL che eseguono la stessa operazione di protezione con password direttamente contro gli endpoint REST.

1. Autenticare e ottenere un token di accesso

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

La risposta contiene un access_token che utilizzerai nelle chiamate successive.

2. Carica il file XLSX di origine

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.xlsx

3. Richiedi la protezione con password

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/protect" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "outputPath": "output_protected.xlsx",
           "password": "MySecretPassword"
         }'

4. Scarica la cartella di lavoro protetta

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output_protected.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output_protected.xlsx

Questi comandi ti consentono di integrare il flusso di lavoro di protezione negli script o nelle pipeline CI. Per ulteriori dettagli, consulta la documentazione ufficiale dell’API.

Conclusione

Implementare Protezione con password di Excel via REST in Java è semplice con il GroupDocs.Merger Cloud SDK for Java. Seguendo i passaggi sopra puoi proteggere i workbook di Excel, automatizzare il processo nelle applicazioni lato server e mantenere i dati sensibili al sicuro. Ricorda di acquisire una licenza adeguata per l’uso in produzione; le informazioni sui prezzi sono disponibili nella pagina del prodotto e puoi iniziare con una licenza temporanea per valutare la libreria. Buona programmazione!

Domande frequenti

• Come differisce la protezione con password di Excel tramite REST in Java dalla crittografia locale?
  L’API cloud esegue la crittografia sul server, quindi non è necessario gestire le librerie crittografiche localmente. L’SDK gestisce la costruzione della richiesta e l’analisi della risposta, semplificando l’integrazione.

• È possibile impostare opzioni di protezione aggiuntive, come la modalità di sola lettura?
  La classe ProtectOptions attuale si concentra sulla protezione con password. Per funzionalità di sicurezza più avanzate, consultare il riferimento API per eventuali nuovi parametri.

• Quali formati di file sono supportati per la protezione con password?
  L’API Merger attualmente supporta XLSX, DOCX, PPTX, e PDF per la crittografia. Consulta la documentazione ufficiale per l’elenco completo.

• Ho bisogno di una licenza per eseguire l’esempio in un ambiente di sviluppo?
  Lo sviluppo e i test possono essere eseguiti con una licenza temporanea. Le distribuzioni in produzione richiedono una licenza a pagamento, che è possibile acquistare tramite la pagina del prodotto.

Read More

• Proteggi con password i file PowerPoint in Node.js
• Proteggi con password i file Excel usando l’API REST in Python
• Unisci fogli Excel in Java - Unione di file Excel