میمون تصویر

یک کلاس monkeyrunner برای نگه داشتن تصویری از صفحه نمایش دستگاه یا شبیه ساز. تصویر در حین اسکرین شات از بافر صفحه کپی می شود. روش‌های این شی به شما امکان می‌دهد تصویر را به فرمت‌های ذخیره‌سازی مختلف تبدیل کنید، تصویر را در یک فایل بنویسید، بخش‌هایی از تصویر را کپی کنید و این شی را با سایر اشیاء MonkeyImage مقایسه کنید.

شما نیازی به ایجاد نمونه های جدید از MonkeyImage ندارید. در عوض، از MonkeyDevice.takeSnapshot() برای ایجاد یک نمونه جدید از یک اسکرین شات استفاده کنید. برای مثال استفاده کنید: 

newimage = MonkeyDevice.takeSnapshot()

خلاصه

روش ها
رشته convertToBytes (فرمت رشته )
تصویر فعلی را به فرمت خاصی تبدیل می کند و آن را به صورت رشته ای برمی گرداند که سپس می توانید به عنوان یک بایت باینری تکرارپذیر به آن دسترسی داشته باشید.
چندتایی getRawPixel ( عدد صحیح x، عدد صحیح y)
تک پیکسل را در محل تصویر (x,y) به صورت یک عدد صحیح به شکل (a,r,g,b) برمی‌گرداند.
عدد صحیح getRawPixelInt ( عدد صحیح x، عدد صحیح y)
تک پیکسل را در محل تصویر (x,y) به عنوان یک عدد صحیح 32 بیتی برمی‌گرداند.
MonkeyImage getSubImage ( tuple rect)
یک شی MonkeyImage جدید از یک انتخاب مستطیلی از تصویر فعلی ایجاد می کند.
بولی sameAs ( MonkeyImage دیگر، درصد شناور )
این شی MonkeyImage با شی دیگری مقایسه می کند و نتیجه مقایسه را برمی گرداند. آرگومان percent درصد اختلاف مجاز برای "برابر" بودن دو تصویر را مشخص می کند.
باطل writeToFile (مسیر رشته ، قالب رشته )
تصویر فعلی را در فایلی که با filename مشخص شده است، در قالب مشخص شده توسط format می‌نویسد.

روش های عمومی

رشته تبدیل به بایت (فرمت رشته )

تصویر فعلی را به فرمت خاصی تبدیل می کند و آن را به صورت رشته ای برمی گرداند که سپس می توانید به عنوان یک بایت باینری تکرارپذیر به آن دسترسی داشته باشید.

استدلال ها
قالب فرمت خروجی مورد نظر همه فرمت های رایج خروجی شطرنجی پشتیبانی می شوند. مقدار پیش فرض "png" (گرافیک شبکه قابل حمل) است.

تاپل getRawPixel ( عدد صحیح x، عدد صحیح y)

تک پیکسل را در محل تصویر (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 بیتی ترکیب می شوند که a به عنوان سمت چپ ترین 8 بیت، r بعدی سمت راست، و غیره.

MonkeyImage getSubImage ( تاپل rect)

یک شی MonkeyImage جدید از یک انتخاب مستطیلی از تصویر فعلی ایجاد می کند.

استدلال ها
راست یک تاپل (x، y، w، h) که انتخاب را مشخص می کند. x و y موقعیت پیکسل مبتنی بر 0 را در گوشه سمت چپ بالای انتخاب مشخص می کنند. w عرض منطقه و h ارتفاع آن را هر دو بر حسب واحد پیکسل مشخص می کند.

جهت تصویر همانند جهت صفحه در زمان تهیه اسکرین شات است.

برمی گرداند
  • یک شی MonkeyImage جدید حاوی انتخاب.

Boolean sameAs ( MonkeyImage otherImage، درصد شناور )

این شی MonkeyImage با شی دیگری مقایسه می کند و نتیجه مقایسه را برمی گرداند. آرگومان percent درصد اختلاف مجاز برای "برابر" بودن دو تصویر را مشخص می کند.

استدلال ها
دیگر یکی دیگر از شی MonkeyImage برای مقایسه با این یکی.
درصد یک شناور در محدوده 0.0 تا 1.0، شامل درصد پیکسل هایی که باید یکسان باشند تا روش به true برگردد. پیش فرض 1.0 است که نشان می دهد همه پیکسل ها باید مطابقت داشته باشند.
برمی گرداند
  • اگر تصاویر مطابقت داشته باشند، true ، یا در غیر این صورت، false بولی.

void writeToFile (نام فایل رشته ، قالب رشته )

تصویر فعلی را در فایلی که با filename مشخص شده است، در قالب مشخص شده توسط format می‌نویسد.

استدلال ها
مسیر نام فایل کاملا واجد شرایط و پسوند فایل خروجی.
قالب فرمت خروجی مورد استفاده برای فایل. اگر هیچ فرمتی ارائه نشده باشد، روش سعی می‌کند فرمت را از پسوند نام فایل حدس بزند. اگر پسوندی ارائه نشده باشد و هیچ فرمتی مشخص نشده باشد، از فرمت پیش فرض "png" (Portable Network Graphics) استفاده می شود.