مرشح Displace هو أحد أكثر أدوات التشويه فائدة في Photoshop. يقوم بتشويه بكسلات الطبقة وفقًا لقيم السطوع في خريطة إزاحة منفصلة، وهو ما يستخدمه المصممون لتغليف الأعمال الفنية حول طيات القماش، أو إضافة تأثيرات تموج، أو وضع الشعارات على أسطح ذات نسيج. عندما يُطبق هذا المرشح كمرشح ذكي، تبقى إعداداته داخل ملف PSD وتظل قابلة للتحرير بالكامل. تُظهر هذه المقالة كيفية قراءة وكتابة بيانات مرشح Displace الذكي في C#. ستضيف مرشح Displace الذكي إلى طبقة Smart Object، وتضبط خيارات المقياس ومعالجة الحواف، وتدمج خريطة الإزاحة، وتحفظ ملف PSD، ثم تقرأ إعدادات المرشح مرة أخرى للتحقق من صحة العملية — كل ذلك دون الحاجة إلى تثبيت Adobe Photoshop.

النقاط الرئيسية

  • الفئة DisplaceSmartFilter، المتاحة في Aspose.PSD for .NET 26.8 وما بعده، تكشف عن فلتر Photoshop Displace ككائن .NET مكتوب بنوع قوي.
  • مقياس الأفقي والرأسي، طريقة الإزاحة (Tile أو Stretch)، ومعالجة المنطقة غير المعرفة (WrapAround أو RepeatEdgePixels) كلها خصائص قراءة/كتابة بسيطة.
  • يمكن تضمين خريطة الإزاحة في ملف PSD الناتج بتمرير true إلى المُنشئ، مما يبقي الملف مستقلًا ومحمولًا.
  • يجب استدعاء SmartFilters.UpdateResourceValues() بعد تغيير مجموعة الفلاتر، وإلا لن يتم حفظ التغييرات.
  • نفس الـ API يقرأ بيانات الفلتر مرة أخرى من ملفات PSD الموجودة، مما يجعله مناسبًا للتحقق، التدقيق، والمعالجة الدفعية.

لماذا يُعَدّ مرشح Displace Smart مهمًا

غالبًا ما تحتاج خطوط أتمتة التصميم إلى إعادة إنتاج تأثيرات Photoshop على نطاق واسع. تشمل الأمثلة النموذجية إنشاء نماذج منتجات حيث يتبع التصميم المطبوع طيات القميص، وإنتاج تنوعات القوالب لفرق التسويق، أو تدقيق مكتبة قوالب PSD للتأكد من أن كل ملف يستخدم نفس إعدادات الفلتر.

القيام بذلك يدويًا في Photoshop لا يتناسب مع المتطلبات، وتحويل التأثير إلى بكسلات يفقد القدرة على تحريره لاحقًا. من خلال قراءة وكتابة بيانات الفلتر الذكي Displace في C#، تحتفظ بالفلتر غير مدمر وقابل للتحرير في Photoshop، مع التحكم فيه من خلال كود الخادم، أو وظائف الخلفية، أو الأدوات المكتبية.

استخدام Aspose.PSD لقراءة وكتابة بيانات مرشح Displace Smart

Aspose.PSD for .NET تمكّن مطوري C# من قراءة وكتابة بيانات مرشح Displace الذكي مباشرةً عبر فئة DisplaceSmartFilter.

البدء

قم بتثبيت Aspose.PSD NuGet package (الإصدار 26.8 أو أحدث) من وحدة التحكم في مدير الحزم:

Install-Package Aspose.PSD

أو استخدم .NET CLI:

dotnet add package Aspose.PSD

تستخدم الأمثلة أدناه المساحات الاسمية التالية:

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Aspose.PSD;
using Aspose.PSD.FileFormats.Psd;
using Aspose.PSD.FileFormats.Psd.Layers.SmartFilters;
using Aspose.PSD.FileFormats.Psd.Layers.SmartObjects;

ستحتاج أيضًا إلى ملفين إدخال: ملف PSD يحتوي على طبقة Smart Object واحدة على الأقل، وملف PSD لاستخدامه كخريطة إزاحة. للحصول على تفاصيل API، راجع توثيق Aspose.PSD for .NET ودليل الفلاتر الذكية.

خصائص DisplaceSmartFilter في لمحة سريعة

الخاصيةالنوعالغرض
HorizontalScaledoubleمقياس إزاحة أفقي، كما هو في مربع حوار Displace في Photoshop
VerticalScaledoubleمقياس إزاحة عمودي
DisplacementMethodDisplacementMethodTile يكرر الخريطة؛ Stretch يغيّر حجم الخريطة لتتناسب مع الطبقة
UndefinedAreasUndefinedAreasWrapAround أو RepeatEdgePixels للبكسلات التي تم إزاحتها خارج الطبقة
IsDisplacementMapEmbeddedboolيشير إلى ما إذا كانت الخريطة مدمجة في ملف PSD
DisplaceMapData—بيانات خريطة الإزاحة المدمجة
DisplacementMapPathstringمسار خريطة الإزاحة

كيفية إضافة مرشح Displace الذكي في C#

الخطوة الأولى هي تحميل ملف PSD يحتوي على طبقة كائن ذكي. ثم تقوم بإنشاء DisplaceSmartFilter، وتكوين خصائصه، وإضافته إلى مجموعة الفلاتر الذكية للطبقة، ثم حفظ النتيجة.

المثال التالي بلغة C# يضيف ويُكوّن مرشح Displace الذكي على طبقة Smart Object.

string baseFolder = "Data";
string outputFolder = "Output";
Directory.CreateDirectory(outputFolder);

string sourceFile = Path.Combine(baseFolder, "no_displace_filter.psd");
string displaceMapPath = Path.Combine(baseFolder, "displace_map.psd");
string outputFile = Path.Combine(outputFolder, "output_displace_filter.psd");

// Load the source PSD file.
using (PsdImage image = (PsdImage)Image.Load(sourceFile))
{
    // Find the first Smart Object layer instead of relying on a hard-coded index.
    SmartObjectLayer smartObj = image.Layers.OfType<SmartObjectLayer>().FirstOrDefault()
        ?? throw new InvalidOperationException("The source PSD has no Smart Object layer.");

// Create the filter. The second argument embeds the displacement map in the output PSD.
    DisplaceSmartFilter displace = new DisplaceSmartFilter(displaceMapPath, true)
    {
        HorizontalScale = 12.5,
        VerticalScale = 15.0,
        DisplacementMethod = DisplacementMethod.Tile,
        UndefinedAreas = UndefinedAreas.WrapAround
    };

// Filters is exposed as an array, so copy it to a list, append the new filter,
    // and assign the updated array back to the collection.
    List<SmartFilter> filters = new List<SmartFilter>(smartObj.SmartFilters.Filters);
    filters.Add(displace);
    smartObj.SmartFilters.Filters = filters.ToArray();

// Write the updated filter collection into the Smart Object layer's resources.
    smartObj.SmartFilters.UpdateResourceValues();

// Save the modified PSD.
    image.Save(outputFile);
}

شرح

  1. تحميل PSD – Image.Load يُعيد كائن Image عام، يتم تحويله إلى PsdImage للوصول إلى ميزات PSD الخاصة مثل الطبقات والفلاتر الذكية.
  2. العثور على طبقة Smart Object – OfType<SmartObjectLayer>() يختار أول طبقة Smart Object ويعطي رسالة واضحة إذا لم توجد. هذا أكثر أمانًا من الفهرسة مباشرة في Layers، لأن ترتيب الطبقات يختلف بين الملفات.
  3. إنشاء الفلتر – DisplaceSmartFilter(string, bool) هو المُنشئ الذي يأخذ مسار خريطة الإزاحة وعلمًا يتحكم فيما إذا كانت الخريطة مدمجة. تمرير true يجعل ملف PSD الناتج مستقلًا.
  4. تكوين الفلتر – HorizontalScale و VerticalScale يحددان قوة الإزاحة. DisplacementMethod.Tile يكرر الخريطة عبر الطبقة، بينما Stretch يغير حجمها لتناسب. UndefinedAreas.WrapAround يملأ البكسلات التي انتقلت خارج القماش بالمحتوى من الحافة المقابلة؛ RepeatEdgePixels يمد ألوان الحافة بدلاً من ذلك.
  5. تحديث المجموعة – SmartFilters.Filters يُعرض كمصفوفة. نسخها إلى List<SmartFilter>، إضافة الفلتر الجديد، وإعادة تعيين ToArray() يحافظ على أي فلاتر ذكية كانت موجودة بالفعل على الطبقة.
  6. حفظ التغييرات – UpdateResourceValues() يكتب مجموعة الفلاتر في موارد PSD للطبقة. إذا تم تخطي هذه الدالة، سيُفقد الفلتر الجديد عند الحفظ.
  7. حفظ – image.Save(outputFile) يكتب ملف PSD المحدث إلى القرص.

كيفية قراءة بيانات فلتر Displace Smart في C#

بعد حفظ ملف PSD، يمكنك إعادة تحميله وفحص خصائص الفلتر للتأكد من أن كل قيمة تم حفظها بشكل صحيح. نفس النهج يعمل مع ملفات PSD التي تم إنشاؤها في Photoshop.

المثال التالي بلغة C# يقرأ مرشح Displace الذكي ويُتحقق من إعداداته.

using (PsdImage image = (PsdImage)Image.Load(outputFile))
{
    SmartObjectLayer smartObj = image.Layers.OfType<SmartObjectLayer>().FirstOrDefault()
        ?? throw new InvalidOperationException("The PSD has no Smart Object layer.");

// Search by type instead of position, so other smart filters on the layer are ignored.
    DisplaceSmartFilter displace = smartObj.SmartFilters.Filters
        .OfType<DisplaceSmartFilter>()
        .LastOrDefault()
        ?? throw new InvalidOperationException("No Displace smart filter found on the layer.");

Console.WriteLine($"Horizontal scale:   {displace.HorizontalScale}");
    Console.WriteLine($"Vertical scale:     {displace.VerticalScale}");
    Console.WriteLine($"Method:             {displace.DisplacementMethod}");
    Console.WriteLine($"Undefined areas:    {displace.UndefinedAreas}");
    Console.WriteLine($"Map embedded:       {displace.IsDisplacementMapEmbedded}");

// Verify that the saved values match the values written earlier.
    AssertAreEqual(12.5, displace.HorizontalScale);
    AssertAreEqual(15.0, displace.VerticalScale);
    AssertAreEqual(DisplacementMethod.Tile, displace.DisplacementMethod);
    AssertAreEqual(UndefinedAreas.WrapAround, displace.UndefinedAreas);
    AssertAreEqual(true, displace.IsDisplacementMapEmbedded);
    AssertAreEqual(true, displace.DisplaceMapData != null);
}

static void AssertAreEqual(object expected, object actual, string message = null)
{
    if (!object.Equals(expected, actual))
    {
        throw new Exception(message ?? $"Expected {expected}, but got {actual}.");
    }
}

شرح

  1. إعادة تحميل الملف – Image.Load يفتح ملف PSD المحفوظ في الخطوة السابقة.
  2. تحديد طبقة Smart Object – البحث القائم على النوع نفسه يحافظ على اتساق خطوات القراءة والكتابة.
  3. العثور على الفلتر حسب النوع – OfType<DisplaceSmartFilter>().LastOrDefault() يُعيد أحدث فلتر Displace مضاف ولا ينتج أبداً تحويلًا غير صالح. هذا أكثر موثوقية من قراءة العنصر الأخير في المصفوفة والتحويل باستخدام as، الذي يُعيد null بصمت إذا كان هناك فلتر مختلف في ذلك الموضع.
  4. قراءة الخصائص – جميع إعدادات الفلتر متاحة كخصائص مكتوبة، لذا يمكن تسجيلها، مقارنتها، أو تصديرها إلى تقرير.
  5. التحقق – أداة المساعدة AssertAreEqual تقارن القيم المخزنة بالقيم الأصلية وتطرح استثناءً برسالة وصفية عند أي عدم تطابق.

الخلاصة

باستخدام الفئة DisplaceSmartFilter في Aspose.PSD for .NET، يمكن لمطوري C# إضافة وتكوين وحفظ وقراءة فلاتر Displace الذكية في Photoshop بالكامل عبر الشيفرة. يظل الفلتر غير مدمر وقابل للتحرير في Photoshop، ويمكن لخريطة الإزاحة الانتقال داخل ملف PSD، وتدعم نفس واجهة برمجة التطبيقات (API) التحقق من صحة الجولة الكاملة. هذا يجعل من السهل بناء مولدات نماذج أولية، خطوط أنابيب القوالب، وأدوات تدقيق PSD على منصة .NET.

الأسئلة الشائعة

  1. أي نسخة من Aspose.PSD for .NET تدعم مرشح Displace الذكي؟
    تم تقديم قراءة وكتابة بيانات مرشح Displace الذكي في Aspose.PSD for .NET 26.8. استخدم الإصدار 26.8 أو أحدث للوصول إلى الفئة DisplaceSmartFilter.

  2. هل يمكنني إضافة DisplaceSmartFilter إلى طبقة نقطية عادية؟
    يتم تخزين بيانات الفلاتر الذكية مع طبقات Smart Object، لذا يجب إضافة الفلتر إلى مجموعة SmartFilters الخاصة بـ SmartObjectLayer. إذا كان المحتوى الخاص بك على طبقة عادية، قم بتحويله إلى Smart Object أولاً.

  3. كيف يمكنني تضمين خريطة الإزاحة في ملف PSD؟ مرّر مسار خريطة الإزاحة والقيمة true إلى مُنشئ DisplaceSmartFilter. بعد الحفظ، تُعيد IsDisplacementMapEmbedded القيمة true وتحتوي DisplaceMapData على بيانات الخريطة المضمّنة.

  4. ما القيم التي يمكن أن تأخذها الخاصية UndefinedAreas؟ UndefinedAreas يدعم WrapAround، الذي يملأ البكسلات غير المعرفة بالمحتوى من الحافة المقابلة للصورة، و RepeatEdgePixels، الذي يمد ألوان بكسلات الحافة.

  5. ما الفرق بين DisplacementMethod.Tile و DisplacementMethod.Stretch؟ Tile يكرر خريطة الإزاحة عبر الطبقة بحجمها الأصلي، بينما Stretch يعيد تحجيم الخريطة لتتناسب مع الطبقة.

  6. هل يجب عليّ استدعاء UpdateResourceValues بعد تعديل الفلاتر الذكية؟ نعم. UpdateResourceValues يكتب مجموعة الفلاتر المعدلة في موارد طبقة Smart Object. بدون ذلك، لا يتم حفظ الفلتر الجديد عند الحفظ.

احصل على ترخيص مجاني واستكشف المزيد

قيّم Aspose.PSD for .NET بدون قيود عن طريق طلب ترخيص مؤقت:

احصل على ترخيص مؤقت مجاني

موارد إضافية للعمل مع ملفات PSD في .NET:

اقرأ المزيد