Graphics (MID 프로필)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

MID 프로필

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.microedition.lcdui
Class Graphics

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

public class Graphics
extends Object

단순한 2D 기하 렌더링 기능을 제공합니다.

텍스트, 이미지, 선, 직사각형 및 호에 대해 그리기 프리미티브가 제공됩니다. 또한 단색으로 직사각형과 호를 채울 수 있습니다. 직사각형에 둥근 모서리를 지정할 수도 있습니다.

색의 빨간색, 녹색, 파란색 구성 요소 각각에 대해 8비트씩 24비트 색상 모델이 제공됩니다. 모든 장치가 전체 24비트 색상을 지원하는 것은 아니므로 응용 프로그램에서 요청하는 색을 장치에서 사용 가능한 색으로 매핑합니다. 사용 가능한 색은 무엇인지, 사용 가능한 회색 수준은 몇 개나 되는지 등 장치 특성을 알 수 있는 기능이 Display 클래스에 제공됩니다. 응용 프로그램은 요청한 색에 대해 디스플레이할 실제 색을 얻기 위해 getDisplayColor()를 사용할 수 있습니다. 이로 인해 응용 프로그램은 장치 독립성을 침해하지 않으면서도 장치에 동작을 순응시킬 수 있습니다.

모든 렌더링 작업의 경우 소스 대 대상 규칙 [Porter-Duff]를 사용하여 소스 픽셀은 항상 대상 픽셀과 결합됩니다. 소스 픽셀과 래스터 ops 같은 대상 픽셀을 결합하기 위한 다른 방법은 제공되지 않습니다.

텍스트, 선, 직사각형, 호 그리기 및 채우기 프리미티브의 경우 소스 픽셀은 렌더링에 사용되는 그래픽 객체의 현재 색을 나타내는 픽셀입니다. 이 픽셀은 항상 완전 불투명으로 간주됩니다. 항상 완전 불투명인 소스 픽셀을 사용하면 소스 대 대상 규칙은 픽셀을 바꾸는 효과를 가지므로 대상 픽셀은 단순히 그래픽 객체의 소스 픽셀로 바뀝니다.

drawImage() 및 drawRegion() 메소드는 그래픽 객체의 현재 색 대신 작업을 렌더링하는 데 필요한 소스로 이미지를 사용합니다. 이 상황에서 소스 대 대상 규칙의 등록 정보는 다음과 같습니다. 소스의 완전 불투명 픽셀은 대상 픽셀로 바꿔야 하고 소스의 투명 픽셀은 대상 픽셀을 변경되지 않은 상태로 두어야 하며 소스의 반투명 픽셀은 대상 픽셀과 알파 블렌딩되어야 합니다. 반투명 픽셀을 알파 블렌딩해야 합니다. 구현 시 알파 블렌딩을 지원하지 않는 경우 이미지를 만들 때 이미지 소스 데이터에서 반투명도를 모두 제거해야 합니다. 자세한 내용은 알파 처리를 참조하십시오.

모든 그래픽 렌더링의 대상은 전체가 완전 불투명 픽셀로 구성되는 것으로 간주됩니다. 소스 대 대상 규칙의 특성은 완전 불투명 대상 픽셀을 갖는 픽셀을 합성하면 그 결과 완전 불투명 대상 픽셀이 반드시 생긴다는 것입니다. 이는 전체 및 부분 투명성을 렌더링 작업의 소스로만 사용될 수 있는 변경할 수 없는 이미지로 한정하는 효과가 있습니다.

그래픽은 디스플레이나 오프스크린 이미지 버퍼로 직접 렌더링될 수 있습니다. 렌더링된 그래픽의 대상은 그래픽 객체의 출처에 따라 달라집니다. 디스플레이에 렌더링할 그래픽 객체는 Canvas 객체의 paint() 메소드에 전달됩니다. 이는 대상이 디스플레이인 그래픽 객체를 얻을 수 있는 유일한 방법입니다. 또한 응용 프로그램은 paint() 메소드가 지속되는 동안만 이 그래픽 객체를 사용하여 그릴 수 있습니다.

오프스크린 이미지 버퍼를 렌더링할 그래픽 객체는 원하는 이미지에서 getGraphics() 메소드를 호출하여 얻을 수 있습니다. 이렇게 얻은 그래픽 객체는 응용 프로그램에 의해 무기한 보류되며 이 그래픽 객체에 대해 언제든지 요청을 실행할 수 있습니다.

기본 좌표계의 원점은 대상의 왼쪽 위 모서리에 있습니다. X축 방향은 오른쪽으로 양수이며 Y축 방향은 아래쪽으로 양수입니다. 응용 프로그램은 좌표계의 수평 및 수직 거리가 실제 장치 디스플레이에서 같은 거리를 나타낸다고 가정합니다. 즉, 픽셀은 정사각형입니다. 좌표계 원점을 변환하기 위한 기능이 제공됩니다. 모든 좌표는 정수로 지정됩니다.

좌표계는 픽셀 자체가 아닌 픽셀 사이의 위치를 나타냅니다. 그러므로 디스플레이의 왼쪽 위 모서리에 있는 첫 번째 픽셀은 좌표 (0,0), (1,0), (0,1), (1,1) 범위의 정사각형에 놓입니다.

이러한 정의 하에 채우기 작업의 의미는 명확합니다. 좌표 격자 선은 픽셀 사이에 놓이므로 채우기 작업은 전체적으로 작업 좌표계에 의해 범위 설정된 영역 내에 놓인 픽셀에 영향을 줍니다. 예를 들어, 다음 작업은


    g.fillRect(0, 0, 3, 2)

정확히 6개의 픽셀을 그립니다. 위의 예와 다음에 나오는 모든 예에서 변수 g가 Graphics 객체에 대한 참조를 포함한다고 가정합니다.

글꼴의 각 문자에는 문자의 모양을 형성하는 일련의 픽셀 집합이 포함됩니다. 문자를 그릴 때 문자의 모양을 형성하는 픽셀은 Graphics 객체의 현재 색으로 채워지며 문자 모양의 일부가 아닌 픽셀은 변경되지 않습니다. 텍스트 그리기 호출 drawChar(), drawChars(), drawString() 및 drawSubstring()은 텍스트를 모두 이 방식으로 그립니다.

setStrokeStyle() 메소드에서 설정한 대로 선, 호, 직사각형 및 둥근 직사각형은 SOLID나 DOTTED 입력 스타일 중 하나로 그릴 수 있습니다. 입력 스타일은 채우기, 텍스트 및 이미지 작업에는 영향을 미치지 않습니다.

SOLID 입력 스타일의 경우 그리기 작업은 바로 아래의 픽셀을 지정한 좌표의 오른쪽까지 채우는 픽셀 하나 너비의 펜으로 수행됩니다. 그려진 선은 선의 양쪽 끝점에 있는 픽셀까지 사용합니다. 따라서 다음 작업으로


    g.drawLine(0, 0, 0, 0);

정확히 한 픽셀, 디스플레이의 왼쪽 위 모서리에 있는 첫 번째 픽셀을 그립니다.

DOTTED 입력 스타일의 그리기 작업은 SOLID 입력 스타일에서 사용한 픽셀의 일부를 사용합니다. 점의 빈도와 길이는 구현별로 다릅니다. 선과 호의 끝점이 그려지지 않거나 직사각형의 모서리 점이 그려지지 않을 수도 있습니다. 현재 색을 사용하여 점을 칠하고 점 사이의 공간은 그대로 둡니다.

좌표계의 아티팩트는 채우기 작업에 의해 영향을 받는 영역이 같은 좌표에서 그리기 작업에 의해 영향을 받는 영역과 약간 다른 것입니다. 예를 들어 다음 작업을 참조하십시오.


    g.fillRect(x, y, w, h); // 1
    g.drawRect(x, y, w, h); // 2

명령문 (1)은 w 픽셀 너비와 h 픽셀 높이인 직사각형을 채웁니다. 명령문 (2)는 왼쪽과 위쪽 모서리가 명령문 (1)에서 채운 영역 내에 있는 직사각형을 그립니다. 하지만 아래쪽과 오른쪽 모서리는 채워진 영역 밖의 한 픽셀에 놓입니다. 이는 반직관적이지만 위의 명령문 (2)와 동일한 효과를 갖는


    g.drawLine(x, y, x+w, y);
    g.drawLine(x+w, y, x+w, y+h);
    g.drawLine(x+w, y+h, x, y+h);
    g.drawLine(x, y+h, x, y);

불변형을 보존합니다.

drawLine()과 drawArc()에 의해 그려지는 정확한 픽셀은 지정되어 있지 않습니다. 채우기 작업에서 사용하는 픽셀은 해당 그리기 작업에서 사용하는 픽셀에 바로 인접해 있거나 정확하게 겹쳐야 합니다. 채우기 작업 시에는 채우기 영역과 해당 그리기 작업으로 다루는 픽셀 사이에 간격을 두지 말아야 하며 해당 그리기 작업에 의해 범위가 설정된 영역 밖에 있는 픽셀을 사용하면 안 됩니다.

자르기

클립은 그래픽 렌더링 작업으로 수정할 수 있는 Graphics 객체의 대상 픽셀 집합입니다.

Graphics 객체마다 한 개의 클립이 있습니다. 그래픽 작업으로는 픽셀은 클립 내에 놓인 픽셀만 수정할 수 있습니다. 해당 클립의 범위를 벗어난 픽셀은 그래픽 작업으로 수정되지 않습니다.

현재 클립을 지정된 직사각형과 교차시키고 명확하게 설정하기 위한 작업이 제공됩니다. 응용 프로그램은 현재 좌표계에 상대적인 좌표를 사용하는 클립 직사각형을 제공하여 클립을 지정할 수 있습니다.

너비나 높이가 0이나 음수인 클립 직사각형을 지정하는 것은 유효합니다. 이 경우 클립은 비어 있는 것으로 간주됩니다. 즉, 클립에 포함된 픽셀이 없습니다. 따라서 이러한 클립에서 그래픽 작업이 실행된 경우 어떤 픽셀도 수정되지 않습니다.

대상의 범위를 벗어나 확장하거나 전체적으로 해당 범위 밖에 있는 클립 직사각형을 지정하는 것은 유효합니다. 대상의 범위 밖에 있는 픽셀은 없으며 대상의 범위 밖에 있는 클립 직사각형의 영역은 무시됩니다. 대상과 지정된 클립 직사각형 모두에 놓이는 픽셀만 클립의 일부로 간주됩니다.

translate() 같은 좌표계 작업은 클립을 수정하지 않습니다. Graphics 객체 좌표계를 변경하지 않고 setClip에 전달하는 경우 getClipX(), getClipY(), getClipWidth() 및 getClipHeight() 메소드는 클립에서 동일한 픽셀 집합을 만드는 직사각형을 반환해야 합니다. getClip 메소드 계열에서 반환된 직사각형은 setClip()에서 요청된 클립 직사각형과 다를 수 있습니다. 이러한 내용은 좌표계가 변경되었거나 구현 시 클립 직사각형이 Graphics 객체의 대상 경계와 교차하도록 선택한 경우 발생할 수 있습니다.

그래픽 작업이 클립의 영향을 받은 경우 해당 작업으로 다룬 픽셀은 클립이 작업에 영향을 미치지 않은 것처럼 다뤄지는 픽셀과 같아야 합니다. 예를 들어, 직사각형 (cx, cy, cw, ch)에 의해 표현되는 클립과 이 직사각형 밖에 있는 점 (x1, y1), 그리고 이 직사각형 내에 있는 점 (x2, y2)를 가정합니다. 다음 코드 조각에서


    g.setClip(0, 0, canvas.getWidth(),
                    canvas.getHeight());
    g.drawLine(x1, y1, x2, y2); // 3
    g.setClip(cx, cy, cw, ch);
    g.drawLine(x1, y1, x2, y2); // 4

명령문 (4)의 터치를 받는 픽셀은 명령문 (3)의 터치를 받는 (cx, cy, cw, ch) 내의 픽셀과 동일해야 합니다.

앵커 포인트

텍스트의 그리기는 "앵커 포인트"를 기반으로 합니다. 앵커 포인트는 텍스트를 놓을 때 필요한 계산량을 최소화하기 위해 사용됩니다. 예를 들어, 텍스트 일부를 가운데 맞추기 위해 응용 프로그램은 stringWidth()나 charWidth()를 호출하여 너비를 구한 다음 빼기와 나누기의 조합을 수행하여 적절한 위치를 계산해야 합니다. 텍스트를 그리기 위한 메소드는 다음과 같이 정의되어 있습니다.


 public void drawString(String text, int x, int y, int anchor);

이 메소드는 앵커 포인트가 (x,y)에 있는 현재 글꼴을 사용하여 텍스트를 현재 색으로 그립니다. 앵커 포인트의 정의는 비트 OR 연산자를 사용하여 수직 상수 (LEFT, HCENTER, RIGHT) 중 하나와 결합된 수평 상수 (TOP, BASELINE, BOTTOM) 중 하나가 되어야 합니다. 0은 앵커 포인트의 값으로 사용될 수도 있습니다. 앵커 포인트 값에 0을 사용하면 TOP | LEFT를 사용하는 것과 같은 결과가 됩니다.

텍스트의 수직 가운데 맞춤은 지정하기 어렵고 구현하기 번거로워 유용하지 않으므로 지정하지 않습니다. 따라서 VCENTER 값은 텍스트 그리기 호출의 앵커 포인트 매개 변수에서 허용되지 않습니다.

(x, y) 위치에 비례하는 텍스트 경계 상자의 실제 위치는 앵커 포인트에 의해 결정됩니다. 이러한 앵커 포인트는 경계 상자의 외곽 모서리를 따라 이름이 지정된 위치에서 발생합니다. 따라서 f가 g의 현재 글꼴(g.getFont()에서 반환)인 경우 다음 호출은 모두 동일한 결과를 반환합니다.


    g.drawString(str, x, y, TOP|LEFT);
    g.drawString(str, x + f.stringWidth(str)/2, y, TOP|HCENTER);
    g.drawString(str, x + f.stringWidth(str), y, TOP|RIGHT);

    g.drawString(str, x,
        y + f.getBaselinePosition(), BASELINE|LEFT);
    g.drawString(str, x + f.stringWidth(str)/2,
        y + f.getBaselinePosition(), BASELINE|HCENTER);
    g.drawString(str, x + f.stringWidth(str),
        y + f.getBaselinePosition(), BASELINE|RIGHT);

    drawString(str, x,
        y + f.getHeight(), BOTTOM|LEFT);
    drawString(str, x + f.stringWidth(str)/2,
        y + f.getHeight(), BOTTOM|HCENTER);
    drawString(str, x + f.stringWidth(str),
        y + f.getHeight(), BOTTOM|RIGHT);

텍스트 그리기의 경우 글꼴 설계자가 지정한 문자간 간격 및 줄간 간격(선행)은 Font 클래스의 stringWidth()와 getHeight() 호출에서 반환한 값의 일부로 포함됩니다. 예를 들어, 다음 코드의 경우


    // (5)
    g.drawString(string1+string2, x, y, TOP|LEFT);

    // (6)
    g.drawString(string1, x, y, TOP|LEFT);
    g.drawString(string2, x + f.stringWidth(string1), y, TOP|LEFT);

코드 조각 (5)와 (6)은 같지는 않더라도 유사한 방식으로 작동합니다. 이러한 내용은 f.stringWidth()에 문자간 간격이 포함되기 때문에 발생합니다. 시스템에서 글꼴 돌출을 지원하는 경우 정확한 간격은 이러한 호출에 따라 다를 수 있습니다.

마찬가지로 다음 줄의 Y 위치에 글꼴 높이만 추가하면 합리적으로 수직 간격이 정해질 수 있습니다. 예를 들면 다음과 같습니다.


    g.drawString(string1, x, y, TOP|LEFT);
    g.drawString(string2, x, y + f.fontHeight(), TOP|LEFT);

적절한 줄간 간격으로 별도의 줄에서 string1과 string2를 그립니다.

그려지는 문자열의 stringWidth()와 글꼴의 fontHeight()는 텍스트 일부의 경계 상자 크기를 정의합니다. 위에서 설명한 대로 이 상자에는 줄간 간격 및 문자간 간격이 포함됩니다. 구현 시 그려진 문자에 실제로 속하도록 픽셀의 아래와 오른쪽에 이 공간을 두어야 합니다. 그래픽을 텍스트 가까이 배치하려는 응용 프로그램은 문자열의 아래쪽과 오른쪽에 공간이 있고 문자열의 위쪽과 왼쪽에는 공간이 없다고 가정합니다.

또한 이미지 배치를 위해 앵커 포인트가 사용됩니다. 텍스트 그리기와 마찬가지로 이미지의 앵커 포인트는 그래픽 요청에서 주어진 (x,y) 위치에 배치될 대상의 경계 직사각형에서 점을 지정합니다. 텍스트와 달리 이미지의 수직 가운데 맞춤은 잘 정의되어 있으므로 VCENTER 값은 이미지 그리기 요청의 앵커 포인트 매개 변수 내에서 사용될 수 있습니다. 이미지에는 기준선의 의미가 없으므로 BASELINE 값은 이미지 그리기 요청의 앵커 포인트 매개 변수 내에서 사용되지 않을 수 있습니다.

참조

Porter-Duff: Porter, T., T. Duff 공저. "Compositing Digital Images." Computer Graphics V18 N3 (SIGGRAPH 1984), p. 253-259.

Since:: MIDP 1.0

Field Summary

static int BASELINE
          텍스트의 기준선에 앵커 포인트를 배치하기 위한 상수.

static int BOTTOM
          텍스트나 이미지의 아래에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.

static int DOTTED
          DOTTED 입력 스타일의 상수.

static int HCENTER
          앵커 포인트 주위로 텍스트와 이미지를 가로로 가운데 맞추기 위한 상수.

static int LEFT
          텍스트나 이미지의 왼쪽에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.

static int RIGHT
          텍스트나 이미지의 오른쪽에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.

static int SOLID
          SOLID 입력 스타일에 대한 상수.

static int TOP
          텍스트나 이미지 위에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.

static int VCENTER
          앵커 포인트 주위에 이미지를 세로로 가운데 맞추기 위한 상수.

Method Summary

void clipRect(int x, int y, int width, int height)
          현재 클립을 지정한 직사각형과 교차 시킵니다.

void copyArea(int x_src, int y_src, int width, int height, int x_dest, int y_dest, int anchor)
          직사각형 영역 (x_src, y_src, width, height)의 내용을 앵커에 의해 식별된 앵커 포인트가 (x_dest, y_dest)에 있는 대상 영역으로 복사합니다.

void drawArc(int x, int y, int width, int height, int startAngle, int arcAngle)
          지정한 직사각형을 덮는 원형 호나 타원형 호의 윤곽을 현재 색과 입력 스타일을 사용하여 그립니다.

void drawChar(char character, int x, int y, int anchor)
          지정한 문자를 현재 글꼴과 색을 사용하여 그립니다.

void drawChars(char[] data, int offset, int length, int x, int y, int anchor)
          지정한 문자를 현재 글꼴과 색을 사용하여 그립니다.

void drawImage(Image img, int x, int y, int anchor)
          지정한 이미지를 앵커 포인트를 사용하여 그립니다.

void drawLine(int x1, int y1, int x2, int y2)
          현재 색과 입력 스타일을 사용하여 (x1,y1)과 (x2,y2) 좌표 사이에서 선을 그립니다.

void drawRect(int x, int y, int width, int height)
          지정한 직사각형의 윤곽을 현재 색과 입력 스타일을 사용하여 그립니다.

void drawRegion(Image src, int x_src, int y_src, int width, int height, int transform, int x_dest, int y_dest, int anchor)
          지정한 소스 이미지의 영역을, 선택한 변환 함수를 사용하여 이미지 데이터를 변환(회전 및 반사)하여 대상 내의 위치로 복사합니다.

void drawRGB(int[] rgbData, int offset, int scanlength, int x, int y, int width, int height, boolean processAlpha)
          지정한 영역에서 일련의 장치 독립 RGB+투명도 값을 렌더링합니다.

void drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)
          지정한 둥근 모서리 직사각형의 윤곽을 현재 색과 입력 스타일을 사용하여 그립니다.

void drawString(String str, int x, int y, int anchor)
          지정한 String을 현재 글꼴과 색을 사용하여 그립니다.

void drawSubstring(String str, int offset, int len, int x, int y, int anchor)
          지정한 String을 현재 글꼴과 색을 사용하여 그립니다.

void fillArc(int x, int y, int width, int height, int startAngle, int arcAngle)
          지정한 직사각형을 덮는 원형 호나 타원형 호를 채웁니다.

void fillRect(int x, int y, int width, int height)
          지정한 직사각형을 현재 색으로 채웁니다.

void fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)
          현재 색으로 지정된 둥근 모서리의 직사각형을 채웁니다.

void fillTriangle(int x1, int y1, int x2, int y2, int x3, int y3)
          현재 색으로 지정한 삼각형을 채웁니다 각 지점 쌍을 연결하는 선이 채워진 삼각형에 포함됩니다.

int getBlueComponent()
          현재 색의 파랑 구성 요소를 가져옵니다.

int getClipHeight()
          현재 클립 영역의 높이를 가져옵니다.

int getClipWidth()
          현재 클립 영역의 너비를 가져옵니다.

int getClipX()
          이 그래픽 컨텍스트의 좌표계 원점과 비례하여 현재 클립 영역의 X 오프셋을 가져옵니다.

int getClipY()
          이 그래픽 컨텍스트의 좌표계 원점과 비례하여 현재 클립 영역의 Y 오프셋을 가져옵니다.

int getColor()
          현재 색을 가져옵니다.

int getDisplayColor(int color)
          지정한 색을 요청하면 표시될 색을 가져옵니다.

Font getFont()
          현재 글꼴을 가져옵니다.

int getGrayScale()
          렌더링 작업에 사용된 색의 현재 회색조 값을 가져옵니다.

int getGreenComponent()
          현재 색의 녹색 구성 요소를 가져옵니다.

int getRedComponent()
          현재 색의 빨강 구성 요소를 가져옵니다.

int getStrokeStyle()
          그리기 작업에 사용된 입력 스타일을 가져옵니다.

int getTranslateX()
          이 그래픽 컨텍스트의 변환된 원점의 X 좌표를 가져옵니다.

int getTranslateY()
          이 그래픽 컨텍스트의 변환된 원점의 Y 좌표를 가져옵니다.

void setClip(int x, int y, int width, int height)
          현재 클립을 주어진 좌표에 의해 지정된 직사각형으로 설정합니다.

void setColor(int RGB)
          현재 색을 지정한 RGB 값으로 설정합니다.

void setColor(int red, int green, int blue)
          현재 색을 지정한 RGB 값으로 설정합니다.

void setFont(Font font)
          모든 후속 텍스트 렌더링 작업의 글꼴을 설정합니다.

void setGrayScale(int value)
          모든 후속 렌더링 작업에서 사용되는 현재 회색조를 설정합니다.

void setStrokeStyle(int style)
          선, 호, 직사각형 및 둥근 직사각형을 그리는 데 사용된 입력 스타일을 설정합니다.

void translate(int x, int y)
          그래픽 컨텍스트의 원점을 현재 좌표계의 점 (x, y)로 변환됩니다.

Methods inherited from class java.lang.Object

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

Field Detail

HCENTER

public static final int HCENTER

앵커 포인트 주위로 텍스트와 이미지를 가로로 가운데 맞추기 위한 상수.

HCENTER에 1의 값이 할당됩니다.

See Also:: Constant Field Values

VCENTER

public static final int VCENTER

앵커 포인트 주위에 이미지를 세로로 가운데 맞추기 위한 상수.

VCENTER에 2의 값이 할당됩니다.

See Also:: Constant Field Values

LEFT

public static final int LEFT

텍스트나 이미지의 왼쪽에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.

LEFT에 4의 값이 할당됩니다.

See Also:: Constant Field Values

RIGHT

public static final int RIGHT

텍스트나 이미지의 오른쪽에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.

RIGHT에 8의 값이 할당됩니다.

See Also:: Constant Field Values

TOP

public static final int TOP

텍스트나 이미지 위에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.

TOP에 16의 값이 할당됩니다.

See Also:: Constant Field Values

BOTTOM

public static final int BOTTOM

텍스트나 이미지의 아래에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.

BOTTOM에 32의 값이 할당됩니다.

See Also:: Constant Field Values

BASELINE

public static final int BASELINE

텍스트의 기준선에 앵커 포인트를 배치하기 위한 상수.

BASELINE에 64의 값이 할당됩니다.

See Also:: Constant Field Values

SOLID

public static final int SOLID

SOLID 입력 스타일에 대한 상수.

SOLID에 0의 값이 할당됩니다.

See Also:: Constant Field Values

DOTTED

public static final int DOTTED

DOTTED 입력 스타일의 상수.

DOTTED에 1의 값이 할당됩니다.

See Also:: Constant Field Values

Method Detail

translate

public void translate(int x,
                      int y)

그래픽 컨텍스트의 원점을 현재 좌표계의 점 (x, y)로 변환됩니다. 이 그래픽 컨텍스트의 후속 렌더링 작업에서 사용되는 모든 좌표는 이 새 원점에 비례합니다.

translate()에 대한 호출의 효과는 누적됩니다. 예를 들어 translate(1, 2)를 호출한 다음 translate(3, 4)를 호출하면 (4, 6)의 변환도 발생합니다.

응용 프로그램은 다음 기술을 사용하여 절대 원점 (ax, ay)을 설정할 수 있습니다.

g.translate(ax - g.getTranslateX(), ay - g.getTranslateY())

Parameters:: x - 새 변환 원점의 x 좌표; y - 새 변환 원점의 y 좌표
See Also:: getTranslateX(), getTranslateY()

getTranslateX

public int getTranslateX()

이 그래픽 컨텍스트의 변환된 원점의 X 좌표를 가져옵니다.

Returns:: 현재 원점의 X

getTranslateY

public int getTranslateY()

이 그래픽 컨텍스트의 변환된 원점의 Y 좌표를 가져옵니다.

Returns:: 현재 원점의 Y

getColor

public int getColor()

현재 색을 가져옵니다.

Returns:: 0x00RRGGBB 형식의 정수
See Also:: setColor(int, int, int)

getRedComponent

public int getRedComponent()

현재 색의 빨강 구성 요소를 가져옵니다.

Returns:: 0-255 범위의 정수 값
See Also:: setColor(int, int, int)

getGreenComponent

public int getGreenComponent()

현재 색의 녹색 구성 요소를 가져옵니다.

Returns:: 0-255 범위의 정수 값
See Also:: setColor(int, int, int)

getBlueComponent

public int getBlueComponent()

현재 색의 파랑 구성 요소를 가져옵니다.

Returns:: 0-255 범위의 정수 값
See Also:: setColor(int, int, int)

getGrayScale

public int getGrayScale()

렌더링 작업에 사용된 색의 현재 회색조 값을 가져옵니다. setGrayScale()에 의해 색이 설정된 경우 해당 값만 반환됩니다. 빨강, 녹색, 파랑 구성 요소의 설정을 허용하는 메소드 중 하나로 색을 설정한 경우 반환되는 값은 해당 색의 밝기에 가장 근접하는 RGB 색상 구성 요소(장치별 유형에서)에서 계산됩니다.

Returns:: 0-255 범위의 정수 값
See Also:: setGrayScale(int)

setColor

public void setColor(int red,
                     int green,
                     int blue)

현재 색을 지정한 RGB 값으로 설정합니다. 모든 후속 렌더링 작업은 이 지정 색을 사용합니다.

Parameters:: red - 0-255 범위에 설정된 색의 빨강 구성 요소; green - 0-255 범위에 설정된 색의 녹색 구성 요소; blue - 0-255 범위에 설정된 색의 파랑 구성 요소
Throws:: IllegalArgumentException - 색 구성 요소 중 하나가 0-255 범위를 벗어난 경우
See Also:: getColor()

setColor

public void setColor(int RGB)

현재 색을 지정한 RGB 값으로 설정합니다. 모든 후속 렌더링 작업은 이 지정 색을 사용합니다. 전달된 RGB 값은 파랑 구성 요소를 제공하는 가장 중요하지 않은 8비트, 녹색 구성 요소를 제공하는 다음으로 중요한 8비트, 빨강 구성 요소를 제공하는 다음으로 더 중요한 8비트로 해석됩니다. 즉, 색 구성 요소는 0x00RRGGBB 형식으로 지정됩니다. 이 값의 상위 바이트는 무시됩니다.

Parameters:: RGB - 설정된 색
See Also:: getColor()

setGrayScale

public void setGrayScale(int value)

모든 후속 렌더링 작업에서 사용되는 현재 회색조를 설정합니다. 흑백 디스플레이의 경우 동작은 명백합니다. 컬러 디스플레이의 경우 모든 후속 그리기 작업이 전달된 값에 해당하는 회색이 되도록 색을 설정합니다. 값은 0-255 범위에 있어야 합니다.

Parameters:: value - 원하는 회색조 값
Throws:: IllegalArgumentException - 회색이 범위를 벗어나는 경우
See Also:: getGrayScale()

getFont

public Font getFont()

현재 글꼴을 가져옵니다.

Returns:: 현재 글꼴
See Also:: Font, setFont(javax.microedition.lcdui.Font)

setStrokeStyle

public void setStrokeStyle(int style)

선, 호, 직사각형 및 둥근 직사각형을 그리는 데 사용된 입력 스타일을 설정합니다. 채우기, 텍스트 및 이미지 작업에는 영향을 미치지 않습니다.

Parameters:: style - SOLID나 DOTTED가 될 수 있습니다.
Throws:: IllegalArgumentException - style이 유효하지 않은 경우
See Also:: getStrokeStyle()

getStrokeStyle

public int getStrokeStyle()

그리기 작업에 사용된 입력 스타일을 가져옵니다.

Returns:: 입력 스타일, SOLID 또는 DOTTED
See Also:: setStrokeStyle(int)

setFont

public void setFont(Font font)

모든 후속 텍스트 렌더링 작업의 글꼴을 설정합니다. 글꼴이 null인 경우 setFont(Font.getDefaultFont())와 동일합니다.

Parameters:: font - 지정된 글꼴
See Also:: Font, getFont(), drawString(java.lang.String, int, int, int), drawChars(char[], int, int, int, int, int)

getClipX

public int getClipX()

이 그래픽 컨텍스트의 좌표계 원점과 비례하여 현재 클립 영역의 X 오프셋을 가져옵니다. getClip 작업을 정수를 반환하는 두 가지 메소드로 분리하면 한 객체를 반환하는 한 번의 getClip() 호출보다 성능도 향상되고 메모리도 효율적입니다.

Returns:: 현재 클립 영역의 X 오프셋
See Also:: clipRect(int, int, int, int), setClip(int, int, int, int)

getClipY

public int getClipY()

이 그래픽 컨텍스트의 좌표계 원점과 비례하여 현재 클립 영역의 Y 오프셋을 가져옵니다. getClip 작업을 정수를 반환하는 두 가지 메소드로 분리하면 한 객체를 반환하는 한 번의 getClip() 호출보다 성능도 향상되고 메모리도 효율적입니다.

Returns:: 현재 클립 영역의 Y 오프셋
See Also:: clipRect(int, int, int, int), setClip(int, int, int, int)

getClipWidth

public int getClipWidth()

현재 클립 영역의 너비를 가져옵니다.

Returns:: 현재 클립 영역의 너비
See Also:: clipRect(int, int, int, int), setClip(int, int, int, int)

getClipHeight

public int getClipHeight()

현재 클립 영역의 높이를 가져옵니다.

Returns:: 현재 클립 영역의 높이
See Also:: clipRect(int, int, int, int), setClip(int, int, int, int)

clipRect

public void clipRect(int x,
                     int y,
                     int width,
                     int height)

현재 클립을 지정한 직사각형과 교차 시킵니다. 결과 클립 영역은 현재 클립 영역과 지정한 직사각형이 교차된 것입니다. 현재 클립을 더 작게 만들기 위해서만 이 메소드를 사용할 수 있습니다. 현재 클립을 더 크게 설정하려면 setClip 메소드를 사용합니다. 클립 영역을 벗어나면 렌더링 작업이 아무 효과가 없습니다.

Parameters:: x - 클립과 교차할 직사각형의 x 좌표; y - 클립과 교차할 직사각형의 y 좌표; width - 클립과 교차할 직사각형의 너비; height - 클립과 교차할 직사각형의 높이
See Also:: setClip(int, int, int, int)

setClip

public void setClip(int x,
                    int y,
                    int width,
                    int height)

현재 클립을 주어진 좌표에 의해 지정된 직사각형으로 설정합니다. 클립 영역을 벗어나면 렌더링 작업이 아무 효과가 없습니다.

Parameters:: x - 새 클립 직사각형의 x 좌표; y - 새 클립 직사각형의 y 좌표; width - 새 클립 직사각형의 너비; height - 새 클립 직사각형의 높이
See Also:: clipRect(int, int, int, int)

drawLine

public void drawLine(int x1,
                     int y1,
                     int x2,
                     int y2)

현재 색과 입력 스타일을 사용하여 (x1,y1)과 (x2,y2) 좌표 사이에서 선을 그립니다.

Parameters:: x1 - 선이 시작하는 부분의 x 좌표; y1 - 선이 시작하는 부분의 y 좌표; x2 - 선이 끝나는 부분의 x 좌표; y2 - 선이 끝나는 부분의 y 좌표

fillRect

public void fillRect(int x,
                     int y,
                     int width,
                     int height)

지정한 직사각형을 현재 색으로 채웁니다. 너비나 높이가 0 이하인 경우 아무 것도 그려지지 않습니다.

Parameters:: x - 채워질 직사각형의 x 좌표; y - 채워질 직사각형의 y 좌표; width - 채워질 직사각형의 너비; height - 채워질 직사각형의 높이
See Also:: drawRect(int, int, int, int)

drawRect

public void drawRect(int x,
                     int y,
                     int width,
                     int height)

지정한 직사각형의 윤곽을 현재 색과 입력 스타일을 사용하여 그립니다. 결과 직사각형은 (width + 1) 픽셀 너비와 (height + 1) 픽셀 높이의 영역을 덮습니다. 너비나 높이가 0 미만인 경우 아무 것도 그려지지 않습니다.

Parameters:: x - 그려지는 직사각형의 x 좌표; y - 그려지는 직사각형의 y 좌표; width - 그려지는 직사각형의 너비; height - 그려지는 직사각형의 높이
See Also:: fillRect(int, int, int, int)

drawRoundRect

public void drawRoundRect(int x,
                          int y,
                          int width,
                          int height,
                          int arcWidth,
                          int arcHeight)

지정한 둥근 모서리 직사각형의 윤곽을 현재 색과 입력 스타일을 사용하여 그립니다. 결과 직사각형은 (width + 1) 픽셀 너비와 (height + 1) 픽셀 높이의 영역을 덮습니다. width나 height가 0 미만인 경우 아무 것도 그려지지 않습니다.

Parameters:: x - 그려지는 직사각형의 x 좌표; y - 그려지는 직사각형의 y 좌표; width - 그려지는 직사각형의 너비; height - 그려지는 직사각형의 높이; arcWidth - 네 개의 모서리에 있는 호의 가로 지름; arcHeight - 네 개의 모서리에 있는 호의 세로 지름
See Also:: fillRoundRect(int, int, int, int, int, int)

fillRoundRect

public void fillRoundRect(int x,
                          int y,
                          int width,
                          int height,
                          int arcWidth,
                          int arcHeight)

현재 색으로 지정된 둥근 모서리의 직사각형을 채웁니다. width 또는 height 가 0 이하인 경우 아무 것도 그려지지 않습니다.

Parameters:: x - 채워질 직사각형의 x 좌표; y - 채워질 직사각형의 y 좌표; width - 채워질 직사각형의 너비; height - 채워질 직사각형의 높이; arcWidth - 네 개의 모서리에 있는 호의 가로 지름; arcHeight - 네 개의 모서리에 있는 호의 세로 지름
See Also:: drawRoundRect(int, int, int, int, int, int)

fillArc

public void fillArc(int x,
                    int y,
                    int width,
                    int height,
                    int startAngle,
                    int arcAngle)

지정한 직사각형을 덮는 원형 호나 타원형 호를 채웁니다.

결과 호는 startAngle에서 시작하며 arcAngle도 확장합니다. 0도가 3시 위치에 있도록 각도가 해석됩니다. 양의 값은 시계 반대 방향을 나타내며 음의 값은 시계 방향을 나타냅니다.

호의 중심은 원점이 (x, y)이고 크기가 width와 height 인자에 의해 지정되는 직사각형의 중심입니다.

width 또는 height가 0 이하인 경우 아무 것도 그려지지 않습니다.

채우기 영역은 drawArc()에 의해 그려진 것처럼 호 세그먼트에 의해 경계가 지어진 "파이 조각" 영역, 중심에서 이 호까지 startAngle도 확장된 반지름, 중심에서 이 호까지 startAngle + arcAngle도 확장된 반지름으로 구성됩니다.

각도는 45도가 타원의 중심에서 경계 직사각형의 오른쪽 모서리에 이르는 선에 항상 떨어지도록 경계 직사각형의 비사각형 범위에 비례하게 지정됩니다. 결과적으로 경계 직사각형이 다른 축보다 한 축에서 눈에 띄게 긴 경우 호 세그멘트의 시작과 끝의 각도는 경계의 더 긴 축을 따라 더 비뚤어집니다.

Parameters:: x - 채워질 호 왼쪽 위 모서리의 x 좌표; y - 채워질 호 왼쪽 위 모서리의 y 좌표; width - 채울 호의 너비; height - 채울 호의 높이; startAngle - 시작 각도; arcAngle - 시작 각도에 비례하는 호의 각도 범위
See Also:: drawArc(int, int, int, int, int, int)

drawArc

public void drawArc(int x,
                    int y,
                    int width,
                    int height,
                    int startAngle,
                    int arcAngle)

지정한 직사각형을 덮는 원형 호나 타원형 호의 윤곽을 현재 색과 입력 스타일을 사용하여 그립니다.

결과 호는 현재 색을 사용하여 startAngle에서 시작하여 arcAngle도까지 확장합니다. 0 도가 3 시 위치에 있도록 각도가 해석됩니다. 양의 값은 시계 반대 방향을 나타내고 음의 값은 시계 방향을 나타냅니다.

호의 중심은 원점이 (x, y)이고 크기가 width와 height 인자에 의해 지정되는 직사각형의 중심입니다.

결과 호는 width + 1 픽셀 너비와 height + 1 픽셀 높이의 영역을 덮습니다. width나 height가 0 미만인 경우 아무 것도 그려지지 않습니다.

Parameters:: x - 그려지는 호 왼쪽 위 모서리의 x 좌표; y - 그려지는 호 왼쪽 위 모서리의 y 좌표; width - 그릴 호의 너비; height - 그릴 호의 높이; startAngle - 시작 각도; arcAngle - 시작 각도에 비례하는 호의 각 범위
See Also:: fillArc(int, int, int, int, int, int)

drawString

public void drawString(String str,
                       int x,
                       int y,
                       int anchor)

지정한 String을 현재 글꼴과 색을 사용하여 그립니다. x,y 위치는 앵커 포인트의 위치입니다. 앵커 포인트를 참조하십시오.

Parameters:: str - 그려지는 String; x - 앵커 포인트의 x 좌표; y - 앵커 포인트의 y 좌표; anchor - 텍스트를 배치할 앵커 포인트
Throws:: NullPointerException - str이 null인 경우; IllegalArgumentException - 앵커가 유효한 값이 아닌 경우
See Also:: drawChars(char[], int, int, int, int, int)

drawSubstring

public void drawSubstring(String str,
                          int offset,
                          int len,
                          int x,
                          int y,
                          int anchor)

지정한 String을 현재 글꼴과 색을 사용하여 그립니다. x,y 위치는 앵커 포인트의 위치입니다. 앵커 포인트를 참조하십시오.

offset 및 len 매개 변수는 문자열 str 내의 유효한 문자 범위를 지정해야 합니다. offset 매개 변수는 [0..(str.length)] 범위(포함)에 있어야 합니다. len 매개 변수는 음수가 아닌 정수여야 하며, 여기 (offset + len) <= str.length()입니다.

Parameters:: str - 그려지는 String; offset - 부속 문자열에 있는 첫 번째 문자의 0에서 시작하는 색인; len - 부속 문자열의 길이; x - 앵커 포인트의 x 좌표; y - 앵커 포인트의 y 좌표; anchor - 텍스트를 배치하기 위한 앵커 포인트
Throws:: StringIndexOutOfBoundsException - offset과 length가 String str 내의 유효한 범위를 지정하지 않는 경우; IllegalArgumentException - anchor가 유효한 값이 아닌 경우; NullPointerException - str이 null인 경우
See Also:: drawString(String, int, int, int).

drawChar

public void drawChar(char character,
                     int x,
                     int y,
                     int anchor)

지정한 문자를 현재 글꼴과 색을 사용하여 그립니다.

Parameters:: character - 그려지는 문자; x - 앵커 포인트의 x 좌표; y - 앵커 포인트의 y 좌표; anchor - 텍스트를 배치할 앵커 포인트. 앵커 포인트 참조
Throws:: IllegalArgumentException - anchor가 유효한 값이 아닌 경우
See Also:: drawString(java.lang.String, int, int, int), drawChars(char[], int, int, int, int, int)

drawChars

public void drawChars(char[] data,
                      int offset,
                      int length,
                      int x,
                      int y,
                      int anchor)

지정한 문자를 현재 글꼴과 색을 사용하여 그립니다.

offset 및 length 매개 변수는 문자 배열 data 내의 유효한 문자 범위를 지정해야 합니다. offset 매개 변수는 [0..(data.length)] 범위(포함)에 있어야 합니다. length 매개 변수는 음수가 아닌 정수여야 하며, 여기서 (offset + length) <= data.length입니다.

Parameters:: data - 그려지는 문자의 배열; offset - 데이터의 시작 오프셋; length - 그려지는 문자의 수; x - 앵커 포인트의 x 좌표; y - 앵커 포인트의 y 좌표; anchor - 텍스트를 배치할 앵커 포인트. 앵커 포인트 참조
Throws:: ArrayIndexOutOfBoundsException - offset과 length는 데이터 배열 내의 유효한 범위를 지정하지 않습니다.; IllegalArgumentException - 앵커가 유효한 값이 아닌 경우; NullPointerException - data가 null인 경우
See Also:: drawString(java.lang.String, int, int, int)

drawImage

public void drawImage(Image img,
                      int x,
                      int y,
                      int anchor)

지정한 이미지를 앵커 포인트를 사용하여 그립니다. 적절한 위치 상수를 전달하여 앵커 포인트에 비례하는 다른 위치에 이미지를 그릴 수 있습니다. 앵커 포인트를 참조하십시오.

소스 이미지에 투명 픽셀이 포함되어 있는 경우 대상 이미지의 해당 픽셀은 그대로 두어야 합니다. 소스 이미지에 부분적으로 투명한 픽셀이 포함되어 있는 경우 합성 작업은 대상 이미지의 모든 픽셀을 완전히 불투명하게 둔 상태로 대상 픽셀과 함께 수행되어야 합니다.

img가 이 Graphics 객체의 대상과 같은 경우 결과는 정의되지 않습니다. Image 내에서 영역을 복사하려면 copyArea가 대신 사용되어야 합니다.

Parameters:: img - 그려지는 지정 이미지; x - 앵커 포인트의 x 좌표; y - 앵커 포인트의 y 좌표; anchor - 이미지 배치를 위한 앵커 포인트
Throws:: IllegalArgumentException - anchor가 유효한 값이 아닌 경우; NullPointerException - img가 null인 경우
See Also:: Image

drawRegion

public void drawRegion(Image src,
                       int x_src,
                       int y_src,
                       int width,
                       int height,
                       int transform,
                       int x_dest,
                       int y_dest,
                       int anchor)

지정한 소스 이미지의 영역을, 선택한 변환 함수를 사용하여 이미지 데이터를 변환(회전 및 반사)하여 대상 내의 위치로 복사합니다.

대상이 이미지인 경우 소스 이미지와 같은 이미지가 아니어야 합니다. 같은 이미지인 경우 예외가 발생됩니다. 중복된, 변환된 복사본을 허용하는 경우 발생할 수 있는 잘못 정의된 동작을 피하기 위해 이러한 제한이 있습니다.

사용된 변환 함수는 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도 회전되게 합니다.

소스 영역에 투명한 픽셀이 포함된 경우 대상 영역에 있는 해당 픽셀은 그대로 두어야 합니다. 소스 영역에 부분적으로 투명한 픽셀이 포함되어 있는 경우 합성 작업은 대상 영역의 모든 픽셀을 완전히 불투명하게 둔 상태로 대상 픽셀과 함께 수행되어야 합니다.

(x_src, y_src) 좌표는 소스 이미지의 왼쪽 위 모서리에 비례합니다. x_src, y_src, width 및 height 매개 변수는 소스 이미지의 직사각형 영역을 지정합니다. 이 영역이 소스 이미지의 경계를 벗어나서 확장되는 것은 유효하지 않습니다. 여기에는 다음 내용이 필요합니다.


   x_src >= 0
   y_src >= 0
   x_src + width <= source width
   y_src + height <= source height

(x_dest, y_dest) 좌표는 Graphics 객체의 좌표계에 비례합니다. 이 대상 영역이 Graphics 객체의 경계를 벗어나서 확장되는 것은 유효합니다. Graphics 객체의 경계를 벗어나는 픽셀은 그려지지 않습니다.

변환은 소스 이미지의 영역으로부터 이미지 데이터로 적용되며 결과는 대상의 (x_dest, y_dest) 위치에 있는 앵커 포인트와 함께 렌더링됩니다.

Parameters:: src - 복사할 소스 이미지; x_src - 복사할 소스 이미지 내에 있는 영역 왼쪽 위 모서리의 x 좌표; y_src - 복사할 소스 이미지 내에 있는 영역 왼쪽 위 모서리의 y 좌표; width - 복사할 영역의 너비; height - 복사할 영역의 높이; transform - 복사할 선택 영역에 대해 원하는 변환; x_dest - 대상 그리기 영역에 있는 앵커 포인트의 x 좌표; y_dest - 대상 그리기 영역에 있는 앵커 포인트의 y 좌표; anchor - 대상 이미지 내에서 영역을 배치할 앵커 포인트
Throws:: IllegalArgumentException - src가 이 Graphics 객체의 대상과 같은 이미지인 경우; NullPointerException - src가 null인 경우; IllegalArgumentException - transform이 유효하지 않은 경우; IllegalArgumentException - anchor가 유효하지 않은 경우; IllegalArgumentException - 복사되는 영역이 소스 이미지의 범위를 넘는 경우
Since:: MIDP 2.0

copyArea

public void copyArea(int x_src,
                     int y_src,
                     int width,
                     int height,
                     int x_dest,
                     int y_dest,
                     int anchor)

직사각형 영역 (x_src, y_src, width, height)의 내용을 앵커에 의해 식별된 앵커 포인트가 (x_dest, y_dest)에 있는 대상 영역으로 복사합니다. 효과는 이 메소드를 바로 호출하기 전에 대상 영역이 소스 영역 내용의 정확한 복사본을 포함하는 것입니다. 소스 및 대상 영역이 중복되더라도 이 결과는 발생해야 합니다.

점 (x_src, y_src)와 (x_dest, y_dest)는 모두 Graphics 객체의 좌표계에 비례하여 지정됩니다. 소스 영역이 그래픽 객체의 경계를 벗어나서 확장되는 것은 유효하지 않습니다. 여기에는 다음 내용이 필요합니다.


   x_src + tx >= 0
   y_src + ty >= 0
   x_src + tx + width <= width of Graphics object's destination
   y_src + ty + height <= height of Graphics object's destination

여기서 tx와 ty는 각각 getTranslateX()와 getTranslateY()에 의해 반환되는, 이 그래픽 객체의 변환된 원점 X와 Y 좌표를 나타냅니다.

하지만 대상 영역이 Graphics 객체의 경계를 벗어나서 확장되는 것은 유효하지 않습니다. Graphics 객체의 경계를 벗어나는 픽셀은 그려지지 않습니다.

대상이 실제 디스플레이 장치인 객체를 제외하고 copyArea 메소드는 모든 Graphics 객체에서 허용됩니다. 디스플레이에서 copyArea 메소드를 허용하면 이중 버퍼링을 구현하는 특정 기술에 역으로 영향을 미칠 수 있으므로 이 제한이 필요합니다.

다른 그래픽 작업과 마찬가지로 copyArea 메소드는 픽셀 결합을 위한 소스 대 대상 규칙을 사용합니다. 하지만 이 규칙은 완전히 불투명한 픽셀만 포함할 수 있는, 변경할 수 있는 이미지에 대해서만 정의되므로 이는 픽셀 교체와 같은 효과입니다.

Parameters:: x_src - 소스 영역 왼쪽 위 모서리의 x 좌표; y_src - 소스 영역 왼쪽 위 모서리의 y 좌표; width - 소스 영역의 너비; height - 소스 영역의 높이; x_dest - 대상 앵커 포인트의 x 좌표; y_dest - 대상 앵커 포인트의 y 좌표; anchor - 대상 이미지 내에서 영역을 배치할 앵커 포인트
Throws:: IllegalStateException - Graphics 객체의 대상이 디스플레이 장치인 경우; IllegalArgumentException - 복사되는 영역이 소스 이미지의 범위를 넘는 경우
Since:: MIDP 2.0

fillTriangle

public void fillTriangle(int x1,
                         int y1,
                         int x2,
                         int y2,
                         int x3,
                         int y3)

현재 색으로 지정한 삼각형을 채웁니다 각 지점 쌍을 연결하는 선이 채워진 삼각형에 포함됩니다.

Parameters:: x1 - 삼각형의 첫 번째 정점의 x 좌표; y1 - 삼각형의 첫 번째 정점의 y 좌표; x2 - 삼각형의 두 번째 정점의 x 좌표; y2 - 삼각형의 두 번째 정점의 y 좌표; x3 - 삼각형의 세 번째 정점의 x 좌표; y3 - 삼각형의 세 번째 정점의 y 좌표
Since:: MIDP 2.0

drawRGB

public void drawRGB(int[] rgbData,
                    int offset,
                    int scanlength,
                    int x,
                    int y,
                    int width,
                    int height,
                    boolean processAlpha)

지정한 영역에서 일련의 장치 독립 RGB+투명도 값을 렌더링합니다. 값은 RGB의 24 비트와 8비트 알파 값(0xAARRGGBB)을 갖는 형식으로 rgbData에 저장되며 첫 번째 값은 지정한 오프셋에 저장됩니다. scanlength는 연속 행의 해당 픽셀 사이의 배열 내에서 상대적 오프셋을 지정합니다. 모든 결과 참조가 rgbData 배열의 경계 내에 있는 경우 scanlength의 모든 값(음수 값이더라도)은 적용할 수 있습니다. ARGB 데이터는 각 행 내에서 왼쪽에서 오른쪽으로 가로로 래스터화됩니다. ARGB 값은 x, y, width 및 height에서 지정한 영역에서 렌더링되며 작업은 Graphics 객체에 대한 현재 클립 영역 및 변환에 종속됩니다.

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


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

다음 경우


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

스크린과 오프스크린 Image 객체로 렌더링할 때 모두 사용할 수 있도록 이 기능은 Graphics에서 제공합니다. Image.getRGB(int[], int, int, int, int, int, int) 메소드는 ARGB 값을 읽어 들일 수 있는 기능을 제공합니다.

processAlpha가 true인 경우 ARGB 형식의 상위 바이트는 불투명도를 지정합니다. 즉, 0x00RRGGBB는 완전히 투명한 픽셀을 지정하고 0xFFRRGGBB는 완전히 불투명한 픽셀을 지정합니다. 중간 알파 값은 반투명도를 지정합니다. 구현 시 이미지 렌더링 작업에 대해 알파 블렌딩을 지원하지 않으면 렌더링을 수행하기 전에 소스 데이터에서 반투명도를 제거해야 합니다(자세한 내용은 알파 처리 참조). processAlpha가 false인 경우 알파 값은 무시되며 모든 픽셀은 완전히 불투명하게 처리되어야 합니다.

ARGB 값을 장치 종속 픽셀에 매핑하는 것은 플랫폼에 따라 달라지며 중요한 계산이 필요합니다.

Parameters:: rgbData - 0xAARRGGBB 형식을 갖는 ARGB 값의 배열; offset - 첫 번째 ARGB 값의 배열 색인; scanlength - rgbData 배열의 연속 행에 있는 해당 픽셀 사이의 상대적 배열 오프셋; x - 렌더링할 영역의 수평 위치; y - 렌더링할 영역의 수직 위치; width - 렌더링할 영역의 너비; height - 렌더링할 영역의 높이; processAlpha - rgbData에 알파 채널이 있는 경우 true, 모든 픽셀이 전체적으로 불투명한 경우 false
Throws:: ArrayIndexOutOfBoundsException - 색인이 음수이거나 해당 길이를 초과하는 rgbData의 요소에 요청한 작업이 액세스하려고 시도하는 경우; NullPointerException - rgbData가 null인 경우
Since:: MIDP 2.0

getDisplayColor

public int getDisplayColor(int color)

지정한 색을 요청하면 표시될 색을 가져옵니다. 이 메소드를 사용하면 개발자는 RGB 값이 장치가 실제로 표시하는 색상 집합에 매핑되는 방식을 검사할 수 있습니다. 예를 들어, 흑백 장치를 사용하면 이 메소드는 지정한 색의 밝기에 따라 0xFFFFFF(흰색)나 0x000000(검정) 중 하나를 반환합니다.

Parameters:: color - 원하는 색(0x00RRGGBB 형식이며 상위 바이트는 무시됨)
Returns:: 장치 화면에 표시될 해당 색(0x00RRGGBB 형식으로)
Since:: MIDP 2.0

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

MID 프로필

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

의견이나 제안 사항 보내기 MID 프로필 사양 버전 2.0
Java는 미국 및 다른 국가에서 Sun Microsystems, Inc.의 상표 또는 등록 상표입니다. Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. 모든 권리는 저작권자의 소유입니다.

Field Summary
`static int`	`BASELINE` 텍스트의 기준선에 앵커 포인트를 배치하기 위한 상수.
`static int`	`BOTTOM` 텍스트나 이미지의 아래에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.
`static int`	`DOTTED` `DOTTED` 입력 스타일의 상수.
`static int`	`HCENTER` 앵커 포인트 주위로 텍스트와 이미지를 가로로 가운데 맞추기 위한 상수.
`static int`	`LEFT` 텍스트나 이미지의 왼쪽에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.
`static int`	`RIGHT` 텍스트나 이미지의 오른쪽에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.
`static int`	`SOLID` `SOLID` 입력 스타일에 대한 상수.
`static int`	`TOP` 텍스트나 이미지 위에 텍스트와 이미지의 앵커 포인트를 배치하기 위한 상수.
`static int`	`VCENTER` 앵커 포인트 주위에 이미지를 세로로 가운데 맞추기 위한 상수.

Method Summary
`void`	`clipRect(int x, int y, int width, int height)` 현재 클립을 지정한 직사각형과 교차 시킵니다.
`void`	`copyArea(int x_src, int y_src, int width, int height, int x_dest, int y_dest, int anchor)` 직사각형 영역 `(x_src, y_src, width, height)`의 내용을 앵커에 의해 식별된 앵커 포인트가 `(x_dest, y_dest)`에 있는 대상 영역으로 복사합니다.
`void`	`drawArc(int x, int y, int width, int height, int startAngle, int arcAngle)` 지정한 직사각형을 덮는 원형 호나 타원형 호의 윤곽을 현재 색과 입력 스타일을 사용하여 그립니다.
`void`	`drawChar(char character, int x, int y, int anchor)` 지정한 문자를 현재 글꼴과 색을 사용하여 그립니다.
`void`	`drawChars(char[] data, int offset, int length, int x, int y, int anchor)` 지정한 문자를 현재 글꼴과 색을 사용하여 그립니다.
`void`	`drawImage(Image img, int x, int y, int anchor)` 지정한 이미지를 앵커 포인트를 사용하여 그립니다.
`void`	`drawLine(int x1, int y1, int x2, int y2)` 현재 색과 입력 스타일을 사용하여 `(x1,y1)`과 `(x2,y2)` 좌표 사이에서 선을 그립니다.
`void`	`drawRect(int x, int y, int width, int height)` 지정한 직사각형의 윤곽을 현재 색과 입력 스타일을 사용하여 그립니다.
`void`	`drawRegion(Image src, int x_src, int y_src, int width, int height, int transform, int x_dest, int y_dest, int anchor)` 지정한 소스 이미지의 영역을, 선택한 변환 함수를 사용하여 이미지 데이터를 변환(회전 및 반사)하여 대상 내의 위치로 복사합니다.
`void`	`drawRGB(int[] rgbData, int offset, int scanlength, int x, int y, int width, int height, boolean processAlpha)` 지정한 영역에서 일련의 장치 독립 RGB+투명도 값을 렌더링합니다.
`void`	`drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)` 지정한 둥근 모서리 직사각형의 윤곽을 현재 색과 입력 스타일을 사용하여 그립니다.
`void`	`drawString(String str, int x, int y, int anchor)` 지정한 `String`을 현재 글꼴과 색을 사용하여 그립니다.
`void`	`drawSubstring(String str, int offset, int len, int x, int y, int anchor)` 지정한 `String`을 현재 글꼴과 색을 사용하여 그립니다.
`void`	`fillArc(int x, int y, int width, int height, int startAngle, int arcAngle)` 지정한 직사각형을 덮는 원형 호나 타원형 호를 채웁니다.
`void`	`fillRect(int x, int y, int width, int height)` 지정한 직사각형을 현재 색으로 채웁니다.
`void`	`fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)` 현재 색으로 지정된 둥근 모서리의 직사각형을 채웁니다.
`void`	`fillTriangle(int x1, int y1, int x2, int y2, int x3, int y3)` 현재 색으로 지정한 삼각형을 채웁니다 각 지점 쌍을 연결하는 선이 채워진 삼각형에 포함됩니다.
`int`	`getBlueComponent()` 현재 색의 파랑 구성 요소를 가져옵니다.
`int`	`getClipHeight()` 현재 클립 영역의 높이를 가져옵니다.
`int`	`getClipWidth()` 현재 클립 영역의 너비를 가져옵니다.
`int`	`getClipX()` 이 그래픽 컨텍스트의 좌표계 원점과 비례하여 현재 클립 영역의 X 오프셋을 가져옵니다.
`int`	`getClipY()` 이 그래픽 컨텍스트의 좌표계 원점과 비례하여 현재 클립 영역의 Y 오프셋을 가져옵니다.
`int`	`getColor()` 현재 색을 가져옵니다.
`int`	`getDisplayColor(int color)` 지정한 색을 요청하면 표시될 색을 가져옵니다.
`Font`	`getFont()` 현재 글꼴을 가져옵니다.
`int`	`getGrayScale()` 렌더링 작업에 사용된 색의 현재 회색조 값을 가져옵니다.
`int`	`getGreenComponent()` 현재 색의 녹색 구성 요소를 가져옵니다.
`int`	`getRedComponent()` 현재 색의 빨강 구성 요소를 가져옵니다.
`int`	`getStrokeStyle()` 그리기 작업에 사용된 입력 스타일을 가져옵니다.
`int`	`getTranslateX()` 이 그래픽 컨텍스트의 변환된 원점의 X 좌표를 가져옵니다.
`int`	`getTranslateY()` 이 그래픽 컨텍스트의 변환된 원점의 Y 좌표를 가져옵니다.
`void`	`setClip(int x, int y, int width, int height)` 현재 클립을 주어진 좌표에 의해 지정된 직사각형으로 설정합니다.
`void`	`setColor(int RGB)` 현재 색을 지정한 RGB 값으로 설정합니다.
`void`	`setColor(int red, int green, int blue)` 현재 색을 지정한 RGB 값으로 설정합니다.
`void`	`setFont(Font font)` 모든 후속 텍스트 렌더링 작업의 글꼴을 설정합니다.
`void`	`setGrayScale(int value)` 모든 후속 렌더링 작업에서 사용되는 현재 회색조를 설정합니다.
`void`	`setStrokeStyle(int style)` 선, 호, 직사각형 및 둥근 직사각형을 그리는 데 사용된 입력 스타일을 설정합니다.
`void`	`translate(int x, int y)` 그래픽 컨텍스트의 원점을 현재 좌표계의 점 `(x, y)`로 변환됩니다.

javax.microedition.lcdui Class Graphics

자르기

앵커 포인트

참조

HCENTER

VCENTER

LEFT

RIGHT

TOP

BOTTOM

BASELINE

SOLID

DOTTED

translate

getTranslateX

getTranslateY

getColor

getRedComponent

getGreenComponent

getBlueComponent

getGrayScale

setColor

setColor

setGrayScale

getFont

setStrokeStyle

getStrokeStyle

setFont

getClipX

getClipY

getClipWidth

getClipHeight

clipRect

setClip

drawLine

fillRect

drawRect

drawRoundRect

fillRoundRect

fillArc

drawArc

drawString

drawSubstring

drawChar

drawChars

drawImage

drawRegion

copyArea

fillTriangle

drawRGB

getDisplayColor

javax.microedition.lcdui
Class Graphics