Das Wasserzeichen ist ein überlagertes Bild, Logo, Muster oder Text, das über einem Foto oder Bild platziert wird. Es kann verwendet werden, um den Ersteller des Bildes zu identifizieren. Sie können jedem Bild in der Cloud programmgesteuert ein Wasserzeichen hinzufügen. Dieser Artikel konzentriert sich auf das Hinzufügen eines Wasserzeichens zu Bildern mithilfe einer REST-API in Java.
Die folgenden Themen sollen in diesem Artikel behandelt werden:
- Wasserzeichen-REST-API und Java SDK
- Fügen Sie mithilfe einer REST-API Textwasserzeichen zu Bildern hinzu
- Fügen Sie mithilfe einer REST-API Bildwasserzeichen zu Bildern hinzu
Wasserzeichen-REST-API und Java SDK
Um ein Bild mit einem Wasserzeichen zu versehen, verwende ich die API Java SDK von GroupDocs.Watermark Cloud. Es ermöglicht Ihnen, Wasserzeichen in Bildern und Dokumenten unterstützter Formate wie PDF, Microsoft Word und Powerpoint programmgesteuert hinzuzufügen, zu entfernen, zu suchen und zu ersetzen. Derzeit wird auch das .NET SDK für die Cloud-API bereitgestellt.
Sie können GroupDocs.Watermark Cloud problemlos in Ihren Maven-basierten Java-Anwendungen verwenden, indem Sie die folgende pom.xml-Konfiguration hinzufügen.
<repository>
<id>groupdocs-artifact-repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://repository.groupdocs.cloud/repo</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-watermark-cloud</artifactId>
<version>19.12</version>
<packaging>jar</packaging>
</dependency>
Bitte rufen Sie Ihre Client-ID und Ihr Client-Geheimnis vom Dashboard ab, bevor Sie mit dem Befolgen der Schritte und verfügbaren Codebeispiele beginnen. Fügen Sie Ihre ID und Ihr Geheimnis wie unten gezeigt in den Code ein:
String clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
String clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
String myStorage = "";
Configuration configuration = new Configuration(clientId, clientSecret);
Fügen Sie mithilfe einer REST-API Textwasserzeichen zu Bildern hinzu
Sie können Textwasserzeichen zu Fotos oder Bilddateien hinzufügen, indem Sie die folgenden einfachen Schritte ausführen:
- Hochladenthe JPG image to the Cloud
- Mit Java Textwasserzeichen zum Bild hinzufügen
- Herunterladenthe watermarked image
Laden Sie das JPG bild hoch
Laden Sie zunächst die JPG bilddatei mithilfe des unten angegebenen Codebeispiels in die Cloud hoch:
// API-Initialisierung
FileApi apiInstance = new FileApi(clientId, clientSecret);
File fileStream = new File("C:\\Files\\sample.jpg");
// Datei-Upload-Anfrage erstellen
UploadFileRequest request = new UploadFileRequest("sample.jpg", fileStream, myStorage);
FilesUploadResult response = apiInstance.uploadFile(request);
Als Ergebnis wird die JPG-Datei in den Cloud-Speicher hochgeladen und ist im Dateienbereich Ihres Dashboards verfügbar.
Fügen Sie mit Java Textwasserzeichen zu JPG bildern hinzu
Sie können dem JPEG bild programmgesteuert ein Textwasserzeichen hinzufügen, indem Sie die folgenden Schritte ausführen.
- Erstellen Sie eine Instanz von WatermarkApi
- Legen Sie den Pfad der JPEG bilddatei im FileInfo-Modell fest
- Definieren Sie WatermarkOptions und legen Sie FileInfo fest
- Definieren Sie TextWatermarkOptions
- Legen Sie Text, Schriftfamilie, Schriftgröße und die Textausrichtung fest
- Legen Sie die Vordergrundfarbe des Wasserzeichentexts fest
- Definieren Sie die Position des Wasserzeichens
- Definieren Sie WatermarkDetails und legen Sie TextWatermarkOptions und Position fest
- Setzen Sie WatermarkDetails auf List
- Erstellen Sie AddRequest mit WatermarkOptions
- Erhalten Sie Ergebnisse, indem Sie die Methode WatermarkApi.add() aufrufen
Das folgende Codebeispiel zeigt, wie Sie mithilfe einer REST-API Text als Wasserzeichen zu einem Bild hinzufügen.
// API-Initialisierung
WatermarkApi apiInstance = new WatermarkApi(configuration);
// JPG-Dateipfad festlegen
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// Definieren Sie Wasserzeichenoptionen
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// Definieren Sie Textwasserzeichenoptionen
TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions();
textWatermarkOptions.setText("Copyright© 2021");
textWatermarkOptions.setFontFamilyName("Arial");
textWatermarkOptions.setFontSize(12d);
textWatermarkOptions.setTextAlignment("Center");
// Legen Sie die Textfarbe des Wasserzeichens fest
Color color = new Color();
color.setName("White");
textWatermarkOptions.setForegroundColor(color);
// Definieren Sie Wasserzeichendetails
WatermarkDetails watermarkDetails = new WatermarkDetails();
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions);
// Legen Sie die Position des Wasserzeichens fest
Position position = new Position();
position.setX(180.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// Wasserzeichendetails festlegen
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// Erstellen Sie eine Anfrage zum Hinzufügen eines Wasserzeichens
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Laden Sie das aktualisierte Bild herunter
Die obigen Codebeispiele speichern die mit Wasserzeichen versehene Bilddatei in der Cloud. Sie können es mit dem folgenden Codebeispiel herunterladen:
// API-Initialisierung
FileApi apiInstance = new FileApi(clientId, clientSecret);
// Download-Dateianfrage erstellen
DownloadFileRequest request = new DownloadFileRequest("watermark/added_watermark/sample_jpg/sample.jpg", "", null);
File response = apiInstance.downloadFile(request);
Fügen Sie mithilfe der REST-API Bildwasserzeichen zu Bildern hinzu
Sie können dem JPEG bild programmgesteuert ein Bild oder Logo-Wasserzeichen hinzufügen, indem Sie die folgenden Schritte ausführen.
- Erstellen Sie eine Instanz von WatermarkApi
- Legen Sie den Pfad der JPEG bilddatei im FileInfo-Modell fest
- Definieren Sie WatermarkOptions und legen Sie FileInfo fest
- Definieren Sie ImageWatermarkOptions
- Legen Sie den Dateipfad eines PNG bilds als Wasserzeichen fest
- Definieren Sie die Position des Wasserzeichens
- Definieren Sie WatermarkDetails und legen Sie ImageWatermarkOptions und Position fest
- Setzen Sie WatermarkDetails auf List
- Erstellen Sie AddRequest mit WatermarkOptions
- Erhalten Sie Ergebnisse, indem Sie die Methode WatermarkApi.add() aufrufen
Das folgende Codebeispiel zeigt, wie Sie mithilfe einer REST-API ein Bild als Wasserzeichen zu einem JPEG bild hinzufügen. Bitte befolgen Sie die zuvor genannten Schritte, um die Dateien hoch und herunterzuladen.
// API-Initialisierung
WatermarkApi apiInstance = new WatermarkApi(configuration);
// JPG-Dateipfad festlegen
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// Definieren Sie Wasserzeichenoptionen
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// Definieren Sie Wasserzeichendetails
WatermarkDetails watermarkDetails = new WatermarkDetails();
// Definieren Sie die Wasserzeichen bildoptionen
ImageWatermarkOptions imageWatermarkOptions = new ImageWatermarkOptions();
FileInfo image = new FileInfo();
image.setFilePath("sample_watermark.png");
image.setStorageName(myStorage);
imageWatermarkOptions.setImage(image);
// Legen Sie die Position des Wasserzeichens fest
Position position = new Position();
position.setX(100.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// Legen Sie die Bildwasserzeichenoptionen fest
watermarkDetails.setImageWatermarkOptions(imageWatermarkOptions);
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// Erstellen Sie eine Anfrage hinzufügen
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Versuchen Sie es online
Bitte probieren Sie das folgende kostenlose Online-Wasserzeichen-Tool aus, das mit der oben genannten API entwickelt wurde. https://products.groupdocs.app/watermark/jpeg
Abschluss
Abschließend haben Sie gelernt, wie Sie einem JPEG bild in der Cloud Text oder Bildwasserzeichen hinzufügen. Sie haben auch gelernt, wie Sie die Bilddateien programmgesteuert in die Cloud hochladen und dann aus der Cloud herunterladen. Weitere Informationen zur GroupDocs.Watermark Cloud API finden Sie in der Dokumentation. Wir bieten auch einen Abschnitt API-Referenz an, mit dem Sie unsere APIs direkt über den Browser visualisieren und mit ihnen interagieren können. Bei Unklarheiten können Sie sich gerne an den Support wenden.