Водяний знак — це накладене зображення, логотип, візерунок або текст, розміщений поверх фотографії чи зображення. За ним можна ідентифікувати автора зображення. Ви можете програмно додати водяний знак до будь-якого зображення в хмарі. У цій статті мова піде про те, як додати водяний знак до зображень за допомогою REST API у Java.
У цій статті будуть розглянуті такі теми:
- Водяний знак REST API та Java SDK
- Додайте текстовий водяний знак до зображень за допомогою REST API
- Додайте водяний знак зображення до зображень за допомогою REST API
Водяний знак REST API та Java SDK
Для створення водяних знаків на зображенні я буду використовувати Java SDK GroupDocs.Watermark Cloud API. Він дозволяє програмно додавати, видаляти, шукати та замінювати водяні знаки на зображеннях і документах підтримуваних форматів, таких як PDF, Microsoft Word і Powerpoint. Наразі він також надає .NET SDK, а також для Cloud API.
Ви можете легко використовувати GroupDocs.Watermark Cloud у своїх програмах Java на основі Maven, додавши таку конфігурацію 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>
Будь ласка, отримайте свій ідентифікатор клієнта та секрет клієнта з інформаційної панелі, перш ніж почати виконувати кроки та доступні приклади коду. Додайте свій ідентифікатор і секрет у код, як показано нижче:
String clientId = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5";
String clientSecret = "479db2b01dcb93a3d4d20efb16dea971";
String myStorage = "";
Configuration configuration = new Configuration(clientId, clientSecret);
Додайте текстовий водяний знак до зображень за допомогою REST API
Ви можете додати текстовий водяний знак до фотографій або файлів зображень, виконавши прості дії, наведені нижче:
- Завантажитиthe JPG image to the Cloud
- Додати текстовий водяний знак до зображення за допомогою Java
- Завантажитиthe watermarked image
Завантажте зображення JPG
По-перше, завантажте файл зображення JPG у хмару, використовуючи наведений нижче приклад коду:
// ініціалізація API
FileApi apiInstance = new FileApi(clientId, clientSecret);
File fileStream = new File("C:\\Files\\sample.jpg");
// створити запит на завантаження файлу
UploadFileRequest request = new UploadFileRequest("sample.jpg", fileStream, myStorage);
FilesUploadResult response = apiInstance.uploadFile(request);
У результаті файл JPG буде завантажено в хмарне сховище та доступний у розділі файлів вашої інформаційної панелі.
Додайте текстовий водяний знак до зображення JPG за допомогою Java
Ви можете програмно додати текстовий водяний знак до зображення JPEG, виконавши наведені нижче дії.
- Створіть екземпляр WatermarkApi
- Встановіть шлях до файлу зображення JPEG у моделі FileInfo
- Визначте WatermarkOptions і встановіть FileInfo
- Визначте TextWatermarkOptions
- Установіть текст, сімейство шрифтів, розмір шрифту та вирівнювання тексту
- Встановити колір переднього плану для тексту водяного знака
- Визначте положення водяного знака
- Визначте WatermarkDetails і встановіть TextWatermarkOptions і Position
- Встановіть WatermarkDetails на List
- Створіть AddRequest із WatermarkOptions
- Отримайте результати, викликавши метод WatermarkApi.add().
У наведеному нижче прикладі коду показано, як додати текст як водяний знак до зображення за допомогою REST API.
// ініціалізація API
WatermarkApi apiInstance = new WatermarkApi(configuration);
// встановити шлях до файлу JPG
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// визначте параметри водяного знака
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// визначте параметри текстового водяного знака
TextWatermarkOptions textWatermarkOptions = new TextWatermarkOptions();
textWatermarkOptions.setText("Copyright© 2021");
textWatermarkOptions.setFontFamilyName("Arial");
textWatermarkOptions.setFontSize(12d);
textWatermarkOptions.setTextAlignment("Center");
// встановити колір тексту водяного знака
Color color = new Color();
color.setName("White");
textWatermarkOptions.setForegroundColor(color);
// визначити деталі водяного знака
WatermarkDetails watermarkDetails = new WatermarkDetails();
watermarkDetails.setTextWatermarkOptions(textWatermarkOptions);
// встановити положення водяного знака
Position position = new Position();
position.setX(180.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// встановити деталі водяного знака
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// створити запит на додавання водяного знака
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Завантажте оновлене зображення
Наведені вище зразки коду збережуть файл зображення з водяним знаком у хмарі. Ви можете завантажити його за допомогою наступного зразка коду:
// ініціалізація API
FileApi apiInstance = new FileApi(clientId, clientSecret);
// створити запит на завантаження файлу
DownloadFileRequest request = new DownloadFileRequest("watermark/added_watermark/sample_jpg/sample.jpg", "", null);
File response = apiInstance.downloadFile(request);
Додайте водяний знак зображення до зображень за допомогою REST API
Ви можете програмно додати водяний знак зображення або логотипа до зображення JPEG, виконавши наведені нижче дії.
- Створіть екземпляр WatermarkApi
- Встановіть шлях до файлу зображення JPEG у моделі FileInfo
- Визначте WatermarkOptions і встановіть FileInfo
- Визначте параметри ImageWatermark
- Установіть FilePath зображення PNG для водяного знака
- Визначте положення водяного знака
- Визначте WatermarkDetails і встановіть ImageWatermarkOptions і Position
- Встановіть WatermarkDetails на List
- Створіть AddRequest із WatermarkOptions
- Отримайте результати, викликавши метод WatermarkApi.add().
У наведеному нижче прикладі коду показано, як додати зображення як водяний знак до зображення JPEG за допомогою REST API. Будь ласка, виконайте кроки, згадані раніше, щоб завантажити та завантажити файли.
// ініціалізація API
WatermarkApi apiInstance = new WatermarkApi(configuration);
// встановити шлях до файлу JPG
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("sample.jpg");
fileInfo.setStorageName(myStorage);
// визначте параметри водяного знака
WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
// визначити деталі водяного знака
WatermarkDetails watermarkDetails = new WatermarkDetails();
// визначте параметри зображення водяного знака
ImageWatermarkOptions imageWatermarkOptions = new ImageWatermarkOptions();
FileInfo image = new FileInfo();
image.setFilePath("sample_watermark.png");
image.setStorageName(myStorage);
imageWatermarkOptions.setImage(image);
// встановити положення водяного знака
Position position = new Position();
position.setX(100.0);
position.setY(450.0);
watermarkDetails.setPosition(position);
// встановити параметри зображення водяного знака
watermarkDetails.setImageWatermarkOptions(imageWatermarkOptions);
List<WatermarkDetails> watermarkDetailsList = new ArrayList<WatermarkDetails>();
watermarkDetailsList.add(watermarkDetails);
options.setWatermarkDetails(watermarkDetailsList);
// створити Додати запит
AddRequest request = new AddRequest(options);
WatermarkResult response = apiInstance.add(request);
System.out.println("Resultant file path: " + response.getPath());
Спробуйте онлайн
Будь ласка, спробуйте наведений нижче безкоштовний онлайн-інструмент водяних знаків, розроблений за допомогою вищезазначеного API. https://products.groupdocs.app/watermark/jpeg
Висновок
Підсумовуючи, ви дізналися, як додати текстовий або графічний водяний знак до зображення JPEG у хмарі. Ви також дізналися, як програмно завантажити файли зображень у хмару, а потім завантажити їх із хмари. Ви можете дізнатися більше про GroupDocs.Watermark Cloud API з документації. Ми також надаємо розділ API Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-якої неясності зверніться до служби підтримки.