javax.print.attribute
클래스 ResolutionSyntax

java.lang.Object 
  javax.print.attribute.ResolutionSyntax

모든 구현된 인터페이스:

Serializable, Cloneable

알려진 직계 서브 클래스:

PrinterResolution

public abstract class ResolutionSyntax
extends Object 
implements Serializable,
 Cloneable 

ResolutionSyntax 클래스는 프린터의 해상도를 나타내는 모든 속성의 일반적인 구현을 제공하는 추상 base class입니다.

해상도 속성의 값은 전후 보내는 방법향의 해상도와 보내는 방법향의 해상도의 2 항목으로부터 구성됩니다. 해상도 속성은 이 2개의 값을 제공해, 값을 측정하는 단위를 지정하는 것으로써 구축됩니다. 메서드는 해상도 속성의 값을 돌려주도록 제공되어 값이 리턴된 단위가 나타납니다. 무엇보다 일반적인 2 종류의 해상도의 단위는 1 인치 근처의 닷수 (dpi)와 1 센치당의 닷수 (dpcm)로 export 되는 정수 DPI 와 DPCM 는 이러한 단위를 나타내기 위해서 제공됩니다.

해상도 속성은 일단 구축된다고 변경할 수 없습니다.

설계

해상도 속성의 전후 보내는 방법향의 해상도와 보내는 방법향의 해상도의 값은 100 인치 근처 닷수 (dphi) 단위를 사용해 내부에 포함됩니다. 이른바 미터법 단위가 아니고 dphi 단위의 값을 포함하는 것으로써, 1 dpi = 100 dphi, 1 dpcm = 254 dphi 등 dpi와 dphi와 의 사이 및 dpcm와 dphi와 의 사이의 정수형의 정확한 산술 변환이 가능하게 됩니다. 이 결과, 값이 어느 단위에서도 정확함을 잃는 일 없이 해상도 속성에 포함되어 꺼낼 수 있습니다. 부동 소수점의 표현이 사용되는 경우, 이것은 보증되지 않습니다. 다만, 해상도 속성의 값이 있는 단위로 작성되어 다른 단위로 꺼내졌을 경우, 보통 사사오입의 오차가 발생합니다. 예를 들어 600 dpi는 5 자리수의 진정한 값은 236.22 dpcm 인데 236 dpcm에 사사오입 됩니다.

dphi를 공통의 단위로서 값을 내부에 포함하는 것으로써, 작성된 단위에 관계없이 2개의 해상도 속성을 비교할 수 있습니다. 예를 들어 양쪽 모두 76200 dphi 로서 포함되고 있기 때문에 300 dpcm는 762 dpi와 동일한 일이 비교에 의해 압니다. 특히, 검색 서비스는 작성된 단위에 관계없이, 직렬화 표현이 동일한지 어떤지에 근거해 해상도 속성을 조합할 수 있습니다. 이와 같이, 내부 기억에 정수형을 사용하는 것으로써, 정확한 동등성의 비교가 가능하게 됩니다. 다만, 이것은 부동 소수점 표현이 사용되는 경우는 보증되지 않습니다.

export 되는 정수 DPI 는 실제로 dpi 단위의 값에 곱셈해, dphi 단위의 값을 얻는 변환계수입니다. 같이 export 되는 정수 DPCM 는 dpcm 단위의 값에 곱셈해 dphi 단위의 값을 얻는 변환계수입니다. 클라이언트는 클라이언트 자신의 변환계수를 제공해 dpi 또는 dpcm 이외의 단위로 해상도 속성을 지정할 수 있습니다. 다만, 내부 단위 dphi는 외부 단위 dpi와 dpcm 만을 고려해 지원 하도록 선택되고 있으므로 클라이언트의 단위의 변환계수가 정확한 정수형이 될지 어떨지 보증되지 않습니다. 변환계수가 정확한 정수형이 아닌 경우, 클라이언트의 단위의 해상도의 값은 정확하게 포함되지 않습니다.

관련 항목:

직렬화 된 형식

필드 개요

static int	DPCM 1 센치당 닷수 (dpcm)를 나타내는 값입니다.
static int	DPI 1 인치 근처 닷수 (dpi)를 나타내는 값입니다.

생성자 개요

ResolutionSyntax (int crossFeedResolution, int feedResolution, int units)
지정된 항목으로부터 새로운 해상도 속성을 구축합니다.

메서드 개요

boolean	equals (Object object) 이 해상도 속성이 객체에게 건네진 속성과 동일한지 어떤지를 리턴합니다.
int	getCrossFeedResolution (int units) 지정된 단위로 해상도 속성의 전후 보내는 방법향의 해상도를 리턴합니다.
protected int	getCrossFeedResolutionDphi () 단위 dphi 로 이 해상도 속성의 전후 보내는 방법향의 해상도를 리턴합니다 (서브 클래스에서 사용).
int	getFeedResolution (int units) 지정된 단위로 해상도 속성의 보내는 방법향의 해상도를 리턴합니다.
protected int	getFeedResolutionDphi () 단위 dphi 로 이 해상도 속성의 보내는 방법향의 해상도를 리턴합니다 (서브 클래스에서 사용).
int[]	getResolution (int units) 지정된 단위로 해상도 속성의 값을 리턴합니다.
int	hashCode () 이 해상도 속성의 해시 코드값을 리턴합니다.
boolean	lessThanOrEquals (ResolutionSyntax other) 이 해상도 속성의 값이 지정된 해상도 속성의 값보다 작은가 또는 동일한지 어떤지를 판정합니다.
String	toString () 이 해상도 속성의 캐릭터 라인 버전을 리턴합니다.
String	toString (int units, String unitsName) 지정된 단위로 해상도 속성의 캐릭터 라인 버전을 리턴합니다.

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

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

필드의 상세

DPI

public static final int DPI

1 인치 근처 닷수 (dpi)를 나타내는 값입니다. 이것은 실제로 dpi에 곱셈해 dphi (100)를 산출하는 변환계수입니다.

관련 항목:

정수 필드값

DPCM

public static final int DPCM

1 센치당 닷수 (dpcm)를 나타내는 값입니다. 이것은 실제로 dpcm에 곱셈해 dphi (254)를 산출하는 변환계수입니다.

관련 항목:

정수 필드값

생성자 상세

ResolutionSyntax

public ResolutionSyntax(int crossFeedResolution,
                        int feedResolution,
                        int units)

지정된 항목으로부터 새로운 해상도 속성을 구축합니다.

파라미터:

crossFeedResolution - 전후 보내는 방법향의 해상도

feedResolution - 보내는 방법향의 해상도

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

예외:

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

메서드의 상세

getResolution

public int[] getResolution(int units)

지정된 단위로 해상도 속성의 값을 리턴합니다. 값은 가장 가까운 정수값에 사사오입 됩니다.

파라미터:

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

반환값:

인덱스 0에 있는 전후 보내는 방법향의 해상도 및 인덱스 1에 있는 보내는 방법향의 해상도를 가지는 2 요소의 배열

예외:

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

getCrossFeedResolution

public int getCrossFeedResolution(int units)

지정된 단위로 해상도 속성의 전후 보내는 방법향의 해상도를 리턴합니다. 값은 가장 가까운 정수값에 사사오입 됩니다.

파라미터:

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

반환값:

전후 보내는 방법향의 해상도

예외:

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

getFeedResolution

public int getFeedResolution(int units)

지정된 단위로 해상도 속성의 보내는 방법향의 해상도를 리턴합니다. 값은 가장 가까운 정수값에 사사오입 됩니다.

파라미터:

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

반환값:

보내는 방법향의 해상도

예외:

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

toString

public String  toString(int units,
                       String  unitsName)

지정된 단위로 해상도 속성의 캐릭터 라인 버전을 리턴합니다. 캐릭터 라인은, 「CxF U」 형식을 취합니다. 여기서, C는 전후 보내는 방법향의 해상도, F는 보내는 방법향의 해상도, U는 단위명입니다. 값은 가장 가까운 정수값에 사사오입 됩니다.

파라미터:

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

unitsName - 단위명의 캐릭터 라인. 예를 들어, 「dpi」 또는 「dpcm」. null인 경우, 결과에 단위명을 붙일 수 없습니다.

반환값:

이 해상도 속성의 캐릭터 라인 버전

예외:

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

lessThanOrEquals

public boolean lessThanOrEquals(ResolutionSyntax  other)

이 해상도 속성의 값이 지정된 해상도 속성의 값보다 작은가 또는 동일한지 어떤지를 판정합니다. 다음의 모든 조건이 true인 경우에 true가 됩니다.

• 이 속성의 전후 보내는 방법향의 해상도가 other 속성의 전후 보내는 방법향의 해상도보다 작은지, 또는 동일하다
• 이 속성의 보내는 방법향의 해상도가 other 속성의 보내는 방법향의 해상도보다 작은지, 또는 동일하다

파라미터:

other - 비교 대상의 해상도 속성

반환값:

이 해상도 속성이 other 해상도 속성보다 작은지, 또는 동일한 경우는 true, 그렇지 않은 경우는 false

예외:

NullPointerException - (체크되지 않는 예외) other가 null인 경우에 Throw 된다

equals

public boolean equals(Object  object)

이 해상도 속성이 객체에게 건네진 속성과 동일한지 어떤지를 리턴합니다. 동등하기 때문에는 다음의 조건의 모든 것이 true가 아니면 안됩니다.

1. object가 null은 아니다
2. object가 ResolutionSyntax 클래스의 인스턴스이다
3. 이 속성의 전후 보내는 방법향의 해상도가 object 전후 보내는 방법향의 해상도에 동일하다
4. 이 속성의 보내는 방법향의 해상도가 object 보내는 방법향의 해상도에 동일하다

오버라이드(override):

클래스 Object 내의 equals

파라미터:

object - 비교 대상의 객체

반환값:

object가 이 해상도 속성과 동일한 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 해상도 속성의 해시 코드값을 리턴합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

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

toString

public String  toString()

이 해상도 속성의 캐릭터 라인 버전을 리턴합니다. 캐릭터 라인은, 「CxF dphi」 형식을 취합니다. 여기서, C는 전후 보내는 방법향의 해상도, F는 보내는 방법향의 해상도입니다. 값은 내부 단위 dphi 로 보고됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 객체의 캐릭터 라인 표현

getCrossFeedResolutionDphi

protected int getCrossFeedResolutionDphi()

단위 dphi 로 이 해상도 속성의 전후 보내는 방법향의 해상도를 리턴합니다 (서브 클래스에서 사용).

반환값:

전후 보내는 방법향의 해상도

getFeedResolutionDphi

protected int getFeedResolutionDphi()

단위 dphi 로 이 해상도 속성의 보내는 방법향의 해상도를 리턴합니다 (서브 클래스에서 사용).

반환값:

보내는 방법향의 해상도