Obraz małpy
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Klasa monkeyrunner do przechowywania obrazu ekranu urządzenia lub emulatora. Obraz jest
skopiowane z bufora ekranu podczas zrzutu ekranu. Metody tego obiektu umożliwiają:
przekonwertować obraz na różne formaty pamięci, zapisać obraz w pliku, skopiować fragmenty
i porównaj ten obiekt z innymi obiektami MonkeyImage.
Nie musisz tworzyć nowych instancji MonkeyImage. Zamiast tego użyj
MonkeyDevice.takeSnapshot(), aby utworzyć nową instancję ze zrzutu ekranu. Przykład:
newimage = MonkeyDevice.takeSnapshot()
Podsumowanie
| Metody |
|
ciąg znaków
|
convertToBytes,
(format ciągu znaków)
Konwertuje bieżący obraz na określony format i zwraca go jako
ciąg znaków, do którego możesz uzyskać dostęp w postaci identycznej bajtów binarnych.
|
|
krotka
|
getRawPixel
(liczba całkowita x,
liczba całkowita y)
Zwraca pojedynczy piksel w lokalizacji obrazu (x,y) jako
krotka liczby całkowitej w formacie (a,r,g,b).
|
|
liczba całkowita
|
getRawPixelInt
(liczba całkowita x,
liczba całkowita y)
Zwraca pojedynczy piksel w lokalizacji obrazu (x,y) jako
32-bitowa liczba całkowita.
|
MonkeyImage
|
Obraz getSub
(kropka)
Tworzy nowy obiekt MonkeyImage z prostokątnego zaznaczenia
bieżącego obrazu.
|
|
boolean (wartość logiczna).
|
sameAs
(MonkeyImage)
inne,
liczba zmiennoprzecinkowa)
.
Porównuje ten obiekt MonkeyImage z innym i zwraca wynik funkcji
dane porównawcze. Argument percent określa wartość procentową
pozwala, aby oba obrazy były „równe”.
|
|
void
|
writeToFile,
(ciąg znaków,
ciąg znaków)
Zapisuje bieżący obraz w pliku określonym przez funkcję filename w funkcji
w formacie określonym przez format.
|
Metody publiczne
Konwertuje bieżący obraz na określony format i zwraca go jako ciąg znaków
do którego masz dostęp w postaci identycznych bajtów binarnych.
Argumenty
| format |
Żądany format wyjściowy. Obsługiwane są wszystkie popularne formaty wyjściowe rastrowania.
Wartość domyślna to „png”. (Portable Network Graphics).
|
krotka
getRawPixel
(liczba całkowita x,
liczba całkowita y)
Zwraca pojedynczy piksel w lokalizacji obrazu (x,y) jako
krotka liczby całkowitej w formacie (a,r,g,b).
Argumenty
| x |
Położenie piksela w poziomie, zaczynając od 0 po lewej stronie ekranu w
orientacji ekranu w momencie robienia zrzutu ekranu.
|
| Y |
Położenie piksela w pionie, zaczynając od 0 na górze ekranu
orientacji ekranu w momencie robienia zrzutu ekranu.
|
Zwroty
-
Krótka liczb całkowitych reprezentujących piksel w formacie (a, r,g,b), gdzie
to wartość kanału alfa, a r, g i b to wartości czerwone, zielone i niebieskie.
.
krotka
getRawPixelInt
(liczba całkowita x,
liczba całkowita y)
Zwraca pojedynczy piksel w lokalizacji obrazu (x,y) jako
liczbą całkowitą. Użyj tej metody, aby oszczędzać pamięć.
Argumenty
| x |
Położenie piksela w poziomie, zaczynając od 0 po lewej stronie ekranu w
orientacji ekranu w momencie robienia zrzutu ekranu.
|
| Y |
Położenie piksela w pionie, zaczynając od 0 na górze ekranu
orientacji ekranu w momencie robienia zrzutu ekranu.
|
Zwroty
-
Wartości a, r, g i b piksela jako 8-bitowe połączone w 32-bitowy
liczba całkowita, gdzie a a jest 8 bitem po lewej stronie, „r” w kolejności od prawej itd.
MonkeyImage
obraz getSub,
(kropka)
Tworzy nowy obiekt MonkeyImage z prostokątnego zaznaczenia
bieżącego obrazu.
Argumenty
| rect |
Kropka (x, y, w, h) określająca wybór. x i y określają piksel, którego wartość jest równa 0.
w lewym górnym rogu zaznaczenia. w określa szerokość
regionu, a h określa jego wysokość, wyrażoną w pikselach.
Orientacja obrazu jest taka sama jak orientacja ekranu w momencie
po zrobieniu zrzutu ekranu.
|
Zwroty
-
Nowy obiekt
MonkeyImage zawierający zaznaczenie.
boolean (wartość logiczna).
sameAs
(
MonkeyImage
innyObraz,
liczba zmiennoprzecinkowa procent
).
Porównuje ten obiekt MonkeyImage z innym i zwraca wynik funkcji
dane porównawcze. Argument percent określa wartość procentową
pozwala, aby oba obrazy były „równe”.
Argumenty
| inne |
Kolejny obiekt MonkeyImage do porównania z tym.
|
|
procent
|
Liczba zmiennoprzecinkowa w zakresie od 0,0 do 1,0 włącznie, wskazująca
jaki procent pikseli musi być taki sam, aby metoda została zwrócona
true Wartość domyślna to 1,0, co oznacza, że wszystkie piksele
muszą pasować.
|
Zwroty
-
Wartość logiczna
true, jeśli obrazy pasują, lub wartość logiczna false w przeciwnym razie.
Zapisuje bieżący obraz w pliku określonym przez funkcję filename w funkcji
w formacie określonym przez format.
Argumenty
| ścieżka |
Pełna nazwa pliku i rozszerzenie pliku wyjściowego.
|
|
format
|
Format wyjściowy dla pliku. Jeśli nie podano formatu,
próbuje odgadnąć format na podstawie rozszerzenia nazwy pliku. Jeśli nie
z rozszerzenia i nie określono formatu, to domyślny format
„png” (Portable Network Graphics).
|
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-27 UTC."],[],[],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|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|"]]
