ОбезьянаИзображение

Класс обезьяньего бегуна для хранения изображения устройства или экрана эмулятора. Изображение копируется из буфера экрана во время создания скриншота. Методы этого объекта позволяют конвертировать изображение в различные форматы хранения, записывать изображение в файл, копировать части изображения и сравнивать этот объект с другими объектами 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» (переносимая сетевая графика).