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

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

java.awt
클래스 GraphicsConfiguration

java.lang.Object 
  java.awt.GraphicsConfiguration

public abstract class GraphicsConfiguration
extends Object
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)

파라미터:: 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

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

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

java.awt 클래스 GraphicsConfiguration

GraphicsConfiguration

getDevice

createCompatibleImage

createCompatibleImage

createCompatibleVolatileImage

createCompatibleVolatileImage

createCompatibleVolatileImage

createCompatibleVolatileImage

getColorModel

getColorModel

getDefaultTransform

getNormalizingTransform

getBounds

getBufferCapabilities

getImageCapabilities

java.awt
클래스 GraphicsConfiguration