Ajouter une superposition de texte à un GIF en utilisant REST en Java - Exemple de code

Cet exemple montre comment configurer un filigrane texte et l’appliquer à chaque image d’un fichier 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();
        }
    }
}

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez-vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Superposer du texte sur un GIF avec l’API REST en utilisant cURL

Voici les commandes cURL qui effectuent la même opération depuis un terminal. Elles illustrent le flux de travail complet de l’API REST : authentification, téléversement, ajout de filigrane et téléchargement.

# 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"}'

Remplacez YOUR_ACCESS_TOKEN dans les appels suivants par le jeton renvoyé ci‑dessus.

# 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

Pour plus de détails sur les corps de requête et les formats de réponse, consultez la documentation officielle de l’API.

Analyse détaillée de l’ajout d’une superposition de texte à un GIF via REST en Java - Fonctionnement

1. Initialiser le client API - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") crée un objet de configuration qui contient vos identifiants. L’instance WatermarkApi utilise cette configuration pour signer chaque requête.

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

2. Spécifier les fichiers source et destination - FileInfo et OutputFileInfo indiquent au service où lire le GIF original et où écrire le résultat. Les deux peuvent faire référence à un nom de stockage personnalisé.

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

3. Configurer le filigrane texte - TextWatermarkOptions contient toutes les propriétés visuelles : texte, police, taille, couleur, opacité, rotation et alignement. Définir pageRange sur "1-" garantit que chaque image du GIF animé reçoit la superposition.

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. Construire et envoyer la requête - AddWatermarkRequest regroupe les informations du fichier et les options. L’appel de watermarkApi.addWatermark(request) exécute l’opération sur le serveur et renvoie le chemin du fichier traité.

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

5. Gérer la réponse - La réponse contient le chemin du fichier de sortie. Dans une application réelle, vous téléchargeriez généralement le fichier ou transmettriez le chemin à un autre service.

Pour une liste complète des classes et des propriétés, consultez la référence API.

Installation et configuration de GroupDocs.Watermark Cloud SDK for Java

Ajoutez la dépendance Maven à votre pom.xml (ou l’entrée Gradle équivalente). Cela récupère la version 23.8 du SDK.

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

Prérequis

• Java 8 ou version supérieure
• Un compte GroupDocs Cloud actif
• Client ID et Client Secret (disponibles dans le tableau de bord GroupDocs Cloud)

Exemple de configuration

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

Téléchargez les derniers JAR depuis la page de téléchargement. Pour une utilisation en production, appliquez une licence valide obtenue à partir de la page de licence temporaire.

Conclusion

Ajouter une superposition de texte à un GIF en utilisant REST en Java devient une opération répétable côté serveur grâce au GroupDocs.Watermark Cloud SDK for Java. Le SDK abstrait les complexités de la gestion des images animées, vous permettant de vous concentrer sur le contenu de vos sous‑titres ou messages promotionnels. Après avoir intégré le code d’exemple ou le workflow cURL, vous pouvez affiner les styles de police, les couleurs et l’opacité pour correspondre à votre marque. N’oubliez pas d’obtenir une licence de production ; les détails de tarification sont disponibles sur la page produit, et une licence temporaire peut être obtenue pour les tests via la page de licence temporaire. Bon codage !

FAQs

• Comment ajouter une superposition de texte à un GIF en utilisant REST en Java lorsque le texte change selon l’utilisateur ?
  Créez l’objet TextWatermarkOptions à l’exécution avec la chaîne spécifique à l’utilisateur, puis appelez la même méthode addWatermark. L’API traite chaque requête de manière indépendante, de sorte que le contenu dynamique est entièrement pris en charge.

• Puis-je ajouter des sous-titres à un GIF animé sans affecter sa vitesse d’animation ?
  Oui. Le filigrane est appliqué à chaque image tout en préservant le délai d’image d’origine. Il suffit de définir pageRange sur "1-" afin que chaque image reçoive la même superposition.

• Quels formats sont pris en charge pour la couleur du texte superposé ?
  Le SDK accepte les codes couleur HEX (par exemple, #FF0000) et les noms de couleur standard HTML. Consultez la référence API pour la liste complète.

• Ai-je besoin d’une licence pour le développement et les tests ?
  Une licence temporaire suffit pour l’évaluation et les tests. Pour les déploiements en production, achetez une licence complète depuis la page du produit et appliquez‑la à l’aide de l’API de licence du SDK.

Read More

• Ajouter du texte superposé à un GIF à l’aide de l’API REST en C#
• Ajouter un filigrane aux images avec Java
• Ajouter un filigrane à Word en Java - Créateur de filigrane

Prérequis et configuration

Avant de commencer, assurez‑vous d’avoir ce qui suit :

• Java 8 ou version supérieure installé.
• Maven ou Gradle pour la gestion des dépendances.
• Un compte GroupDocs Cloud avec client ID et client secret.
• Accès au stockage cloud où les fichiers Excel seront stockés.

Ajoutez la dépendance Maven à votre pom.xml (ou le fragment Gradle équivalent) :

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

Vous pouvez télécharger les dernières JAR depuis la page de téléchargement. Après avoir ajouté la dépendance, créez un objet de configuration avec vos identifiants :

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

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

Une fois le client prêt, vous pouvez passer au flux de travail réel de protection par mot de passe.

Protéger par mot de passe un fichier Excel via REST en Java : guide étape par étape

Étape 1 : Charger le document source

Définissez l’emplacement du fichier XLSX source dans votre stockage cloud.

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

Étape 2 : définir le chemin de destination

Spécifiez où le classeur protégé sera enregistré.

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

Étape 3 : Configurer les options de protection par mot de passe

Créez un objet ProtectOptions, joignez les informations du fichier, le chemin de sortie et le mot de passe souhaité.

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

Étape 4 : Construire la requête de protection du document

Enveloppez les options dans un ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Étape 5 : Exécuter la requête et gérer la réponse

Appelez la méthode API et traitez les éventuelles erreurs.

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());
}

Pour plus de détails sur chaque classe, consultez la référence API.

Exemple complet fonctionnel pour protéger par mot de passe un fichier Excel via REST en Java

Le code suivant montre le processus complet du début à la fin.

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());
        }
    }
}

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour les chemins de fichiers (input.xlsx, output_protected.xlsx) pour qu’ils correspondent à vos emplacements réels, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Protéger le classeur Excel via l’API REST avec cURL

Voici un ensemble de commandes cURL qui effectuent la même opération de protection par mot de passe directement contre les points de terminaison REST.

1. Authentifiez‑vous et obtenez un jeton d’accès

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 réponse contient un access_token que vous utiliserez dans les appels suivants.

2. Télécharger le fichier XLSX source

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. Demander la protection par mot de passe

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. Télécharger le classeur protégé

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

Ces commandes vous permettent d’intégrer le flux de travail de protection dans des scripts ou des pipelines CI. Pour plus de détails, consultez la documentation officielle de l’API.

Conclusion

Implémenter Protection par mot de passe d’Excel via REST en Java est simple avec le GroupDocs.Merger Cloud SDK for Java. En suivant les étapes ci‑dessus, vous pouvez sécuriser les classeurs Excel, automatiser le processus dans les applications côté serveur et protéger les données sensibles. N’oubliez pas d’obtenir une licence appropriée pour la production ; les informations tarifaires sont disponibles sur la page du produit et vous pouvez commencer avec une licence temporaire pour évaluer la bibliothèque. Bon codage !

FAQs

• En quoi la protection par mot de passe d’Excel via REST en Java diffère-t-elle du chiffrement local ?
  L’API cloud effectue le chiffrement sur le serveur, vous n’avez donc pas besoin de gérer les bibliothèques cryptographiques localement. Le SDK gère la construction des requêtes et l’analyse des réponses, simplifiant l’intégration.

• Est-il possible de définir des options de protection supplémentaires, comme le mode lecture seule ?
  La classe ProtectOptions actuelle se concentre sur la protection par mot de passe. Pour des fonctionnalités de sécurité plus avancées, consultez la référence API pour d’éventuels nouveaux paramètres.

• Quels formats de fichiers sont pris en charge pour la protection par mot de passe ?
  L’API Merger prend actuellement en charge XLSX, DOCX, PPTX, et PDF pour le chiffrement. Consultez la documentation officielle pour la liste complète.

• Ai-je besoin d’une licence pour exécuter l’exemple dans un environnement de développement ?
  Le développement et les tests peuvent être effectués avec une licence temporaire. Les déploiements en production nécessitent une licence payante, que vous pouvez acheter via la page produit.

Lire la suite

• Protéger par mot de passe les fichiers PowerPoint avec Node.js
• Protéger par mot de passe les fichiers Excel à l’aide de l’API REST en Python
• Combiner les feuilles Excel en Java - Fusionneur de fichiers Excel