Vodoznak je překrývající se obrázek, logo, vzor nebo text umístěný přes fotografii nebo obrázek. Může být použit k identifikaci tvůrce obrázku. Vodoznak můžete přidat k libovolnému obrázku programově v cloudu. Tento článek se zaměří na to, jak přidat vodoznak do obrázků pomocí REST API v Javě.
Tento článek bude obsahovat následující témata:
- Watermark REST API a Java SDK
- Přidejte textový vodoznak do obrázků pomocí REST API
- Přidejte vodoznak obrázku do obrázků pomocí REST API
Watermark REST API a Java SDK
Pro vodoznak obrázku budu používat Java SDK of GroupDocs.Watermark Cloud API. Umožňuje programově přidávat, odebírat, vyhledávat a nahrazovat vodoznaky z obrázků a dokumentů podporovaných formátů, jako jsou PDF, Microsoft Word a Powerpoint. V současné době také poskytuje .NET SDK i pro Cloud API.
GroupDocs.Watermark Cloud můžete snadno používat ve svých Java aplikacích založených na Maven přidáním následující konfigurace pom.xml.
<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>
Než začnete postupovat podle kroků a dostupných příkladů kódu, získejte své ID klienta a tajný klíč klienta z dashboard. Přidejte své ID a tajemství do kódu, jak je ukázáno níže:
String clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
String clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
String myStorage = "";
Configuration configuration = new Configuration(clientId, clientSecret);
Přidejte textový vodoznak do obrázků pomocí REST API
Textový vodoznak můžete přidat k fotografiím nebo souborům obrázků podle jednoduchých kroků uvedených níže:
- nahrátthe JPG image to the Cloud
- Přidat textový vodoznak do obrázku pomocí Java
- Staženíthe watermarked image
Nahrajte obrázek JPG
Nejprve nahrajte soubor obrázku JPG do cloudu pomocí příkladu kódu uvedeného níže:
// inicializace api
FileApi apiInstance = new FileApi(clientId, clientSecret);
File fileStream = new File("C:\\Files\\sample.jpg");
// vytvořit požadavek na nahrání souboru
UploadFileRequest request = new UploadFileRequest("sample.jpg", fileStream, myStorage);
FilesUploadResult response = apiInstance.uploadFile(request);
V důsledku toho bude soubor JPG nahrán do cloudového úložiště a bude k dispozici v sekci souborů na vašem řídicím panelu.
Přidejte textový vodoznak do obrázku JPG pomocí Java
Textový vodoznak můžete k obrázku JPEG přidat programově podle následujících kroků.
- Vytvořte instanci WatermarkApi
- Nastavte cestu k souboru obrázku JPEG v modelu FileInfo
- Definujte možnosti WatermarkOptions a nastavte FileInfo
- Definujte možnosti TextWatermark
- Nastavte text, rodinu písem, velikost písma a zarovnání textu
- Nastavit text vodoznaku barvu popředí
- Definujte pozici vodoznaku
- Definujte podrobnosti vodoznaku a nastavte možnosti a polohu TextWatermark
- Nastavte WatermarkDetails na List
- Vytvořte AddRequest pomocí WatermarkOptions
- Získejte výsledky voláním metody WatermarkApi.add()
Následující ukázka kódu ukazuje, jak přidat text jako vodoznak do obrázku pomocí REST API.
// inicializace api
WatermarkApi apiInstance = new WatermarkApi(configuration);
// nastavit cestu k souboru JPG
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// definovat možnosti vodoznaku
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// definovat možnosti textového vodoznaku
TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions();
textWatermarkOptions.setText("Copyright© 2021");
textWatermarkOptions.setFontFamilyName("Arial");
textWatermarkOptions.setFontSize(12d);
textWatermarkOptions.setTextAlignment("Center");
// nastavit barvu textu vodoznaku
Color color = new Color();
color.setName("White");
textWatermarkOptions.setForegroundColor(color);
// definovat podrobnosti vodoznaku
WatermarkDetails watermarkDetails = new WatermarkDetails();
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions);
// nastavit pozici vodoznaku
Position position = new Position();
position.setX(180.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// nastavit podrobnosti vodoznaku
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// vytvořit žádost o přidání vodoznaku
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Stáhněte si aktualizovaný obrázek
Výše uvedené ukázky kódu uloží soubor obrázku s vodoznakem do cloudu. Můžete si jej stáhnout pomocí následující ukázky kódu:
// inicializace api
FileApi apiInstance = new FileApi(clientId, clientSecret);
// vytvořit žádost o stažení souboru
DownloadFileRequest request = new DownloadFileRequest("watermark/added_watermark/sample_jpg/sample.jpg", "", null);
File response = apiInstance.downloadFile(request);
Přidejte vodoznak obrázku do obrázků pomocí REST API
K obrázku JPEG můžete přidat obrázek nebo vodoznak loga programově podle následujících kroků.
- Vytvořte instanci WatermarkApi
- Nastavte cestu k souboru obrázku JPEG v modelu FileInfo
- Definujte možnosti WatermarkOptions a nastavte FileInfo
- Definujte ImageWatermarkOptions
- Nastavte FilePath obrázku PNG na vodoznak pomocí
- Definujte pozici vodoznaku
- Definujte podrobnosti vodoznaku a nastavte možnosti a polohu ImageWatermark
- Nastavte WatermarkDetails na List
- Vytvořte AddRequest pomocí WatermarkOptions
- Získejte výsledky voláním metody WatermarkApi.add()
Následující ukázka kódu ukazuje, jak přidat obrázek jako vodoznak do obrázku JPEG pomocí REST API. Při nahrávání a stahování souborů postupujte podle výše uvedených kroků.
// inicializace api
WatermarkApi apiInstance = new WatermarkApi(configuration);
// nastavit cestu k souboru JPG
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// definovat možnosti vodoznaku
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// definovat podrobnosti vodoznaku
WatermarkDetails watermarkDetails = new WatermarkDetails();
// definovat možnosti obrázku vodoznaku
ImageWatermarkOptions imageWatermarkOptions = new ImageWatermarkOptions();
FileInfo image = new FileInfo();
image.setFilePath("sample_watermark.png");
image.setStorageName(myStorage);
imageWatermarkOptions.setImage(image);
// nastavit pozici vodoznaku
Position position = new Position();
position.setX(100.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// nastavte možnosti vodoznaku obrázku
watermarkDetails.setImageWatermarkOptions(imageWatermarkOptions);
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// vytvořit žádost o přidání
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Vyzkoušejte online
Vyzkoušejte prosím následující bezplatný online nástroj Watermark, který je vyvinut pomocí výše uvedeného API. https://products.groupdocs.app/watermark/jpeg
Závěr
Na závěr jste se naučili, jak přidat textový nebo obrázkový vodoznak do obrázku JPEG v cloudu. Také jste se naučili, jak programově nahrát soubory obrázků do cloudu a poté je z cloudu stáhnout. Více o GroupDocs.Watermark Cloud API se můžete dozvědět z dokumentace. Poskytujeme také sekci API Reference, která vám umožní vizualizovat a pracovat s našimi API přímo prostřednictvím prohlížeče. V případě jakýchkoliv nejasností se neváhejte obrátit na support.