فئة Monerrunner للاحتفاظ بصورة لشاشة الجهاز أو المحاكي. يتم نسخ الصورة من المخزن المؤقت للشاشة أثناء التقاط لقطة شاشة. تتيح لك الطرق التي يستخدمها هذا العنصر
تحويل الصورة إلى تنسيقات تخزين مختلفة، وكتابة الصورة إلى ملف، ونسخ أجزاء من
الصورة، ومقارنة هذا الكائن بكائنات MonkeyImage
الأخرى.
لست بحاجة إلى إنشاء نُسخ جديدة من MonkeyImage
. بدلاً من ذلك، يمكنك استخدام
MonkeyDevice.takeSnapshot()
لإنشاء مثيل جديد من لقطة شاشة. على سبيل المثال، يمكنك استخدام:
newimage = MonkeyDevice.takeSnapshot()
ملخّص
الطرق | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
تحوِّل الصورة الحالية إلى تنسيق معيّن وتعرضها في شكل سلسلة يمكنك الوصول إليها بعد ذلك كقابلة للتكرار في وحدات البايت الثنائية.
|
||||||||||
|
يتم عرض وحدة البكسل المفردة في موقع الصورة (س,ص)، على أنّها صف من عدد صحيح، بالصيغة (a,r,g,b).
|
||||||||||
|
يتم عرض وحدة البكسل المفردة في موقع الصورة (x,y)، على شكل عدد صحيح 32 بت.
|
||||||||||
MonkeyImage
|
لإنشاء عنصر
MonkeyImage جديد من خلال اختيار مستطيل للصورة الحالية
|
||||||||||
|
MonkeyImage
غير ذلك،
نسبة عائمة)
لمقارنة كائن
MonkeyImage هذا بعنصر آخر وعرض نتيجة المقارنة. تحدّد الوسيطة percent الفرق بالنسبة المئوية
المسموح لها بأن تكون الصورتان "متساويتان".
|
||||||||||
|
لكتابة الصورة الحالية إلى الملف المحدد من خلال
filename ، بالتنسيق الذي تحدده format .
|
الطرق المتاحة للجميع
سلسلة conversionToBytes ( تنسيق سلسلة)
لتحويل الصورة الحالية إلى تنسيق معيّن وعرضها على شكل سلسلة يمكنك الوصول إليها بعد ذلك بصفتها قابلة للتكرار في وحدات البايت الثنائية.
الوسيطات
الصيغة | تمثّل هذه السمة تنسيق الإخراج المطلوب. يتم دعم جميع تنسيقات الإخراج النقطية الشائعة. القيمة التلقائية هي "png" (رسومات الشبكة المحمولة). |
---|
الصف getRawPixel (عدد صحيح x، عدد صحيح y)
يتم عرض وحدة البكسل المفردة في موقع الصورة (س,ص)، على أنّها صف من عدد صحيح، بالصيغة (a,r,g,b).
الوسيطات
x | تمثّل هذه السمة الموضع الأفقي للبكسل، بدءًا من 0 على يسار الشاشة بالاتجاه الذي كان عليه عند التقاط لقطة الشاشة. |
---|---|
y | الموضع العمودي للبكسل، بدءًا من 0 في أعلى الشاشة بالاتجاه الذي كان عليه عند التقاط لقطة الشاشة. |
الركلات المردودة
- صف من الأعداد الصحيحة التي تمثل البكسل، على هيئة (a,r,g,b) حيث a هي قيمة قناة ألفا، وr وg وb هي القيم الحمراء والأخضر والأزرق، على التوالي.
الصف getRawPixelInt (عدد صحيح x، عدد صحيح 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" (رسومات الشبكة المحمولة). |