javax.microedition.lcdui
Class Image

java.lang.Object
  |
  +--javax.microedition.lcdui.Image

public class Image

extends Object

Image 클래스는 그래픽 이미지 데이터를 보관하는 데 사용됩니다. Image 객체는 디스플레이 장치와는 별도로 존재합니다. 이러한 객체는 오프스크린 메모리에만 존재하며 응용 프로그램에서 명시적인 명령(예: Canvas의 paint() 메소드)을 실행하거나 활성화된 Form 화면 또는 Alert 화면에 Image 객체를 배치한 경우가 아니라면 디스플레이에 표시되지 않습니다.

이미지는 작성 방법에 따라 변경 가능한 경우도 있고 변경 불가능한 경우도 있습니다. 변경 불가능한 이미지는 일반적으로 자원 번들, 파일 또는 네트워크에서 이미지 데이터를 로드할 때 작성됩니다. 이러한 이미지는 한 번 작성되면 수정될 수 없습니다. 변경 가능한 이미지는 흰색 픽셀만 들어 있는 공백 이미지로 작성됩니다. 특히 이를 위해 응용 프로그램에서는 Image의 getGraphics()를 호출하는 방식으로 변경 가능한 이미지를 렌더링하여 Graphics 객체를 얻을 수 있습니다.

Images는 Alert, Choice, Form 또는 ImageItem 객체에 배치될 수 있습니다. 응용 프로그램에 알리지 않고 언제든지 디스플레이를 업데이트하려면 고급 사용자 인터페이스 구현이 필요할 수도 있습니다. 동작을 예측 가능하도록 하기 위해 고급 사용자 인터페이스 객체는 이미지의 스냅샷 의미를 제공합니다. 즉, 변경 가능한 이미지가 Alert, Choice, Form 또는 ImageItem 객체에 배치된 경우 현재 내용으로 스냅샷을 생성한 것과 같은 기능을 합니다. 그런 다음 이 스냅샷은 고급 사용자 인터페이스 구성 요소의 모든 후속 그리기에 사용됩니다. 응용 프로그램이 이미지의 내용을 수정한 경우 수정된 내용을 표시하려면 해당 이미지가 들어 있는 구성 요소를 업데이트해야 합니다(예: ImageItem.setImage 호출).

변경 불가능한 이미지는 createImage 메소드를 사용하여 변경 가능한 이미지에서 작성될 수 있습니다. 다음과 유사한 기술을 사용하여 변경 불가능한 이미지의 변경 가능한 사본을 작성할 수 있습니다.

    Image source; // the image to be copied
    source = Image.createImage(...);
    Image copy = Image
        .createImage(source.getWidth(), source.getHeight());
    Graphics g = copy.getGraphics();
    g.drawImage(source, 0, 0, TOP|LEFT);       

알파 처리

변경 가능한 이미지에 있는 모든 픽셀은 항상 완전 불투명입니다. 변경 불가능한 이미지에는 완전 불투명 픽셀(alpha = 2bitdepth - 1), 완전 투명 픽셀 (alpha = 0) 및 반투명 픽셀(0 < alpha < 2bitdepth - 1)의 조합이 들어 있을 수 있습니다. 여기서 bitdepth는 소스 데이터의 샘플당 비트 수입니다.

구현 시 변경 불가능 이미지에서 완전 불투명 픽셀과 완전 투명 픽셀의 저장소, 처리 및 렌더링을 지원해야 합니다. 소스 데이터에서 이미지를 작성할 때(PNG 파일에서건 ARGB 데이터 배열에서건 상관없이) 소스 데이터의 완전 불투명 픽셀은 새 이미지에서 항상 완전 불투명 픽셀이 되어야 하고 소스 데이터의 완전 투명 픽셀은 새 이미지에서 항상 완전 투명 픽셀이 되어야 합니다.

반투명 픽셀 데이터에 필요한 처리는 렌더링 시 알파 블렌딩을 지원하는지에 따라 다릅니다. 구현 시 알파 블렌딩을 지원하면 소스 데이터의 반투명 픽셀은 새 이미지에서도 반투명 픽셀이 되어야 합니다. 결과 알파 값은 플랫폼이 지원하는 반투명도 수준 수에 맞춰 수정될 수 있습니다. Display.numAlphaLevels() 메소드를 참조하십시오. 구현 시 알파 블렌딩을 지원하지 않으면 소스 데이터의 반투명 픽셀은 모두 새 이미지의 완전 투명 픽셀로 교체되어야 합니다.

PNG 이미지 형식

구현 시 PNG (Portable Network Graphics) 사양, 버전 1.0에서 지정된 대로 PNG 형식으로 저장된 이미지를 지원해야 합니다. MIDP를 준수하는 모든 구현은 PNG 사양이 제공하는 최소 요구 사항 집합도 준수합니다. MIDP 구현은 또한 PNG 이미지 처리와 관련하여 여기에 제공된 추가 요구 사항도 준수해야 합니다. 여기에 나열된 요구 사항은 PNG 사양에 제공된 권장 사항과 충돌할 경우 이보다 우선합니다.

위험 청크

PNG가 지정한 모든 '위험' 청크가 지원되어야 합니다. 아래 단락은 이러한 위험 청크를 설명합니다.

IHDR 청크. MIDP 장치는 IHDR 청크에서 다음 값을 처리해야 합니다.

• 모든 양수 값의 너비와 높이가 지원되지만 매우 큰 이미지는 메모리 제약 조건 때문에 읽지 못할 수도 있습니다. 결과 Image 객체의 치수는 PNG 이미지의 치수와 일치해야 합니다. 즉, getWidth() 및 getHeight()가 반환한 값과 렌더링된 너비 및 높이는 IHDR 청크에 지정된 너비 및 높이와 동일해야 합니다.
• 이미지의 모양은 장치 화면의 기능에 따라 달라지지만 모든 색상 유형이 지원됩니다. 알파 채널 데이터를 포함하는 색상 유형이 지원됩니다.
• 색상 유형 4 & 6(각각 알파가 있는 회색조 및 알파가 있는 RGB)의 경우 알파 채널은 디코딩되어야 합니다. 알파 값이 0인 픽셀은 투명으로 처리되어야 합니다. 알파 값이 255(샘플당 비트가 8인 이미지의 경우) 또는 65535(샘플당 비트가 16인 이미지의 경우)인 픽셀은 불투명으로 처리 되어야 합니다. 알파 블렌딩을 사용한 렌더링이 지원되면 중간 알파 값이 있는 모든 픽셀은 결과 이미지로 이동되어야 합니다. 알파 블렌딩이 지원되지 않으면 중간 알파 값이 있는 모든 픽셀은 완전 투명 픽셀로 교체되어야 합니다.
• 주어진 색상 유형에 대한 모든 비트 깊이 값이 지원됩니다.
• 압축 메소드 0(수축)은 지원되는 유일한 압축 메소드입니다. 이 메소드는 "zlib" 압축 방법을 활용하는 데 이 방법은 jar 파일에도 사용됩니다. 따라서 jar 디코딩과 PNG 디코딩 구현 간에 압축 해제(팽창) 코드가 공유될 수도 있습니다. PNG 사양에서 언급되었듯이 압축된 데이터 스트림은 내부적으로 압축된 데이터와 압축 해제된(원시) 데이터 모두로 구성될 수 있습니다.
• 필터 메소드는 압축을 최적화하는 데 사용할 수 있는 일련의 인코딩 방법을 표현합니다. PNG 사양은 현재 5개의 기본 필터 유형이 있는 적응 필터링 방법인 단일 필터 메소드(메소드 0)를 정의합니다. 필터링은 이미지 내에서 공간의 유사성을 이용하기 위한 수축 알고리즘을 사용할 수 있으므로 최적의 압축을 위해 매우 중요합니다. 그러므로, MIDP 장치는 필터 메소드 0으로 정의된 5개 필터 유형 모두를 지원해야 합니다.
• MIDP 장치는 교차 메소드 0(None) 또는 교차 메소드 1(Adam7)로 인코딩되는 PNG 이미지를 읽어야 합니다. MIDP에서의 이미지 로딩은 동기적이며 이미지 렌더링과 겹쳐질 수 없습니다. 따라서 응용 프로그램은 교차 메소드 1을 사용하는 장점이 없습니다. 이미 교차된 이미지를 사용하는 개발자들에게 편의를 제공하고 PNG와의 호환을 위해 교차된 이미지 디코딩을 지원해야 합니다.

PLTE 청크. 팔레트 기반 이미지가 지원되어야 합니다.

IDAT 청크. 이미지 데이터는 필터 메소드 0(None, Sub, Up, Average, Paeth)에 의해 정의된 5 필터 유형 중 하나를 사용하여 인코딩될 수 있습니다.

IEND 청크. 이미지가 유효한 것으로 간주되려면 이 청크가 있어야 합니다.

보조 청크

PNG는 PNG 이미지에 있을 수 있지만 이미지 디코딩에는 중요하지 않은 몇몇 '보조' 청크를 정의합니다.

tRNS 청크. 모든 구현은 tRNS 청크를 지원해야 합니다. 이 청크는 각 픽셀에 알파 채널 데이터를 제공하지 않고 투명도를 구현하는 데 사용됩니다. 색상 유형 0과 2의 경우 특정 회색이나 RGB 값이 투명 픽셀이 되도록 정의됩니다. 이런 경우에는 구현 시 이 값이 있는 픽셀을 완전 투명으로 처리해야 합니다. 픽셀 값 비교는 원본 샘플 깊이를 사용하여 실제 픽셀 값을 기준으로 해야 합니다. 즉, 픽셀 값이 장치의 디스플레이 기능을 반영하여 재배열되기 전에 이 비교를 수행해야 합니다. 색상 유형 3(색인 색상)의 경우, 색상 팔레트의 각 항목에 잠재적으로 8 비트 알파 값이 제공됩니다. 이런 경우에는 구현 시 알파 값이 0인 픽셀을 완전 투명으로 처리해야 하며 알파 값이 255인 픽셀을 완전 불투명으로 처리해야 합니다. 알파 블렌딩을 사용한 렌더링이 지원되면 중간 알파 값이 있는 모든 픽셀은 결과 이미지로 이동되어야 합니다. 알파 블렌딩이 지원되지 않으면 중간 알파 값이 있는 모든 픽셀은 완전 투명 픽셀로 교체되어야 합니다.

구현 시 다른 보조 청크를 지원하지 않을 수도(반드시 지원해야 하는 것은 아님) 있습니다. 지원되지 않는 보조 청크가 발생하면 모두 자동으로 무시해야 합니다. 현재 정의된 선택적 보조 청크는 다음과 같습니다.

    cHRM gAMA hIST iCCP iTXt pHYs
    sBIT sPLT sRGB tEXt tIME zTXt 

참조

PNG(Portable Network Graphics) Specification, Version 1.0. W3C Recommendation, October 1, 1996. http://www.w3.org/TR/REC-png.html(RFC 2083, http://www.ietf.org/rfc/rfc2083.txt로도 다운로드 가능).

Since:

MIDP 1.0

Method Summary

static Image	createImage(byte[] imageData, int imageOffset, int imageLength) 지정된 오프셋과 길이에 지정된 바이트 배열로 저장된 데이터에서 디코딩된 변경 불가능한 이미지를 작성합니다.
static Image	createImage(Image source) 소스 이미지에서 변경 불가능한 이미지를 작성합니다.
static Image	createImage(Image image, int x, int y, int width, int height, int transform) 지정된 대로 변환된 소스 이미지의 지정된 영역에서 픽셀 데이터를 사용하여 변경 불가능한 이미지를 작성합니다.
static Image	createImage(InputStream stream) InputStream에서 얻은 디코딩된 이미지 데이터에서 변경 불가능한 이미지를 작성합니다.
static Image	createImage(int width, int height) 오프스크린 그리기에 대한 새로운 변경 가능한 이미지를 작성합니다.
static Image	createImage(String name) 이름 지정된 자원에서 얻은 디코딩된 이미지 데이터에서 변경 불가능한 이미지를 작성합니다.
static Image	createRGBImage(int[] rgb, int width, int height, boolean processAlpha) 0xAARRGGBB로 지정된 ARGB 값 순서에서 변경 불가능한 이미지를 작성합니다.
Graphics	getGraphics() 이 이미지에 렌더링하는 새 Graphics 객체를 작성합니다.
int	getHeight() 이미지의 높이(단위: 픽셀)를 가져옵니다.
void	getRGB(int[] rgbData, int offset, int scanlength, int x, int y, int width, int height) 이 이미지의 지정된 영역에서 ARGB 픽셀 데이터를 얻어 이를 제공된 정수 배열에 저장합니다.
int	getWidth() 이미지의 너비(단위: 픽셀)를 가져옵니다.
boolean	isMutable() 이미지가 변경 가능한지 확인합니다.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createImage

public static Image createImage(int width,
                                int height)

오프스크린 그리기에 대한 새로운 변경 가능한 이미지를 작성합니다. 새로 작성된 이미지의 모든 픽셀은 흰색입니다. 이미지의 너비와 높이는 모두 0보다 커야 합니다.

Parameters:

width - 새 이미지의 너비(단위: 픽셀)

height - 새 이미지의 높이(단위: 픽셀)

Returns:

만든 이미지

Throws:

IllegalArgumentException - width 또는 height가 0 이하인 경우

createImage

public static Image createImage(Image source)

소스 이미지에서 변경 불가능한 이미지를 작성합니다. 소스 이미지가 변경 가능하면 변경 불가능한 사본이 작성되고 반환됩니다. 소스 이미지가 변경 불가능하면 새 이미지를 작성하지 않고 이를 반환할 수도 있습니다. 변경 불가능한 소스 이미지에 투명도 정보가 들어 있으면 이 정보는 변경되지 않고 새 이미지로 복사됩니다.

이 메소드는 변경 가능한 이미지의 내용을 Choice 객체에 배치하는 데 유용합니다. 응용 프로그램은 createImage(w, h) 메소드를 사용하여 오프스크린 이미지를 작성하고 getGraphics() 메소드로 얻은 Graphics 객체를 사용하여 그림을 그린 다음 이 메소드를 사용하여 이 이미지의 변경 불가능한 사본을 작성할 수 있습니다. 그러면 변경 불가능한 사본이 Choice 객체에 배치됩니다.

Parameters:

source - 복사할 소스 이미지

Returns:

변경 불가능한 새 이미지

Throws:

NullPointerException - source가 null인 경우

createImage

public static Image createImage(String name)
                         throws IOException

이름 지정된 자원에서 얻은 디코딩된 이미지 데이터에서 변경 불가능한 이미지를 작성합니다. 이름 매개 변수는 Class.getResourceAsStream(name)으로 정의된 자원 이름입니다. 자원 이름 해석 규칙은 응용 프로그램 자원 파일 섹션(java.lang 패키지 설명서에 있음)에 정의되어 있습니다.

Parameters:

name - 지원되는 이미지 형식 중 하나로 된 이미지 데이터가 들어 있는 자원 이름

Returns:

만든 이미지

Throws:

NullPointerException - name이 null인 경우

IOException - 자원이 존재하지 않거나, 데이터를 로드할 수 없거나, 이미지 데이터를 디코딩할 수 없는 경우

createImage

public static Image createImage(byte[] imageData,
                                int imageOffset,
                                int imageLength)

지정된 오프셋과 길이에 지정된 바이트 배열로 저장된 데이터에서 디코딩된 변경 불가능한 이미지를 작성합니다. 이 데이터는 구현 시 지원되는 자기 인식 이미지 파일 형식(예: PNG)이어야 합니다.

imageoffset 및 imagelength 매개 변수는 imageData 바이트 배열 내에서 데이터 범위를 지정합니다. imageOffset 매개 변수는 사용할 첫 번째 데이터 바이트의 배열에 대한 오프셋을 지정합니다. 그러므로 [0..(imageData.length-1)] 범위에 있어야 합니다. imageLength 매개 변수는 사용할 데이터 바이트의 수를 지정합니다. 수는 양수이어야 하며 범위가 배열의 끝을 초과하지 않도록 해야 합니다. 즉, imageOffset + imageLength < imageData.length가 참이어야 합니다.

이 메소드는 영구 저장소나 네트워크와 같은 다양한 소스에서 이미지를 로드할 때 사용됩니다.

Parameters:

imageData - 지원되는 이미지 형식으로 된 이미지 데이터 배열

imageOffset - 배열에 있는 데이터의 시작 오프셋

imageLength - 배열에 있는 데이터 길이

Returns:

만든 이미지

Throws:

ArrayIndexOutOfBoundsException - imageOffset 및 imageLength가 유효하지 않은 범위를 지정한 경우

NullPointerException - imageData가 null인 경우

IllegalArgumentException - imageData의 형식이 잘못되었거나 디코딩할 수 없는 경우

createImage

public static Image createImage(Image image,
                                int x,
                                int y,
                                int width,
                                int height,
                                int transform)

지정된 대로 변환된 소스 이미지의 지정된 영역에서 픽셀 데이터를 사용하여 변경 불가능한 이미지를 작성합니다.

소스 이미지는 변경 가능한 경우도 있고 변경 불가능한 경우도 있습니다. 변경 불가능한 소스 이미지의 경우, 투명도 정보가 있으면 변경되지 않고 새 이미지로 복사됩니다.

사전 변환된 이미지는 일부 장치에서 drawRegion을 사용하여 즉석에서 변환된 이미지보다 더 빠르게 렌더링할 수 있습니다. 그러나, 이러한 이미지를 작성하려면 추가 힙 공간이 필요하므로 이 기술은 렌더링 속도가 중요한 이미지에만 적용되어야 합니다.

사용된 변환 기능은 Sprite 클래스에 정의된 대로 다음 중 하나이어야 합니다.
Sprite.TRANS_NONE - 지정된 이미지 영역을 변경하지 않고 복사합니다.
Sprite.TRANS_ROT90 - 지정된 이미지 영역을 시계 방향으로 90도 회전합니다.
Sprite.TRANS_ROT180 - 지정된 이미지 영역을 시계 방향으로 180도 회전합니다.
Sprite.TRANS_ROT270 - 지정된 이미지 영역을 시계 방향으로 270도 회전합니다.
Sprite.TRANS_MIRROR - 지정된 이미지 영역을 수직 중심으로 반사시킵니다.
Sprite.TRANS_MIRROR_ROT90 - 지정된 이미지 영역을 수직 중심을 기준으로 대칭시킨 다음 시계 방향으로 90도 회전합니다.
Sprite.TRANS_MIRROR_ROT180 - 지정된 이미지 영역을 수직 중심으로 반사시킨 다음 시계 방향으로 180도 회전합니다.
Sprite.TRANS_MIRROR_ROT270 - 지정된 이미지 영역을 수직 중심으로 반사시킨 다음 시계 방향으로 270도 회전합니다.

반환된 이미지의 크기는 지정된 영역에 변환을 적용한 크기입니다. 예를 들어, 영역이 100 x 50 픽셀이고 변환이 TRANS_ROT90이면 반환된 이미지는 50 x 100 픽셀이 됩니다.

주: 다음 조건을 모두 충족하는 경우 이 메소드는 새 이미지를 작성하지 않고 소스 Image만을 반환합니다.

• 소스 이미지는 변경 불가능합니다.
• 영역은 전체 소스 이미지를 표현하고
• 변환은 TRANS_NONE입니다.

Parameters:

image - 복사할 소스 이미지

x - 복사할 영역의 수평 위치

y - 복사할 영역의 수직 위치

width - 복사할 영역의 너비

height - 복사할 영역의 높이

transform - 영역에 적용할 변환

Returns:

변경 불가능한 새 이미지

Throws:

NullPointerException - image가 null인 경우

IllegalArgumentException - 복사되는 영역이 소스 이미지의 범위를 넘는 경우

IllegalArgumentException - width 또는 height가 0 이하인 경우

IllegalArgumentException - transform이 유효하지 않은 경우

Since:

MIDP 2.0

createImage

public static Image createImage(InputStream stream)
                         throws IOException

InputStream에서 얻은 디코딩된 이미지 데이터에서 변경 불가능한 이미지를 작성합니다. 이 메소드는 모든 이미지 데이터를 읽고 디코딩할 때까지 차단됩니다. 이 메소드를 완료하면(반환 또는 예외 발생 여부에 상관없이) 스트림은 열린 상태로 남고 현재 위치는 정의되지 않습니다.

Parameters:

stream - 지원되는 이미지 형식 중 하나로 된 이미지 데이터가 들어 있는 자원 이름

Returns:

만든 이미지

Throws:

NullPointerException - stream이 null인 경우

IOException - 입출력 오류가 발생한 경우, 이미지 데이터를 로드할 수 없는 경우 또는 이미지 데이터를 디코딩할 수 없는 경우

Since:

MIDP 2.0

getGraphics

public Graphics getGraphics()

이 이미지에 렌더링하는 새 Graphics 객체를 작성합니다. 이 이미지는 변경 가능해야 하며 변경 불가능한 이미지에서는 이 메소드를 호출하면 안 됩니다. 이미지의 변경 가능 여부는 isMutable() 메소드로 테스트할 수 있습니다.

새로 작성된 Graphics 객체에는 다음과 같은 등록 정보가 있습니다.

• 대상은 이 Image 객체입니다.
• 클립 영역은 전체 Image를 포함합니다.
• 현재 색은 검정입니다.
• 글꼴은 Font.getDefaultFont()에서 반환된 글꼴과 같습니다.
• 스트로크 유형은 SOLID입니다.
• 좌표계의 원점은 이미지의 왼쪽 상단 모서리에 있습니다.

이 메소드를 사용하여 작성된 Graphics 객체의 수명은 무기한입니다. 이러한 객체는 스레드가 언제든지 사용할 수 있습니다.

Returns:

이 이미지가 대상인 Graphics 객체

Throws:

IllegalStateException - 이미지가 변경 불가능한 경우

getWidth

public int getWidth()

이미지의 너비(단위: 픽셀)를 가져옵니다. 반환된 값은 이미지 렌더링 시의 실제 너비를 반영해야 합니다.

Returns:

이미지 너비

getHeight

public int getHeight()

이미지의 높이(단위: 픽셀)를 가져옵니다. 반환된 값은 이미지 렌더링 시의 실제 높이를 반영해야 합니다.

Returns:

이미지 높이

isMutable

public boolean isMutable()

이미지가 변경 가능한지 확인합니다. 변경 가능한 이미지는 이 객체의 getGraphics() 메소드에서 얻은 Graphics 객체를 통해 렌더링하여 수정할 수 있습니다.

Returns:

이미지가 변경 가능한 경우 true, 그렇지 않은 경우 false

createRGBImage

public static Image createRGBImage(int[] rgb,
                                   int width,
                                   int height,
                                   boolean processAlpha)

0xAARRGGBB로 지정된 ARGB 값 순서에서 변경 불가능한 이미지를 작성합니다. rgb 배열 내의 ARGB 데이터는 한 행씩 위에서 아래로, 각 행의 왼쪽부터 오른쪽으로 수평으로 배열됩니다. processAlpha가 true이면 상위 바이트는 불투명도를 지정합니다. 즉, 0x00RRGGBB는 완전 투명 픽셀을 지정하고 0xFFRRGGBB는 완전 불투명 픽셀을 지정합니다. 중간 알파 값은 반투명을 지정합니다. 구현 시 이미지 렌더링 작업에서 알파 블렌딩을 지원하지 않으면 반투명 픽셀을 모두 완전 투명 픽셀로 교체해야 합니다. 자세한 사항은 알파 처리를 참조하십시오. processAlpha가 false이면 알파 값은 무시되고 모든 픽셀은 완전 불투명으로 처리되어야 합니다.

P(a,b)를 이미지의 a 열과 b 행에 있는 픽셀 값으로 간주합니다. 여기서 행과 열은 0부터 시작하여 위에서 아래로 번호가 매겨지고 열은 0부터 시작하여 왼쪽에서 오른쪽으로 번호가 매겨집니다. 이 작업은 다음과 같이 정의할 수 있습니다.

    P(a, b) = rgb[a + b * width];    

다음을 참조하십시오.

     0 <= a < width
     0 <= b < height    

Parameters:

rgb - 이미지를 구성하는 ARGB 값의 배열

width - 이미지 너비

height - 이미지 높이

processAlpha - rgb에 알파 채널이 있으면 true, 모든 픽셀이 완전 불투명이면 false

Returns:

만든 이미지

Throws:

NullPointerException - rgb가 null인 경우

IllegalArgumentException - width 또는 height가 0 이하인 경우

ArrayIndexOutOfBoundsException - rgb의 길이가 width * height보다 작은 경우

Since:

MIDP 2.0

getRGB

public void getRGB(int[] rgbData,
                   int offset,
                   int scanlength,
                   int x,
                   int y,
                   int width,
                   int height)

이 이미지의 지정된 영역에서 ARGB 픽셀 데이터를 얻어 이를 제공된 정수 배열에 저장합니다. 각 픽셀 값은 0xAARRGGBB 형식으로 저장됩니다. 여기서 상위 바이트에는 알파 채널이 들어 있고 나머지 바이트에는 각각 빨간색, 녹색 및 파란색의 색상 구성 요소가 들어 있습니다. 알파 채널은 픽셀의 불투명도를 지정합니다. 여기서 0x00 값은 완전 투명 픽셀을 표현하며 0xFF는 완전 불투명 픽셀을 표현합니다.

반환된 값은 createRGBImage 또는 PNG 이미지와 같은 원본 소스의 값과 반드시 일치하지는 않습니다. 색상 값은 장치의 디스플레이 기능을 반영하여 재배열될 수 있습니다(예를 들어, 빨간색, 녹색 및 파란색 픽셀은 회색조 장치에서는 모두 동일한 회색 값으로 표현될 수도 있습니다). 알파 블렌딩을 지원하지 않는 장치에서는 알파 값은 불투명 픽셀의 경우 0xFF이고 나머지 모든 픽셀의 경우 0x00입니다. 자세한 내용은 알파 처리를 참조하십시오. 알파 블렌딩을 지원하는 장치에서 알파 채널 값은 지원되는 반투명도 수준 수를 반영하여 재배열될 수 있습니다.

scanlength는 연속하는 행에 대응하는 픽셀 사이의 배열에 상대 오프셋을 지정합니다. 저장된 픽셀 행이 겹치지 않게 하려면 scanlength의 절대값이 width 이상이어야 합니다. scanlength는 음수 값도 허용합니다. 이 값은 항상 rgbData 배열의 범위 내에 있는 모든 참조가 되어야 합니다.

P(a,b)를 이미지의 a 열과 b 행에 있는 픽셀 값으로 간주합니다. 여기서 행과 열은 0부터 시작하여 위에서 아래로 번호가 매겨지고 열은 0부터 시작하여 왼쪽에서 오른쪽으로 번호가 매겨집니다. 이 작업은 다음과 같이 정의할 수 있습니다.

    rgbData[offset + (a - x) + (b - y) * scanlength] = P(a, b);

다음을 참조하십시오.

     x <= a < x + width
     y <= b < y + height    

소스 직사각형은 이미지의 범위를 초과하면 안 됩니다. 즉, 다음과 같습니다.

   x >= 0
   y >= 0
   x + width <= image width
   y + height <= image height    

이러한 조건 중 하나라도 충족하지 않으면 IllegalArgumentException이 발생합니다. 그렇지 않으면, width <= 0 또는 height <= 0인 경우 예외가 발생하지 않으며 픽셀 데이터가 rgbData에 복사되지 않습니다.

Parameters:

rgbData - ARGB 픽셀 데이터가 저장된 정수 배열

offset - 첫 번째 ARGB 값이 저장된 배열의 색인

scanlength - 영역에서 연속하는 행에 대응하는 픽셀 사이의 배열에서 상대 오프셋

x - 영역의 왼쪽 상단 모서리의 x 좌표

y - 영역의 왼쪽 상단 모서리의 y 좌표

width - 영역의 너비

height - 영역의 높이

Throws:

ArrayIndexOutOfBoundsException - 요청된 작업이 음수이거나 배열 길이를 초과하는 색인을 가진 rgbData 배열의 요소에 접근하려고 시도하는 경우(배열의 내용은 변경되지 않음)

IllegalArgumentException - 검색 중인 영역이 소스 이미지의 범위를 초과하는 경우

IllegalArgumentException - scanlength의 절대값이 width 미만인 경우

NullPointerException - rgbData가 null인 경우

Since:

MIDP 2.0