GraphicsConfiguration (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

## java.awt
클래스 GraphicsConfiguration

    java.lang.Object
      java.awt.GraphicsConfiguration

    public abstract class GraphicsConfiguration

extends Object

`GraphicsConfiguration` 클래스는 프린터 또는 모니터등의 그래픽스 목적지의 특성을 기술합니다. 1 개의 그래픽스 디바이스에는, 다른 draw 모드 또는 기능을 나타내는 많은 관련하는 `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` 를 돌려줍니다.
`BufferedImage` | `createCompatibleImage (int width, int height, int transparency)` 지정된 투명도를 지원해, 이 `GraphicsConfiguration` 와 호환성이 있는 데이터 레이아웃 및 칼라 모델을 가지는 `BufferedImage` 를 돌려줍니다.
`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` 를 돌려줍니다.
`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`

### createCompatibleImage

    public 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`

### createCompatibleVolatileImage

    public VolatileImage  createCompatibleVolatileImage(int width,
                                                       int height)

  이 `GraphicsConfiguration` 와 호환성이 있는 데이터 레이아웃과 칼라 모델을 가지는 `VolatileImage` 를 돌려줍니다. 반환된 `VolatileImage` 는, 바탕으로 되는 그래픽 디바이스에 대해서 최적으로 되도록(듯이) 포함된 데이터를 가지고 있으므로, 플랫폼에 고유의 draw 속도의 향상에 도움이 됩니다.

  파라미터:
    `width` - 반환되는 `VolatileImage` 의 폭
    `height` - 반환되는 `VolatileImage` 의 높이
  반환값:
    데이터 레이아웃과 칼라 모델이 이 `GraphicsConfiguration` 와 호환성이 있는 `VolatileImage`
  도입된 버젼:
    1.4
  관련 항목:
    `Component.createVolatileImage(int, int)`

### createCompatibleVolatileImage

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

  이 `GraphicsConfiguration` 와 호환성이 있는 데이터 레이아웃과 칼라 모델을 가지는 `VolatileImage` 를 돌려줍니다. 반환된 `VolatileImage` 는, 바탕으로 되는 그래픽 디바이스에 대해서 최적으로 되도록(듯이) 포함된 데이터를 가지고 있으므로, 플랫폼에 고유의 draw 속도의 향상에 도움이 됩니다.

  파라미터:
    `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` 를 돌려줍니다. `caps` 파라미터가 null 인 경우, 이 파라미터는 실질적으로 무시되어 이 메소드에 의해 `ImageCapabilities` 제약과는 관계없이 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` 를 돌려줍니다. `caps` 파라미터가 null 인 경우, 이 파라미터는 실질적으로 무시되어 이 메소드에 의해 `ImageCapabilities` 제약과는 관계없이 VolatileImage 가 작성됩니다. 반환되는 `VolatileImage` 는, 이 네이티브의 디바이스 구성에 가장 가까운 레이아웃 및 칼라 모델을 가지고 있기 (위해)때문에, 이 디바이스에 최적으로 소총탄 할 수 있습니다.

  파라미터:
    `width` - 반환되는 `VolatileImage` 의 폭
    `height` - 반환되는 `VolatileImage` 의 높이
    `caps` - 이미지 기능
    `transparency` - 지정된 투명도 모드
  반환값:
    데이터 레이아웃과 칼라 모델이 이 `GraphicsConfiguration` 와 호환성이 있는 `VolatileImage`
  예외:
    `IllegalArgumentException` - 투명도가 유효한 값이 아닌 경우
    `AWTException` - 지정된 이미지 기능이 이 그래픽스 구성에 일치하지 않았던 경우
  도입된 버젼:
    1.5
  관련 항목:
    `Transparency.OPAQUE` , `Transparency.BITMASK` , `Transparency.TRANSLUCENT` , `Component.createVolatileImage(int, int)`

### 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.getDeviceConfiguration();

            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

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세: 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.