javax.print.attribute
클래스 ResolutionSyntax

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

모든 구현 인터페이스:

Cloneable , Serializable

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

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 의 경우에 슬로우 된다

메소드의 상세

getResolution

public int[] getResolution(int units)

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

파라미터:

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

반환값:

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

예외:

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

getCrossFeedResolution

public int getCrossFeedResolution(int units)

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

파라미터:

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

반환값:

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

예외:

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

getFeedResolution

public int getFeedResolution(int units)

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

파라미터:

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

반환값:

보내는 방법향의 해상도

예외:

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

toString

public String  toString(int units,
                       String  unitsName)

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

파라미터:

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

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

반환값:

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

예외:

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

lessThanOrEquals

public boolean lessThanOrEquals(ResolutionSyntax  other)

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

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

파라미터:

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

반환값:

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

예외:

NullPointerException - 미확인의 예외. other 가 null 의 경우, 슬로우 된다

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

반환값:

보내는 방법향의 해상도