واترمارک یک تصویر، آرم، الگو، یا متنی است که روی عکس یا تصویر قرار گرفته است. می توان از آن برای شناسایی سازنده تصویر استفاده کرد. می توانید به هر تصویری به صورت برنامه ریزی شده در فضای ابری یک واترمارک اضافه کنید. این مقاله بر روی نحوه افزودن واترمارک به تصاویر با استفاده از REST API در جاوا تمرکز دارد.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
- Watermark REST API و Java SDK
- اضافه کردن متن واترمارک به تصاویر با استفاده از REST API
- اضافه کردن واترمارک تصویر به تصاویر با استفاده از REST API
Watermark REST API و Java SDK
برای واترمارک کردن یک تصویر، از Java SDK of GroupDocs.Watermark Cloud API استفاده خواهم کرد. این به شما اجازه می دهد تا به صورت برنامه نویسی، واترمارک ها را از تصاویر و اسناد فرمت های پشتیبانی شده مانند PDF، Microsoft Word و Powerpoint اضافه، حذف، جستجو و جایگزین کنید. در حال حاضر، NET SDK را نیز برای Cloud API ارائه می دهد.
با افزودن پیکربندی pom.xml زیر میتوانید به راحتی از GroupDocs.Watermark Cloud در برنامههای جاوا مبتنی بر Maven خود استفاده کنید.
<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
- افزودن واترمارک متنی به تصویر با استفاده از جاوا
- دانلودthe watermarked image
تصویر JPG را آپلود کنید
ابتدا فایل تصویری JPG را با استفاده از نمونه کد زیر در Cloud آپلود کنید:
// مقداردهی اولیه 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 با استفاده از جاوا
با دنبال کردن مراحل زیر می توانید یک واترمارک متنی را به صورت برنامه نویسی به تصویر 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 را تنظیم کنید
- ImageWatermarkOptions را تعریف کنید
- 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();
// گزینه های تصویر Watermark را تعریف کنید
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);
// گزینه های Watermark Image را تنظیم کنید
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 های ما را مستقیماً از طریق مرورگر تجسم کنید و با آنها تعامل داشته باشید. در صورت وجود هرگونه ابهام، با [پشتیبانی] تماس بگیرید9.