javax.print.attribute
클래스 Size2DSyntax

java.lang.Object 
  |
  +--javax.print.attribute.Size2DSyntax

모든 구현 인터페이스:

Cloneable , Serializable

직계의 기존의 서브 클래스:

MediaSize

public abstract class Size2DSyntax

extends Object

implements Serializable , Cloneable

Size2DSyntax 클래스는 2 차원의 사이즈를 나타내는 모든 속성의 일반적인 구현을 제공하는 추상 base class입니다.

2 차원의 사이즈의 속성치는 치수 X 와 치수 Y 의 2 개의 항목으로부터 구성됩니다. 2 차원의 사이즈의 속성치는 2 개의 값을 제공해, 그 값을 측정하는 단위를 나타내는 것에 의해 구축됩니다. 메소드는 2 차원의 사이즈의 속성치를 돌려주기 위해서(때문에) 제공되어 값을 돌려주는 단위를 나타냅니다. 무엇보다 일반적인 2 개의 사이즈의 단위는 인치 (in)와 밀리미터 (mm)로, 이러한 단위를 나타내기 위해서(때문에) export 되는 정수 INCH 와 MM 가 제공됩니다.

2 차원의 사이즈의 속성치는 일단 구축된다고 변경할 수 없습니다.

설계

2 차원의 사이즈의 속성치의 치수 X 와 치수 Y 의 값은 정수형으로서 미크론 (µm) 단위로 내부에 저장됩니다. 여기서, 1 미크론 = 10^-6 미터 = 1/1000 밀리미터 = 1/25400 인치입니다. 이것에 의해, 치수를 1/1000 밀리미터 (= 1 µm) 또는 1/100 인치 (= 254 µm)의 정밀도로 정확하게 나타낼 수가 있습니다. 인치의 소수부가 부의 2 의 누승으로 나타내지는 경우, 이것은 치수를 1/8 인치 (= 3175 µm)의 정밀도로 정확하게 나타낼 수가 있습니다. 다만,1/16 인치는 µm 의 적분수로 동일하지 않기 때문에,1/16 인치로 나타낼 수 없습니다.

치수를 공통의 µm 단위로 내부에 저장하는 것으로써, 작성시의 단위에 관계없이 2 개의 사이즈의 속성이 비교 가능하게 됩니다. 예를 들어, 양쪽 모두 215900 µm 로서 저장되기 (위해)때문에, 비교의 결과 8.5 인치는 215.9 mm 와 동일한 것을 압니다. 예를 들어, 검색 서비스는 작성시의 단위에 관계없이, 직렬화 표현의 동등성에 근거해 해상도 속성을 조합할 수 있습니다. 내부 기억에 정수형을 사용하는 것으로써, 정확한 동등성의 비교가 가능하게 됩니다. 다만, 이것은 내부 표현에 부동 소수점이 사용되는 경우는 프로텍션되지 않습니다. 미터법 단위의 U.S. letter-size 미디어를 검출하는 경우, 215.9 x 279.4 mm 의 미디어 사이즈를 검색해야 하는 것에 주의해 주세요. 정수형 216 x 279 mm 에 사사오입 하면(자) 조합되지 않습니다.

export 되는 정수 INCH 는 실제로 인치 단위의 값에 곱셈해, µm 단위의 값을 취득하는 변환계수입니다. 같이 export 되는 정수 MM 는 mm 단위의 값에 곱셈해 µm 단위의 값을 취득하는 변환계수입니다. 클라이언트는 클라이언트 자신의 변환계수를 제공해, 인치 또는 mm 이외의 단위로 해상도 속성을 지정할 수 있습니다. 다만, 내부 단위 µm 는 외부 단위로서 인치와 mm 만을 고려해 서포트하도록(듯이) 선택되고 있으므로, 클라이언트의 단위의 변환계수가 정확한 정수형이 될지 어떨지 프로텍션되지 않습니다. 변환계수가 정확한 정수형이 아닌 경우, 클라이언트의 단위의 해상도의 값은 정확하게 저장되지 않습니다.

관련 항목:

직렬화 된 형식

필드의 개요

static int	INCH 인치 (in) 단위를 나타내는 값입니다.
static int	MM 밀리미터 (mm) 단위를 나타내는 값입니다.

생성자의 개요

protected	Size2DSyntax (float x, float y, int units) 지정된 부동 소수점의 값으로 새로운 2 차원의 사이즈의 속성을 구축합니다.
protected	Size2DSyntax (int x, int y, int units) 지정된 정수치로 새로운 2 차원의 사이즈의 속성을 구축합니다.

메소드의 개요

boolean	equals (Object object) 이 2 차원의 사이즈의 속성이 오브젝트에게 건네진 속성과 동일한지 어떤지를 돌려줍니다.
float[]	getSize (int units) 부동 소수점의 값으로 해서 지정된 단위로, 이 2 차원의 사이즈의 속성의 치수를 돌려줍니다.
float	getX (int units) 부동 소수점의 값으로 해서 지정된 단위로, 이 2 차원의 사이즈의 속성의 치수 X 를 돌려줍니다.
protected int	getXMicrometers () 이 2 차원의 사이즈의 속성의 치수 X 를 미크론 (µm) 단위로 돌려줍니다 (서브 클래스에서 사용).
float	getY (int units) 부동 소수점의 값으로 해서 지정된 단위로, 이 2 차원의 사이즈의 속성의 치수 Y 를 돌려줍니다.
protected int	getYMicrometers () 이 2 차원의 사이즈의 속성의 치수 Y 를 미크론 (µm) 단위로 돌려줍니다 (서브 클래스에서 사용).
int	hashCode () 이 2 차원의 사이즈의 속성의 해시 코드치를 돌려줍니다.
String	toString () 이 2 차원의 사이즈의 속성의 캐릭터 라인 버젼을 돌려줍니다.
String	toString (int units, String unitsName) 이 2 차원의 사이즈의 속성의 캐릭터 라인 버젼이 지정된 단위로 돌려줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

clone , finalize , getClass , notify , notifyAll , wait , wait , wait

필드의 상세

INCH

public static final int INCH

인치 (in) 단위를 나타내는 값입니다. 이것은 실제로 인치에 곱셈해 µm (25400)를 산출하는 변환계수입니다.

관련 항목:

정수 필드치

MM

public static final int MM

밀리미터 (mm) 단위를 나타내는 값입니다. 이것은 실제로 mm 에 곱셈해 µm (1000)를 산출하는 변환계수입니다.

관련 항목:

정수 필드치

생성자의 상세

Size2DSyntax

protected Size2DSyntax(float x,
                       float y,
                       int units)

지정된 부동 소수점의 값으로 새로운 2 차원의 사이즈의 속성을 구축합니다.

파라미터:

x - 치수 X

y - 치수 Y

units - 단위 변환계수. 예를 들어,INCH 또는 MM

예외:

IllegalArgumentException - 미확인의 예외. x < 0 또는 y < 0 또는 units < 1 의 경우에 슬로우 된다

Size2DSyntax

protected Size2DSyntax(int x,
                       int y,
                       int units)

지정된 정수치로 새로운 2 차원의 사이즈의 속성을 구축합니다.

파라미터:

x - 치수 X

y - 치수 Y

units - 단위 변환계수. 예를 들어,INCH 또는 MM

예외:

IllegalArgumentException - 미확인의 예외. x < 0 또는 y < 0 또는 units < 1 의 경우에 슬로우 된다

메소드의 상세

getSize

public float[] getSize(int units)

부동 소수점의 값으로 해서 지정된 단위로, 이 2 차원의 사이즈의 속성의 치수를 돌려줍니다.

파라미터:

units - 단위 변환계수. 예를 들어,INCH 또는 MM

반환값:

인덱스 0 의 치수 X 및 인덱스 1 의 치수 Y 를 가지는 2 요소의 배열

예외:

IllegalArgumentException - 미확인의 예외. units < 1 의 경우, 슬로우 된다

getX

public float getX(int units)

부동 소수점의 값으로 해서 지정된 단위로, 이 2 차원의 사이즈의 속성의 치수 X 를 돌려줍니다.

파라미터:

units - 단위 변환계수. 예를 들어,INCH 또는 MM

반환값:

치수 X

예외:

IllegalArgumentException - 미확인의 예외. units < 1 의 경우, 슬로우 된다

getY

public float getY(int units)

부동 소수점의 값으로 해서 지정된 단위로, 이 2 차원의 사이즈의 속성의 치수 Y 를 돌려줍니다.

파라미터:

units - 단위 변환계수. 예를 들어,INCH 또는 MM

반환값:

치수 Y

예외:

IllegalArgumentException - 미확인의 예외. units < 1 의 경우, 슬로우 된다

toString

public String  toString(int units,
                       String  unitsName)

이 2 차원의 사이즈의 속성의 캐릭터 라인 버젼이 지정된 단위로 돌려줍니다. 캐릭터 라인은 "XxY U" 의 형식을 취합니다. 여기서, 「X」는 치수 X, 「Y」는 치수 Y, 「U」는 단위명입니다. 값은 부동 소수점으로써 표시됩니다.

파라미터:

units - 단위 변환계수. 예를 들어,INCH 또는 MM

unitsName - 단위명의 캐릭터 라인. 예를 들어,"in" 또는 "mm". null 의 경우, 결과에 단위명은 붙이지 않을 수 없다

반환값:

이 2 차원의 사이즈의 속성의 캐릭터 라인 버젼

예외:

IllegalArgumentException - 미확인의 예외. units < 1 의 경우, 슬로우 된다

equals

public boolean equals(Object  object)

이 2 차원의 사이즈의 속성이 오브젝트에게 건네진 속성과 동일한지 어떤지를 돌려줍니다. 동등하기 때문에 는 다음의 조건의 모든 것이 true 가 아니면 안됩니다.

1. object 가 null 는 아니다
2. object 가 Size2DSyntax 의 인스턴스이다
3. 이 속성의 치수 X 가 object 의 치수 X 와 동일하다
4. 이 속성의 치수 Y 가 object 의 치수 Y 와 동일하다

오버라이드(override):

클래스 Object 내의 equals

파라미터:

object - 비교 대상의 오브젝트

반환값:

object 가 이 2 차원의 사이즈의 속성과 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode() , Hashtable

hashCode

public int hashCode()

이 2 차원의 사이즈의 속성의 해시 코드치를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 오브젝트의 해시 코드치

관련 항목:

Object.equals(java.lang.Object) , Hashtable

toString

public String  toString()

이 2 차원의 사이즈의 속성의 캐릭터 라인 버젼을 돌려줍니다. 캐릭터 라인은 "XxY um" 의 형식을 취합니다. 여기서, 「X」는 치수 X, 「Y」는 치수 Y 입니다. 값은 내부 단위 미크론으로 보고됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 오브젝트의 캐릭터 라인 표현

getXMicrometers

protected int getXMicrometers()

이 2 차원의 사이즈의 속성의 치수 X 를 미크론 (µm) 단위로 돌려줍니다 (서브 클래스에서 사용).

반환값:

치수 X (µm)

getYMicrometers

protected int getYMicrometers()

이 2 차원의 사이즈의 속성의 치수 Y 를 미크론 (µm) 단위로 돌려줍니다 (서브 클래스에서 사용).

반환값:

치수 Y (µm)