java.awt
클래스 Graphics2D

java.lang.Object 
  java.awt.Graphics 
      java.awt.Graphics2D

public abstract class Graphics2D
extends Graphics 

Graphics2D 클래스는 Graphics 클래스를 확장해, 지오메트리, 좌표변화, 컬러 관리 및 텍스트 배치에 대해 고도의 제어를 실시합니다. 이 클래스는 Java(TM) 플랫폼에서 2D 도형, 텍스트 및 이미지를 렌더링하기 위한 기본 클래스입니다.

좌표 공간

Graphics2D 객체에게 건네지는 모든 좌표는 사용자 공간 (어플리케이션에 의해 사용된다)으로 불리는 디바이스에 존하지 않는 좌표계로 지정됩니다. Graphics2D 객체에는 디바이스 공간에서 사용자 공간의 좌표를 디바이스에 의존된 좌표로 변환하는 방법을 정의하는 AffineTransform 객체가 렌더링 상태의 일부로서 포함됩니다.

디바이스 공간의 좌표는 보통, 개별의 디바이스 픽셀을 나타내, 이러한 픽셀간에 무한하게 가는 간격에 늘어놓을 수 있고 있습니다. 일부의 Graphics2D 객체에서는 렌더링 조작을 수중에 넣을 수가 있습니다. 그래픽 메타파일로서 수중에 넣는 것으로 후에 물리적인 해상도가 불명한 구상 디바이스를 사용해 재생할 수 있습니다 . 렌더링 조작을 수중에 넣으려면 해상도가 불명해서, Graphics2D Transform를 설정해 사용자 좌표를 가상 디바이스 공간으로 변환하도록 합니다. 타겟 디바이스가 예상되는 해상도가 개산 됩니다만, 그 견적이 올바르지 않은 경우에는 재생시에 또한 변환을 적용할 필요가 있습니다.

렌더링 속성 객체에 의해 실행되는 일부의 조작에는 디바이스 공간에서 처리되는 것도 있습니다만, Graphics2D 메서드는 모두 사용자 공간 좌표를 취급합니다.

모든 Graphics2D객체는 렌더링가 행해지는 위치를 정의하는 타겟과 관련지을 수 있고 있습니다. GraphicsConfiguration 객체는 픽셀 형식 및 해상도라고 하는 렌더링 타겟의 특성을 정의합니다. Graphics2D 객체에서는 항상 같은 렌더링 타겟이 사용됩니다.

Graphics2D 객체가 작성될 때, GraphicsConfiguration는 Graphics2D (Component 또는 Image )의 타겟으로서디폴트 변환을 지정합니다. 이 디폴트 변환에서는 사용자 공간 좌표계를 화면과 프린터의 디바이스 좌표에 매핑 해, 원점을 디바이스의 타겟 영역의 좌상구석에 우측으로 확장하려면 X 좌표를, 하부에 확장하려면 Y 좌표를 늘리는 것 같은 매핑을 실시합니다. 스크린 디바이스등의 72 dpi에 가까운 디바이스의 경우, 디폴트 변환의 슬캘링은 그러한 디바이스의 식별 정보로 설정됩니다. 프린터등의 고해상도 디바이스의 경우, 디폴트 변환의 슬캘링은 1 평방 인치 근처 약 72 사용자 공간 좌표로 설정됩니다. 이미지 버퍼에서는 디폴트의 변환은 Identity 변환입니다.

렌더링 프로세스

렌더링 프로세스는 Graphics2D 렌더링 속성에 의해 제어되는 4개의 단계로 나눌 수가 있습니다. 렌더링에서는 이러한 스텝의 대부분을 최적화할 수 있습니다. 최적화는 장래의 호출에 대비해 결과를 캐쉬에 포함해 두거나 복수의 가상 스텝을 실질적으로 1개의 조작에 정리하거나 다양한 속성에 관한 단순한 공통의 문제점을 조작외의 부분을 변경하는 것으로써 배제하거나 하는 것, 등에 의해 행해집니다.

렌더링 프로세스의 순서를 이하에 설명합니다.

1. 렌더링 하는 대상을 지정한다
2. 렌더링 조작을 현재의 Clip에 제한한다. Clip는 사용자 공간 Shape 에 의해 지정되어Graphics 및 Graphics2D 다양한 클립 조작 메서드를 사용해 프로그램에 의해 제어됩니다. 이 「사용자 클립」은 현재의 Transform에 의해 디바이스 공간에 변환되어 윈도우의 가시성 및 디바이스의 크기에 의해 정의되는 「디바이스 클립」이라고 결합됩니다. 사용자 클립과 디바이스 클립의 결합에의해 최종적인 클리핑 영역을 결정하는 「복합 클립」을 정의합니다. 렌더링 시스템은 사용자 클립을 변경해 복합 클립의 결과를 반영할 수 없습니다.
3. 렌더링 하는 색을 지정한다
4. Graphics2D 컨텍스트 의 현재 Composite 속성을 사용해, 목적지의 렌더링 표면으로 지정된 색을 바른다

3 종류의 렌더링 조작에 대해, 각각의 렌더링 프로세스의 상세를 이하에 설명합니다.

1. Shape 조작
   1. draw(Shape) 조작의 경우, Graphics2D 컨텍스트 의 현재 Stroke 속성으로 createStrokedShape 메서드를 사용해, 지정의 Shape 윤곽을 포함하는 새로운 Shape 객체가 구축됩니다.
   2. Shape는 Graphics2D 컨텍스트 의 현재의 Transform를 사용해 사용자 공간으로부터 디바이스 공간에 변환됩니다.
   3. Shape 윤곽은, Shape getPathIterator 메서드를 사용해 추출됩니다. 이 메서드는 Shape 경계를 따라 반복 처리를 실시하는 PathIterator 객체를 리턴합니다.
   4. xPathIterator 객체에 의해 리턴된 곡선 세그먼트(segment)를 Graphics2D 객체를 처리할 수 없는 경우는 Shape 평탄화를 실시하는 대체 메서드 getPathIterator를 호출할 수 있습니다 .
   5. Graphics2D 컨텍스트 의 현재 Paint 가 디바이스 공간에서 렌더링 하는 색을 지정하는 PaintContext를 취득하기 위해서 조회됩니다.
2. 텍스트 조작
   1. 지정된 String를 렌더링 하기 위해서 필요한 그래프 세트는 아래의 순서로 지정됩니다.
      1. 인수가 String인 경우, 폰트가 구현하는 기본 레이아웃 및 형상 결정 알고리즘에 관계없이 그것들을 이용해 표시하기 위해서 Graphics2D 컨텍스트 의 현재의 Font는 String Unicode 캐릭터 라인을 그래프 세트로 변환하도록 요구됩니다.
      2. 인수가 AttributedCharacterIterator 인 경우, 반복자는 매입 폰트 속성을 사용해, 그 자체를 TextLayout 로 변환하도록 요구됩니다. TextLayout는 출력 방향이 다른 복수의 폰트를 위해서 자동적으로 Unicode 쌍방향 레이아웃 조정을 실행하는 보다 고성능인 그래프 레이아우트아르고리즘을 구현할 수 있습니다.
      3. 인수가 GlyphVector 인 경우, GlyphVector객체는 각 그래프 의 위치를 나타내는 명시적인 좌표를 가지는 폰트 독자적인 적절한 그래프 코드를 이미 포함하고 있습니다.
   2. 현재의 Font를 조회하면, 지정된 그래프 의 아우트라인을 취득할 수 있습니다. 이러한 아우트라인은 순서 1 으로 지정된 각 그래프 의 위치를 기준으로 한 사용자 공간의 형상으로서 처리됩니다.
   3. 문자의 아우트라인이, 「Shape 조작」으로 설명한 것처럼 전부 칠해집니다.
   4. 현재의 Paint이 디바이스 공간에서 렌더링 하는 색을 지정하는 PaintContext를 취득하기 위해서 조회됩니다.
3. Image 조작
   1. 대상이 되는 영역은 소스 Image 바운딩박스 로 정의됩니다. 이 바운딩박스는 Image 객체의 로컬인 좌표계인 이미지 공간에서 지정됩니다.
   2. AffineTransform 이 drawImage(Image, AffineTransform, ImageObserver) 에게 건네지는 경우는 이미지 공간으로부터 사용자 공간에 바운딩박스를 변환하기 위해서 그 AffineTransform가 사용됩니다. AffineTransform가 지정되지 않는 경우, 바운딩박스는 이미 사용자 공간에 있는 것으로서 다루어집니다.
   3. 소스 Image 바운딩박스는 현재의 Transform를 사용해 사용자 공간으로부터 디바이스 공간에 변환됩니다. 다만, 바운딩박스를 변환한 결과가 디바이스 공간에서 구형 영역이 된다고는 할 수 없습니다.
   4. Image객체는 렌더링 하는 색을 지정합니다. 색은 현재의 Transform와 옵션의 이미지 변환에 의해 지정된 소스로부터 목적지에의 매핑에 따라 샘플링 됩니다.

디폴트의 렌더링 속성

Graphics2D 렌더링 속성의 설정값을 이하에 나타냅니다.

Paint

Component 색

Font

Component Font

Stroke

선폭 1, 파선 이루어, 마이타세그먼트 결합 및 모퉁이 엔드 캡을 가지는 모퉁이 펜

Transform

Component GraphicsConfiguration용의 getDefaultTransform

Composite

AlphaComposite.SRC_OVER 규칙

Clip

렌더링 Clip 이루어, 출력은 Component에 클립 된다

렌더링 호환성

JDK^TM 1.1 렌더링 모델은 좌표가 픽셀간의 무한하게 가는 간격에 존재한다고 하는 픽셀화 모델에 근거합니다. 렌더링 조작은 윤곽 선상의 엥커 포인트의 오른쪽 및 아래의 픽셀을 전부 칠하는 1 픽셀폭의 펜을 사용해 행해집니다. JDK 1.1 렌더링 모델은 지정된 번호의 픽셀에 제대로 들어가지 않으면 안 되는 이산 펜에 정수 좌표를 변환할 필요가 있는 플랫폼 렌더링의 대부분의 기존 클래스의 기능에 준거하고 있습니다.

Java 2D(TM) (Java(TM) 2 플랫폼) API는 평활화 렌더링을 지원하고 있습니다. 1 픽셀폭의 펜은 픽셀 N+1와 대비한 픽셀 N에 완전하게 들어갈 필요는 없습니다. 펜은 부분적으로 양쪽 모두의 픽셀에 걸릴 수가 있습니다. 이동하고 있는 펜의 인연이 양쪽 모두의 픽셀에 걸리면, 펜의 서브 픽셀 위값이 사용자에 게 표시되기 때문에 대폭 펜의 바이어스 방향을 선택할 필요는 없습니다. 한편, KEY_ANTIALIASING 힌트 키를 VALUE_ANTIALIAS_OFF 힌트치로 설정하는 것에 의해 평활화를 무효로 했을 경우는 디바이스 공간에서 정수 좌표에 따라 렌더링 하고 있을 때 등, 펜이 픽셀 경계를 넘으려 하고 있을 때 어느 쪽의 픽셀을 수정할까 판단하기 위해서 렌더링은 바이어스를 적용할 필요가 있습니다. 평활화 렌더링의 기능에의해 렌더링 모델은 펜의 바이어스를 지정하는 필요성이 없어졌습니다만, 화면상에서 1 픽셀폭의 수평선 및 수직선을 렌더링 하는 공통의 케이스에서는 평활화 렌더링과 비평활화 렌더링은 똑같이 동작할 필요가 있습니다. KEY_ANTIALIASING 힌트 키를 VALUE_ANTIALIAS_ON 로 설정해 평활화를 유효하게 했기 때문에 이 선폭이 갑자기 2 배가 되어 불투명도가 반이 되는 것을 막으려면, 그러한 선의 윤곽선을 모델로 지정하는 것에의해 그 선이 특정의 픽셀세트를 완전하게 커버해 윤곽이 선명히 되도록 합니다.

Java 2D API는 JDK 1.1 렌더링 동작과의 호환성을 유지하고 있어, Java 2D API 에서는 종래부터의 조작이나 기존의 렌더링의 동작으로 변경은 없습니다. 일반적인 draw 메서드 및 fill 메서드에 매핑 되는 종래의 메서드가 정의되고 있기 때문에 Stroke 속성과 Transform 속성의 설정 및 렌더링 힌트에 근거해 Graphics2D가 Graphics를 어떻게 확장하고 있을지가 명확하게 나타나고 있습니다. 그 정의는 디폴트의 속성 설정에서는 똑같이 실행됩니다. 예를 들어 디폴트의 Stroke는 넓이 1 및 파선 없음의 BasicStroke 이며, 화면 렌더링의 디폴트의 Transform는 항등변환입니다.

다음의 2개의 규칙은 비에일리어징 제거 또는 에일리어징 제거의 어느 쪽이 사용되고 있어도, 예측 가능한 렌더링 동작을 제공합니다.

• 디바이스 픽셀간에 디바이스 좌표가 정의되어 그것에 의해 에일리어징 제거와 에일리어징 제거의 렌더링의 사이에 일관성이 있는 결과를 얻을 수 있습니다. 좌표가 픽셀의 중심에 있도록 정의되었을 경우, 구형등의 형상에 의해 커버되는 일부의 픽셀은 반밖에 커버되지 않습니다. 비에일리어징 제거의 렌더링의 경우, 반커버된 픽셀은 형상의 안쪽이나 외측의 어느 쪽인지가 렌더링 됩니다. 에일리어징 제거의 렌더링에서는 형상의 엣지 전체에 있는 픽셀이 반만큼 커버됩니다. 그러나, 픽셀의 사이에 좌표가 정의되고 있으면, 구형등의 형상은 에일리어징 제거를 사용해 렌더링 되는 제발에 관계없이, 반만큼 커버된 픽셀을 가질 것은 없습니다.
• BasicStroke 객체를 사용해 stroke 한 선 및 도형의 윤곽을 「정규화」하는 것으로 렌더링 가능한 다양한 위치에서 비에일리어징 제거 렌더링 또는 에일리어징 제거 렌더링 할 경우에 일관성이 있는 윤곽을 렌더링 할 수 있습니다 . 이 정규화 프로세스는 KEY_STROKE_CONTROL 힌트에 의해 제어됩니다. 정확한 정규화 알고리즘은 지정됩니다만, 이 정규화의 목표는 픽셀 구라두에 선이 어떻게 들어가는 것에 관계없이, 시각적으로 일관성이 있는 선을 렌더링 할 수 있도록 하는 것 및 에일리어징 제거 모드에서의 수평선 및 수직선을 보다 치밀하게 해, 에일리어징 제거되어 있지 않은 경우의 선이 될 수 있도록 접근하는 것입니다. 보통 의 정규화의 스텝에서는 부동 소수점의 선폭이 동등의 가능성으로 짝수 또는 홀수의 픽셀수에 사사오입 할 수 있도록, 에일리어징 제거 된 선의 종단을 보다 픽셀의 중심에 의해 겹치는 양을 줄이든가 혹은 에일리어징 제거되어 있지 않은 선의 서브 픽셀의 위치 결정을 조정합니다. 이 프로세스에서는 종단을 픽셀의 반까지 이동해 (일반적으로 양축으로 따라 정의 무한대 방향), 이러한 결과의 일관성을 높일 수가 있습니다.

다음에 나타내는 일반적인 종래의 메서드의 정의는 디폴트 속성 설정에서는 이전으로 지정된 동작과 같이 실행됩니다.

• fillRect, fillRoundRect, fillOval, fillArc, fillPolygon, clearRect 등의 fill 조작의 경우는 목적의 Shape를 지정해 fill를 호출할 수 있습니다 . 예를 들어 구형을 전부 칠하는 경우는

  
   fill(new Rectangle(x, y, w, h));
   

  를 호출합니다.

• 똑같이, drawLine, drawRect, drawRoundRect, drawOval, drawArc, drawPolyline, drawPolygon 등의 렌더링 조작의 경우는 목적의 Shape를 지정해 draw를 호출할 수 있습니다 . 예를 들어 구형을 렌더링 하는 경우는

  
   draw(new Rectangle(x, y, w, h));
   

  를 호출합니다.

• draw3DRect 메서드와 fill3DRect 메서드는 Graphics 클래스에서는 drawLine 메서드와 fillRect 메서드를 사용해 구현되고 있습니다. 이러한 동작은, Graphics2D 컨텍스트 의 현재의 Stroke 객체와 Paint 객체에 근거해 예측할 수 있습니다. Graphics2D 클래스는 현재의 Paint를 오버라이드(override) 해, 이러한 2개의 객체의 구현을 현재의 Color를 배타적으로 사용하는 버전 으로 오버라이드(override) 합니다. 이 클래스는 기존의 메서드와 완전하게 동일한 동작을 기술하기 위해서 Stroke 현재의 설정 (와)는 관계없는 것으로 fillRect를 사용합니다.

Graphics 클래스는 페인트 되는 색을 제어하기 위해서 setColor 메서드만을 정의합니다. Java 2D API는 Color 객체를 확장해 새로운 Paint인터페이스를 구현하므로 기존의 setColor 메서드는 현재의 Paint 속성을 Color 객체로 설정하기 위한 간이 메서드가 되어 있습니다. setColor(c)는 setPaint(c)에 상당합니다.

Graphics 클래스는 색을 목적지에 적용하는 방법을 제어하기 위해서 2개의 메서드를 정의합니다.

1. setPaintMode 메서드는 setComposite(new AlphaComposite.SrcOver)에 상당하는 디폴트의 Composite를 설정하는 간이 메서드로서 구현됩니다.
2. setXORMode(Color xorcolor) 메서드는 소스 컬러의 Alpha 컴퍼넌트를 무시해, 목적지 컬러를 그 값으로 설정하는 특수한 Composite 객체를 설정하기 위한 간이 메서드로서 구현됩니다.

   
    dstpixel = (PixelOf(srccolor) ^ PixelOf(xorcolor) ^ dstpixel);
    

관련 항목:

RenderingHints

생성자 개요

protected

Graphics2D () 새로운 Graphics2D 객체를 구축합니다.

메서드 개요

abstract void	addRenderingHints (Map <?,?> hints) 렌더링 알고리즘에 관한 임의의 수의 추천 설정의 값을 설정합니다.
abstract void	clip (Shape s) 현재의 Clip가 지정된 Shape 내부와 교차시켜, 결과적으로 생긴 공통 부분에 그 Clip를 설정합니다.
abstract void	draw (Shape s) 현재의 Graphics2D 컨텍스트 의 설정을 사용하는 것으로Shape 윤곽을 stroke로 렌더링 합니다.
void	draw3DRect (int x, int y, int width, int height, boolean raised) 지정된 구형의 윤곽을 3D 로 강조 표시해 렌더링 합니다.
abstract void	drawGlyphVector (GlyphVector g, float x, float y) Graphics2D 컨텍스트 의 렌더링 속성을 사용하는 것으로 지정된 GlyphVector 텍스트를 렌더링 합니다.
abstract void	drawImage (BufferedImage img, BufferedImageOp op, int x, int y) BufferedImageOp 로 필터 처리되는 BufferedImage를 렌더링 합니다.
abstract boolean	drawImage (Image img, AffineTransform xform, ImageObserver obs) 이미지 공간으로부터 사용자 공간에의 변환을 적용하고 나서, 이미지를 렌더링 합니다.
abstract void	drawRenderableImage (RenderableImage img, AffineTransform xform) 이미지 공간으로부터 사용자 공간에의 변환을 적용하고 나서, RenderableImage를 렌더링 합니다.
abstract void	drawRenderedImage (RenderedImage img, AffineTransform xform) 이미지 공간으로부터 사용자 공간에의 변환을 적용하고 나서, RenderedImage를 렌더링 합니다.
abstract void	drawString (AttributedCharacterIterator iterator, float x, float y) Graphics2D 컨텍스트 의 현재의 Paint를 사용하는 것으로 지정된 반복자의 텍스트를 렌더링 합니다.
abstract void	drawString (AttributedCharacterIterator iterator, int x, int y) Graphics2D 컨텍스트 의 현재의 Paint를 사용하는 것으로 지정된 반복자의 텍스트를 렌더링 합니다.
abstract void	drawString (String s, float x, float y) Graphics2D 컨텍스트 의 현재의 텍스트 속성 상태를 사용하는 것으로 특정의 String에 의해 지정된 텍스트를 렌더링 합니다.
abstract void	drawString (String str, int x, int y) Graphics2D 컨텍스트 의 현재의 텍스트 속성 상태를 사용하는 것으로 지정된 String 텍스트를 렌더링 합니다.
abstract void	fill (Shape s) Graphics2D 컨텍스트 의 설정을 사용하는 것으로Shape 내부를 전부 칠합니다.
void	fill3DRect (int x, int y, int width, int height, boolean raised) 현재의 색으로 전부 칠해지고 있는 3D 로 강조 표시된 구형을 페인트 합니다.
abstract Color	getBackground () 영역을 클리어 하는데 사용하는 백그라운드 컬러를 리턴합니다.
abstract Composite	getComposite () Graphics2D 컨텍스트에 서의 현재의 Composite를 리턴합니다.
abstract GraphicsConfiguration	getDeviceConfiguration () 이 Graphics2D에 관련한 디바이스 구성을 리턴합니다.
abstract FontRenderContext	getFontRenderContext () 이 Graphics2D 컨텍스트에 서의 Font 렌더링 컨텍스트를 리턴합니다.
abstract Paint	getPaint () Graphics2D 컨텍스트에 서의 현재의 Paint를 리턴합니다.
abstract Object	getRenderingHint (RenderingHints.Key hintKey) 렌더링 알고리즘의 추천 설정의 값을 1개 리턴합니다.
abstract RenderingHints	getRenderingHints () 렌더링 알고리즘의 추천 설정을 리턴합니다.
abstract Stroke	getStroke () Graphics2D 컨텍스트에 서의 현재의 Stroke를 리턴합니다.
abstract AffineTransform	getTransform () Graphics2D 컨텍스트에 서의 현재의 Transform 복사본을 리턴합니다.
abstract boolean	hit (Rectangle rect, Shape s, boolean onStroke) 지정된 Shape가 지정된 Rectangle (디바이스 공간에 있다)와 교차할지 어떨지를 판정합니다.
abstract void	rotate (double theta) 현재의 Graphics2D Transform를 회전 변환과 연결합니다.
abstract void	rotate (double theta, double x, double y) 현재의 Graphics2D Transform를 이동 후의 회전 변환과 연결합니다.
abstract void	scale (double sx, double sy) 현재의 Graphics2D Transform를 슬캘링 변환과 연결합니다.
abstract void	setBackground (Color color) Graphics2D 컨텍스트 의 백그라운드 컬러를 설정합니다.
abstract void	setComposite (Composite comp) Graphics2D 컨텍스트 의 Composite를 설정합니다.
abstract void	setPaint (Paint paint) Graphics2D 컨텍스트에 Paint 속성을 설정합니다.
abstract void	setRenderingHint (RenderingHints.Key hintKey, Object hintValue) 렌더링 알고리즘의 추천 설정의 값을 1개 설정합니다.
abstract void	setRenderingHints (Map <?,?> hints) 렌더링 알고리즘의 모든 추천 설정의 값을 지정된 hints에 옮겨놓습니다.
abstract void	setStroke (Stroke s) Graphics2D 컨텍스트 의 Stroke를 설정합니다.
abstract void	setTransform (AffineTransform Tx) Graphics2D 컨텍스트 으로 Transform를 덧쓰기합니다.
abstract void	shear (double shx, double shy) 현재의 Graphics2D Transform를 셔링 변환과 연결합니다.
abstract void	transform (AffineTransform Tx) AffineTransform 객체를 이 Graphics2D에 서의 Transform를 사용해, 후 지정 우선 적용이라고 하는 규칙에 따라 변환합니다.
abstract void	translate (double tx, double ty) 현재의 Graphics2D Transform를 이동 변환과 연결합니다.
abstract void	translate (int x, int y) Graphics2D 컨텍스트 의 원점을 현재의 좌표계의 점 (x, y)으로 이동합니다.

클래스 java.awt. Graphics 로부터 상속된 메서드

clearRect, clipRect, copyArea, create, create, dispose, drawArc, drawBytes, drawChars, drawImage, drawImage, drawImage, drawImage, drawImage, drawImage, drawLine, drawOval, drawPolygon, drawPolygon, drawPolyline, drawRect, drawRoundRect, fillArc, fillOval, fillPolygon, fillPolygon, fillRect, fillRoundRect, finalize, getClip, getClipBounds, getClipBounds, getClipRect, getColor, getFont, getFontMetrics, getFontMetrics, hitClip, setClip, setClip, setColor, setFont, setPaintMode, setXORMode, toString

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

생성자 상세

Graphics2D

protected Graphics2D()

새로운 Graphics2D 객체를 구축합니다. Graphics2D는 abstract 클래스이며, 다양한 출력 디바이스를 위해서 서브 클래스에서 커스터마이즈 되지 않으면 안 되기 때문에 Graphics2D 객체를 직접 작성할 수 없습니다. 대신에 다른 Graphics2D 객체로부터 얻는 지, Component에 의해 작성하든가 혹은 BufferedImage 객체등의 이미지로부터 취득하지 않으면 안됩니다.

관련 항목:

Component.getGraphics(), Graphics.create()

메서드의 상세

draw3DRect

public void draw3DRect(int x,
                       int y,
                       int width,
                       int height,
                       boolean raised)

지정된 구형의 윤곽을 3D 로 강조 표시해 렌더링 합니다. 구형의 구석은 경사해, 좌상구석으로부터 빛을 쬔 것처럼 강조 표시됩니다.

강조 표시 효과에 사용되는 색은 현재의 색에 근거해 지정됩니다. 렌더링 된 구형은 폭 width + 1 픽셀, 높이 height + 1 픽셀의 영역을 커버합니다. 이 메서드는 현재의 Color 만을 사용해, 현재의 Paint는 무시합니다.

오버라이드(override):

클래스 Graphics 내의 draw3DRect

파라미터:

x - 렌더링 되는 구형의 x 좌표

y - 렌더링 되는 구형의 y 좌표

width - 렌더링 되는 구형의 폭

height - 렌더링 되는 구형의 높이

raised - 구형이 표면으로부터 떠오른 것처럼 보이는지, 표면에 조각해 붐비어진 것처럼 보이는지를 지정하는 boolean 치

관련 항목:

Graphics.fill3DRect(int, int, int, int, boolean)

fill3DRect

public void fill3DRect(int x,
                       int y,
                       int width,
                       int height,
                       boolean raised)

현재의 색으로 전부 칠해지고 있는 3D 로 강조 표시된 구형을 페인트 합니다. 구형의 구석은 경사해, 좌상구석으로부터 빛을 쬔 것처럼 강조 표시됩니다. 강조 표시 효과 및 전부 칠해에 사용되는 색은 현재의 Color에 의해 지정됩니다. 이 메서드는 현재의 Color 만을 사용해, 현재의 Paint는 무시합니다.

오버라이드(override):

클래스 Graphics 내의 fill3DRect

파라미터:

x - 전부 칠해지는 구형의 x 좌표

y - 전부 칠해지는 구형의 y 좌표

width - 전부 칠해지는 구형의 폭

height - 전부 칠해지는 구형의 높이

raised - 구형이 표면으로부터 떠오른 것처럼 보이는지, 표면에 조각해 붐비어진 것처럼 보이는지를 지정하는 boolean 치

관련 항목:

Graphics.draw3DRect(int, int, int, int, boolean)

draw

public abstract void draw(Shape  s)

현재의 Graphics2D 컨텍스트 의 설정을 사용하는 것으로Shape 윤곽을 stroke로 렌더링 합니다. 적용되는 렌더링 속성에는 Clip, Transform, Paint, Composite 및 Stroke 각 속성이 있습니다.

파라미터:

s - 렌더링 되는 Shape

관련 항목:

setStroke(java.awt.Stroke), setPaint(java.awt.Paint), Graphics.setColor(java.awt.Color), transform(java.awt.geom.AffineTransform), setTransform(java.awt.geom.AffineTransform), clip(java.awt.Shape), Graphics.setClip(int, int, int, int), setComposite(java.awt.Composite)

drawImage

public abstract boolean drawImage(Image  img,
                                  AffineTransform  xform,
                                  ImageObserver  obs)

이미지 공간으로부터 사용자 공간에의 변환을 적용하고 나서, 이미지를 렌더링 합니다. 사용자 공간으로부터 디바이스 공간에의 변환은, Graphics2D에 서의 현재의 Transform에 의해 행해집니다. 지정된 변환은, Graphics2D 컨텍스트 의 변환 속성에 적용되기 전에 이미지에 적용됩니다. 적용되는 렌더링 속성에는 Clip, Transform 및 Composite 각 속성이 있습니다. 다만, 지정된 변환이 역변환을 가지지 않는 경우, 렌더링는 행해지지 않습니다.

파라미터:

img - 렌더링 되는 지정 이미지. img가 null인 경우에는 아무것도 실시하지 않는

xform - 이미지 공간으로부터 사용자 공간에의 변환

obs - Image 것보다 많은 부분이 변환된다고 통지되는 ImageObserver

반환값:

Image가 모두 로드 되어 완전하게 렌더링 되었을 경우는 true, Image가 아직 로드안의 경우는 false

관련 항목:

transform(java.awt.geom.AffineTransform), setTransform(java.awt.geom.AffineTransform), setComposite(java.awt.Composite), clip(java.awt.Shape), Graphics.setClip(int, int, int, int)

drawImage

public abstract void drawImage(BufferedImage  img,
                               BufferedImageOp  op,
                               int x,
                               int y)

BufferedImageOp 로 필터 처리되는 BufferedImage를 렌더링 합니다. 적용되는 렌더링 속성에는 Clip, Transform 및 Composite 각 속성이 있습니다. 이것은 다음의 조작에 상당합니다.

 img1 = op.filter(img, null);
 drawImage(img1, new AffineTransform(1f, 0f, 0f, 1f, x, y), null);
 

파라미터:

op - 렌더링전에 이미지에 적용되는 필터

img - 렌더링 되는 지정 BufferedImage. img가 null인 경우에는 아무것도 실시하지 않는

x - 이미지의 좌상구석이 렌더링 되는 사용자 공간의 위치의 x 좌표

y - 이미지의 좌상구석이 렌더링 되는 사용자 공간의 위치의 y 좌표

관련 항목:

transform(java.awt.geom.AffineTransform), setTransform(java.awt.geom.AffineTransform), setComposite(java.awt.Composite), clip(java.awt.Shape), Graphics.setClip(int, int, int, int)

drawRenderedImage

public abstract void drawRenderedImage(RenderedImage  img,
                                       AffineTransform  xform)

이미지 공간으로부터 사용자 공간에의 변환을 적용하고 나서, RenderedImage를 렌더링 합니다. 사용자 공간으로부터 디바이스 공간에의 변환은, Graphics2D에 서의 현재의 Transform에 의해 행해집니다. 지정된 변환은, Graphics2D 컨텍스트 의 변환 속성에 적용되기 전에 이미지에 적용됩니다. 적용되는 렌더링 속성에는 Clip, Transform 및 Composite 각 속성이 있습니다. 다만, 지정된 변환이 역변환을 가지지 않는 경우, 렌더링는 행해지지 않습니다.

파라미터:

img - 렌더링 되는 이미지. img가 null인 경우에는 아무것도 실시하지 않는

xform - 이미지 공간으로부터 사용자 공간에의 변환

관련 항목:

transform(java.awt.geom.AffineTransform), setTransform(java.awt.geom.AffineTransform), setComposite(java.awt.Composite), clip(java.awt.Shape), Graphics.setClip(int, int, int, int)

drawRenderableImage

public abstract void drawRenderableImage(RenderableImage  img,
                                         AffineTransform  xform)

이미지 공간으로부터 사용자 공간에의 변환을 적용하고 나서, RenderableImage를 렌더링 합니다. 사용자 공간으로부터 디바이스 공간에의 변환은, Graphics2D에 서의 현재의 Transform에 의해 행해집니다. 지정된 변환은, Graphics2D 컨텍스트 의 변환 속성에 적용되기 전에 이미지에 적용됩니다. 적용되는 렌더링 속성에는 Clip, Transform 및 Composite 각 속성이 있습니다. 다만, 지정된 변환이 역변환을 가지지 않는 경우, 렌더링는 행해지지 않습니다.

Graphics2D 객체로 설정된 렌더링 힌트는 RenderableImage 렌더링에 사용할 수 있습니다. 특정의 RenderableImage에 의해 인식된 특정의 힌트에 명시적인 제어가 필요한 경우나, 어느 힌트가 사용될까를 알아 둘 필요가 있는 경우에는 RenderedImage를 RenderableImage로 부터 직접 취득해, (RenderedImage, AffineTransform) drawRenderedImage를 사용해 렌더링 할 필요가 있습니다.

파라미터:

img - 렌더링 되는 이미지. img가 null인 경우에는 아무것도 실시하지 않는

xform - 이미지 공간으로부터 사용자 공간에의 변환

관련 항목:

transform(java.awt.geom.AffineTransform), setTransform(java.awt.geom.AffineTransform), setComposite(java.awt.Composite), clip(java.awt.Shape), Graphics.setClip(int, int, int, int), drawRenderedImage(java.awt.image.RenderedImage, java.awt.geom.AffineTransform)

drawString

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

Graphics2D 컨텍스트 의 현재의 텍스트 속성 상태를 사용하는 것으로 지정된 String 텍스트를 렌더링 합니다. 최초의 문자의 baseline는 사용자 공간의 것 (x, y)에 위치합니다. 적용되는 렌더링 속성에는 Clip, Transform, Paint, Font 및 Composite 각 속성이 있습니다. 헤브라이어나 아라비아어등의 필기 시스템의 문자에서는 그래프는 오른쪽에서 왼쪽으로 렌더링 됩니다. 이 경우 지정된 좌표는 baseline의 좌단의 문자 위치에 있습니다.

정의:

클래스 Graphics 내의 drawString

파라미터:

str - 렌더링 되는 캐릭터 라인

x - String가 렌더링 되는 위치의 x 좌표

y - String가 렌더링 되는 위치의 y 좌표

예외:

NullPointerException - str가 null인 경우

도입된 버전 :

JDK1. 0

관련 항목:

Graphics.drawBytes(byte[], int, int, int, int), Graphics.drawChars(char[], int, int, int, int)

drawString

public abstract void drawString(String  s,
                                float x,
                                float y)

Graphics2D 컨텍스트 의 현재의 텍스트 속성 상태를 사용하는 것으로 특정의 String에 의해 지정된 텍스트를 렌더링 합니다. 최초의 문자의 baseline는 사용자 공간의 것 (x, y)에 위치합니다. 적용되는 렌더링 속성에는 Clip, Transform, Paint, Font 및 Composite 각 속성이 있습니다. 헤브라이어나 아라비아어등의 필기 시스템의 문자에서는 그래프는 오른쪽에서 왼쪽으로 렌더링 됩니다. 이 경우에는 지정된 좌표는 baseline의 좌단의 문자 위치에 있습니다.

파라미터:

s - 렌더링 되는 String

x - String가 렌더링 되는 위치의 x 좌표

y - String가 렌더링 되는 위치의 y 좌표

예외:

NullPointerException - str가 null인 경우

관련 항목:

setPaint(java.awt.Paint), Graphics.setColor(java.awt.Color), Graphics.setFont(java.awt.Font), setTransform(java.awt.geom.AffineTransform), setComposite(java.awt.Composite), Graphics.setClip(int, int, int, int)

drawString

public abstract void drawString(AttributedCharacterIterator  iterator,
                                int x,
                                int y)

Graphics2D 컨텍스트 의 현재의 Paint를 사용하는 것으로 지정된 반복자의 텍스트를 렌더링 합니다. 반복자는 각 문자의 폰트를 지정하지 않으면 안됩니다. 최초의 문자의 baseline는 사용자 공간의 것 (x, y)에 위치합니다. 적용되는 렌더링 속성에는 Clip, Transform, Paint 및 Composite 각 속성이 있습니다. 헤브라이어나 아라비아어등의 필기 시스템의 문자에서는 그래프는 오른쪽에서 왼쪽으로 렌더링 됩니다. 이 경우에는 지정된 좌표는 baseline의 좌단의 문자 위치에 있습니다.

정의:

클래스 Graphics 내의 drawString

파라미터:

iterator - 렌더링 되는 텍스트를 가지는 반복자

x - 반복자의 텍스트가 렌더링 되는 x 좌표

y - 반복자의 텍스트가 렌더링 되는 y 좌표

관련 항목:

setPaint(java.awt.Paint), Graphics.setColor(java.awt.Color), setTransform(java.awt.geom.AffineTransform), setComposite(java.awt.Composite), Graphics.setClip(int, int, int, int)

drawString

public abstract void drawString(AttributedCharacterIterator  iterator,
                                float x,
                                float y)

Graphics2D 컨텍스트 의 현재의 Paint를 사용하는 것으로 지정된 반복자의 텍스트를 렌더링 합니다. 반복자는 각 문자의 폰트를 지정하지 않으면 안됩니다. 최초의 문자의 baseline는 사용자 공간의 것 (x, y)에 위치합니다. 적용되는 렌더링 속성에는 Clip, Transform, Paint 및 Composite 각 속성이 있습니다. 헤브라이어나 아라비아어등의 필기 시스템의 문자에서는 그래프는 오른쪽에서 왼쪽으로 렌더링 됩니다. 이 경우에는 지정된 좌표는 baseline의 좌단의 문자 위치에 있습니다.

파라미터:

iterator - 렌더링 되는 텍스트를 가지는 반복자

x - 반복자의 텍스트가 렌더링 되는 x 좌표

y - 반복자의 텍스트가 렌더링 되는 y 좌표

관련 항목:

setPaint(java.awt.Paint), Graphics.setColor(java.awt.Color), setTransform(java.awt.geom.AffineTransform), setComposite(java.awt.Composite), Graphics.setClip(int, int, int, int)

drawGlyphVector

public abstract void drawGlyphVector(GlyphVector  g,
                                     float x,
                                     float y)

Graphics2D 컨텍스트 의 렌더링 속성을 사용하는 것으로 지정된 GlyphVector 텍스트를 렌더링 합니다. 적용되는 렌더링 속성에는 Clip, Transform, Paint 및 Composite 각 속성이 있습니다. GlyphVector는 개개의 그래프를 Font 로부터 지정합니다. 또, GlyphVector는 그래프 의 위치도 포함할 수 있습니다. 이 메서드를 사용하면, 화면에 일련의 캐릭터 라인을 가장 빠르게 렌더링 할 수 있습니다.

파라미터:

g - 렌더링 되는 GlyphVector

x - 그래프가 렌더링 되는 사용자 공간의 x 위치

y - 그래프가 렌더링 되는 사용자 공간의 y 위치

관련 항목:

Font.createGlyphVector(java.awt.font.FontRenderContext, java.lang.String), GlyphVector, setPaint(java.awt.Paint), Graphics.setColor(java.awt.Color), setTransform(java.awt.geom.AffineTransform), setComposite(java.awt.Composite), Graphics.setClip(int, int, int, int)

fill

public abstract void fill(Shape  s)

Graphics2D 컨텍스트 의 설정을 사용하는 것으로Shape 내부를 전부 칠합니다. 적용되는 렌더링 속성에는 Clip, Transform, Paint 및 Composite 각 속성이 있습니다.

파라미터:

s - 전부 칠해지는 Shape

관련 항목:

setPaint(java.awt.Paint), Graphics.setColor(java.awt.Color), transform(java.awt.geom.AffineTransform), setTransform(java.awt.geom.AffineTransform), setComposite(java.awt.Composite), clip(java.awt.Shape), Graphics.setClip(int, int, int, int)

hit

public abstract boolean hit(Rectangle  rect,
                            Shape  s,
                            boolean onStroke)

지정된 Shape가 지정된 Rectangle (디바이스 공간에 있다)와 교차할지 어떨지를 판정합니다. onStroke가 false인 경우, 이 메서드는 지정된 Shape 내부가 지정된 Rectangle와 교차할지 어떨지를 조사합니다. onStroke가 true인 경우, 이 메서드는 지정된 Shape 윤곽의 Stroke가 지정된 Rectangle와 교차할지 어떨지를 조사합니다. 고려되는 렌더링 속성에는 Clip, Transform 및 Stroke 각 속성이 있습니다.

파라미터:

rect - 히트를 조사하는 디바이스 공간의 영역

s - 히트를 조사하는 Shape

onStroke - stroke로 렌더링 된 형상을 조사할까 전부 칠해진 형상을 조사하는지를 선택하는 플래그. 플래그가 true인 경우는 Stroke 윤곽이 조사할 수 있다. 플래그가 false인 경우는 전부 칠해진 Shape가 조사할 수 있다

반환값:

히트가 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

setStroke(java.awt.Stroke), fill(java.awt.Shape), draw(java.awt.Shape), transform(java.awt.geom.AffineTransform), setTransform(java.awt.geom.AffineTransform), clip(java.awt.Shape), Graphics.setClip(int, int, int, int)

getDeviceConfiguration

public abstract GraphicsConfiguration  getDeviceConfiguration()

이 Graphics2D에 관련한 디바이스 구성을 리턴합니다.

반환값:

이 Graphics2D 속성의 디바이스 구성

setComposite

public abstract void setComposite(Composite  comp)

Graphics2D 컨텍스트 의 Composite를 설정합니다. Composite는 drawImage, drawString, draw 및 fill 등의 모든 렌더링 메서드로 사용됩니다. Composite는 그래픽 디바이스에서의 렌더링 처리중에 새로운 픽셀이 기존의 픽셀과 어떻게 결합되는지를 지정합니다.

이 Graphics2D 컨텍스트이 표시 화면의 Component에 렌더링 되고 있는 경우, Composite는 AlphaComposite 클래스의 인스턴스가 아닌 커스텀 객체입니다. 시큐러티 매니저가 있는 경우는 시큐러티 매니저의 checkPermission 메서드가 접근 권한 AWTPermission("readDisplayPixels")를 지정해 호출합니다.

파라미터:

comp - 렌더링에 사용되는 Composite 객체

예외:

SecurityException - 화면에 렌더링 하기 위해서 커스텀 Composite 객체가 사용되고 있어 시큐러티 매니저가 설정되어 있는 경우에 시큐러티 매니저의 checkPermission 메서드가 이 조작을 허가하지 않을 때

관련 항목:

Graphics.setXORMode(java.awt.Color), Graphics.setPaintMode(), getComposite(), AlphaComposite, SecurityManager.checkPermission(java.security.Permission), AWTPermission

setPaint

public abstract void setPaint(Paint  paint)

Graphics2D 컨텍스트에 Paint 속성을 설정합니다. 이 메서드를 null Paint 객체로 호출해도, 이 Graphics2D 현재의 Paint 속성에는 영향을 주지 않습니다.

파라미터:

paint - 렌더링 프로세스로 색을 생성하기 위해서 사용되는 Paint 객체, 또는 null

관련 항목:

Graphics.setColor(java.awt.Color), getPaint(), GradientPaint, TexturePaint

setStroke

public abstract void setStroke(Stroke  s)

Graphics2D 컨텍스트 의 Stroke를 설정합니다.

파라미터:

s - 렌더링 프로세스로 Shape를 stroke로 렌더링 하기 위해서 사용되는 Stroke 객체

관련 항목:

BasicStroke, getStroke()

setRenderingHint

public abstract void setRenderingHint(RenderingHints.Key  hintKey,
                                      Object  hintValue)

렌더링 알고리즘의 추천 설정의 값을 1개 설정합니다. Hint 카테고리에는 렌더링 품질을 제어하는 것으로 렌더링 프로세스에서의 렌더링 속도와 렌더링 품질과의 전체적인 타협점을 제어하는 것이 포함됩니다. RenderingHints 클래스에서 공통의 키와 값의 정의의 일부를 참조할 수 있습니다.

파라미터:

hintKey - 설정되는 힌트의 키

hintValue - 지정된 힌트 카테고리의 추천 설정을 나타내는 값

관련 항목:

getRenderingHint(RenderingHints.Key), RenderingHints

getRenderingHint

public abstract Object  getRenderingHint(RenderingHints.Key  hintKey)

렌더링 알고리즘의 추천 설정의 값을 1개 리턴합니다. Hint 카테고리에는 렌더링 품질을 제어하는 것으로 렌더링 프로세스에서의 렌더링 속도와 렌더링 품질과의 전체적인 타협점을 제어하는 것이 포함됩니다. RenderingHints 클래스에서 공통의 키와 값의 정의의 일부를 참조할 수 있습니다.

파라미터:

hintKey - 얻는 힌트에 대응하는 키

반환값:

지정된 힌트 키의 값을 나타내는 객체. 몇개의 키와 그 키에 관련한 값은 RenderingHints 클래스에서 정의되고 있는

관련 항목:

RenderingHints, setRenderingHint(RenderingHints.Key, Object)

setRenderingHints

public abstract void setRenderingHints(Map <?,?> hints)

렌더링 알고리즘의 모든 추천 설정의 값을 지정된 hints에 옮겨놓습니다. 렌더링 힌트의 기존의 값은 모두 파기되어 기존의 힌트와 값의 새로운 세트가 지정된 Map 객체로부터 초기화됩니다. Hint 카테고리에는 렌더링 품질을 제어하는 것으로 렌더링 프로세스에서의 렌더링 속도와 렌더링 품질과의 전체적인 타협점을 제어하는 것이 포함됩니다. RenderingHints 클래스에서 공통의 키와 값의 정의의 일부를 참조할 수 있습니다.

파라미터:

hints - 설정되는 렌더링 힌트

관련 항목:

getRenderingHints(), RenderingHints

addRenderingHints

public abstract void addRenderingHints(Map <?,?> hints)

렌더링 알고리즘에 관한 임의의 수의 추천 설정의 값을 설정합니다. 지정된 Map 객체에 있는 렌더링 힌트의 값만이 변경됩니다. 지정된 객체에 없는 추천 설정은 변경되지 않습니다. Hint 카테고리에는 렌더링 품질을 제어하는 것으로 렌더링 프로세스에서의 렌더링 속도와 렌더링 품질과의 전체적인 타협점을 제어하는 것이 포함됩니다. RenderingHints 클래스에서 공통의 키와 값의 정의의 일부를 참조할 수 있습니다.

파라미터:

hints - 설정되는 렌더링 힌트

관련 항목:

RenderingHints

getRenderingHints

public abstract RenderingHints  getRenderingHints()

렌더링 알고리즘의 추천 설정을 리턴합니다. Hint 카테고리에는 렌더링 품질을 제어하는 것으로 렌더링 프로세스에서의 렌더링 속도와 렌더링 품질과의 전체적인 타협점을 제어하는 것이 포함됩니다. 1회 의 오퍼레이션으로 지정된 모든 힌트 키와 값의 페어를 리턴합니다. RenderingHints 클래스에서 공통의 키와 값의 정의의 일부를 참조할 수 있습니다.

반환값:

현재의 추천 설정을 포함하고 있는 RenderingHints 인스턴스에의 참조

관련 항목:

RenderingHints, setRenderingHints(Map)

translate

public abstract void translate(int x,
                               int y)

Graphics2D 컨텍스트 의 원점을 현재의 좌표계의 점 (x, y)으로 이동합니다. Graphics2D 컨텍스트를 수정해, 새로운 원점이 Graphics2D 컨텍스트 의 원의 좌표계의 점 (x, y)에 대응하도록 합니다. 이 그래픽 컨텍스트 으로 그 이후의 렌더링 조작으로 사용되는 좌표는 모두, 이 새로운 원점을 기준으로 합니다.

정의:

클래스 Graphics 내의 translate

파라미터:

x - 지정된 x 좌표

y - 지정된 y 좌표

도입된 버전 :

JDK1. 0

translate

public abstract void translate(double tx,
                               double ty)

현재의 Graphics2D Transform를 이동 변환과 연결합니다. 이후의 렌더링는 이전의 위치를 기준으로 지정된 거리로 이동합니다. 이것은 transform(T)를 호출하는 것에 상당합니다. 다만, T는 다음의 행렬에 의해 표현되는 AffineTransform 입니다.

                [   1    0    tx  ]
                [   0    1    ty  ]
                [   0    0    1   ]
 

파라미터:

tx - x 축으로 따라 이동하는 거리

ty - y 축으로 따라 이동하는 거리

rotate

public abstract void rotate(double theta)

현재의 Graphics2D Transform를 회전 변환과 연결합니다. 이후의 렌더링는 이전의 원점을 기준으로 지정된 라디안으로 회전합니다. 이것은, transform(R)를 호출하는 것에 상당합니다. 다만, R는 다음의 행렬에 의해 표현되는 AffineTransform 입니다.

                [   cos(theta)    -sin(theta)    0   ]
                [   sin(theta)     cos(theta)    0   ]
                [       0              0         1   ]
 

정의 각도 theta 로 회전하면, 정의 x 축의 점이 정의 y 축으로 향해 회전됩니다.

파라미터:

theta - 라디안으로 나타낸 회전 각도

rotate

public abstract void rotate(double theta,
                            double x,
                            double y)

현재의 Graphics2D Transform를 이동 후의 회전 변환과 연결합니다. 이후의 렌더링는 지정된 위치로 이동해, 지정된 라디안으로 회전해, 원의 평행이동과 같은 양으로 평행이동 다시 하는 것으로 작성되는 변환에 의해 변환됩니다. 이것은 다음의 calling sequence에 상당합니다.

                translate(x, y);
                rotate(theta);
                translate(-x, -y);
 

정의 각도 theta 로 회전하면, 정의 x 축의 점이 정의 y 축으로 향해 회전됩니다.

파라미터:

theta - 라디안으로 나타낸 회전 각도

x - 회전의 원점의 x 좌표

y - 회전의 원점의 y 좌표

scale

public abstract void scale(double sx,
                           double sy)

현재의 Graphics2D Transform를 슬캘링 변환과 연결합니다. 이후의 렌더링는 이전의 슬캘링을 기준으로 지정된 슬캘링 계수에 따라 사이즈 변경됩니다. 이것은, transform(S)를 호출하는 것에 상당합니다. 다만, S는 다음의 행렬에 의해 표현되는 AffineTransform 입니다.

                [   sx   0    0   ]
                [   0    sy   0   ]
                [   0    0    1   ]
 

파라미터:

sx - 이후의 렌더링 조작의 X 좌표가 이전의 렌더링 조작을 기준에 곱셈되는 양

sy - 이후의 렌더링 조작의 Y 좌표가 이전의 렌더링 조작을 기준에 곱셈되는 양

shear

public abstract void shear(double shx,
                           double shy)

현재의 Graphics2D Transform를 셔링 변환과 연결합니다. 이후의 렌더링는 이전의 위치를 기준으로 지정된 승수로 셔링 됩니다. 이것은, transform(SH)를 호출하는 것에 상당합니다. 다만, SH는 다음의 행렬에 의해 표현되는 AffineTransform 입니다.

                [   1   shx   0   ]
                [  shy   1    0   ]
                [   0    0    1   ]
 

파라미터:

shx - Y 좌표의 함수로서 좌표를 정의 X 축방향으로 쉬프트하기 위한 승수

shy - X 좌표의 함수로서 좌표를 정의 Y 축방향으로 쉬프트하기 위한 승수

transform

public abstract void transform(AffineTransform  Tx)

AffineTransform 객체를 이 Graphics2D에 서의 Transform를 사용해, 후 지정 우선 적용이라고 하는 규칙에 따라 변환합니다. 현재의 Transform가 Cx 인 경우, Tx 에 한 변환의 결과는 새로운 Transform Cx'가 됩니다. Cx'는 이 Graphics2D용의 현재의 Transform가 됩니다. 갱신된 Transform Cx'로 점 p를 변환하는 것은 최초로 Tx 로 p를 변환하고 나서, 그 결과를 원의 Transform Cx 로 변환하는 것에 상당합니다. 즉, Cx'(p) = Cx(Tx(p))입니다. 필요에 따라서 Tx 복사본을 실시하면, Tx를 그 이상 수정해도 렌더링에 영향을 주지 않습니다.

파라미터:

Tx - 현재의 Transform로 변환되는 AffineTransform 객체

관련 항목:

setTransform(java.awt.geom.AffineTransform), AffineTransform

setTransform

public abstract void setTransform(AffineTransform  Tx)

Graphics2D 컨텍스트 으로 Transform를 덧쓰기합니다. 경고: 이 메서드는 새로운 좌표변화를 기존의 변환상에서 적용하는 목적에서는 사용하지 말아 주세요. 이것은, Graphics2D에는 Swing 컴퍼넌트의 렌더링 또는 프린터의 해상도를 조정하기 위한 슬캘링 변환의 적용 등, 다른 목적을 위해서 필요한 변환이 이미 포함되어 있기 때문입니다.

좌표변화를 추가하기 위해서 transform, rotate, scale, 또는shear 메서드를 사용합니다. setTransform는 이 예로 나타나고 있는 대로 렌더링 종료후에 원의 Graphics2D 변환을 복원하기 때문에인 만큼 사용됩니다.

 // Get the current transform
 AffineTransform saveAT = g2.getTransform();
 // Perform transformation
 g2d.transform(...);
 // Render
 g2d.draw(...);
 // Restore original transform
 g2d.setTransform(saveAT);
 

파라미터:

Tx - getTransform 메서드로부터 취득된 AffineTransform

관련 항목:

transform(java.awt.geom.AffineTransform), getTransform(), AffineTransform

getTransform

public abstract AffineTransform  getTransform()

Graphics2D 컨텍스트에 서의 현재의 Transform 복사본을 리턴합니다.

반환값:

Graphics2D 컨텍스트에 서의 현재의 AffineTransform

관련 항목:

transform(java.awt.geom.AffineTransform), setTransform(java.awt.geom.AffineTransform)

getPaint

public abstract Paint  getPaint()

Graphics2D 컨텍스트에 서의 현재의 Paint를 리턴합니다.

반환값:

색 또는 패턴을 정의하는 현재의 Graphics2D Paint

관련 항목:

setPaint(java.awt.Paint), Graphics.setColor(java.awt.Color)

getComposite

public abstract Composite  getComposite()

Graphics2D 컨텍스트에 서의 현재의 Composite를 리턴합니다.

반환값:

거듭해 맞댐 스타일을 정의하는 현재의 Graphics2D Composite

관련 항목:

setComposite(java.awt.Composite)

setBackground

public abstract void setBackground(Color  color)

Graphics2D 컨텍스트 의 백그라운드 컬러를 설정합니다. 백그라운드 컬러는 영역을 클리어 하기 위해서 사용됩니다. Graphics2D를 Component 용으로 작성하면, 백그라운드 컬러가 Component로 부터 상속됩니다. Graphics2D 컨텍스트에 서의 백그라운드 컬러를 설정해도, 그 이후의 clearRect() 호출해에 작용하는 것만으로Component 백그라운드 컬러에는 영향을 미치지 않습니다. Component 백그라운드를 변경하려면, Component 적절한 메서드를 사용합니다.

파라미터:

color - 이후의 clearRect() 호출로 사용되는 백그라운드 컬러

관련 항목:

getBackground(), Graphics.clearRect(int, int, int, int)

getBackground

public abstract Color  getBackground()

영역을 클리어 하는데 사용하는 백그라운드 컬러를 리턴합니다.

반환값:

백그라운드 컬러를 정의하는 현재의 Graphics2D Color

관련 항목:

setBackground(java.awt.Color)

getStroke

public abstract Stroke  getStroke()

Graphics2D 컨텍스트에 서의 현재의 Stroke를 리턴합니다.

반환값:

선의 스타일을 정의하는 현재의 Graphics2D Stroke

관련 항목:

setStroke(java.awt.Stroke)

clip

public abstract void clip(Shape  s)

현재의 Clip가 지정된 Shape 내부와 교차시켜, 결과적으로 생긴 공통 부분에 그 Clip를 설정합니다. 지정된 Shape는 현재의 Clip와 교차하기 전에 현재의 Graphics2D Transform를 사용해 변환됩니다. 이 메서드를 사용하면, 현재의 Clip를 작게 할 수 있습니다. Clip를 크게 하려면, setClip 메서드를 사용합니다. 이 메서드에 의해 변경된 사용자 클립은 디바이스의 경계 및 가시성과 관련한 클리핑과는 무관계합니다. 지금까지 설정되어 있는 클립이 없는 경우, 또는 setClip에 null인수를 사용해 클립이 클리어 되고 있는 경우는 지정된 Shape가 새로운 사용자 클립이 됩니다.

파라미터:

s - 현재의 Clip와 교차하는 Shape. s가 null인 경우, 이 메서드는 현재의 Clip를 클리어 한다

getFontRenderContext

public abstract FontRenderContext  getFontRenderContext()

이 Graphics2D 컨텍스트에 서의 Font 렌더링 컨텍스트를 리턴합니다. FontRenderContext 는 에일리어징 제거나 부분 메트릭스등의 어플리케이션 힌트외, 타겟 디바이스에 특유의 해상도 (dpi)등의 정보를 캡슐화합니다. 이러한 정보는 Font 나 TextLayout 등의 문자 체재의 포맷을 실행하는 객체의 사용시에 어플리케이션에 의해 제공됩니다. 이 정보는 또, 각종 렌더링 힌트가 텍스트 렌더링에 적용되었을 때에 그 자체의 레이아웃을 실행해, 유효폭이나 행의 높이 등, 그래프 의 각종 특성의 정확한 파악을 필요로 하는 어플리케이션에 의해 제공되지 않으면 안됩니다.

반환값:

FontRenderContext 인스턴스에의 참조

도입된 버전 :

1.2

관련 항목:

FontRenderContext, Font.createGlyphVector(java.awt.font.FontRenderContext, java.lang.String), TextLayout