صورة القرد

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

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

newimage = MonkeyDevice.takeSnapshot()

ملخّص

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

الطرق العامة

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

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

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

صف getRawPixel (عدد صحيح x، integer y)

لعرض وحدة البكسل الفردية في موقع الصورة (س، ص) في صورة صف مؤلف من عدد صحيح بالصيغة (a،r،g،b).

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

صف getRawPixelInt (عدد صحيح x، integer y)

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

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

MonkeyImage getSubImage (مستطيل للصف)

تنشئ كائن MonkeyImage جديدًا من تحديد مستطيل الصورة الحالية.

الوسيطات
rect صف (x، y، w، h) يحدد التحديد. يُحدد كل من x وy وحدات البكسل القائمة على 0 الموضع في أعلى الجانب الأيمن من التحديد. ويحدد w عرض المنطقة، وتحدد h ارتفاعها، سواء بوحدات البكسل.

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

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

منطقي sameAs ( MonkeyImage صورة أخرى، عائم في المئة )

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

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

فراغ كتابة ToFile (اسم ملف سلسلة، تنسيق سلسلة)

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

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