org.kwis.msp.lcdui
Class Font

java.lang.Object
  |
  +--org.kwis.msp.lcdui.Font

public class Font

extends Object

글꼴 클래스 입니다.

문자열을 찍는데 사용되는 문자를 나타내는 글꼴 클래스입니다. getFont를 사용해서 원하는 폰트를 가져옵니다. 기본적으로 getFont를 해서 가져온 폰트는 내부적으로 공유하므로 자원을 프리해야할 필요는 없습니다.

getFont함수로 가져와서 Graphics.setFont(org.kwis.msp.lcdui.Font)함수를 통해서 폰트를 지정하여 문자의 화면 출력 외형을 변경할 수 있습니다.

getFont를 통해서 시스템에 따라서, 지정한 폰트가 아닌 그와 유사한 폰트를 돌려 받을 수 있습니다.

문자열의 화면 출력 길이를 알기 위해서는 stringWidth나 substringWidth함수를 사용합니다.

폰트의 스타일은 다음중 하나가 됩니다. STYLE_PLAIN
STYLE_UNDERLINED
STYLE_BOLD
STYLE_BOLD | STYLE_UNDERLINED
STYLE_ITALIC
STYLE_ITALIC | STYLE_UNDERLINED
STYLE_BOLD | STYLE_ITALIC
STYLE_BOLD | STYLE_ITALIC | STYLE_UNDERLINED

Field Summary

protected int	face
static int	FACE_MONOSPACE Monospace폰트 페이스.
static int	FACE_PROPORTIONAL Proportional폰트 페이스.
static int	FACE_SYSTEM System 폰트 페이스.
protected int	size
static int	SIZE_LARGE 큰 크기의 폰트 크기.
static int	SIZE_MEDIUM 중간 크기의 폰트 크기.
static int	SIZE_SMALL 작은 크기의 폰트 크기.
protected int	style
static int	STYLE_BOLD 진한 폰트 스타일.
static int	STYLE_ITALIC 기운 폰트 스타일.
static int	STYLE_PLAIN 보통 폰트 스타일.
static int	STYLE_UNDERLINED 밑줄 그은 폰트 스타일.

Method Summary

int	charsWidth(char[] ch, int offset, int length) 문자열의 화면상의 폭을 넘겨줍니다.
int	charWidth(char ch) 문자의 화면상의 폭을 넘겨 줍니다.
int	getBaselinePosition() 문자의 베이스 라인(base line) 높이를 돌려줍니다.
static Font	getDefaultFont() 시스템의 기본 폰트를 돌려줍니다.
int	getFace() 폰트의 페이스를 돌려줍니다.
static Font	getFont(int face, int style, int size) 특정 폰트를 얻어 옵니다.
int	getHeight() 폰트의 높이를 얻어옵니다.
int	getSize() 폰트의 크기를 얻어 옵니다.
int	getStyle() 폰트의 스타일을 얻어 옵니다.
boolean	isBold() 폰트의 스타일을 STYLE_BOLD인지 아닌지 여부를 돌려줍니다.
boolean	isItalic() 폰트의 스타일을 STYLE_ITALIC인지 아닌지 여부를 돌려줍니다.
boolean	isPlain() 폰트의 스타일을 STYLE_PLAIN인지 아닌지 여부를 돌려줍니다.
boolean	isUnderlined() 폰트의 스타일을 STYLE_UNDERLINED인지 아닌지 여부를 돌려줍니다.
int	stringWidth(String str) 문자열의 폭을 얻어 옵니다.
int	substringWidth(String str, int offset, int len) 문자열의 일부의 폭을 얻어 옵니다.

Methods inherited from class java.lang.Object

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

Field Detail

FACE_MONOSPACE

public static int FACE_MONOSPACE

Monospace폰트 페이스. 값 32로 지정되어 있으며, 폭이 일정한 폰트를 지정합니다.

FACE_PROPORTIONAL

public static int FACE_PROPORTIONAL

Proportional폰트 페이스. 값이 64로 지정되어 있으며, 폭이 일정하지 않은 폰트를 지정합니다.

FACE_SYSTEM

public static int FACE_SYSTEM

System 폰트 페이스. 값이 0으로 지정되어 있으며, 시스템 폰트에서 사용하는 폰트입니다. MONOSPACE혹은 PROPORTIONAL둘중 하나 입니다.

SIZE_LARGE

public static int SIZE_LARGE

큰 크기의 폰트 크기. 값이 16으로 지정되어 있으며, 시스템의 큰 폰트를 지정합니다.

SIZE_MEDIUM

public static int SIZE_MEDIUM

중간 크기의 폰트 크기. 값이 0으로 지정되어 있으며, 시스템의 중간 폰트를 지정합니다.

SIZE_SMALL

public static int SIZE_SMALL

작은 크기의 폰트 크기. 값이 8로 지정되어 있으며, 시스템의 작은 폰트를 지정합니다.

STYLE_BOLD

public static int STYLE_BOLD

진한 폰트 스타일. 다른 폰트 스타일과 혼합되어 사용할 수 있다. 값은 1로 지정합니다.

STYLE_ITALIC

public static int STYLE_ITALIC

기운 폰트 스타일. 다른 폰트 스타일과 혼합되어 사용할 수 있다. 값은 2로 지정합니다.

STYLE_PLAIN

public static int STYLE_PLAIN

보통 폰트 스타일. 다른 폰트 스타일과 혼합되어 사용할 수 있다. 값은 0로 지정합니다.

STYLE_UNDERLINED

public static int STYLE_UNDERLINED

밑줄 그은 폰트 스타일. 다른 폰트 스타일과 혼합되어 사용할 수 있다. 값은 4로 지정되어 있다.

style

protected int style

size

protected int size

face

protected int face

Method Detail

getFont

public static Font getFont(int face,
                           int style,
                           int size)

특정 폰트를 얻어 옵니다. 지정된 폰트와 가장 유사한 폰트를 얻어 옵니다. 이 함수는 시스템에 따라서 제대로 된 폰트가 나올 수 있습니다.

Parameters:

face - 폰트의 face; FACE_MONOSPACE, FACE_PROPORTIONAL, FACE_SYSTEM과 같은 값이 올 수 있음

style - 폰트 스타일; STYLE_PLAIN이나 STYLE_ITALIC, STYLE_BOLD, STYLE_UNDERLINED의 조합이 올 수 있음.

size - 폰트 크기; SIZE_LARGE, SIZE_MEDIUM, SIZE_SMALL중 하나가 올 수 있음

Throws:

IllegalArgumentException - face, style, size중에 하나라도 유효한 값을 가지지 않는 경우.

charsWidth

public int charsWidth(char[] ch,
                      int offset,
                      int length)

문자열의 화면상의 폭을 넘겨줍니다. 문자열의 화면상의 폭을 픽셀 단위로 넘겨줍니다. 계산되는 문자열을 ch가 가르키는 문자 배열의 offset부터 시작해서 length개 까지의 문자가 됩니다.

Parameters:

ch - 문자 배열

offset - 문자 배열에서의 위치

length - 문자 갯수

Returns:

문자열의 화면상의 픽셀 단위의 폭

Throws:

ArrayIndexOutOfBoundException - offset값과 length가 문자 어레이의 범위를 벗어나는 경우

NullPointerException - ch가 null인 경우

charWidth

public int charWidth(char ch)

문자의 화면상의 폭을 넘겨 줍니다. ch가 나타내는 문자의 화면상의 픽셀 단위의 폭을 넘겨줍니다. 만일 시스템이 지원하지 않는 문자라면 ' '(0x20)의 폭을 넘겨줍니다. 물론 화면에 출력시에도 ' '가 출력됩니다.

Parameters:

ch - 문자

Returns:

문자의 화면상의 픽셀 단위의 폭

getBaselinePosition

public int getBaselinePosition()

문자의 베이스 라인(base line) 높이를 돌려줍니다.

Returns:

문자의 baseline

getDefaultFont

public static Font getDefaultFont()

시스템의 기본 폰트를 돌려줍니다.

Returns:

시스템 기본 폰트

getFace

public int getFace()

폰트의 페이스를 돌려줍니다. 돌려주는 값은 폰트에 따라서 FACE_MONOSPACE, FACE_PROPORTIONAL, FACE_SYSTEM중의 하나가 됩니다.

Returns:

폰트의 페이스

getHeight

public int getHeight()

폰트의 높이를 얻어옵니다.

Returns:

폰트의 높이

getSize

public int getSize()

폰트의 크기를 얻어 옵니다.

Returns:

폰트의 크기

getStyle

public int getStyle()

폰트의 스타일을 얻어 옵니다. 폰트의 스타일에 따라서 STYLE_BOLD, STYLE_ITALIC, STYLE_UNDERLINE, STYLE_PLAIN의 값을 OR한 값을 돌려줍니다.

Returns:

폰트의 스타일

isBold

public boolean isBold()

폰트의 스타일을 STYLE_BOLD인지 아닌지 여부를 돌려줍니다.

Returns:

폰트의 스타일이 STYLE_BOLD이면 true 그렇지 않으면 false

isItalic

public boolean isItalic()

폰트의 스타일을 STYLE_ITALIC인지 아닌지 여부를 돌려줍니다.

Returns:

폰트의 스타일이 STYLE_ITALIC이면 true 그렇지 않으면 false

isPlain

public boolean isPlain()

폰트의 스타일을 STYLE_PLAIN인지 아닌지 여부를 돌려줍니다.

Returns:

폰트의 스타일이 STYLE_PLAIN이면 true 그렇지 않으면 false

isUnderlined

public boolean isUnderlined()

폰트의 스타일을 STYLE_UNDERLINED인지 아닌지 여부를 돌려줍니다.

Returns:

폰트의 스타일이 STYLE_UNDERLINED이면 true 그렇지 않으면 false

stringWidth

public int stringWidth(String str)

문자열의 폭을 얻어 옵니다. str가 지정하는 문자열의 화면에 출력시 폭을 얻어 옵니다.

Parameters:

str - 폭을 계산할 문자열

Returns:

문자열의 폭

Throws:

NullPointerException - str이 null인 경우.

substringWidth

public int substringWidth(String str,
                          int offset,
                          int len)

문자열의 일부의 폭을 얻어 옵니다. str가 지정하는 문자열의 offset부터 len개의 문자의 폭을 얻어 옵니다.

Parameters:

str - 폭을 계산할 문자열

offset - 문자열의 시작 점

len - 문자열의 문자 갯수

Returns:

문자열의 폭

Throws:

StringIndexOutOfBoundsException - offset과 len값이 문자열의 범위를 벗어나는 경우

NullPointerException - str이 null인 경우.