java.awt
클래스 GraphicsDevice

java.lang.Object 
  java.awt.GraphicsDevice

public abstract class GraphicsDevice
extends Object 

GraphicsDevice 클래스는 특정의 그래픽 환경에서 이용 가능한 그래픽 디바이스를 기술합니다. 이러한 디바이스에는 스크린 디바이스와 프린터 디바이스가 있습니다. GraphicsEnvironment 인스턴스에 다수의 화면과 프린터가 있는 경우가 있습니다. 각 그래픽 디바이스는 거기에 관련한 1개 이상 GraphicsConfiguration 객체를 가집니다. 이러한 객체는 GraphicsDevice를 사용할 수 있는 다양한 구성을 지정합니다.

멀티스크린 환경에서는 GraphicsConfiguration 객체를 사용해 복수의 화면에 컴퍼넌트를 렌더링 할 수 있습니다. 다음의 코드 샘플은, GraphicsEnvironment 각 스크린 디바이스로GraphicsConfiguration 마다 JFrame 객체를 생성하는 방법을 나타낸 것입니다.

   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++) {
         JFrame f = new
         JFrame(gs[j]. getDefaultConfiguration());
         Canvas c = new Canvas(gc[i]); 
         Rectangle gcBounds = gc[i]. getBounds();
         int xoffs = gcBounds.x;
         int yoffs = gcBounds.y;
           f.getContentPane(). add(c);
           f.setLocation((i*50) +xoffs, (i*60) +yoffs);
         f.show();
      }
   }
 

관련 항목:

GraphicsEnvironment, GraphicsConfiguration

필드 개요

static int	TYPE_IMAGE_BUFFER 디바이스는 이미지 버퍼입니다.
static int	TYPE_PRINTER 디바이스는 프린터입니다.
static int	TYPE_RASTER_SCREEN 디바이스는 라스터 화면입니다.

생성자 개요

protected

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

메서드 개요

int	getAvailableAcceleratedMemory () 이 메서드는 이 디바이스의 고속 메모리로 사용할 수 있는 바이트수를 리턴합니다.
GraphicsConfiguration	getBestConfiguration (GraphicsConfigTemplate gct) GraphicsConfigTemplate 로 정의되고 있는 기준을 건네줄 수 있는 「최적인」구성을 리턴합니다.
abstract GraphicsConfiguration []	getConfigurations () 이 GraphicsDevice에 관련한 모든 GraphicsConfiguration 객체를 리턴합니다.
abstract GraphicsConfiguration	getDefaultConfiguration () 이 GraphicsDevice에 관련한 디폴트의 GraphicsConfiguration을 리턴합니다.
DisplayMode	getDisplayMode () 이 GraphicsDevice 현재의 표시 모드를 리턴합니다.
DisplayMode []	getDisplayModes () 이 GraphicsDevice로 사용할 수 있는 모든 표시 모드를 리턴합니다.
Window	getFullScreenWindow () 디바이스가 풀 스크린 모드에 있는 경우, 풀 스크린 윈도우를 나타내는 Window 객체를 리턴합니다.
abstract String	getIDstring () 이 GraphicsDevice에 관련한 ID 캐릭터 라인을 리턴합니다.
abstract int	getType () 이 GraphicsDevice 형태를 리턴합니다.
boolean	isDisplayChangeSupported () 이 GraphicsDevice 이 저레벨 표시 변경을 지원하는 경우는 true를 리턴합니다.
boolean	isFullScreenSupported () 이 GraphicsDevice가 풀 스크린 배타 모드를 지원하는 경우는 true를 리턴합니다.
void	setDisplayMode (DisplayMode dm) 이 그래픽 디바이스의 표시 모드를 설정합니다.
void	setFullScreenWindow (Window w) 풀 스크린 모드에 들어가는지, 또는 윈도우 모드에 복귀합니다.

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

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

필드의 상세

TYPE_RASTER_SCREEN

public static final int TYPE_RASTER_SCREEN

디바이스는 라스터 화면입니다.

관련 항목:

정수 필드값

TYPE_PRINTER

public static final int TYPE_PRINTER

디바이스는 프린터입니다.

관련 항목:

정수 필드값

TYPE_IMAGE_BUFFER

public static final int TYPE_IMAGE_BUFFER

디바이스는 이미지 버퍼입니다. 이 버퍼는 디바이스 또는 시스템메모리에 포함됩니다만, 사용자가 물리적으로 표시할 수 없습니다.

관련 항목:

정수 필드값

생성자 상세

GraphicsDevice

protected GraphicsDevice()

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

관련 항목:

GraphicsEnvironment.getScreenDevices(), GraphicsEnvironment.getDefaultScreenDevice(), GraphicsConfiguration.getDevice()

메서드의 상세

getType

public abstract int getType()

이 GraphicsDevice 형태를 리턴합니다.

반환값:

이 GraphicsDevice 형태. TYPE_RASTER_SCREEN, TYPE_PRINTER, 또는 TYPE_IMAGE_BUFFER

관련 항목:

TYPE_RASTER_SCREEN, TYPE_PRINTER, TYPE_IMAGE_BUFFER

getIDstring

public abstract String  getIDstring()

이 GraphicsDevice에 관련한 ID 캐릭터 라인을 리턴합니다.

특정의 프로그램은 GraphicsEnvironment에 있는 복수의 GraphicsDevice를 사용하는 경우가 있습니다. 이 메서드는 로컬의 GraphicsEnvironment에 있는 특정의 GraphicsDevice를 식별하는 String를 리턴합니다. 이 String를 설정하는 public 메서드는 없습니다만, 프로그래머는 이 String를 디버그용으로 사용할 수 있습니다. Java^TM Runtime Environment 벤더는 이 String 반환값을 포맷 할 수 있습니다. 이 String값을 해석하는 방법을 결정하려면, Java Runtime 구입 바탕으로 연락해 주세요. 프로그램으로부터 벤더를 확인하려면, "java.vendor" 로 System 클래스의 getProperty 메서드를 호출합니다.

반환값:

이 GraphicsDevice ID를 나타내는 String

getConfigurations

public abstract GraphicsConfiguration [] getConfigurations()

이 GraphicsDevice에 관련한 모든 GraphicsConfiguration 객체를 리턴합니다.

반환값:

이 GraphicsDevice에 관련하고 있는 GraphicsConfiguration 객체의 배열

getDefaultConfiguration

public abstract GraphicsConfiguration  getDefaultConfiguration()

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

반환값:

이 GraphicsDevice 디폴트의 GraphicsConfiguration

getBestConfiguration

public GraphicsConfiguration  getBestConfiguration(GraphicsConfigTemplate  gct)

GraphicsConfigTemplate 로 정의되고 있는 기준을 건네줄 수 있는 「최적인」구성을 리턴합니다.

파라미터:

gct - 유효한 GraphicsConfiguration을 취득하기 위해서 사용되는 GraphicsConfigTemplate 객체

반환값:

지정된 GraphicsConfigTemplate로 정의되고 있는 기준을 건네줄 수 있는 GraphicsConfiguration

관련 항목:

GraphicsConfigTemplate

isFullScreenSupported

public boolean isFullScreenSupported()

이 GraphicsDevice가 풀 스크린 배타 모드를 지원하는 경우는 true를 리턴합니다.

반환값:

이 그래픽 디바이스로 풀 스크린 배타 모드가 이용 가능한가 어떤가

도입된 버전 :

1.4

setFullScreenWindow

public void setFullScreenWindow(Window  w)

풀 스크린 모드에 들어가는지, 또는 윈도우 모드에 복귀합니다.

isFullScreenSupported가 true를 돌려주는 경우, 풀 스크린 모드는 exclusive 이다고 보여집니다. 이것은 다음 일을의미합니다.

• Windows는 풀 스크린 윈도우를 오버랩 할 수 없습니다. 그 외의 모든 어플리케이션 윈도우는 항상 풀 스크린 윈도우아래에 Z 축 순서로 숨겨져 표시됩니다.
• 인풋 메서드 윈도우가 무효가 됩니다. Component.enableInputMethods(false)를 호출해, 컴퍼넌트를 인풋 메서드 체제의 비클라이언트로 하는 것을 추천합니다.

isFullScreenSupported가 false를 돌려주는 경우, 풀 스크린 배타 모드는 윈도우의 사이즈를 스크린 사이즈로 변경해 (0,0) 배치하는 것에 의해 시뮬레이트 됩니다.

풀 스크린 배타 모드로 전환했을 때에 풀 스크린 윈도우로서 사용하는 윈도우가 표시되어 있지 않은 경우, 이 메서드는 그 윈도우를 표시합니다. 윈도우 모드에 돌아와도 표시된 채로 있습니다.

풀 스크린 배타 윈도우로부터 윈도우 모드에 복귀하면, setDisplayMode 호출에 의해 행해진 표시 변경은 원 상태에 자동적으로 복원됩니다.

파라미터:

w - 풀 스크린 윈도우로서 사용하는 윈도우. 윈도우 모드에 복귀하는 경우는 null. 일부의 플랫폼에서는 풀 스크린 윈도우가 톱 레벨 컴퍼넌트 (즉, Frame)인 것이 기대되기 때문에 여기에서는 Window 보다 Frame를 사용하는 (분)편이 적절한

도입된 버전 :

1.4

관련 항목:

isFullScreenSupported(), getFullScreenWindow(), setDisplayMode(java.awt.DisplayMode), Component.enableInputMethods(boolean), Component.setVisible(boolean)

getFullScreenWindow

public Window  getFullScreenWindow()

디바이스가 풀 스크린 모드에 있는 경우, 풀 스크린 윈도우를 나타내는 Window 객체를 리턴합니다.

반환값:

풀 스크린 윈도우, 디바이스가 풀 스크린 모드가 아닌 경우는 null

도입된 버전 :

1.4

관련 항목:

setFullScreenWindow(Window)

isDisplayChangeSupported

public boolean isDisplayChangeSupported()

이 GraphicsDevice 이 저레벨 표시 변경을 지원하는 경우는 true를 리턴합니다.

반환값:

이 그래픽 디바이스가 저레벨 표시 변경을 지원할지 어떨지. 이것은 풀 스크린 배타 모드에 의존된 경우와 존하지 않는 경우가 있는

도입된 버전 :

1.4

관련 항목:

setDisplayMode(java.awt.DisplayMode)

setDisplayMode

public void setDisplayMode(DisplayMode  dm)

이 그래픽 디바이스의 표시 모드를 설정합니다. 이것은 풀 스크린 배타 모드에서만 실행할 수 있습니다.

파라미터:

dm - 이 그래픽 디바이스의 새로운 표시 모드

예외:

IllegalArgumentException - 지정된 DisplayMode가 null 또는 getDisplayModes에 의해 리턴된 배열로 사용할 수 없는 경우

UnsupportedOperationException - isDisplayChangeSupported가 false를 돌려주는 경우

도입된 버전 :

1.4

관련 항목:

getDisplayMode(), getDisplayModes(), isDisplayChangeSupported()

getDisplayMode

public DisplayMode  getDisplayMode()

이 GraphicsDevice 현재의 표시 모드를 리턴합니다.

반환값:

이 그래픽 디바이스의 현재의 표시 모드

도입된 버전 :

1.4

관련 항목:

setDisplayMode(DisplayMode)

getDisplayModes

public DisplayMode [] getDisplayModes()

이 GraphicsDevice로 사용할 수 있는 모든 표시 모드를 리턴합니다.

반환값:

이 그래픽 디바이스로 사용할 수 있는 모든 표시 모드

도입된 버전 :

1.4

getAvailableAcceleratedMemory

public int getAvailableAcceleratedMemory()

이 메서드는 이 디바이스의 고속 메모리로 사용할 수 있는 바이트수를 리턴합니다. 일부의 이미지는 선착순으로 작성되든가 또는 고속 메모리에 캐쉬됩니다. 일부의 OS에 서는 이 메모리는 유한의 자원입니다. 이 메서드를 호출해, 이미지의 작성과 플래시를 스케줄링 하는 것으로써, 어플리케이션이 이 유한의 자원을 가장 효과적으로 사용할 수 있게 됩니다.
리턴된 값은 사용할 수 있는 메모리량의 snapshot입니다. 일부의 이미지는 그 메모리에 할당할 수 있는 것으로 문제가 생기는 경우가 있습니다. 예를 들어 OS, 드라이버, 메모리 구성 및 thread의 상황에 따라서는 지정된 이미지에 대해서 보고된 전체의 사이즈를 사용할 수 없는 경우가 있습니다. VolatileImage에 관련된 ImageCapabilities 객체상에 또한 조회를 실시하는 메서드가 있습니다. 이 메서드는 고속 메모리에 특정의 VolatileImage가 작성되고 있는지를 판정하기 위해서 사용할 수 있습니다.

반환값:

고속 메모리로 이용 가능한 바이트수. 부의 반환값은 고속 메모리가 무제한한 것을 나타내는

관련 항목:

VolatileImage.flush(), ImageCapabilities.isAccelerated()