Класс обезьяньего бегуна для хранения изображения устройства или экрана эмулятора. Изображение копируется из буфера экрана во время создания скриншота. Методы этого объекта позволяют конвертировать изображение в различные форматы хранения, записывать изображение в файл, копировать части изображения и сравнивать этот объект с другими объектами 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 ( кортеж прямоугольник) Создает новый объект MonkeyImage из прямоугольного выделения текущего изображения. | ||||||||||
логическое значение | SameAs ( MonkeyImage другое, процент с плавающей запятой ) Сравнивает этот объект MonkeyImage с другим и возвращает результат сравнения. Аргумент percent указывает разницу в процентах, при которой два изображения могут быть «равными». | ||||||||||
пустота | writeToFile (путь к строке , формат строки ) Записывает текущее изображение в файл, указанный в параметре filename , в формате, указанном в format . |
Публичные методы
строка ConvertToBytes (формат строки )
Преобразует текущее изображение в определенный формат и возвращает его в виде строки , к которой затем можно получить доступ как к итерации двоичных байтов.
Аргументы
формат | Желаемый формат вывода. Поддерживаются все распространенные форматы растрового вывода. Значение по умолчанию — «png» (переносимая сетевая графика). |
---|
кортеж getRawPixel ( целое число x, целое число y)
Возвращает один пиксель в местоположении изображения (x,y) как кортеж целых чисел в форме (a,r,g,b).
Аргументы
х | Горизонтальное положение пикселя, начиная с 0, слева от экрана в той ориентации, которую он имел при создании снимка экрана. |
---|---|
й | Вертикальное положение пикселя, начиная с 0 в верхней части экрана, в той ориентации, которую он имел при создании снимка экрана. |
Возврат
- Кортеж целых чисел, представляющих пиксель, в форме (a,r,g,b), где a — значение альфа-канала, а r, g и b — значения красного, зеленого и синего соответственно.
кортеж getRawPixelInt ( целое число x, целое число y)
Возвращает один пиксель в местоположении изображения (x,y) в виде целого числа . Используйте этот метод, чтобы сэкономить память.
Аргументы
х | Горизонтальное положение пикселя, начиная с 0, слева от экрана в той ориентации, которую он имел при создании снимка экрана. |
---|---|
й | Вертикальное положение пикселя, начиная с 0 в верхней части экрана, в той ориентации, которую он имел при создании снимка экрана. |
Возврат
- Значения a,r,g и b пикселя представляют собой 8-битные значения, объединенные в 32-битное целое число, где a — самые левые 8 бит, r — следующие самые правые и т. д.
MonkeyImage
getSubImage ( кортеж прямоугольник)
Создает новый объект MonkeyImage
из прямоугольного выделения текущего изображения.
Аргументы
прямой | Кортеж (x, y, w, h), определяющий выбор. x и y определяют положение пикселя верхнего левого угла выделения, отсчитываемое от 0. w определяет ширину области, а h определяет ее высоту, как в пикселях. Ориентация изображения такая же, как ориентация экрана на момент создания снимка экрана. |
---|
Возврат
- Новый объект
MonkeyImage
, содержащий выделение.
логическое значение SameAs ( MonkeyImage
, процент с плавающей запятой )
Сравнивает этот объект MonkeyImage
с другим и возвращает результат сравнения. Аргумент percent
указывает разницу в процентах, при которой два изображения могут быть «равными».
Аргументы
другой | Еще один объект MonkeyImage для сравнения с этим. |
---|---|
процент | Число с плавающей запятой в диапазоне от 0,0 до 1,0 включительно, указывающее процент пикселей, которые должны быть одинаковыми, чтобы метод возвращал true . Значение по умолчанию — 1,0, что означает, что все пиксели должны совпадать. |
Возврат
- Логическое значение
true
, если изображения совпадают, или логическое значениеfalse
в противном случае.
void writeToFile ( строковое имя файла, строковый формат)
Записывает текущее изображение в файл, указанный в параметре filename
, в формате, указанном в format
.
Аргументы
путь | Полное имя файла и расширение выходного файла. |
---|---|
формат | Выходной формат, используемый для файла. Если формат не указан, метод пытается угадать формат по расширению имени файла. Если расширение не указано и формат не указан, то используется формат по умолчанию «png» (переносимая сетевая графика). |