صورة القرد
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
فئة ألعاب القردة التي تتضمن صورة للجهاز أو شاشة المحاكي. الصورة هي
من المخزن المؤقت للشاشة أثناء التقاط لقطة شاشة. تتيح لك طرق هذا الكائن
وتحويل الصورة إلى تنسيقات تخزين مختلفة، وكتابة الصورة إلى ملف، ونسخ أجزاء من
للصورة، ومقارنة هذا الكائن بكائنات 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.
|
الطرق العامة
تحويل الصورة الحالية إلى تنسيق معيّن وعرضها في شكل سلسلة
التي يمكنك الوصول إليها باعتبارها قابلة للتكرار لوحدات البايت الثنائية.
الوسيطات
| الصيغة |
تنسيق الإخراج المطلوب. يتم اعتماد جميع تنسيقات مخرجات الصور النقطية الشائعة.
القيمة الافتراضية هي "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 غير ذلك.
لكتابة الصورة الحالية إلى الملف المحدد من خلال filename، في
التنسيق المحدد بواسطة format.
الوسيطات
| مسار |
اسم الملف المؤهّل بالكامل والامتداد لملف الإخراج.
|
|
الصيغة
|
تنسيق الإخراج المراد استخدامه للملف. إذا لم يتم توفير أي تنسيق،
تخمين التنسيق من امتداد اسم الملف. إذا كانت الإجابة "لا"
لم يتم توفير أي تنسيق، فعندئذٍ يتم تحديد التنسيق الافتراضي
"png" يتم استخدام (رسومات الشبكة المحمولة).
|
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# MonkeyImage\n\nA monkeyrunner class to hold an image of the device or emulator's screen. The image is\ncopied from the screen buffer during a screenshot. This object's methods allow you to\nconvert the image into various storage formats, write the image to a file, copy parts of\nthe image, and compare this object to other `MonkeyImage` objects.\n\n\nYou do not need to create new instances of `MonkeyImage`. Instead, use\n[MonkeyDevice.takeSnapshot()](/tools/help/MonkeyDevice#takeSnapshot) to create a new instance from a screenshot. For example, use: \n\n```\nnewimage = MonkeyDevice.takeSnapshot()\n```\n\nSummary\n-------\n\n| Methods ||||||||||||\n|----------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|---|---|---|---|---|---|---|---|---|\n| *string* | [convertToBytes](#convertToBytes) (*string* format) Converts the current image to a particular format and returns it as a *string* that you can then access as an *iterable* of binary bytes. |\n| *tuple* | [getRawPixel](#getRawPixel) (*integer* x, *integer* y) Returns the single pixel at the image location (x,y), as an a *tuple* of *integer*, in the form (a,r,g,b). |\n| *integer* | [getRawPixelInt](#getRawPixelInt) (*integer* x, *integer* y) Returns the single pixel at the image location (x,y), as a 32-bit *integer*. |\n| ` `[MonkeyImage](/tools/help/MonkeyImage)` ` | [getSubImage](#getSubImage) (*tuple* rect) Creates a new `MonkeyImage` object from a rectangular selection of the current image. |\n| *boolean* | [sameAs](#sameAs) ([MonkeyImage](/tools/help/MonkeyImage) other, *float* percent) Compares this `MonkeyImage` object to another and returns the result of the comparison. The `percent` argument specifies the percentage difference that is allowed for the two images to be \"equal\". |\n| *void* | [writeToFile](#writeToFile) (*string* path, *string* format) Writes the current image to the file specified by `filename`, in the format specified by `format`. |\n\nPublic methods\n--------------\n\n#### *string*\nconvertToBytes\n( *string* format)\n\n\nConverts the current image to a particular format and returns it as a *string*\nthat you can then access as an *iterable* of binary bytes. \n\n##### Arguments\n\n| format | The desired output format. All of the common raster output formats are supported. The default value is \"png\" (Portable Network Graphics). |\n|--------|-------------------------------------------------------------------------------------------------------------------------------------------|\n\n#### *tuple*\ngetRawPixel\n(*integer* x, *integer* y)\n\n\nReturns the single pixel at the image location (x,y), as an\na *tuple* of *integer*, in the form (a,r,g,b). \n\n##### Arguments\n\n| x | The horizontal position of the pixel, starting with 0 at the left of the screen in the orientation it had when the screenshot was taken. |\n| y | The vertical position of the pixel, starting with 0 at the top of the screen in the orientation it had when the screenshot was taken. |\n|---|------------------------------------------------------------------------------------------------------------------------------------------|\n\n##### Returns\n\n- A tuple of integers representing the pixel, in the form (a,r,g,b) where a is the alpha channel value, and r, g, and b are the red, green, and blue values, respectively. \n\n#### *tuple*\ngetRawPixelInt\n(*integer* x, *integer* y)\n\n\nReturns the single pixel at the image location (x,y), as an\nan *integer*. Use this method to economize on memory. \n\n##### Arguments\n\n| x | The horizontal position of the pixel, starting with 0 at the left of the screen in the orientation it had when the screenshot was taken. |\n| y | The vertical position of the pixel, starting with 0 at the top of the screen in the orientation it had when the screenshot was taken. |\n|---|------------------------------------------------------------------------------------------------------------------------------------------|\n\n##### Returns\n\n- The a,r,g, and b values of the pixel as 8-bit values combined into a 32-bit integer, with a as the leftmost 8 bits, r the next rightmost, and so forth. \n\n#### `\n`[MonkeyImage](/tools/help/MonkeyImage)`\n`\ngetSubImage\n(*tuple* rect)\n\n\nCreates a new `MonkeyImage` object from a rectangular selection of the\ncurrent image. \n\n##### Arguments\n\n| rect | A tuple (x, y, w, h) specifying the selection. x and y specify the 0-based pixel position of the upper left-hand corner of the selection. w specifies the width of the region, and h specifies its height, both in units of pixels. The image's orientation is the same as the screen orientation at the time the screenshot was made. |\n|------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n\n##### Returns\n\n- A new `MonkeyImage` object containing the selection. \n\n#### *boolean*\nsameAs\n( `\n`[MonkeyImage](/tools/help/MonkeyImage)`\n` otherImage, *float* percent )\n\n\nCompares this `MonkeyImage` object to another and returns the result of\nthe comparison. The `percent` argument specifies the percentage\ndifference that is allowed for the two images to be \"equal\". \n\n##### Arguments\n\n| other | Another `MonkeyImage` object to compare to this one. |\n| percent | A float in the range 0.0 to 1.0, inclusive, indicating the percentage of pixels that need to be the same for the method to return `true`. The default is 1.0, indicating that all the pixels must match. |\n|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n\n##### Returns\n\n- Boolean `true` if the images match, or boolean `false` otherwise. \n\n#### void\nwriteToFile\n(*string* filename, *string* format)\n\n\nWrites the current image to the file specified by `filename`, in the\nformat specified by `format`. \n\n##### Arguments\n\n| path | The fully-qualified filename and extension of the output file. |\n| format | The output format to use for the file. If no format is provided, then the method tries to guess the format from the filename's extension. If no extension is provided and no format is specified, then the default format of \"png\" (Portable Network Graphics) is used. |\n|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|"]]
