Класс ResolutionSyntax

public abstract class ResolutionSyntax
extends Object
implements Serializable, Cloneable

Класс 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 фактически является коэффициентом преобразования, с помощью которого нужно умножить значение в dpi, чтобы получить значение в dphi. Аналогично, экспортированная константа DPCM является коэффициентом преобразования, с помощью которого нужно умножить значение в dpcm, чтобы получить значение в dphi. Клиент может указать значение разрешения в других единицах, кроме dpi или dpcm, указав собственный коэффициент преобразования. Однако, поскольку внутренние единицы dphi были выбраны с учетом поддержки только внешних единиц dpi и dpcm, нет гарантии, что коэффициент преобразования для единиц клиента будет точным целым числом. Если коэффициент преобразования не является точным целым числом, значения разрешения в единицах клиента не будут храниться точно.