java.awt
클래스 GraphicsConfiguration

java.lang.Object 
  java.awt.GraphicsConfiguration

public abstract class GraphicsConfiguration
extends Object 

GraphicsConfiguration 클래스는 프린터 또는 모니터등의 그래픽 목적지의 특성을 기술합니다. 1개의 그래픽 디바이스에는 다른 렌더링 모드 또는 기능을 나타내는 많은 관련된 GraphicsConfiguration가 있습니다. 대응하는 네이티브 구조는 플랫폼간에 다릅니다. 예를 들어 X11 윈도우 시스템에서는 각 표시는 각각 다른 GraphicsConfiguration 입니다. Microsoft Windows 에서는 GraphicsConfiguration는 현재의 해상도와 색심도로 사용할 수 있는 PixelFormats를 표시합니다.

데스크탑 영역이 물리적으로 복수의 화면 디바이스에 걸치는 가상 디바이스의 멀티스크린 환경에서는 GraphicsConfiguration 객체의 경계는 가상의 좌표계를 기준으로 하고 있습니다. 컴퍼넌트의 위치를 설정하는 경우는 다음의 코드 샘플로 가리키도록, getBounds를 사용해 목적의 GraphicsConfiguration 경계를 취득해, GraphicsConfiguration 좌표와의 위치를 오프셋(offset) 합니다.

      Frame f = new Frame(gc);  // where gc is a GraphicsConfiguration
      Rectangle bounds = gc.getBounds();
      f.setLocation(10 + bounds.x, 10 + bounds.y); 

환경이 가상 디바이스 환경인가 어떤가를 판정하려면, 시스템에 있는 모든 GraphicsConfiguration 객체로 getBounds를 호출합니다. 리턴된 경계의 원점의 어떤 것인가가 (0, 0) 이외이면, 환경은 가상 디바이스 환경입니다.

getBounds를 사용해 가상 디바이스의 경계도 판정할 수 있습니다. 이렇게 하려면, 우선 시스템에 있는 모든 GraphicsConfiguration 객체로 getBounds를 호출합니다. 계속되어, getBounds 호출로부터 리턴된 경계의 모든 화집합을 계산합니다. 화집합이 가상 디바이스의 경계입니다. 다음의 코드 샘플은 가상 디바이스의 경계를 계산한 것입니다.

      Rectangle virtualBounds = new Rectangle();
      GraphicsEnvironment ge = GraphicsEnvironment.
              getLocalGraphicsEnvironment();
      GraphicsDevice[] gs =
              ge.getScreenDevices();
      for (int j = 0; j < gs.length; j++) { 
          GraphicsDevice gd = gs[j];
          GraphicsConfiguration[] gc =
              gd.getConfigurations();
          for (int i=0; i < gc.length; i++) {
              virtualBounds =
                  virtualBounds.union(gc[i]. getBounds());
          }
      } 

관련 항목:

Window, Frame, GraphicsEnvironment, GraphicsDevice

생성자 개요

protected

GraphicsConfiguration () 인스턴스를 직접 생성할 수 없는 abstract 클래스입니다.

메서드 개요

abstract BufferedImage	createCompatibleImage (int width, int height) 이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃과 컬러 모델을 가지는 BufferedImage를 리턴합니다.
abstract BufferedImage	createCompatibleImage (int width, int height, int transparency) 지정된 투명도를 지원해, 이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃 및 컬러 모델을 가지는 BufferedImage를 리턴합니다.
abstract VolatileImage	createCompatibleVolatileImage (int width, int height) 이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃과 컬러 모델을 가지는 VolatileImage를 리턴합니다.
VolatileImage	createCompatibleVolatileImage (int width, int height, ImageCapabilities caps) 지정된 이미지 기능을 사용해, 이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃과 컬러 모델을 가지는 VolatileImage를 리턴합니다.
VolatileImage	createCompatibleVolatileImage (int width, int height, ImageCapabilities caps, int transparency) 지정된 이미지 기능과 투명도의 값을 사용해, 이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃과 컬러 모델을 가지는 VolatileImage를 리턴합니다.
abstract VolatileImage	createCompatibleVolatileImage (int width, int height, int transparency) 이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃과 컬러 모델을 가지는 VolatileImage를 리턴합니다.
abstract Rectangle	getBounds () 디바이스의 좌표의 GraphicsConfiguration 경계를 리턴합니다.
BufferCapabilities	getBufferCapabilities () 이 GraphicsConfiguration 버퍼링 기능을 리턴합니다.
abstract ColorModel	getColorModel () 이 GraphicsConfiguration에 관련한 ColorModel를 리턴합니다.
abstract ColorModel	getColorModel (int transparency) 지정된 투명도를 지원해, 이 GraphicsConfiguration에 관련한 ColorModel을 리턴합니다.
abstract AffineTransform	getDefaultTransform () 이 GraphicsConfiguration 디폴트 AffineTransform를 리턴합니다.
abstract GraphicsDevice	getDevice () 이 GraphicsConfiguration에 관련한 디폴트 GraphicsDevice를 리턴합니다.
ImageCapabilities	getImageCapabilities () 이 GraphicsConfiguration 이미지 기능을 리턴합니다.
abstract AffineTransform	getNormalizingTransform () 사용자 공간의 72 단위가 디바이스 공간의 1 인치에 상당하도록, GraphicsConfiguration 디폴트 AffineTransform 과 연결할 수 있는 AffineTransform를 리턴합니다.

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

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

생성자 상세

GraphicsConfiguration

protected GraphicsConfiguration()

인스턴스를 직접 생성할 수 없는 abstract 클래스입니다. 인스턴스는 적절한 팩토리 메서드나 쿼리메서드로부터 취득할 필요가 있습니다.

관련 항목:

GraphicsDevice.getConfigurations(), GraphicsDevice.getDefaultConfiguration(), GraphicsDevice.getBestConfiguration(java.awt.GraphicsConfigTemplate), Graphics2D.getDeviceConfiguration()

메서드의 상세

getDevice

public abstract GraphicsDevice  getDevice()

이 GraphicsConfiguration에 관련한 디폴트 GraphicsDevice를 리턴합니다.

반환값:

이 GraphicsConfiguration에 관련한 GraphicsDevice 객체

createCompatibleImage

public abstract BufferedImage  createCompatibleImage(int width,
                                                    int height)

이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃과 컬러 모델을 가지는 BufferedImage를 리턴합니다. 이 메서드는 디바이스를 메모리맙핑 하는 것으로는 무관계합니다. 리턴된 BufferedImage는 이 네이티브의 디바이스 구성에 가장 가까운 레이아웃 및 컬러 모델을 가지고 있기 때문에 이 디바이스에 최적으로 소총탄 할 수 있습니다.

파라미터:

width - 리턴된 BufferedImage 폭

height - 리턴된 BufferedImage 높이

반환값:

데이터 레이아웃과 컬러 모델이 이 GraphicsConfiguration와 호환성이 있는 BufferedImage

createCompatibleVolatileImage

public abstract VolatileImage  createCompatibleVolatileImage(int width,
                                                            int height)

이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃과 컬러 모델을 가지는 VolatileImage를 리턴합니다. 리턴된 VolatileImage는 바탕으로 되는 그래픽 디바이스에 대해서 최적으로 되도록 포함된 데이터를 가지고 있으므로 플랫폼에 고유의 렌더링 속도의 향상에 도움이 됩니다.

파라미터:

width - 리턴된 VolatileImage 폭

height - 리턴된 VolatileImage 높이

반환값:

데이터 레이아웃과 컬러 모델이 이 GraphicsConfiguration와 호환성이 있는 VolatileImage

관련 항목:

Component.createVolatileImage(int, int)

createCompatibleVolatileImage

public abstract VolatileImage  createCompatibleVolatileImage(int width,
                                                            int height,
                                                            int transparency)

이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃과 컬러 모델을 가지는 VolatileImage를 리턴합니다. 리턴된 VolatileImage는 바탕으로 되는 그래픽 디바이스에 대해서 최적으로 되도록 포함된 데이터를 가지고 있으므로 플랫폼에 고유의 렌더링 속도의 향상에 도움이 됩니다.

파라미터:

width - 리턴된 VolatileImage 폭

height - 리턴된 VolatileImage 높이

transparency - 지정된 투명도 모드

반환값:

데이터 레이아웃과 컬러 모델이 이 GraphicsConfiguration와 호환성이 있는 VolatileImage

예외:

IllegalArgumentException - 투명도가 유효한 값이 아닌 경우

도입된 버전 :

1.5

관련 항목:

Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT, Component.createVolatileImage(int, int)

createCompatibleVolatileImage

public VolatileImage  createCompatibleVolatileImage(int width,
                                                   int height,
                                                   ImageCapabilities  caps)
                                            throws AWTException 

지정된 이미지 기능을 사용해, 이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃과 컬러 모델을 가지는 VolatileImage를 리턴합니다. 리턴된 VolatileImage는 이 네이티브의 디바이스 구성에 가장 가까운 레이아웃 및 컬러 모델을 가지고 있기 때문에 이 디바이스에 최적으로 소총탄 할 수 있습니다.

파라미터:

width - 리턴된 VolatileImage 폭

height - 리턴된 VolatileImage 높이

caps - 이미지 기능

반환값:

데이터 레이아웃과 컬러 모델이 이 GraphicsConfiguration와 호환성이 있는 VolatileImage

예외:

AWTException - 지정된 이미지 기능이 이 그래픽 구성에 일치하지 않았던 경우

도입된 버전 :

1.4

createCompatibleVolatileImage

public VolatileImage  createCompatibleVolatileImage(int width,
                                                   int height,
                                                   ImageCapabilities  caps,
                                                   int transparency)
                                            throws AWTException 

지정된 이미지 기능과 투명도의 값을 사용해, 이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃과 컬러 모델을 가지는 VolatileImage를 리턴합니다. 리턴된 VolatileImage는 이 네이티브의 디바이스 구성에 가장 가까운 레이아웃 및 컬러 모델을 가지고 있기 때문에 이 디바이스에 최적으로 소총탄 할 수 있습니다.

파라미터:

width - 리턴된 VolatileImage 폭

height - 리턴된 VolatileImage 높이

caps - 이미지 기능

transparency - 지정된 투명도 모드

반환값:

데이터 레이아웃과 컬러 모델이 이 GraphicsConfiguration와 호환성이 있는 VolatileImage

예외:

IllegalArgumentException - 투명도가 유효한 값이 아닌 경우

AWTException - 지정된 이미지 기능이 이 그래픽 구성에 일치하지 않았던 경우

도입된 버전 :

1.5

관련 항목:

Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT, Component.createVolatileImage(int, int)

createCompatibleImage

public abstract BufferedImage  createCompatibleImage(int width,
                                                    int height,
                                                    int transparency)

지정된 투명도를 지원해, 이 GraphicsConfiguration와 호환성이 있는 데이터 레이아웃 및 컬러 모델을 가지는 BufferedImage를 리턴합니다. 이 메서드는 디바이스를 메모리맙핑 하는 것으로는 무관계합니다. 리턴된 BufferedImage는 이 GraphicsConfiguration을 가지는 디바이스에 최적으로 소총탄 할 수 있는 레이아웃 및 컬러 모델을 가집니다.

파라미터:

width - 리턴된 BufferedImage 폭

height - 리턴된 BufferedImage 높이

transparency - 지정된 투명도 모드

반환값:

데이터 레이아웃과 컬러 모델이 이 GraphicsConfiguration와 호환성이 있어, 지정된 투명도를 지원하는 BufferedImage

예외:

IllegalArgumentException - 투명도가 유효한 값이 아닌 경우

관련 항목:

Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT

getColorModel

public abstract ColorModel  getColorModel()

이 GraphicsConfiguration에 관련한 ColorModel를 리턴합니다.

반환값:

이 GraphicsConfiguration에 관련한 ColorModel 객체

getColorModel

public abstract ColorModel  getColorModel(int transparency)

지정된 투명도를 지원해, 이 GraphicsConfiguration에 관련한 ColorModel을 리턴합니다.

파라미터:

transparency - 지정된 투명도 모드

반환값:

이 GraphicsConfiguration에 관련지을 수 있어 지정된 투명도의 값을 지원하는 ColorModel 객체, 또는 투명도가 유효한 값이 아닌 경우는 null

관련 항목:

Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT

getDefaultTransform

public abstract AffineTransform  getDefaultTransform()

이 GraphicsConfiguration 디폴트 AffineTransform를 리턴합니다. 이 AffineTransform는 보통, 최표준의 화면에 대한 항등변환입니다. 디폴트의 AffineTransform는 72 사용자 공간 좌표 단위가 디바이스 공간의 대략 1 인치에 대응하도록 디바이스에 좌표를 매핑 합니다. 정규화 변환을 사용하면, 이 매핑을 보다 정확하게 할 수 있습니다 . 화면 디바이스와 프린터 디바이스의 디폴트의 AffineTransform 으로 정의되고 있는 좌표 공간의 좌표는 디바이스의 타겟 영역의 좌상구석에 원점을 가져, X 좌표는 우측향에 Y 좌표는 아래방향에 값이 증가합니다. createCompatibleImage로 작성되지 않는 디바이스에 관련하고 있지 않는 이미지 버퍼등으로는 이 AffineTransform는 항등변환이 됩니다.

반환값:

이 GraphicsConfiguration 디폴트의 AffineTransform

getNormalizingTransform

public abstract AffineTransform  getNormalizingTransform()

사용자 공간의 72 단위가 디바이스 공간의 1 인치에 상당하도록, GraphicsConfiguration 디폴트 AffineTransform 과 연결할 수 있는 AffineTransform를 리턴합니다.

특정 Graphics2D 에서는 다음의 사 코드를 사용해 변환을 리셋 해, 이러한 매핑을 작성할 수 있습니다.

      GraphicsConfiguration gc = g.getGraphicsConfiguration();

      g.setTransform(gc.getDefaultTransform());
      g.transform(gc.getNormalizingTransform());
 

다만, 이 AffineTransform는인 경우에의해 예를 들어 프린터 출력이나 메타파일 출력의 경우에 항등변환이 되어, 그 정확함은 바탕으로 있는 시스템에 의해 지정되는 정보와 같은 정도가 됩니다. createCompatibleImage에에 서는 작성되지 않는 것 같은 디바이스에 관련하고 있지 않는 이미지 버퍼등으로는 유효한 거리 측정법이 없기 위해, 이 AffineTransform는 항등변환이 됩니다.

반환값:

사용자 공간의 72 단위가 디바이스 공간의 1 인치에 상당하도록, 디폴트의 AffineTransform에 연결하는 AffineTransform

getBounds

public abstract Rectangle  getBounds()

디바이스의 좌표의 GraphicsConfiguration 경계를 리턴합니다. 가상 디바이스를 가지는 멀티스크린 환경에서는 경계는 부의 X 또는 Y 원점을 가질 수가 있습니다.

반환값:

이 GraphicsConfiguration에 의해 커버되는 영역의 경계

도입된 버전 :

1.3

getBufferCapabilities

public BufferCapabilities  getBufferCapabilities()

이 GraphicsConfiguration 버퍼링 기능을 리턴합니다.

반환값:

이 그래픽 구성 객체의 버퍼링 기능

도입된 버전 :

1.4

getImageCapabilities

public ImageCapabilities  getImageCapabilities()

이 GraphicsConfiguration 이미지 기능을 리턴합니다.

반환값:

이 그래픽 구성 객체의 이미지 기능

도입된 버전 :

1.4