MonkeyImage

기기나 에뮬레이터의 화면 이미지를 보유한 monkeyrunner 클래스입니다. 이미지는 스크린샷 중에 화면 버퍼에서 복사됩니다. 이 객체의 메서드를 통해 이미지를 다양한 저장 형식으로 변환하고 파일에 이미지를 작성하며 일부 이미지를 복사하고 이 객체를 다른 MonkeyImage 객체와 비교할 수 있습니다.

MonkeyImage의 새로운 인스턴스를 생성할 필요가 없습니다. 대신 MonkeyDevice.takeSnapshot()을 사용하여 스크린샷에서 새로운 인스턴스를 생성합니다. 예를 들어 다음을 사용하세요. 

newimage = MonkeyDevice.takeSnapshot()

요약

메서드
string convertToBytes (string format)
현재 이미지를 특정 형식으로 변환하고 바이너리 바이트의 iterable로 액세스할 수 있는 string으로 반환합니다.
tuple getRawPixel (integer x, integer y)
이미지 위치(x, y)의 단일 픽셀을 (a, r, g, b) 형식의 integer tuple로 반환합니다.
integer getRawPixelInt (integer x, integer y)
이미지 위치의 단일 픽셀을 32비트 integer로 반환합니다.
MonkeyImage getSubImage (tuple rect)
현재 이미지를 사각형으로 선택하여 새로운 MonkeyImage 객체를 생성합니다.
boolean sameAs (MonkeyImage other, float percent)
이 MonkeyImage 객체를 다른 것과 비교하고 비교 결과를 반환합니다. percent 인수는 두 이미지가 '동일'할 수 있는 비율 차이를 지정합니다.
void writeToFile (string path, string format)
format으로 지정된 형식으로 현재 이미지를 filename으로 지정된 파일에 작성합니다.

공개 메서드

string convertToBytes ( string format)

현재 이미지를 특정 형식으로 변환하고 바이너리 바이트의 iterable로 액세스할 수 있는 string으로 반환합니다.

인수
형식 원하는 출력 형식입니다. 모든 일반적인 래스터 출력 형식이 지원됩니다. 기본값은 'png'(Portable Network Graphics)입니다.

tuple getRawPixel (integer x, integer y)

이미지 위치(x, y)의 단일 픽셀을 (a, r, g, b) 형식의 integer tuple로 반환합니다.

인수
x 스크린샷을 찍을 때와 같은 방향으로 화면 왼쪽에서 0으로 시작하는 픽셀의 수평 위치입니다.
y 스크린샷을 찍을 때와 같은 방향으로 화면 상단에서 0으로 시작하는 수직 위치입니다.
반환 값
  • (a, r, g, b) 형식으로 픽셀을 나타내는 정수 tuple로 a는 알파 채널 값이고 r과 g, b는 각각 빨강, 녹색, 파랑 값입니다.

tuple getRawPixelInt (integer x, integer y)

이미지 위치(x, y)의 단일 픽셀을 integer로 반환합니다. 이 메서드를 사용하여 메모리를 절약합니다.

인수
x 스크린샷을 찍을 때와 같은 방향으로 화면 왼쪽에서 0으로 시작하는 픽셀의 수평 위치입니다.
y 스크린샷을 찍을 때와 같은 방향으로 화면 상단에서 0으로 시작하는 수직 위치입니다.
반환 값
  • 8비트 값인 픽셀의 a, r, g, b 값은 32비트 정수로 결합되며 a는 가장 왼쪽 8비트, r은 그다음 가장 오른쪽 8비트가 되는 식입니다.

MonkeyImage getSubImage (tuple rect)

현재 이미지를 사각형으로 선택하여 새로운 MonkeyImage 객체를 생성합니다.

인수
rect 선택 영역을 지정하는 튜플(x, y, w, h)입니다. x 및 y는 선택 영역의 왼쪽 상단 모서리의 0 기반 픽셀 위치를 지정합니다. w는 영역의 너비를, h는 높이를 픽셀 단위로 각각 지정합니다.

이미지 방향은 스크린샷을 만들 때의 화면 방향과 같습니다.
반환 값
  • 선택 영역이 포함된 새로운 MonkeyImage 객체입니다.

boolean sameAs ( MonkeyImage otherImage, float percent )

이 MonkeyImage 객체를 다른 것과 비교하고 비교 결과를 반환합니다. percent 인수는 두 이미지가 '동일'할 수 있는 비율 차이를 지정합니다.

인수
기타 이 객체와 비교할 또 다른 MonkeyImage 객체입니다.
percent 메서드가 true를 반환하기 위해 동일해야 하는 픽셀 비율을 나타내는 0.0에서 1.0까지의 부동 소수점입니다. 기본값은 1.0이고 모든 픽셀이 일치해야 함을 나타냅니다.
반환 값
  • 이미지가 일치하면 부울이 true이고 일치하지 않으면 부울이 false입니다.

void writeToFile (string filename, string format)

format으로 지정된 형식으로 현재 이미지를 filename으로 지정된 파일에 작성합니다.

인수
경로 출력 파일의 정규화된 파일 이름 및 확장자입니다.
형식 파일에 사용할 출력 형식입니다. 형식이 제공되지 않으면 메서드는 파일 이름의 확장자에서 형식을 추측하려고 시도합니다. 확장자가 제공되지 않고 형식도 지정되지 않으면 기본 형식인 'png'(Portable Network Graphics)가 사용됩니다.