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