Gemini 4 Argon 3D: إعادة إنتاج مشهد Python الرسمي محلياً

يمكنك تشغيل شيفرة Gemini 4 Argon ثلاثية الأبعاد محلياً بإعادة إنتاج مشهد Python المنشور في مستودع الأمثلة التوضيحية لـGoogle Gemini. تنسب Google الشيفرة إلى Argon؛ وتحولها Python وNumPy وPillow إلى صورة PNG لمكتبة يغمرها ضوء الشمس. يستخدم هذا الدليل الشيفرة المصدرية المنشورة، لذلك لا يحتاج إلى مفتاح API للنموذج أو طلب توليد جديد.^[1]

أعدنا إنتاج المشهد بدقتين في 14 أكتوبر 2026. ابدأ بالصورة الأصغر، وتحقق من أبعادها وتكوينها، ثم صيّر الصورة الأكبر. تتضمن الحزمة القابلة للتنزيل برنامج التصيير دون تعديل، وإصدارات محددة للاعتماديات، ومعلومات نسب العمل إلى أصحابه، والنتيجتين المرجعيتين.

ما الذي أنتجته شيفرة Gemini 4 Argon ثلاثية الأبعاد محلياً؟

إعادة إنتاج محلية لمثال Argon مفتوح المصدر من Google، عند commit 15515edc، بموجب Apache-2.0. صُيّرت هذه الصورة من شيفرة منشورة؛ وليست نتيجة توليد جديد عبر API في SeedRouter.

انتهت عمليتا التشغيل بنجاح وأنتجتا صورتي PNG بنمط RGB وبالأبعاد المطلوبة. تحققنا من فك ترميز كل ملف بصورة صحيحة وفحصنا المشهد: رفوف على اليسار، وكرسي وطاولة في المقدمة، ونوافذ عند ركن الغرفة تطل على البحر. تتيح الصورة الأكبر فحص الكتاب المفتوح والفنجان والأوعية الزجاجية بسهولة أكبر.

هاتان عمليتا تشغيل منفردتان، وليستا اختباراً معيارياً للسرعة. تؤثر تهيئة المكتبات والتخزين المؤقت وحمل الجهاز في الزمن؛ وانتهاء تشغيل الصورة الأكبر في وقت أقصر لا يثبت قاعدة للأداء. لم نختبر التصيير بالأبعاد الافتراضية 1600 × 1200.

1. تنزيل المشهد وتجهيز Python

استخدم جهاز Mac بمعالج Apple Silicon مع CPython 3.14 الأصلي لمعمارية arm64 ونظام macOS 14 أو أحدث. كانت بيئة الاختبار لدينا macOS 26.2 وPython 3.14.3 وNumPy 2.5.3 وPillow 12.3.0. تحدد قيم تجزئة الاعتماديات حزم wheel الخاصة بهذه المعمارية وهذا الإصدار من Python؛ وليست هذه الحزمة وصفة تثبيت تم التحقق منها لأجهزة Mac بمعالجات Intel أو لإصدارات Python الأخرى.

احفظ حزمة إعادة الإنتاج في مجلد Downloads. فك ضغطها في مجلد جديد، ثم أنشئ بيئة افتراضية:

cd ~/Downloads
unzip gemini-4-argon-3d.zip
cd gemini-4-argon-3d
python3.14 -m venv .venv
.venv/bin/python -m pip install --only-binary=:all: \
  --require-hashes -r requirements-verified.txt

تُنزّل الاعتماديات أثناء التثبيت، ثم يجري التصيير محلياً. إذا أبلغ التثبيت عن عدم وجود حزمة wheel مطابقة أو عن عدم تطابق قيمة التجزئة، فتحقق من إصدار Python والمعمارية قبل المتابعة. احتفظ بملفي LICENSE وATTRIBUTION.md الموجودين في الحزمة مع الشيفرة المصدرية.^[3]

2. تصيير معاينة صغيرة وفحصها

شغّل هذا الأمر من مجلد الحزمة بعد فك ضغطها:

PAINT_WIDTH=320 PAINT_HEIGHT=240 PAINT_SEED=20301 \
  .venv/bin/python source/python/sunlit_library.py \
  output/library-320x240.png

تحدد الوسيطة الأخيرة اسم ملف الإخراج. ينشئ برنامج التصيير المجلد الذي يحتويه ويطبع رسالة Saved عند اكتمال الكتابة.^[2] تُحفظ الصور الجديدة في output/، وتبقى الصور المرجعية المرفقة منفصلة عنها. افحص الملف نفسه:

.venv/bin/python - <<'PY'
from PIL import Image
with Image.open("output/library-320x240.png") as image:
    image.load()
    assert image.format == "PNG"
    assert image.mode == "RGB"
    assert image.size == (320, 240)
    print(image.format, image.mode, image.size)
PY
open output/library-320x240.png

النتيجة المتوقعة هي PNG RGB (320, 240). بعد ذلك، افحص الصورة في Preview: فقد يحتوي ملف صالح على مشهد غير مكتمل أو غير مرغوب فيه. تحقق من توزيع عناصر الغرفة وإطارات النوافذ واتجاه الظلال قبل زيادة الدقة.

3. إنتاج الصورة بالحجم المرجعي الأكبر

بعد اجتياز المعاينة للفحص، شغّل:

PAINT_WIDTH=800 PAINT_HEIGHT=600 PAINT_SEED=20301 \
  .venv/bin/python source/python/sunlit_library.py \
  output/library-800x600.png
open output/library-800x600.png

كرر فحص الأبعاد باستخدام اسم الملف الجديد و(800, 600). اترك هامشاً للذاكرة: بلغت الذروة التي سجلناها لهذا الحجم نحو 1.24 GiB. يُفترض أن تحتفظ الصورة بالترتيب الأساسي نفسه، مع بكسلات أكثر لفحص الأسطح والأشياء على الطاولة. لم نثبت تطابق البكسلات مع الصورة المرجعية من Google، ولم نكرر الإعدادات نفسها لإثبات حتمية النتيجة.

4. تغيير معلمات التصيير عن قصد

تقرأ الشيفرة المصدرية PAINT_WIDTH وPAINT_HEIGHT وPAINT_SEED من متغيرات البيئة. يكون لاسم الملف المحدد صراحة أولوية على PAINT_OUTPUT. إذا لم تُعدّل الأبعاد، فالقيمة الافتراضية العادية هي 1600 × 1200؛ ويختار --16x9 الأبعاد الافتراضية 1920 × 1080 وإعداد الشاشة العريضة.^[2]

احتفظ بقيمة seed 20301 عند تغيير الدقة حتى لا تغيّر الإدخال العشوائي أيضاً. استخدم اسم ملف جديداً لكل تجربة: قد يستبدل برنامج التصيير الناتج الموجود عند تشغيله مباشرة. قيمة seed مختلفة تعني تجربة أخرى، ولا تضمن ترتيباً محدداً للأثاث. تتطلب تغييرات الكاميرا والخامات والإضاءة تعديل شيفرة Python المصدرية، لا إضافة خيار غير موجود إلى سطر الأوامر.

أسئلة حول هذا المثال ثلاثي الأبعاد

هل هذا دليل لاستخدام Blender مع Gemini 4 Argon؟

يستخدم المثال برنامج تصيير مستقلاً مبنياً بـPython وNumPy. لا يتطلب تثبيت Blender أو ملف .blend. يحتوي مستودع Google أيضاً على نسخة JavaScript/WebGL2، لكن هذه الفحوص المحلية تغطي Python فقط.^[1]

هل تثبت صورة PNG أن النموذج ينتج صوراً أو فيديو بصورة أصلية؟

تُظهر الصورة أن الشيفرة المنشورة تستطيع تصيير صورة ثابتة محلياً. لم نطلب من Argon إعادة توليد الشيفرة أو إجراء تعديلات بصرية أو إنتاج رسوم متحركة. توليد الشيفرة والتصيير خطوتان منفصلتان في هذا المثال.

هل يمكنني أن أطلب من النموذج تغيير المشهد؟

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

الاحتفاظ بنتيجة التصيير الناجحة كنقطة مرجعية

النتيجة المفيدة لهذا التمرين على شيفرة Gemini 4 Argon ثلاثية الأبعاد هي مشهد يمكنك فحصه وتشغيله وتغييره. احتفظ بالشيفرة المصدرية العاملة والمعاينة قبل التجربة. تشرح صفحة نموذج Gemini 4 Argon ومرجع API واجهة النموذج عندما تكون مستعداً لإضافة محادثة برمجية منفصلة.

المصادر

1. Google Gemini. التصيير ثلاثي الأبعاد باستخدام Gemini 4 Argon. commit المصدر الثابت: 15515edc.
2. Google Gemini. برنامج التصيير بـPython ونقطة الدخول. مصدر عناصر التحكم بالتصيير وسلوك الإخراج.
3. Google Gemini. ترخيص Apache-2.0. مرفق بالشيفرة المصدرية القابلة للتنزيل.