javax.print.attribute

Class ResolutionSyntax

java.lang.Object

javax.print.attribute.ResolutionSyntax

All Implemented Interfaces:

Serializable ， Cloneable

已知直接子类：

PrinterResolution

public abstract class ResolutionSyntax
extends Object
implements Serializable, Cloneable

Class ResolutionSyntax是一个抽象基类，提供表示打印机分辨率的所有属性的常见实现。

分辨率属性的值由两个项目组成，即交叉进给方向分辨率和进给方向分辨率。 可以通过提供两个值并指示测量值的单位来构造分辨率属性。 提供了返回分辨率属性值的方法，指示要返回值的单位。 两个最常见的分辨率单位是每英寸点数（dpi）和每厘米点数（dpcm），并且提供用于指示这些单位的导出常数DPI和DPCM 。

一旦构造，分辨率属性的值是不可变的。

设计

分辨率属性的交叉进给方向分辨率和进给方向分辨率值在内部使用每100英寸点的单位（dphi）进行存储。 将数值存储在dphi中而不是公制单位允许在dpi和dphi之间以及dpcm和dphi之间进行精确的整数算术转换：1 dpi = 100 dphi，1 dpcm = 254 dphi。 因此，这些值可以以任何单位的分辨率属性存储和返回，而不会损失精度。 如果使用浮点表示，则无法保证。 然而，如果分辨率属性的值以一个单位创建并以不同的单位检索，则通常会发生舍入误差; 例如，600dpi将四舍五入为236dpcm，而真值（至五个数字）为236.22dpcm。

将内部值保存在dphi的常用单元中，可以比较两个分辨率属性，而不考虑创建它们的单位; 例如，300 dpcm将相当于762 dpi，因为它们都存储为76200 dphi。 特别地，查找服务可以基于其序列化表示的相等性来匹配分辨率属性，而不管它们被创建的单位如何。 再次，使用整数进行内部存储可以进行精确的等式比较，如果使用浮点表示，则不能保证。

导出的常数DPI实际上是用dpi乘以dpi的值来获取dphi中的值的转换因子。 同样，导出的常数DPCM是通过乘以dpcm中的值来获取dphi中的值的转换因子。 客户端可以通过提供自己的转换因子来指定除dpi或dpcm之外的单位的分辨率值。 但是，由于选择dphi的内部单元仅支持dpi和dpcm的外部单元，所以不能保证客户机单元的转换因子将是一个精确的整数。 如果转换因子不是一个精确的整数，客户单位的分辨率值将不会被精确存储。

另请参见：

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	DPCM 值表示每厘米点数（dpcm）。
static int	DPI 值表示每英寸点数（dpi）。

构造方法摘要

构造方法

Constructor and Description
ResolutionSyntax(int crossFeedResolution, int feedResolution, int units) 从给定的项目构造一个新的分辨率属性。

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object object) 返回此分辨率属性是否等同于传入的对象。
int	getCrossFeedResolution(int units) 以给定单位返回此分辨率属性的交叉进给方向分辨率。
protected int	getCrossFeedResolutionDphi() 以dphi为单位返回此分辨率属性的交叉进给方向分辨率。
int	getFeedResolution(int units) 以给定单位返回此分辨率属性的Feed方向分辨率。
protected int	getFeedResolutionDphi() 以dphi为单位返回此分辨率属性的Feed方向分辨率。
int[]	getResolution(int units) 以给定单位获取此分辨率属性的分辨率值。
int	hashCode() 返回此分辨率属性的哈希码值。
boolean	lessThanOrEquals(ResolutionSyntax other) 确定此分辨率属性的值是否小于或等于给定分辨率属性的值。
String	toString() 返回此分辨率属性的字符串版本。
String	toString(int units, String unitsName) 以给定的单位返回此分辨率属性的字符串版本。

Methods inherited from class java.lang.Object

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

字段详细信息

DPI

public static final int DPI

值表示每英寸点数（dpi）。 实际上是将dpi乘以产生dphi（100）的转换因子。

另请参见：

Constant Field Values

DPCM

public static final int DPCM

值表示每厘米点数（dpcm）。 它实际上是乘以dpcm来产生dphi（254）的转换因子。

另请参见：

Constant Field Values

构造方法详细信息

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。

异常

IllegalArgumentException - （未经检查的异常）如果 units < 1抛出。

getCrossFeedResolution

public int getCrossFeedResolution(int units)

以给定单位返回此分辨率属性的交叉进给方向分辨率。 该值舍入到最接近的整数。

参数

units - 单位换算系数，例如 DPI或 DPCM 。

结果

交叉进给方向分辨率。

异常

IllegalArgumentException - （未经检查的例外）如果 units < 1抛出。

getFeedResolution

public int getFeedResolution(int units)

以给定单位返回此分辨率属性的Feed方向分辨率。 该值舍入到最接近的整数。

参数

units - 单位换算系数，例如 DPI或 DPCM 。

结果

进给方向分辨率。

异常

IllegalArgumentException - （未经检查的异常）如果 units < 1抛出。

toString

public String toString(int units,
                       String unitsName)

以给定的单位返回此分辨率属性的字符串版本。 字符串采用格式"CxF U" ，其中C是交叉进给方向分辨率， F是进给方向分辨率， U是单位名称。 值舍入到最接近的整数。

参数

units - 单位换算系数，例如 CODE>DPI或 DPCM 。

unitsName - 单位名称字符串，例如"dpi"或"dpcm" 。 如果为空，则不会在结果附加单位名称。

结果

这个分辨率属性的字符串版本。

异常

IllegalArgumentException - （未经检查的异常）如果 units < 1抛出。

lessThanOrEquals

public boolean lessThanOrEquals(ResolutionSyntax other)

确定此分辨率属性的值是否小于或等于给定分辨率属性的值。 如果满足以下所有条件，则为真：

• 该属性的交叉进给方向分辨率小于或等于other属性的交叉进给方向分辨率。
• 此属性的进纸方向分辨率小于或等于other属性的进纸方向分辨率。

参数

other - 与...比较的分辨率属性。

结果

如果此分辨率属性小于或等于 other分辨率属性，则为真，否则为false。

异常

NullPointerException - （未选中的异常）如果 other为空，则抛出。

equals

public boolean equals(Object object)

返回此分辨率属性是否等同于传入的对象。 要相等的，所有以下条件必须为真：

1. object不为空。
2. object是一个类ResolutionSyntax的实例。
3. 该属性的交叉进给方向分辨率等于object的交叉进给方向分辨率。
4. 此属性的进纸方向分辨率等于object的进纸方向分辨率。

重写：

equals在类别 Object

参数

object - 要比较的对象。

结果

如果 object于此分辨率属性，则为True， object为false。

另请参见：

Object.hashCode() ， HashMap

hashCode

public int hashCode()

返回此分辨率属性的哈希码值。

重写：

hashCode在类 Object

结果

该对象的哈希码值。

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)

toString

public String toString()

返回此分辨率属性的字符串版本。 字符串采用格式"CxF dphi" ，其中C是交叉进给方向分辨率， F是进给方向分辨率。 值在dphi的内部单位中报告。

重写：

toString在类别 Object

结果

对象的字符串表示形式。

getCrossFeedResolutionDphi

protected int getCrossFeedResolutionDphi()

以dphi为单位返回此分辨率属性的交叉进给方向分辨率。 （用于子类。）

结果

交叉进给方向分辨率。

getFeedResolutionDphi

protected int getFeedResolutionDphi()

以dphi为单位返回此分辨率属性的Feed方向分辨率。 （用于子类。）

结果

进给方向分辨率。