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