java.awt
클래스 GraphicsDevice

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

public abstract class GraphicsDevice

extends Object

GraphicsDevice 클래스는 특정의 그래픽스 환경에서 이용 가능한 그래픽스 디바이스를 기술합니다. 이러한 디바이스에는 스크린 디바이스와 프린터 디바이스가 있습니다. GraphicsEnvironment 의 인스턴스에, 다수의 화면과 프린터가 있는 경우가 있습니다. 각 그래픽스 디바이스는 거기에 관련한 1 kr 이상의 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

도입된 버젼:

1.4

관련 항목:

isFullScreenSupported() , getFullScreenWindow() , setDisplayMode(java.awt.DisplayMode) , Component.enableInputMethods(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()

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

반환값:

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

관련 항목:

VolatileImage.flush() , ImageCapabilities.isAccelerated()