java.awt
클래스 GraphicsConfiguration

java.lang.Object 
  |
  +--java.awt.GraphicsConfiguration

public abstract class GraphicsConfiguration

extends Object

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

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

      Frame f = new Frame(GraphicsConfiguration gc);
      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 를 돌려줍니다.
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 는 이 네이티브의 디바이스 구성에 가장 가까운 레이아웃 및 칼라 모델을 가지고 있으므로, 이 디바이스에 최적으로 Blit 할 수 있습니다.

파라미터:

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 VolatileImage  createCompatibleVolatileImage(int width,
                                                   int height,
                                                   ImageCapabilities  caps)
                                            throws AWTException 

지정된 이미지 기능을 사용해, 이 GraphicsConfiguration 와 호환성이 있는 데이터 레이아웃과 칼라 모델을 가지는 VolatileImage 를 돌려줍니다. 돌려주어지는 VolatileImage 는 이 네이티브의 디바이스 구성에 가장 가까운 레이아웃 및 칼라 모델을 가지고 있으므로, 이 디바이스에 최적으로 Blit 할 수 있습니다.

파라미터:

width - 돌려주어지는 VolatileImage 의 폭

height - 돌려주어지는 VolatileImage 의 높이

caps - 이미지 기능

반환값:

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

예외:

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

도입된 버젼:

1.4

createCompatibleImage

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

지정된 투명도를 서포트해, 이 GraphicsConfiguration 와 호환성이 있는 데이터 레이아웃 및 칼라 모델을 가지는 BufferedImage 를 돌려줍니다. 이 메소드는 디바이스를 메모리맙핑 하는 것으로는 무관계합니다. 돌려주어지는 BufferedImage 는 이 GraphicsConfiguration 를 가지는 디바이스에 최적으로 Blit 할 수 있는 레이아웃 및 칼라 모델을 가집니다.

파라미터:

width - 돌려주어지는 BufferedImage 의 폭

height - 돌려주어지는 BufferedImage 의 높이

transparency - 지정된 투명도 모드

반환값:

데이터 레이아웃과 칼라 모델이 이 GraphicsConfiguration 와 호환성이 있어, 지정된 투명도를 서포트하는 BufferedImage

관련 항목:

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 오브젝트

getDefaultTransform

public abstract AffineTransform  getDefaultTransform()

이 GraphicsConfiguration 의 디폴트의 AffineTransform 를 돌려줍니다. 이 AffineTransform 는 통상, 최표준의 화면에 대한 항등변환입니다. 디폴트의 AffineTransform 는 72 유저 공간 좌표 단위가 디바이스 공간의 대략 1 인치에 대응하도록(듯이) 디바이스에 좌표를 매핑 합니다. 정규화 변환을 사용하면(자), 이 매핑을 보다 정확하게 할 수가 있습니다. 화면 디바이스와 프린터 디바이스의 디폴트의 AffineTransform 으로 정의되고 있는 좌표 공간의 좌표는 디바이스의 타겟 area의 좌상구석에 원점을 가져, 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 에 의해 커버되는 area의 경계

도입된 버젼:

1.3

getBufferCapabilities

public BufferCapabilities  getBufferCapabilities()

이 GraphicsConfiguration 의 버퍼링 기능을 돌려줍니다.

반환값:

이 그래픽스 구성 오브젝트의 버퍼링 기능

도입된 버젼:

1.4

getImageCapabilities

public ImageCapabilities  getImageCapabilities()

이 GraphicsConfiguration 의 이미지 기능을 돌려줍니다.

반환값:

이 그래픽스 구성 오브젝트의 이미지 기능

도입된 버젼:

1.4