java.lang.Object javax.print.attribute.ResolutionSyntax
public abstract class ResolutionSyntax
类 ResolutionSyntax 是一种抽象的基类,它提供表示打印机分辨率的所有属性的公共实现。
分辨率属性的值由两项组成,即反向进纸分辨率和进纸分辨率。通过提供两个值和指示测量该值的单位可以构造分辨率属性。提供一些方法以返回分辨率属性的值,并指示将要返回的值的单位。两个最常见分辨率单位是每英寸点数 (dpi) 和每厘米点数 (dpcm),为指示这些单位,提供了导出的常量
和 DPI
。 DPCM
一旦构造之后,分辨率属性的值就是不可变的。
设计
分辨率属性的反向进纸分辨率和进纸分辨率值是使用每 100 英寸的点数为单位 (dphi) 进行内部存储的。使用 dphi(比方说,而不是公制单位)存储该值允许在 dpi 和 dphi 之间以及 dpcm 和 dphi 之间进行精确的整数算法转换:1 dpi = 100 dphi,1 dpcm = 254 dphi。因此,可以使用任一单位将该值存储到分辨率属性,并从其获取,精度上没有任何损失。如果使用浮点表示形式,则不能保证这一点。但是,如果使用一个单位创建分辨率属性的值,使用其他单位进行获取,则通常会发生舍入误差;例如,600 dpi 将被舍入为 236 dpcm,而实际值(五位数)为 236.22 dpcm。
使用通用单位 dphi 内部存储该值可以比较这两种分辨率属性,无需考虑创建值的单位;例如,300 dpcm 将相当于 762 dpi,因为它们都存储为 76200 dphi。尤其是,查询服务可以基于它们序列化表示形式的相等性来匹配分辨率属性,而不管它们用哪种单位创建。另外,对内部存储使用整数可以允许执行精确的相等性比较,如果使用浮点表示形式,则不保证这一点。
导出的常量
实际上是转换因子,将一个以 dpi 为单位的值乘以转换因子可以获得以 dphi 为单位的值。同样,导出的常量 DPI
实际上是转换因子,将一个以 dpcm 为单位的值乘以转换因子可以获得以 dphi 为单位的值。客户机可以通过提供其自已的转换因子指定使用某些单位( dpi 或 dpcm 除外)的分辨率值。但是,由于只注意支持外部单位 dpi 和 dpcm 而选择了内部单位 dphi,所以不能保证对客户机单位的转换因子将是一个准确的整数。如果转换因子不是一个准确的整数,则使用客户机单位的分辨率值不能精确地存储。 DPCM
字段摘要 | |
---|---|
static int |
DPCM 指示每厘米点数为单位 (dpcm) 的值。 |
static int |
DPI 指示每英寸点数为单位 (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 |
字段详细信息 |
---|
public static final int DPI
public static final int DPCM
构造方法详细信息 |
---|
public ResolutionSyntax(int crossFeedResolution, int feedResolution, int units)
crossFeedResolution
- 反向进纸分辨率。
feedResolution
- 进纸分辨率。
units
- 单位转换因子,即
DPI
或
DPCM
。
IllegalArgumentException
- (未经检查的异常)如果
crossFeedResolution
< 1 或
feedResolution
< 1 或
units
< 1,则抛出该异常。
方法详细信息 |
---|
public int[] getResolution(int units)
units
- 单位转换因子,即
DPI
或
DPCM
。
IllegalArgumentException
- (未经检查的异常)如果
units
< 1,则抛出该异常。
public int getCrossFeedResolution(int units)
units
- 单位转换因子,即
DPI
或
DPCM
。
IllegalArgumentException
- (未经检查的异常)如果
units
< 1,则抛出该异常。
public int getFeedResolution(int units)
units
- 单位转换因子,即
DPI
或
DPCM
。
IllegalArgumentException
- (未经检查的异常)如果
units
< 1,则抛出该异常。
public String toString(int units, String unitsName)
"CxF U"
,其中
C 为反向进纸分辨率,
F 为进纸分辨率,
U 为单位名称。将该值舍入为最接近的整数。
units
- 单位转换因子,即
DPI
或
DPCM
。
unitsName
- 单位名称字符串,即
"dpi"
或
"dpcm"
。如果为 null,则没有任何单位名称附加到该结果。
IllegalArgumentException
- (未经检查的异常)如果
units
< 1,则抛出该异常。
public boolean lessThanOrEquals(ResolutionSyntax other)
other
属性的反向进纸分辨率。 other
属性的进纸分辨率。
other
- 与之比较的分辨率属性。
other
分辨率属性,则返回 True,否则返回 false。
NullPointerException
- (未经检查的异常)如果
other
为 null,则抛出该异常。
public boolean equals(Object object)
object
不为 null。 object
是类 ResolutionSyntax 的一个实例。 object
的反向进纸分辨率。 object
的进纸分辨率。
object
- 要比较的对象。
object
等效于此分辨率属性,则返回 True,否则返回 false。
Object.hashCode()
,
Hashtable
public int hashCode()
Object.equals(java.lang.Object)
,
Hashtable
public String toString()
"CxF dphi"
,其中
C 为反向进纸分辨率,
F 为进纸分辨率。使用内部单位 dphi 报告该值。
protected int getCrossFeedResolutionDphi()
protected int getFeedResolutionDphi()