صورة القرد

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

لست بحاجة إلى إنشاء نُسخ جديدة من MonkeyImage. بدلاً من ذلك، يمكنك استخدام MonkeyDevice.takeSnapshot() لإنشاء مثيل جديد من لقطة شاشة. على سبيل المثال، يمكنك استخدام:

newimage = MonkeyDevice.takeSnapshot()

ملخّص

الطرق
سلسلة conversionToBytes (تنسيق سلسلة)
تحوِّل الصورة الحالية إلى تنسيق معيّن وتعرضها في شكل سلسلة يمكنك الوصول إليها بعد ذلك كقابلة للتكرار في وحدات البايت الثنائية.
الصف getRawPixel (عدد صحيحعدد صحيح ص)
يتم عرض وحدة البكسل المفردة في موقع الصورة (س,ص)، على أنّها صف من عدد صحيح، بالصيغة (a,r,g,b).
عدد صحيح getRawPixelInt (عدد صحيحعدد صحيح ص)
يتم عرض وحدة البكسل المفردة في موقع الصورة (x,y)، على شكل عدد صحيح 32 بت.
MonkeyImage getSubImage (مستطيلة tuple)
لإنشاء عنصر MonkeyImage جديد من خلال اختيار مستطيل للصورة الحالية
منطقي sameAs (MonkeyImage غير ذلك، نسبة عائمة)
لمقارنة كائن MonkeyImage هذا بعنصر آخر وعرض نتيجة المقارنة. تحدّد الوسيطة percent الفرق بالنسبة المئوية المسموح لها بأن تكون الصورتان "متساويتان".
ملغاة writeToFile (مسار سلسلة، تنسيق سلسلة)
لكتابة الصورة الحالية إلى الملف المحدد من خلال filename، بالتنسيق الذي تحدده format.

الطرق المتاحة للجميع

سلسلة conversionToBytes ( تنسيق سلسلة)

لتحويل الصورة الحالية إلى تنسيق معيّن وعرضها على شكل سلسلة يمكنك الوصول إليها بعد ذلك بصفتها قابلة للتكرار في وحدات البايت الثنائية.

الوسيطات
الصيغة تمثّل هذه السمة تنسيق الإخراج المطلوب. يتم دعم جميع تنسيقات الإخراج النقطية الشائعة. القيمة التلقائية هي "png" (رسومات الشبكة المحمولة).

الصف getRawPixel (عدد صحيحعدد صحيح y)

يتم عرض وحدة البكسل المفردة في موقع الصورة (س,ص)، على أنّها صف من عدد صحيح، بالصيغة (a,r,g,b).

الوسيطات
x تمثّل هذه السمة الموضع الأفقي للبكسل، بدءًا من 0 على يسار الشاشة بالاتجاه الذي كان عليه عند التقاط لقطة الشاشة.
y الموضع العمودي للبكسل، بدءًا من 0 في أعلى الشاشة بالاتجاه الذي كان عليه عند التقاط لقطة الشاشة.
الركلات المردودة
  • صف من الأعداد الصحيحة التي تمثل البكسل، على هيئة (a,r,g,b) حيث a هي قيمة قناة ألفا، وr وg وb هي القيم الحمراء والأخضر والأزرق، على التوالي.

الصف getRawPixelInt (عدد صحيحعدد صحيح y)

تعرض وحدة البكسل المفردة في موقع الصورة (x,y)، على أنّها عدد صحيح. ويمكنك استخدام هذه الطريقة لتوفير مساحة في الذاكرة.

الوسيطات
x تمثّل هذه السمة الموضع الأفقي للبكسل، بدءًا من 0 على يسار الشاشة بالاتجاه الذي كان عليه عند التقاط لقطة الشاشة.
y الموضع العمودي للبكسل، بدءًا من 0 في أعلى الشاشة بالاتجاه الذي كان عليه عند التقاط لقطة الشاشة.
الركلات المردودة
  • القيم a وr وg وb للبكسل كقيم 8 بت مدمجة في عدد 32 بت صحيح، مثل 8 بت في أقصى اليسار وr في أقصى اليمين التالي، وهكذا.

MonkeyImage getSubImage (مستطيل tuple)

لإنشاء عنصر MonkeyImage جديد من خلال اختيار مستطيل للصورة الحالية

الوسيطات
مستطيل الصف (x وy وw وh) الذي يحدد الاختيار. x وy يحددان موضع وحدات البكسل على أساس 0 في الزاوية العلوية اليسرى من التحديد. ويحدد w عرض المنطقة ويحدد h ارتفاعها بوحدات البكسل.

يكون اتجاه الصورة هو نفسه اتجاه الشاشة في وقت التقاط لقطة الشاشة.

الركلات المردودة
  • عنصر MonkeyImage جديد يحتوي على التحديد.

منطقي sameAs ( MonkeyImage otherImage, float بالمائة )

لمقارنة كائن MonkeyImage هذا بعنصر آخر وعرض نتيجة المقارنة. تحدّد الوسيطة percent الفرق بالنسبة المئوية المسموح لها بأن تكون الصورتان "متساويتان".

الوسيطات
غير ذلك عنصر MonkeyImage آخر للمقارنة بهذا العنصر.
النسبة المئوية عدد عائم يتراوح بين 0.0 و1.0، بما يشير إلى النسبة المئوية لوحدات البكسل التي يجب أن تكون متماثلة للطريقة التي يتم بها عرض true. القيمة التلقائية هي 1.0، ما يشير إلى أنّ جميع وحدات البكسل يجب أن تتطابق.
الركلات المردودة
  • استخدِم القيمة المنطقية true إذا كانت الصور متطابقة، أو استخدِم القيمة المنطقية false في الحالات الأخرى.

void writeToFile (اسم ملف سلسلة، تنسيق سلسلة)

لكتابة الصورة الحالية إلى الملف المحدد من خلال filename، بالتنسيق الذي تحدده format.

الوسيطات
مسار اسم الملف المؤهّل بالكامل وامتداد ملف الإخراج
الصيغة تنسيق الإخراج المطلوب استخدامه للملف في حال عدم توفير أي تنسيق، ستحاول الطريقة تخمين التنسيق من امتداد اسم الملف. إذا لم يتم تقديم أي امتداد ولم يتم تحديد تنسيق، سيتم استخدام التنسيق التلقائي "png" (رسومات الشبكة المحمولة).