Module  java.desktop
软件包  javax.print.attribute

Class ResolutionSyntax

  • All Implemented Interfaces:
    SerializableCloneable
    已知直接子类:
    PrinterResolution


    public abstract class ResolutionSyntax
    extends Object
    implements Serializable, Cloneable
    Class ResolutionSyntax是一个抽象基类,提供表示打印机分辨率的所有属性的常见实现。

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

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

    设计

    分辨率属性的交叉进给方向分辨率和进给方向分辨率值在内部使用每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 描述
      static int DPCM
      值表示每厘米点数(dpcm)。
      static int DPI
      值表示每英寸点数(dpi)。
    • 构造方法摘要

      构造方法  
      Constructor 描述
      ResolutionSyntax​(int crossFeedResolution, int feedResolution, int units)
      从给定的项目构造一个新的分辨率属性。
    • 字段详细信息

      • 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 - 进 feedResolution方向分辨率。
        units - 单位换算系数,例如 DPIDPCM
        异常
        IllegalArgumentException - (未经检查的异常)如果为 crossFeedResolution < 1feedResolution < 1units < 1抛出。
    • 方法详细信息

      • getResolution

        public int[] getResolution​(int units)
        以给定单位获取此分辨率属性的分辨率值。 值舍入到最接近的整数。
        参数
        units - 单位换算系数,例如 DPIDPCM
        结果
        一个双元素阵列,交叉进给方向分辨率为索引0,进给方向分辨率为索引1。
        异常
        IllegalArgumentException - (未经检查的异常)抛出 units < 1
      • getCrossFeedResolution

        public int getCrossFeedResolution​(int units)
        以给定单位返回此分辨率属性的交叉进给方向分辨率。 该值舍入为最接近的整数。
        参数
        units - 单位换算系数,例如 DPIDPCM
        结果
        交叉进给方向分辨率。
        异常
        IllegalArgumentException - (未选中的异常)抛出 units < 1
      • getFeedResolution

        public int getFeedResolution​(int units)
        以给定单位返回此分辨率属性的进纸方向分辨率。 该值舍入为最接近的整数。
        参数
        units - 单位换算系数,例如 DPIDPCM
        结果
        进给方向分辨率。
        异常
        IllegalArgumentException - (未经检查的异常)抛出 units < 1
      • toString

        public String toString​(int units,
                               String unitsName)
        以给定的单位返回此分辨率属性的字符串版本。 字符串采用形式"CxF U" ,其中C是交叉进给方向分辨率, F是进给方向分辨率, U是单位名称。 值舍入到最接近的整数。
        参数
        units - 单位换算系数,例如 CODE>DPIDPCM
        unitsName - 单位名称字符串,例如"dpi""dpcm" 如果为空,则不会在结果附加单位名称。
        结果
        这个分辨率属性的字符串版本。
        异常
        IllegalArgumentException - (未经检查的异常)抛出 units < 1
      • lessThanOrEquals

        public boolean lessThanOrEquals​(ResolutionSyntax other)
        确定此分辨率属性的值是否小于或等于给定分辨率属性的值。 如果满足以下所有条件,则为真:
        • 该属性的交叉进给方向分辨率小于或等于other属性的交叉进给方向分辨率。
        • 此属性的进纸方向分辨率小于或等于other属性的进纸方向分辨率。
        参数
        other - 与...比较的分辨率属性。
        结果
        如果此分辨率属性小于或等于 other分辨率属性, other ,否则为false。
        异常
        NullPointerException - (未选中的异常)如果 other为空,则抛出。
      • equals

        public boolean equals​(Object object)
        返回此分辨率属性是否等同于传入的对象。 要相等的,所有以下条件必须为真:
        1. object不为空。
        2. object是类ResolutionSyntax的一个实例。
        3. 该属性的交叉进给方向分辨率等于object的交叉进给方向分辨率。
        4. 此属性的进纸方向分辨率等于object的进纸方向分辨率。
        重写:
        equalsObject
        参数
        object - 要比较的对象。
        结果
        如果 object等于此分辨率属性, object true,否则为false。
        另请参见:
        Object.hashCode()HashMap
      • toString

        public String toString​()
        返回此分辨率属性的字符串版本。 字符串采用"CxF dphi"形式,其中C是交叉进给方向分辨率, F是进给方向分辨率。 值在dphi的内部单位中报告。
        重写:
        toStringObject
        结果
        对象的字符串表示形式。
      • getCrossFeedResolutionDphi

        protected int getCrossFeedResolutionDphi​()
        以dphi为单位返回此分辨率属性的交叉进给方向分辨率。 (用于子类。)
        结果
        交叉进给方向分辨率。
      • getFeedResolutionDphi

        protected int getFeedResolutionDphi​()
        以dphi为单位返回此分辨率属性的Feed方向分辨率。 (用于子类。)
        结果
        进给方向分辨率。