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