أضف علامة مائية إلى الصور باستخدام Java

العلامة المائية هي صورة متراكبة أو شعار أو نقش أو نص موضوع فوق صورة أو صورة. يمكن استخدامه لتحديد منشئ الصورة. يمكنك إضافة علامة مائية إلى أي صورة برمجيًا على السحابة. ستركز هذه المقالة على كيفية إضافة علامة مائية إلى الصور باستخدام واجهة برمجة تطبيقات REST في Java.

سيتم تناول الموضوعات التالية في هذه المقالة:

Watermark 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

يمكنك إضافة علامة مائية نصية إلى الصور أو ملفات الصور باتباع الخطوات البسيطة المذكورة أدناه:

قم بتحميل صورة 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 إلى Cloud Storage وسيكون متاحًا في قسم الملفات من لوحة المعلومات الخاصة بك.

أضف علامة مائية نصية إلى صورة JPG باستخدام Java

يمكنك إضافة علامة مائية نصية إلى صورة JPEG برمجيًا باتباع الخطوات الواردة أدناه.

  • قم بإنشاء مثيل لـ WatermarkApi
  • قم بتعيين مسار ملف صورة JPEG في نموذج FileInfo
  • حدد WatermarkOptions وقم بتعيين FileInfo
  • تحديد TextWatermarkOptions
  • قم بتعيين النص ومجموعة الخط وحجم الخط ومحاذاة النص
  • تعيين لون المقدمة نص العلامة المائية
  • تحديد موضع العلامة المائية
  • حدد WatermarkDetails وقم بتعيين TextWatermarkOptions and Position
  • قم بتعيين WatermarkDetails على قائمة
  • قم بإنشاء AddRequest باستخدام WatermarkOptions
  • احصل على النتائج عن طريق استدعاء طريقة WatermarkApi.add()

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة نص كعلامة مائية إلى صورة باستخدام واجهة برمجة تطبيقات REST.

// تهيئة 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

يمكنك إضافة صورة أو علامة مائية للشعار إلى صورة JPEG برمجيًا باتباع الخطوات الواردة أدناه.

  • قم بإنشاء مثيل لـ WatermarkApi
  • قم بتعيين مسار ملف صورة JPEG في نموذج FileInfo
  • حدد WatermarkOptions وقم بتعيين FileInfo
  • تحديد خيارات ImageWatermarkOptions
  • قم بتعيين مسار ملف صورة PNG إلى علامة مائية باستخدام
  • تحديد موضع العلامة المائية
  • تحديد WatermarkDetails وتعيين ImageWatermarkOptions and Position
  • قم بتعيين WatermarkDetails على قائمة
  • قم بإنشاء 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());
أضف صورة العلامة المائية إلى الصورة

أضف صورة العلامة المائية إلى الصورة

جرب عبر الإنترنت

يرجى تجربة أداة العلامة المائية المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/watermark/jpeg

خاتمة

في الختام ، تعلمت كيفية إضافة نص أو علامة مائية للصورة إلى صورة JPEG على السحابة. لقد تعلمت أيضًا كيفية تحميل ملفات الصور برمجيًا على السحابة ثم تنزيلها من السحابة. يمكنك معرفة المزيد حول GroupDocs.Watermark Cloud API من الوثائق. نقدم أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، لا تتردد في الاتصال بـ الدعم.

أنظر أيضا