Text-Overlay zu GIF mit REST in Java hinzufügen - Beispielcode

Dieses Beispiel zeigt, wie man ein Textwasserzeichen konfiguriert und es auf jedes Frame einer GIF‑Datei anwendet.

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

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie alle Dateipfade und Konfigurationswerte an Ihre tatsächliche Umgebung anpassen, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

Text auf GIF mit REST-API mittels cURL überlagern

Unten finden Sie die cURL‑Befehle, die dieselbe Operation von einem Terminal aus ausführen. Sie veranschaulichen den vollständigen REST‑Workflow: Authentifizierung, Hochladen, Wasserzeichen und Herunterladen.

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

Ersetzen Sie YOUR_ACCESS_TOKEN in den folgenden Aufrufen durch das oben zurückgegebene Token.

# 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

Weitere Details zu Anforderungskörpern und Antwortformaten finden Sie in der offiziellen API-Dokumentation.

Aufschlüsselung von Add Text Overlay zu GIF mit REST in Java - Wie es funktioniert

1. Initialisieren Sie den API-Client - new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") erstellt ein Konfigurationsobjekt, das Ihre Anmeldeinformationen enthält. Die WatermarkApi‑Instanz verwendet diese Konfiguration, um jede Anfrage zu signieren.

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

2. Quell- und Zieldateien angeben - FileInfo und OutputFileInfo teilen dem Dienst mit, wo das ursprüngliche GIF gelesen und wo das Ergebnis geschrieben werden soll. Beide können einen benutzerdefinierten Speichernamen referenzieren.

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

3. Konfigurieren Sie das Textwasserzeichen - TextWatermarkOptions enthält alle visuellen Eigenschaften: Text, Schriftart, Größe, Farbe, Deckkraft, Drehung und Ausrichtung. Das Festlegen von pageRange auf "1-" stellt sicher, dass jedes Frame des animierten GIFs die Überlagerung erhält.

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. Erstellen und senden Sie die Anforderung - AddWatermarkRequest fasst die Dateiinformationen und Optionen zusammen. Der Aufruf von watermarkApi.addWatermark(request) führt die Operation auf dem Server aus und gibt den Pfad der verarbeiteten Datei zurück.

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

5. Antwort verarbeiten - Die Antwort enthält den Pfad der Ausgabedatei. In einer echten Anwendung würden Sie typischerweise die Datei herunterladen oder den Pfad an einen anderen Dienst übergeben.

Für eine vollständige Liste von Klassen und Eigenschaften siehe die API-Referenz.

Installation und Konfiguration von GroupDocs.Watermark Cloud SDK für Java

Fügen Sie die Maven‑Abhängigkeit zu Ihrer pom.xml hinzu (oder den entsprechenden Gradle‑Eintrag). Dadurch wird Version 23.8 des SDKs eingebunden.

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

Voraussetzungen

• Java 8 oder höher
• Ein aktives GroupDocs Cloud-Konto
• Client ID und Client Secret (verfügbar im GroupDocs Cloud dashboard)

Konfigurationsbeispiel

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

Laden Sie die neuesten JARs von der Download‑Seite herunter. Für den Produktionseinsatz wenden Sie eine gültige Lizenz an, die Sie von der temporären Lizenz‑Seite erhalten.

Fazit

Das Hinzufügen von Text‑Overlay zu GIFs über REST in Java wird zu einer wiederholbaren, serverseitigen Operation mit Hilfe des GroupDocs.Watermark Cloud SDK for Java. Das SDK abstrahiert die Komplexität der Handhabung animierter Frames, sodass Sie sich auf den Inhalt Ihrer Untertitel oder Werbebotschaften konzentrieren können. Nach der Integration des Beispielcodes oder des cURL‑Workflows können Sie Schriftarten, Farben und Deckkraft feinabstimmen, um Ihrer Marke zu entsprechen. Denken Sie daran, eine Produktionslizenz zu sichern; Preisinformationen finden Sie auf der Produktseite, und eine temporäre Lizenz kann für Tests über die temporäre Lizenzseite bezogen werden. Viel Spaß beim Programmieren!

FAQs

• Wie füge ich einem GIF über die REST‑Schnittstelle in Java einen Text‑Overlay hinzu, wenn sich der Text pro Benutzer ändert?
  Erstellen Sie das TextWatermarkOptions‑Objekt zur Laufzeit mit dem benutzerspezifischen String und rufen Sie anschließend denselben addWatermark‑Aufruf auf. Die API verarbeitet jede Anfrage unabhängig, sodass dynamische Inhalte vollständig unterstützt werden.

• Kann ich Untertitel zu einem animierten GIF hinzufügen, ohne die Animationsgeschwindigkeit zu beeinflussen?
  Ja. Das Wasserzeichen wird auf jedes Bild angewendet, wobei die ursprüngliche Bildverzögerung beibehalten wird. Setzen Sie einfach pageRange auf "1-", damit jedes Bild dieselbe Überlagerung erhält.

• Welche Formate werden für die Overlay-Textfarbe unterstützt?
  Das SDK akzeptiert HEX‑Farbcodes (z. B. #FF0000) und standardmäßige HTML Farbnamen. Siehe die API‑Referenz für die vollständige Liste.

• Benötige ich eine Lizenz für Entwicklung und Tests?
  Eine temporäre Lizenz reicht für Evaluierung und Tests aus. Für Produktionsbereitstellungen kaufen Sie eine Volllizenz auf der Produktseite und wenden Sie sie über die Lizenzierungs‑API des SDK an.

Read More

• Overlay-Text zu einem GIF mit der REST-API in C# hinzufügen
• Wasserzeichen zu Bildern mit Java hinzufügen
• Wasserzeichen zu Word in Java hinzufügen – Watermark Creator

Voraussetzungen und Einrichtung

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

• Java 8 oder höher installiert.
• Maven oder Gradle für die Abhängigkeitsverwaltung.
• Ein GroupDocs Cloud‑Konto mit client ID und client secret.
• Zugriff auf den Cloud‑Speicher, in dem die Excel‑Dateien abgelegt werden.

Fügen Sie die Maven‑Abhängigkeit zu Ihrer pom.xml hinzu (oder das entsprechende Gradle‑Snippet):

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

Sie können die neuesten JARs von der Download‑Seite herunterladen. Nachdem Sie die Abhängigkeit hinzugefügt haben, erstellen Sie ein Konfigurationsobjekt mit Ihren Anmeldeinformationen:

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

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

Wenn der Client bereit ist, können Sie mit dem eigentlichen Passwort‑schutz‑Workflow fortfahren.

Excel per REST in Java mit Passwort schützen: Schritt‑für‑Schritt‑Anleitung

Schritt 1: Laden des Quell Dokuments

Definieren Sie den Speicherort der Quell‑XLSX‑Datei in Ihrem Cloud‑Speicher.

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

Schritt 2: Zielpfad festlegen

Geben Sie an, wo die geschützte Arbeitsmappe gespeichert werden soll.

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

Schritt 3: Passwortschutzoptionen konfigurieren

Erstellen Sie ein ProtectOptions-Objekt, fügen Sie die Dateiinformationen, den Ausgabepfad und das gewünschte Passwort hinzu.

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

Schritt 4: Erstellen der Protect Document-Anforderung

Verpacken Sie die Optionen in ein ProtectDocumentRequest.

ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);

Schritt 5: Anfrage ausführen und Antwort verarbeiten

Rufen Sie die API‑Methode auf und verarbeiten Sie etwaige Fehler.

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

Für weitere Details zu jeder Klasse, siehe die API-Referenz.

Vollständiges funktionierendes Beispiel zum Passwortschutz von Excel über REST in Java

Der folgende Code demonstriert den vollständigen Prozess von Anfang bis Ende.

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

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (input.xlsx, output_protected.xlsx) an Ihre tatsächlichen Speicherorte anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten korrekt installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

Excel-Arbeitsmappe über die REST-API mit cURL schützen

Unten finden Sie eine Reihe von cURL‑Befehlen, die dieselbe Passwortschutz‑Operation direkt gegen die REST‑Endpunkte ausführen.

1. Authentifizieren und ein Zugriffstoken erhalten

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

Die Antwort enthält ein access_token, das Sie in nachfolgenden Aufrufen verwenden.

2. Laden Sie die Quell‑XLSX‑Datei hoch

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. Passwortschutz anfordern

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. Laden Sie die geschützte Arbeitsmappe herunter

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

Mit diesen Befehlen können Sie den Schutz‑Workflow in Skripte oder CI‑Pipelines integrieren. Weitere Details finden Sie in der offiziellen API‑Dokumentation.

Fazit

Implementieren Passwortschutz für Excel über REST in Java ist einfach mit dem GroupDocs.Merger Cloud SDK for Java. Wenn Sie den obigen Schritten folgen, können Sie Excel‑Arbeitsmappen sichern, den Vorgang in serverseitigen Anwendungen automatisieren und sensible Daten schützen. Denken Sie daran, für die Produktion eine passende Lizenz zu erwerben; Preisdetails finden Sie auf der Produktseite, und Sie können mit einer temporären Lizenz beginnen, um die Bibliothek zu evaluieren. Viel Spaß beim Programmieren!

FAQs

• Wie unterscheidet sich das Passwortschützen von Excel über REST in Java von der lokalen Verschlüsselung?
  Die Cloud-API führt die Verschlüsselung auf dem Server durch, sodass Sie keine kryptografischen Bibliotheken lokal verwalten müssen. Das SDK übernimmt den Aufbau der Anfragen und das Parsen der Antworten, was die Integration vereinfacht.

• Ist es möglich, zusätzliche Schutzoptionen festzulegen, wie z. B. den Nur‑Lese‑Modus?
  Die aktuelle ProtectOptions‑Klasse konzentriert sich auf den Passwortschutz. Für weiterführende Sicherheitsfunktionen konsultieren Sie die API‑Referenz für mögliche neuere Parameter.

• Welche Dateiformate werden für den Passwortschutz unterstützt?
  Die Merger API unterstützt derzeit XLSX, DOCX, PPTX, und PDF für die Verschlüsselung. Siehe die offizielle Dokumentation für die vollständige Liste.

• Benötige ich eine Lizenz, um das Beispiel in einer Entwicklungsumgebung auszuführen?
  Entwicklung und Tests können mit einer temporären Lizenz durchgeführt werden. Produktionsbereitstellungen erfordern eine kostenpflichtige Lizenz, die Sie über die Produktseite erwerben können.

Mehr lesen

• PowerPoint-Dateien in Node.js mit Passwort schützen
• Excel-Dateien mit REST-API in Python mit Passwort schützen
• Excel-Tabellen in Java kombinieren – Excel-Dateien-Merger