آخر الأخبار
دعوات لفرض قيود جديدة على تصدير رقائق الذكاء الاصطناعي إلى الصينالتصادم في Static Mesh ضمن Unreal Engine: دليل الإعداد خطوة بخطوةكتلة بيانات الصورة وإعدادات الخامة في Blender Python APIتنظيف Mesh في Blender: دليل خطوة بخطوة لتنظيم الهندسةدليل Boolean في Blender: خطوات اختيار العملية وSolver المناسبالتنضيد الافتراضي في Unreal Engine: إعداد SVT وRVTأوامر Picture وScale في Rhino 8: دليل وضع الصورMecanoo يفتح أجزاء من البنك المركزي في أمستردام أمام الجمهوردليل Blender UV Project Modifier: إسقاط الصور والملصقات على المجسماتإضاءة المساحات الداخلية في Blender: أنواع الإضاءة وإعداداتها
دروس تعليميةBlenderBlender Image API

كتلة بيانات الصورة وإعدادات الخامة في Blender Python API

تتيح Python API في Blender إنشاء الصور ككتل بيانات، وتعديل مخزن البكسلات، وفحص خصائص Image Texture. يوضح هذا الدليل الخطوات الأساسية للتصوير المعماري.

مساحة داخلية عصرية ومضيئة يبرز فيها جدار مكسو بحجر ذي نسيج متكررصورة بالذكاء الاصطناعي
صورة تعبيرية مولّدة بالذكاء الاصطناعي.الصورة: 3dsınıfı / FCA AI

باختصار

  1. يمكن أن تستند كتلة بيانات Image في Blender API إلى ملف أو بيانات معبأة أو صورة منشأة.
  2. يمكن استدعاء `update()` لإظهار التغييرات التي أُجريت على مخزن البكسلات.
  3. تشمل خصائص Image Texture إعدادات مثل نمط الامتداد واستخدام ألفا والتكرار.
  4. تحذّر الوثائق المرجعية من أن نسخ كتلة بيانات الصورة قبل حفظ المخزن المعدّل قد لا ينقل التغييرات إلى النسخة.

ما الذي ستتعلمه في هذا الدليل؟

ستتعلم كيفية التعامل مع صورة عبر كتلة بيانات Image في Python API الخاصة بـ Blender، وإجراء تغيير بسيط على مخزن البكسلات، ثم تحديث النتيجة. وستتعرف أيضًا إلى معاني الإعدادات الأساسية الموثقة لـ ImageTexture، وما ينبغي التحقق منه عند إعداد الخامات للمشاهد المعمارية.

لا يشرح هذا الدليل ربط صورة بمادة أو إضافتها إلى المشهد عبر مسار قائمة محدد. تشرح الوثائق المرجعية خصائص نوعَي البيانات Image وImageTexture؛ لذلك تقتصر الخطوات على هذه الخصائص.

المتطلبات

  • يلزم توفر شيفرة Python قابلة للتشغيل داخل Blender وإمكانية الوصول إلى واجهة bpy. ينشئ المثال المرجعي صورة عبر bpy.data.images.

  • المصادر هي وثائق Blender API الحالية؛ ولا تذكر الوثائق رقم إصدار محددًا من Blender. تحقّق أيضًا من توافق خصائص API مع الإصدار المستخدم.

  • لا تتضمن الوثائق معلومات عن الحسابات أو الترخيص أو الرسوم؛ ولا يفترض هذا الدليل أي متطلبات بشأنها.

  • تُنشأ الصورة في المثال داخل الشيفرة. ولا حاجة إلى مسار ملف خارجي أو ملف خامة جاهز.

خطوة بخطوة: إنشاء صورة وتحديث مخزن البكسلات

1. أنشئ كتلة بيانات صورة جديدة

تُعد كتلة بيانات Image غلافًا يشير إلى صورة أو ملف فيديو أو بيانات معبأة أو محتوى منشأ. أما بيانات الصورة، مثل مخزن البكسلات والدقة، فتُحفظ في مخزن الصورة. ينشئ المثال الوارد في الوثائق صورة جديدة باستخدام الاستدعاء bpy.data.images.new().

تنشئ الشيفرة التالية صورة تجريبية، وتطبع حجمها في وحدة التحكم، وتغيّر أول أربع قيم في المخزن، ثم تحدّث العرض:

python
import bpy

image = bpy.data.images.new("Facade_Test", 1024, 1024)
print(image.size)
print(image.pixels[0:4])

image.pixels[0:4] = (0.5, 0.5, 0.5, 0.5)
image.update()

print(image.pixels[0:4])

يمثّل pixels مخزن البكسلات المؤلف من قيم فاصلة عائمة. لا تُسنَد في هذا المثال سوى أول أربع قيم؛ وهذا لا يعني تلوين الخامة بأكملها أو سطح معماري كامل. تتيح update() ظهور التغيير الذي أُجري على المخزن في الصورة المعروضة. أما الخاصية size فتعرض عرض المخزن وارتفاعه بالبكسل.

2. أعد تحجيم مخزن الصورة

تتضمن كتلة بيانات الصورة الطريقة scale(width, height). ويعيد المثال الوارد في الوثائق تحجيم المخزن إلى 1024 × 720. حدّد المقاس المستهدف بوضوح في الشيفرة ضمن عملك، ثم تحقّق من قيمة size. يغيّر التحجيم مخزن الصورة، لكنه لا يحفظ ملفًا بحد ذاته.

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

3. قيّم إعدادات Image Texture بحسب الحاجة

يمكن لـ ImageTexture أن يشير إلى كائن Image، كما يتضمن الخاصية extension التي تحدد سلوك الصورة خارج حدودها. والخيارات الموثقة هي:

  • REPEAT: يكرر الصورة أفقيًا وعموديًا.

  • EXTEND: يمدد بكسلات حواف الصورة إلى الخارج.

  • CLIP: يجعل المنطقة الواقعة خارج حدود الصورة شفافة.

  • CLIP_CUBE: يحصر المنطقة خارج الصورة ضمن نطاق مكعّب ويجعل ما يقع خارجه شفافًا.

  • CHECKER: يكرر الصورة بنمط رقعة الشطرنج.

تشمل خصائص Texture معاملي التكرار repeat_x وrepeat_y، واستخدام بيانات ألفا عبر use_alpha، وعكس قيم ألفا عبر invert_alpha، واستيفاء البكسلات باستخدام المرشح المحدد عبر use_interpolation. وتحدد الوثائق النطاق من 1 إلى 512 لكل من repeat_x وrepeat_y. عند استخدام هذه الإعدادات، حدّد ما إذا كان المطلوب هو التكرار أو تمديد الحواف أو القص عند الحدود.

يمكن أيضًا التعامل مع قناة ألفا في الصورة بطرق مختلفة. تتضمن خيارات Image.alpha_mode القيم STRAIGHT وPREMUL وCHANNEL_PACKED وNONE. وتشير الوثائق المرجعية إلى أنها تصف تمثيلات مختلفة لألفا؛ لذا لا ينبغي تفسير ألفا ملف ذي قنوات معبأة على أنها شفافية عادية.

4. تحقّق من سلوك النسخ والحفظ

من التنبيهات المهمة في وثائق API أن نسخ كتلة بيانات الصورة لا يضمن نقل مخزن الصورة إلى النسخة. إذا لم تكن قد حفظت التغييرات التي أجريتها على المخزن بعد، فقد تحتفظ كتلة البيانات الجديدة الناتجة عن copy() بالحالة الأصلية للصورة بدلًا من المخزن المعدّل. ويُظهر المثال الوارد في الوثائق أن تحديث النسخة يعيد الحجم والألوان أيضًا إلى الحالة التي كانت عليها الصورة الأصلية عند إنشائها.

توثّق الواجهة save() لحفظ الصورة، وsave_render() لحفظها في مسار محدد باستخدام إعدادات التصيير للمشهد. ويتيح الخيار save_copy ضمن save() حفظ نسخة من دون تغيير مسار الملف الحالي للصورة. لذلك، إذا كنت بحاجة إلى تكرار مخزن معدّل، فاختبر ترتيب الحفظ والنسخ أولًا؛ ولا تعتمد على نسخ كتلة البيانات وحدها.

أخطاء شائعة

  • إغفال استدعاء update(): تورد الوثائق الطريقة update() لتحديث الصورة المعروضة بعد تغيير قيم المخزن.

  • افتراض أن النسخة ترث التعديلات تلقائيًا: قد لا تنتقل تغييرات المخزن غير المحفوظة إلى النسخة.

  • استخدام خيارات extension كما لو كانت متبادلة: يكرر REPEAT الصورة، بينما يجعل CLIP المنطقة خارج الحدود شفافة؛ لذا ينبغي الاختيار وفق السلوك المطلوب.

  • تجاهل نمط ألفا: صُمم CHANNEL_PACKED لتعبئة صور مختلفة في قناتي RGB وألفا؛ لذا قد لا تُستخدم ألفا دائمًا كقناع.

الخطوات التالية: سير عمل التصوير المعماري

تساعد هذه الأساسيات مستخدمي Blender والطلاب في مجالي الهندسة المعمارية والتصميم الداخلي وفرق التصوير المعماري الذين يرغبون في فهم كيفية تمثيل مدخلات الصور داخل المشهد. ويسهّل فحص سلوك الخامة اتخاذ قرارات مثل تكرار الصورة المستخدمة للواجهة أو الأرضية أو الكسوة الداخلية، أو تمديد حوافها، أو مراعاة بيانات ألفا فيها. لا تشرح الوثائق نتيجة هذه الإعدادات في محرك تصيير محدد أو أثرها في الأداء؛ لذا ينبغي اختبارها أيضًا في ملف المشروع والإصدار المستخدم.

قبل توسيع نطاق سير العمل، اختبر قيم المخزن والحجم ونمط الامتداد واستخدام ألفا كلًا على حدة، باستخدام صورة تجريبية صغيرة. وترتبط أيضًا قرارات مثل الاحتفاظ بالصور مع ملف المشروع أو إدارتها خارجه بالطريقتين pack() وunpack()؛ إذ توضح الوثائق أن الأولى تضمّن الصورة في ملف .blend، بينما تخرج الثانية الصورة المعبأة إلى القرص.

المصدر والترخيص

أُعد هذا الدليل بالاستناد إلى وثائق Blender Python API الخاصة بـ Image وImageTexture. ويُتاح المصدران بموجب ترخيص CC BY-SA 4.0. جرى تكييف المحتوى إلى التركية وإعادة صياغة الشروحات؛ وأُعد مثال الشيفرة لهذا الدليل.

المصادر

2 مصادر
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/bpy.types.Image.html
ملخص
D(
docs.blender.org (CC BY-SA 4.0)docs.blender.org/api/current/bpy.types.ImageTexture.html
ملخص

لا نعيد نشر نصوص المصادر؛ الاقتباسات القصيرة مشار إليها، وما تبقى ملخص وتعليق من إعدادنا.

رأي 3dsınıfı
3dتقييم المحرر

يُعد هذا النهج في API مفيدًا للمكاتب والطلاب، ولا سيما لمن يرغبون في فحص عدد كبير من مدخلات الصور في المشهد نفسه باتساق، أو جعل تعديلات البيانات الصغيرة قابلة للتكرار. فهو يتيح التحكم في حدود الخامة وسلوك التكرار واستخدام ألفا؛ لكن المصادر لا تشير إلى أنه حل قائم بذاته لإعداد المواد أو تحسين أداء التصيير.

بالنسبة إلى الفرق في تركيا، تتمثل أبسط خطوة عملية في تجربة الخصائص ضمن نسخة صغيرة من مشهد قائم، من دون تغيير الأجهزة الحالية أو تكاليف الترخيص. وينبغي التحقق خصوصًا من توافق الإصدارات وسلوك النسخ قبل حفظ المخزن؛ كما ينبغي للفرق توضيح مسارات الصور الخارجية وآلية التعبئة في ملفات الإنتاج.

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

كيف أغيّر حجم الصورة باستخدام Blender Python API؟

تُعيد الطريقة `Image.scale(width, height)` تحجيم مخزن الصورة إلى العرض والارتفاع المحددين. وتعرض الخاصية `size` أبعاد المخزن بالبكسل.

كيف تتصرف صورة Image Texture خارج حدودها في Blender؟

يمكن ضبط الخاصية `extension` على `REPEAT` أو `EXTEND` أو `CLIP` أو `CLIP_CUBE` أو `CHECKER`. وتوفر هذه الخيارات سلوكيات مختلفة، مثل التكرار أو تمديد الحواف أو جعل المنطقة خارج الحدود شفافة.

هل تنتقل تعديلات البكسلات إلى الصورة المنسوخة في Blender؟

قد لا تنتقل تغييرات مخزن الصورة غير المحفوظة إلى النسخة عند نسخ كتلة بيانات `Image`. وتشير وثائق Blender API إلى ضرورة الانتباه إلى ذلك قبل النسخ.

التعليقات والمنتدى باللغة التركية.شارك في النقاش
+

أخبار ذات صلة