Optimize 48 Watermark Java pages

.github/workflows/production.yml

@@ -26,23 +26,25 @@ jobs:
 
     # Steps represent a sequence of watermark that will be executed as part of the job
     steps:
-      # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
-            submodules: true  # Fetch Hugo themes
-            fetch-depth: 0    # Fetch all history for .GitInfo and .Lastmod
+            submodules: true
+            fetch-depth: 0
       - name: Checkout theme repo
-        uses: actions/checkout@main
+        uses: actions/checkout@v4
         with:
           repository: groupdocs/tutorials-theme
           token: ${{ secrets.REPO_TOKEN }}
           fetch-depth: 0
           path: themes/tutorials-theme
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
       - name: Install Theme Dependencies
         run: npm install
-        working-directory: ./themes/tutorials-theme      
-      # Step 2 - Sets up the latest version of Hugo
+        working-directory: ./themes/tutorials-theme
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v3
         with:
@@ -54,7 +56,6 @@ jobs:
         run:  npm install -D --save postcss-cli
       - name: Install Dependicies3
         run:  npm install -D postcss
-      # Also specifies the theme we want to use
       - name: Build
         run: hugo --configDir config/watermark --environment production --minify
 

.github/workflows/staging.yml

@@ -22,7 +22,7 @@ jobs:
   # This workflow contains a single job called "build"
   build:
     # The type of runner that the job will run on
-    runs-on: macos-latest
+    runs-on: ubuntu-latest
 
     # Steps represent a sequence of watermark that will be executed as part of the job
     steps:
@@ -39,12 +39,19 @@ jobs:
           token: ${{ secrets.REPO_TOKEN }}
           ref: beta
           fetch-depth: 0
-          path: themes/tutorials-theme      
+          path: themes/tutorials-theme 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Install Theme Dependencies
+        run: npm install
+        working-directory: ./themes/tutorials-theme
       # Step 2 - Sets up the latest version of Hugo
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v2
         with:
-            hugo-version: '0.97.3'
+            hugo-version: 'latest'
             extended: true
       - name: Install Dependicies1
         run:  npm install -D --save autoprefixer

content/arabic/java/image-watermarks/apply-image-effects-shape-watermarks-java-groupdocs-watermark/_index.md

@@ -0,0 +1,233 @@
+---
+date: '2026-08-04'
+description: تعلم كيفية استخدام GroupDocs لإضافة image effects—brightness، contrast،
+  chroma key، borders—إلى shape watermarks في عروض Java التقديمية باستخدام GroupDocs.Watermark.
+keywords:
+- how to use groupdocs
+- apply image effects to shape watermarks in java
+- groupdocs watermark java
+lastmod: '2026-08-04'
+og_description: اكتشف كيفية استخدام GroupDocs لإضافة brightness، contrast، chroma
+  key و border effects إلى shape watermarks في عروض Java التقديمية. دليل خطوة بخطوة
+  للمطورين.
+og_image_alt: Guide showing GroupDocs.Watermark Java code for applying image effects
+  to shape watermarks
+og_title: كيفية استخدام GroupDocs – تطبيق image effects على shape watermarks في Java
+schemas:
+- author: GroupDocs
+  dateModified: '2026-08-04'
+  description: Learn how to use GroupDocs to add image effects—brightness, contrast,
+    chroma key, borders—to shape watermarks in Java presentations with GroupDocs.Watermark.
+  headline: How to use GroupDocs to apply image effects to shape watermarks in Java
+  type: TechArticle
+- description: Learn how to use GroupDocs to add image effects—brightness, contrast,
+    chroma key, borders—to shape watermarks in Java presentations with GroupDocs.Watermark.
+  name: How to use GroupDocs to apply image effects to shape watermarks in Java
+  steps:
+  - name: load the presentation file
+    text: The `Watermarker` class is the entry point for all watermark operations
+      on a document.
+  - name: create an image watermark instance
+    text: The `ImageWatermark` class represents a raster image (e.g., a logo) that
+      can be placed onto a shape as a watermark.
+  - name: configure image effects
+    text: The `PresentationImageEffects` class lets you modify brightness, contrast,
+      chroma‑key transparency, and border settings for image watermarks in presentations.
+  - name: add the configured watermark to the presentation
+    text: The `PresentationWatermarkOptions` class specifies where and how a watermark
+      is applied, such as target slides and positioning.
+  - name: save the modified presentation and release resources
+    text: Always close the `Watermarker` to free file handles and memory buffers.
+  type: HowTo
+- questions:
+  - answer: Call `setOpacity(double opacity)` on the `PresentationImageEffects` object;
+      values range from 0.0 (fully transparent) to 1.0 (fully opaque).
+    question: How do I adjust the transparency of an image watermark?
+  - answer: Yes. Use `PresentationWatermarkOptions.setSlideIndices(int... indices)`
+      to target individual slide numbers.
+    question: Can I apply watermarks to specific slides only?
+  - answer: PNG, JPEG, BMP, GIF, TIFF, and WebP are all supported, giving you flexibility
+      for logos and graphics.
+    question: What image formats are supported for watermarking?
+  - answer: Wrap the workflow in a try‑catch block and catch `WatermarkException`
+      to obtain detailed error codes and messages.
+    question: How should I handle errors during watermark processing?
+  - answer: Absolutely. Iterate over a collection of file paths, instantiate a `Watermarker`
+      for each, and apply the same watermark configuration.
+    question: Is batch processing of many presentations possible?
+  type: FAQPage
+tags:
+- groupdocs watermark
+- java image effects
+- shape watermarks
+- presentation security
+title: كيفية استخدام GroupDocs لتطبيق image effects على shape watermarks في Java
+type: docs
+url: /ar/java/image-watermarks/apply-image-effects-shape-watermarks-java-groupdocs-watermark/
+weight: 1
+---
+
+# كيفية استخدام GroupDocs لتطبيق تأثيرات الصورة على علامات مائية على الأشكال في Java
+
+حماية ملفات العرض الخاصة بك هي أولوية قصوى لأي محترف يشارك الشرائح علنًا أو داخليًا. **كيفية استخدام GroupDocs** لإضافة تأثيرات الصورة — مثل السطوع، التباين، شفافية المفتاح اللوني، والحدود المخصصة — يمنحك تحكمًا دقيقًا في مظهر العلامة المائية مع الحفاظ على المحتوى الأصلي سليمًا. في هذا البرنامج التعليمي ستتعلم سير العمل الكامل، من إعداد المشروع إلى حفظ الملف النهائي، وسترى لماذا تُعد GroupDocs.Watermark المكتبة الأكثر غنىً بالميزات لهذه المهمة.
+
+## إجابات سريعة
+- **أي مكتبة تضيف تأثيرات الصورة إلى العلامات المائية؟** GroupDocs.Watermark for Java.  
+- **هل يمكنني تغيير السطوع والتباين معًا؟** Yes, via `PresentationImageEffects`.  
+- **هل الحد اختياري؟** You can enable or disable it with `setBorderColor` and `setBorderWidth`.  
+- **هل أحتاج إلى ترخيص للإنتاج؟** A valid GroupDocs license is required for unrestricted use.  
+- **ما هي صيغ الملفات المدعومة؟** Over 50 formats, including PPTX, PPT, and PDF.
+
+## ما هو GroupDocs.Watermark for Java؟
+
+GroupDocs.Watermark for Java هي مكتبة شاملة تمكّن المطورين من إضافة وتحرير وإزالة العلامات المائية على أكثر من 50 صيغة مستند وصورة. تعمل بالكامل على جانب الخادم، مما يلغي الحاجة إلى تطبيقات الطرف الثالث، وتوفر API غني لتخصيص بصري دقيق، ومعالجة دفعات، وبث عالي الأداء.
+
+## لماذا تستخدم تأثيرات الصورة على العلامات المائية على الأشكال؟
+
+تطبيق تأثيرات الصورة يتيح لك تعديل التأثير البصري للعلامة المائية دون الإضرار بالقراءة. ضبط السطوع أو التباين يمكن أن يجعل الشعار يندمج بشكل خفيف مع خلفيات الشرائح، بينما شفافية المفتاح اللوني تزيل الألوان غير المرغوب فيها. إضافة حدود تُنشئ حدًا بصريًا واضحًا، مما يعزز هوية العلامة التجارية ويجعل العلامة المائية أصعب في الإزالة أو التجاهل.
+
+## المتطلبات المسبقة
+- **GroupDocs.Watermark for Java** — الإصدار 24.11 أو أحدث.  
+- Java Development Kit 8 أو أحدث.  
+- IDE مثل IntelliJ IDEA أو Eclipse.  
+- معرفة أساسية ببرمجة Java وإلمام بملفات العروض (PPTX).
+
+## كيفية إعداد GroupDocs.Watermark for Java
+
+حمّل المكتبة في مشروع Maven الخاص بك وتأكد من توفر الترخيص قبل أي استدعاء API.
+
+**تكوين Maven**  
+أضف التبعية التالية إلى ملف `pom.xml` الخاص بك:
+
+```xml
+<repositories>
+    <repository>
+        <id>repository.groupdocs.com</id>
+        <name>GroupDocs Repository</name>
+        <url>https://releases.groupdocs.com/watermark/java/</url>
+    </repository>
+</repositories>
+
+<dependencies>
+    <dependency>
+        <groupId>com.groupdocs</groupId>
+        <artifactId>groupdocs-watermark</artifactId>
+        <version>24.11</version>
+    </dependency>
+</dependencies>
+```
+
+**تنزيل مباشر**  
+يمكنك أيضًا تنزيل ملف JAR من صفحة الإصدار الرسمية: [GroupDocs.Watermark for Java releases](https://releases.groupdocs.com/watermark/java/).
+
+### الحصول على الترخيص
+يتوفر نسخة تجريبية مجانية للتقييم. للاستخدام في الإنتاج، اطلب ترخيصًا مؤقتًا أو اشترِ ترخيصًا كاملًا من بوابة GroupDocs.
+
+## كيفية تطبيق تأثيرات الصورة على العلامات المائية على الأشكال في عرض تقديمي
+
+حمّل عرضك التقديمي، أنشئ علامة مائية صورة، اضبط التأثيرات المطلوبة، واحفظ النتيجة. الخطوات أدناه تقدم لك حلاً مختصرًا من البداية إلى النهاية، ويتضمن كل خطوة مثالًا قصيرًا من الشيفرة يمكنك نسخه مباشرةً إلى مشروعك.
+
+### الخطوة 1: تحميل ملف العرض التقديمي
+فئة `Watermarker` هي نقطة الدخول لجميع عمليات العلامات المائية على المستند.
+
+```java
+PresentationLoadOptions loadOptions = new PresentationLoadOptions();
+Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/presentation.pptx", loadOptions);
+```
+
+### الخطوة 2: إنشاء مثيل علامة مائية صورة
+فئة `ImageWatermark` تمثل صورة نقطية (مثل الشعار) يمكن وضعها على شكل كعلامة مائية.
+
+```java
+PresentationLoadOptions loadOptions = new PresentationLoadOptions();
+Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/presentation.pptx", loadOptions);
+```
+
+### الخطوة 3: ضبط تأثيرات الصورة
+فئة `PresentationImageEffects` تتيح لك تعديل السطوع، التباين، شفافية المفتاح اللوني، وإعدادات الحدود للعلامات المائية للصور في العروض التقديمية.
+
+```java
+ImageWatermark watermark = new ImageWatermark("YOUR_DOCUMENT_DIRECTORY/logo.png");
+```
+
+### الخطوة 4: إضافة العلامة المائية المضبوطة إلى العرض التقديمي
+فئة `PresentationWatermarkOptions` تحدد أين وكيف يتم تطبيق العلامة المائية، مثل الشرائح المستهدفة والتموضع.
+
+```java
+PresentationImageEffects effects = new PresentationImageEffects();
+effects.setBrightness(0.7); // Set brightness to 70% of original.
+effects.setContrast(0.6);   // Set contrast to 60% of original.
+effects.setChromaKey(Color.getRed()); // Apply chroma key using the color red for transparency.
+
+// Enable and configure border line settings
+effects.getBorderLineFormat().setEnabled(true);
+effects.getBorderLineFormat().setWeight(1); // Set border weight to 1.
+```
+
+### الخطوة 5: حفظ العرض التقديمي المعدل وإطلاق الموارد
+دائمًا أغلق `Watermarker` لتحرير مقابض الملفات وذاكرة التخزين المؤقت.
+
+```java
+PresentationWatermarkSlideOptions options = new PresentationWatermarkSlideOptions();
+options.setEffects(effects);
+
+watermarker.add(watermark, options);
+```
+
+## الأخطاء الشائعة واستكشاف الأخطاء وإصلاحها
+- **مسارات ملفات غير صحيحة** – استخدم مسارات مطلقة أو حل المسارات النسبية بالنسبة إلى `System.getProperty("user.dir")`.  
+- **صيغة صورة غير مدعومة** – تحقق من أن الصورة بصيغة PNG أو JPEG أو BMP أو أي نوع مدعوم آخر.  
+- **الترخيص غير محمّل** – تأكد من وضع ملف الترخيص في classpath وتكوينه قبل أي استدعاء API.  
+- **عروض تقديمية كبيرة** – فعّل وضع البث (`Watermarker.setStreaming(true)`) لتقليل استهلاك الذاكرة.
+
+## التطبيقات العملية
+1. **حماية العلامة التجارية** – دمج شعار الشركة شبه شفاف مع سطوع مخصص لجعل النسخ غير جذاب.  
+2. **محتوى تعليمي** – وضع علامة مائية على شرائح المحاضرات بختم الجامعة الذي يستخدم تأثير المفتاح اللوني للاندماج مع خلفيات الشرائح.  
+3. **تقارير الشركات** – إضافة علامة مائية ذات حدود إلى عروض مالية سرية، مع ضمان تطابق لون الحد مع إرشادات العلامة التجارية للشركة.
+
+## نصائح الأداء
+- عالج العروض التقديمية على دفعات باستخدام مُنفّذ مجموعة خيوط (thread‑pool) لتعظيم استغلال وحدة المعالجة المركزية.  
+- أعد استخدام نفس مثيل `Watermarker` لعدة ملفات عندما يكون ذلك ممكنًا؛ أعد تهيئة كائن العلامة المائية فقط عندما يتغير النمط البصري.  
+- راقب كومة JVM باستخدام أدوات مثل VisualVM لاكتشاف أي ارتفاع غير متوقع في الذاكرة.
+
+## الأسئلة المتكررة
+
+**س: كيف أضبط شفافية علامة مائية صورة؟**  
+ج: استدعِ `setOpacity(double opacity)` على كائن `PresentationImageEffects`؛ القيم تتراوح من 0.0 (شفافية كاملة) إلى 1.0 (معتمة بالكامل).
+
+**س: هل يمكنني تطبيق العلامات المائية على شرائح محددة فقط؟**  
+ج: نعم. استخدم `PresentationWatermarkOptions.setSlideIndices(int... indices)` لاستهداف أرقام شرائح معينة.
+
+**س: ما هي صيغ الصور المدعومة للعلامات المائية؟**  
+ج: PNG، JPEG، BMP، GIF، TIFF، وWebP كلها مدعومة، مما يمنحك مرونة للشعارات والرسومات.
+
+**س: كيف يجب أن أتعامل مع الأخطاء أثناء معالجة العلامة المائية؟**  
+ج: غلف سير العمل بكتلة try‑catch والتقط `WatermarkException` للحصول على رموز أخطاء مفصلة ورسائل.
+
+**س: هل يمكن معالجة دفعات من العديد من العروض التقديمية؟**  
+ج: بالتأكيد. كرّر عبر مجموعة من مسارات الملفات، أنشئ `Watermarker` لكل منها، وطبق نفس إعدادات العلامة المائية.
+
+## موارد إضافية
+- [الوثائق](https://docs.groupdocs.com/watermark/java/)  
+- [مرجع API](https://reference.groupdocs.com/watermark/java)  
+- [تنزيل GroupDocs.Watermark for Java](https://releases.groupdocs.com/watermark/java/)  
+- [مستودع GitHub](https://github.com/groupdocs-watermark/GroupDocs.Watermark-for-Java)  
+- [منتدى الدعم المجاني](https://forum.groupdocs.com/c/watermark/10)  
+- [طلب ترخيص مؤقت](https://purchase.groupdocs.com/temporary-license/)
+
+---
+
+**آخر تحديث:** 2026-08-04  
+**تم الاختبار مع:** GroupDocs.Watermark 24.11 for Java  
+**المؤلف:** GroupDocs
+
+```java
+watermarker.save("YOUR_OUTPUT_DIRECTORY/out_presentation.pptx");
+watermarker.close();
+```
+
+## دروس ذات صلة
+
+- [كيفية إضافة علامات مائية على الأشكال في Java لعروض PowerPoint باستخدام GroupDocs.Watermark](/watermark/java/presentation-document-watermarking/groupdocs-watermark-java-add-shape-watermark-ppt/)
+- [كيفية إضافة علامات مائية لتأثيرات الخط في PowerPoint باستخدام GroupDocs.Watermark و Java](/watermark/java/presentation-document-watermarking/add-line-effects-watermarks-powerpoint-java-groupdocs/)
+- [إضافة علامات مائية إلى عروض PowerPoint باستخدام GroupDocs.Watermark for Java](/watermark/java/presentation-document-watermarking/groupdocs-watermark-java-add-powerpoint-watermarks/)