javax.print.attribute
클래스 Size2DSyntax

java.lang.Object 
  javax.print.attribute.Size2DSyntax

모든 구현된 인터페이스:

Serializable, Cloneable

알려진 직계 서브 클래스:

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인 경우에 Throw 된다

Size2DSyntax

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

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

파라미터:

x - 크기 X

y - 크기 Y

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

예외:

IllegalArgumentException - (체크되지 않는 예외) x < 0 또는 y < 0 또는 units < 1인 경우에 Throw 된다

메서드의 상세

getSize

public float[] getSize(int units)

부동 소수점의 값으로 해서 지정된 단위로 이 2 차원의 사이즈의 속성의 크기를 리턴합니다.

파라미터:

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

반환값:

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

예외:

IllegalArgumentException - (체크되지 않는 예외) units < 1인 경우에 Throw 된다

getX

public float getX(int units)

부동 소수점의 값으로 해서 지정된 단위로 이 2 차원의 사이즈의 속성의 크기 X를 리턴합니다.

파라미터:

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

반환값:

크기 X

예외:

IllegalArgumentException - (체크되지 않는 예외) units < 1인 경우에 Throw 된다

getY

public float getY(int units)

부동 소수점의 값으로 해서 지정된 단위로 이 2 차원의 사이즈의 속성의 크기 Y를 리턴합니다.

파라미터:

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

반환값:

크기 Y

예외:

IllegalArgumentException - (체크되지 않는 예외) units < 1인 경우에 Throw 된다

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인 경우에 Throw 된다

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)