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