java.awt
클래스 GraphicsEnvironment

java.lang.Object 
  java.awt.GraphicsEnvironment

public abstract class GraphicsEnvironment
extends Object 

GraphicsEnvironment 클래스는 특정의 플랫폼의 Java^TM 어플리케이션으로 사용할 수 있는 GraphicsDevice 객체 및 Font 객체의 컬렉션을 기술합니다. 이 GraphicsEnvironment 자원은 로컬 머신상인가 리모트 머신상에 있습니다. GraphicsDevice객체는 화면, 프린터, 또는 이미지 버퍼의 경우가 있어, Graphics2D 렌더링 메서드의 목적지입니다. 각 GraphicsDevice는 거기에 관련하고 싶은 구두인가 GraphicsConfiguration 객체를 가집니다. 이러한 객체는 GraphicsDevice를 사용할 수 있는 다양한 구성을 지정합니다.

관련 항목:

GraphicsDevice, GraphicsConfiguration

생성자 개요

protected

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

메서드 개요

abstract Graphics2D	createGraphics (BufferedImage img) 지정된 BufferedImage에 렌더링하기 위한 Graphics2D 객체를 리턴합니다.
abstract Font []	getAllFonts () 이 GraphicsEnvironment로 이용 가능한 모든 폰트에 대해 1 포인트의 사이즈의 인스턴스를 보관 유지하고 있는 배열을 리턴합니다.
abstract String []	getAvailableFontFamilyNames () Locale.getDefault()에 의해 리턴된 디폴트 로케일에 지역 대응된, 이 GraphicsEnvironment 모든 폰트 패밀리의 이름을 포함하고 있는 배열을 리턴합니다.
abstract String []	getAvailableFontFamilyNames (Locale l) 지정된 로케일에 지역 대응된 이 GraphicsEnvironment 모든 폰트 패밀리의 이름을 포함하고 있는 배열을 리턴합니다.
Point	getCenterPoint () Window를 중앙에 배치하는 Point를 리턴합니다.
abstract GraphicsDevice	getDefaultScreenDevice () 디폴트의 화면 GraphicsDevice를 리턴합니다.
static GraphicsEnvironment	getLocalGraphicsEnvironment () 로컬의 GraphicsEnvironment를 리턴합니다.
Rectangle	getMaximumWindowBounds () 중앙에 배치된 Window 최대의 경계를 리턴합니다.
abstract GraphicsDevice []	getScreenDevices () 모든 화면 GraphicsDevice 객체의 배열을 리턴합니다.
static boolean	isHeadless () 디스플레이, 키보드 및 마우스가 이 환경에서 지원될지 어떨지를 판정합니다.
boolean	isHeadlessInstance () 디스플레이, 키보드 및 마우스가 이 그래픽 환경에서 지원될지 어떨지를 리턴합니다.
void	preferLocaleFonts () 논리 폰트로부터 물리 폰트의 매핑에서의 로케일 고유의 폰트의 설정을 지정합니다.
void	preferProportionalFonts () 논리 폰트로부터 물리 폰트에의 매핑으로 proportional font 이외의 폰트 (dual-spaced CJK 폰트등)보다 proportional font를 우선하는 설정을 지정합니다.

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

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

생성자 상세

GraphicsEnvironment

protected GraphicsEnvironment()

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

메서드의 상세

getLocalGraphicsEnvironment

public static GraphicsEnvironment  getLocalGraphicsEnvironment()

로컬의 GraphicsEnvironment를 리턴합니다.

반환값:

로컬의 GraphicsEnvironment

isHeadless

public static boolean isHeadless()

디스플레이, 키보드 및 마우스가 이 환경에서 지원될지 어떨지를 판정합니다. 이 메서드가 true를 돌려주는 경우, HeadlessException가 디스플레이, 키보드, 또는 마우스에 의존된 Toolkit 및 GraphicsEnvironment 영역으로부터 발생 됩니다.

반환값:

이 환경이 디스플레이, 키보드 및 마우스를 지원할 수 없는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.4

관련 항목:

HeadlessException

isHeadlessInstance

public boolean isHeadlessInstance()

디스플레이, 키보드 및 마우스가 이 그래픽 환경에서 지원될지 어떨지를 리턴합니다. 이 메서드가 true를 돌려주는 경우, HeadlessException가 디스플레이, 키보드, 또는 마우스에 의존된 그래픽 환경의 영역으로부터 발생 됩니다.

반환값:

디스플레이, 키보드 및 마우스가 이 환경에서 지원되는 경우는 true, 그렇지 않은 경우는 false

도입된 버전 :

1.4

관련 항목:

HeadlessException, isHeadless()

getScreenDevices

public abstract GraphicsDevice [] getScreenDevices()
                                           throws HeadlessException 

모든 화면 GraphicsDevice 객체의 배열을 리턴합니다.

반환값:

화면 디바이스를 나타내는 모든 GraphicsDevice 객체를 포함하는 배열

예외:

HeadlessException - isHeadless()가 true를 돌려주는 경우

관련 항목:

isHeadless()

getDefaultScreenDevice

public abstract GraphicsDevice  getDefaultScreenDevice()
                                               throws HeadlessException 

디폴트의 화면 GraphicsDevice를 리턴합니다.

반환값:

디폴트의 화면 디바이스를 나타내는 GraphicsDevice

예외:

HeadlessException - isHeadless()가 true를 돌려주는 경우

관련 항목:

isHeadless()

createGraphics

public abstract Graphics2D  createGraphics(BufferedImage  img)

지정된 BufferedImage에 렌더링하기 위한 Graphics2D 객체를 리턴합니다.

파라미터:

img - 지정된 BufferedImage

반환값:

지정된 BufferedImage에 렌더링 하기 위해서 사용되는 Graphics2D

getAllFonts

public abstract Font [] getAllFonts()

이 GraphicsEnvironment로 이용 가능한 모든 폰트에 대해 1 포인트의 사이즈의 인스턴스를 보관 유지하고 있는 배열을 리턴합니다. 보통 의 사용법에서는 사용자에 게 특정의 폰트의 선택을 허가하므로 어플리케이션은 선택이 끝난 인스턴스에 deriveFont 메서드를 호출해, 폰트의 사이즈 변경과 각종 폰트 속성의 설정을 실시할 수 있습니다 .

이 메서드는 어플리케이션에 Font인스턴스를 사용해 텍스트를 렌더링 하는 가장 적확한 제어를 제공합니다. 이 GraphicsEnvironment 폰트가 복수의 프로그램 가능한 바리에이션을 가지는 경우에는 그 Font 1개의 인스턴스만이 배열로 돌려주고져 다른 바리에이션은 어플리케이션에 의해 나타나지 않으면 안됩니다.

이 환경의 폰트가 다양한 마스터 폰트와 같이 복수의 프로그램 가능한 바리에이션을 가지는 경우에는 그 폰트의 1개의 인스턴스만이 Font 배열로 돌려주고져 다른 바리에이션은 어플리케이션에 의해 나타나지 않으면 안됩니다.

반환값:

Font 객체의 배열

도입된 버전 :

1.2

관련 항목:

getAvailableFontFamilyNames(), Font, Font.deriveFont(int, float), Font.getFontName()

getAvailableFontFamilyNames

public abstract String [] getAvailableFontFamilyNames()

Locale.getDefault()에 의해 리턴된 디폴트 로케일에 지역 대응된, 이 GraphicsEnvironment 모든 폰트 패밀리의 이름을 포함하고 있는 배열을 리턴합니다.

일반적인 사용법에서는 사용자가 특정의 패밀리명을 선택할 수 있도록 합니다. 어플리케이션으로 폰트의 작성시에 Bold 나 Italic 등의 스타일과 함께 이 이름을 지정할 수 있기 때문에 폰트 시스템에 같은 폰트 패밀리의 복수의 폰트 중에서 가장 적절한 것을 선택하는 유연성을 줍니다.

반환값:

디폴트 로케일에 지역 대응된 폰트 패밀리명을 포함하는 String 배열, 또는 이 로케일의 이름이 존재하지 않는 경우는 적절한 대체명

도입된 버전 :

1.2

관련 항목:

getAllFonts(), Font, Font.getFamily()

getAvailableFontFamilyNames

public abstract String [] getAvailableFontFamilyNames(Locale  l)

지정된 로케일에 지역 대응된 이 GraphicsEnvironment 모든 폰트 패밀리의 이름을 포함하고 있는 배열을 리턴합니다.

일반적인 사용법에서는 사용자가 특정의 패밀리명을 선택할 수 있도록 합니다. 어플리케이션으로 폰트의 작성시에 Bold 나 Italic 등의 스타일과 함께 이 이름을 지정할 수 있기 때문에 폰트 시스템에 같은 폰트 패밀리의 복수의 폰트 중에서 가장 적절한 것을 선택하는 유연성을 줍니다.

파라미터:

l - 특정의 지리적, 정치적, 또는 문화적 영역을 나타내는 Locale 객체. null은 Locale.getDefault()를 지정하는 것으로 같다

반환값:

지정된 Locale에 지역 대응된 폰트 패밀리를 포함하는 String 배열, 또는 지정된 로케일의 이름이 존재하지 않는 경우는 적절한 대체명

도입된 버전 :

1.2

관련 항목:

getAllFonts(), Font, Font.getFamily()

preferLocaleFonts

public void preferLocaleFonts()

논리 폰트로부터 물리 폰트의 매핑에서의 로케일 고유의 폰트의 설정을 지정합니다. 이 메서드를 호출하는 것은 폰트의 렌더링로 주요한 서기법 (디폴트의 인코딩 및 초기의 디폴트의 로케일에 의해 지시받은 서기법)을 주로 사용할 필요가 있는 것을의미합니다. 예를 들어 주요한 서기법이 일본어의 경우, 가능한 한 일본어를 사용해 문자를 렌더링 할 필요가 있어, 다른 폰트는 일본어의 폰트가 그래프를 가지지 않는 문자에게만 사용할 필요가 있습니다.

이 메서드의 호출에 의해 실행되는 폰트의 렌더링 동작에서의 실제의 변경은 구현에 따라서 다릅니다. 전혀 영향이 없는 경우도 있으면, 요구된 동작이 디폴트의 동작에 일치하고 있는 경우도 있습니다. 이 동작은 경량 컴퍼넌트의 폰트의 렌더링와 피어 컴퍼넌트의 폰트의 렌더링로 다른 일이 있습니다. 이 메서드를 호출하면, 다른 폰트가 요구되기 때문에 클라이언트는 다른 메트리크스를 예상할 필요가 있어, 윈도우의 사이즈와 레이아웃의 재계산이 필요하게 되는 경우도 있습니다. 그 때문에 이 메서드는 사용자 인터페이스의 초기화전에 호출할 필요가 있습니다.

도입된 버전 :

1.5

preferProportionalFonts

public void preferProportionalFonts()

논리 폰트로부터 물리 폰트에의 매핑으로 proportional font 이외의 폰트 (dual-spaced CJK 폰트등)보다 proportional font를 우선하는 설정을 지정합니다. 디폴트의 매핑에 proportional과 proportional 이외의 형식이 존재하는 폰트가 포함되는 경우, 이 메서드를 호출하는 것은 매핑으로 proportional 형식을 사용할 필요가 있는 것을 지시합니다.

이 메서드의 호출에 의해 실행되는 폰트의 렌더링 동작에서의 실제의 변경은 구현에 따라서 다릅니다. 전혀 영향이 없는 경우도 있습니다. 이 동작은 경량 컴퍼넌트의 폰트의 렌더링와 피어 컴퍼넌트의 폰트의 렌더링로 다른 일이 있습니다. 이 메서드를 호출하면, 다른 폰트가 요구되기 때문에 클라이언트는 다른 메트리크스를 예상할 필요가 있어, 윈도우의 사이즈와 레이아웃의 재계산이 필요하게 되는 경우도 있습니다. 그 때문에 이 메서드는 사용자 인터페이스의 초기화전에 호출할 필요가 있습니다.

도입된 버전 :

1.5

getCenterPoint

public Point  getCenterPoint()
                     throws HeadlessException 

Window를 중앙에 배치하는 Point를 리턴합니다. 중앙에 배치된 Window가 getMaximumWindowBounds()를 사용해 표시 가능한 영역에 들어갈지 어떨지를 체크하는 것을 추천합니다.

반환값:

Window를 중앙에 배치하는 포인트

예외:

HeadlessException - isHeadless()가 true를 돌려주는 경우

도입된 버전 :

1.4

관련 항목:

getMaximumWindowBounds()

getMaximumWindowBounds

public Rectangle  getMaximumWindowBounds()
                                 throws HeadlessException 

중앙에 배치된 Window 최대의 경계를 리턴합니다. 이러한 경계는 태스크바나 도구모음등의 네이티브의 윈도우 처리 시스템의 객체를 처리합니다. 리턴된 경계는 1개의 예외를 가지는 단일의 디스플레이에 상주합니다. 모든 디스플레이를 통해 Window가 중앙에 배치되는 멀티스크린 시스템의 경우, 이 메서드는 전체의 디스플레이 영역의 경계를 리턴합니다.

단일의 디스플레이의 사용할 수 있는 경계를 취득하려면, GraphicsConfiguration.getBounds() 및 Toolkit.getScreenInsets()를 사용합니다.

반환값:

중앙에 배치된 Window 최대의 경계

예외:

HeadlessException - isHeadless()가 true를 돌려주는 경우

도입된 버전 :

1.4

관련 항목:

getCenterPoint(), GraphicsConfiguration.getBounds(), Toolkit.getScreenInsets(java.awt.GraphicsConfiguration)