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 로, 이 해상도 속성의 보내는 방법향의 해상도를 돌려줍니다 (서브 클래스에서 사용).

반환값:

보내는 방법향의 해상도