Класс 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, нет гарантии, что коэффициент преобразования для единиц клиента будет точным целым числом. Если коэффициент преобразования не является целым числом, значения разрешения в единицах клиента не будут храниться точно.