v2.5.0

الإصدار v2.5.0 هو إصدار غني بميزات التصوير: يضيف find_rects() و find_circles() و get_regression() (ملاءمة الخطوط/الانحدار) و find_number() (أرقام LeNet)، وصفّي البثّ ImageWriter / ImageReader، و sensor.flush() / width() / height()، ودعم pyb.RTC. أصبح تحميل الصور الآن مدعومًا بمخزن الإطارات — اقرأ التغييرات الكاسرة أدناه.

أبرز النقاط

  • image.find_rects() — كاشف مستطيلات / رباعيات مع إخراج الزوايا.

  • image.find_circles() — كشف الدوائر بتحويل Hough.

  • image.get_regression() — ملاءمة الخطوط بأقل المربعات وملاءمة قوية (Theil-Sen).

  • image.find_number() — التعرّف على الأرقام بـ LeNet.

  • ImageWriter / ImageReader — تسجيل بثوث الصور وإعادة تشغيلها.

  • دعم pyb.RTC، بالإضافة إلى sensor.flush() / sensor.width() / sensor.height().

  • كاسر: أصبح تحميل الصور الآن مدعومًا بمخزن الإطارات ويثير استثناءً إذا كانت الصورة كبيرة جدًا — راجع التغييرات الكاسرة.

ميزات جديدة

  • كشف الميزات — أُضيفت image.find_rects() (كاشف رباعيات AprilTag؛ كائنات مستطيلات بسمات x / y / w / h / corners / magnitude)، و image.find_circles() (Hough)، و image.get_regression() (ملاءمة الخطوط بأقل المربعات + ملاءمة Theil-Sen القوية)، و image.find_number() (التعرّف على الأرقام بـ LeNet)، كلٌّ منها مع برامج نصية مثالية.

  • زوايا النتائج — أُضيفت سمة corners إلى كائنات نتائج رمز QR / AprilTag / مصفوفة البيانات / الباركود.

  • بثوث الصور — أُضيف الصفّان image.ImageWriter / image.ImageReader (بتنسيق كتل محاذاة على 16 بايت) مع مثالَي image_writer.py / image_reader.py.

  • المستشعر — أُضيفت sensor.flush() (دفع مخزن الإطارات إلى الـ IDE دون لقطة) و sensor.width() / sensor.height().

  • pyb.RTC — فُعّل دعم RTC مع مثال rtc.py.

  • أُضيف Haar cascade لوجه القطط ومثال لدرع المؤازرة Servo-Shield (PCA9685)؛ واكتسبت أداة المضيف openmv-cascade.py دعمًا لتنسيق cascade الجديد بصيغة OpenCV XML.

تغييرات وتحسينات أخرى

  • أُعيد هيكلة مخزن الإطارات بحيث تحدّث دوال الصورة copy_to_fb معاينة الـ IDE؛ ولم تعد مسارات HaarCascade() تتطلب / بادئة (يُكتشف تلقائيًا ما إذا كان مدمجًا أم ملفًا)؛ وأصبح التسجيل بصيغة GIF/MJPEG يدعم الآن VGA (وملفات GIF بصيغة BAYER)؛ وحُدّث ملف README.txt المدمج ولم يعد ملف التعريف openmv.inf يُنشأ على نظام ملفات جديد.

إصلاحات الأخطاء

التصوير:

  • إصلاح تجميع الأصوات في find_circles()، وإزاحة rho في get_regression() مع منطقة اهتمام وتسرّب للذاكرة، ودمج القطع في find_lines()، ومتوسط الزوايا والحدود اللونية الافتراضية (الأقل تقييدًا) في find_blobs()، واستقرار ترتيب نقاط ORB المفتاحية / ترتيب الواصفات وعلامة المطابقة، والتحميل المُخزَّن مؤقتًا لـ Haar cascade (القراءات غير المحاذاة).

النظام:

  • تفعيل المؤازر 3 (P9) في pyb (#256)، وإصلاح تهيئة RTC، وزيادة مهلة محارف UART (#240)، وإصلاح علامة "مُفعّل" غير المهيّأة لمخزن إطارات المستشعر.

دعم العتاد واللوحات

  • دعم pyb.RTC والمؤازر 3 (P9) في pyb؛ ومثال درع المؤازرة Servo-Shield (PCA9685).

تغييرات كاسرة في API

تغييرات كاسرة في API ظاهرة للمستخدم بين v2.4.1 و v2.5.0. النطاق: وحدات Python بلغة C في modules/ ومكتبات Python في scripts/libraries/.

التغيير الكاسر هو تغيير في السلوك (واجهة API نفسها، نتيجة مختلفة) — أعد التحقق من البرامج النصية المتأثرة. كل تجزئة لتأكيد commit ترتبط بفرق التغيير الخاص بها على GitHub.

تحميل الصور أصبح مدعومًا بمخزن الإطارات (سلوك)

أصبحت image.Image / تحميل الصور الآن تنسخ الصورة المحمّلة إلى مخزن الإطارات الرئيسي وتثير استثناءً إذا كانت الصورة أكبر من أن تتسع. والتحميلات التي كانت تنجح سابقًا في مخزن الكومة قد تفشل الآن — تأكد من أن الصور المحمّلة تتسع في مخزن الإطارات (أو عالج الخطأ الجديد).

التأكيدات: 87d53385a

قائمة تحقق النقل

تأكد من أن الصور المحمّلة تتسع في مخزن الإطارات (أو التقط خطأ "الصورة كبيرة جدًا" الجديد) حيثما كنت تعتمد سابقًا على تحميل الصور المدعوم بالكومة (تغيير تحميل الصور). تعمل جميع البرامج النصية الأخرى دون تعديل.