Класс Size2DSyntax

Значение атрибута двухмерного размера состоит из двух элементов: измерения X и измерения Y. Атрибут двухмерного размера можно создать, указав два значения и единицы, в которых они измеряются. Предусмотрены методы для получения значений атрибута двухмерного размера с указанием единиц, в которых следует их вернуть. Две наиболее распространённые единицы измерения размера — дюймы (in) и миллиметры (mm); для их обозначения предоставляются экспортируемые константы INCH и MM.

После создания значение атрибута двухмерного размера становится неизменяемым.

Проектирование

Значения измерений X и Y атрибута двухмерного размера хранятся внутри в виде целых чисел в микрометрах (µm), где 1 микрометр = 10^-6 метра = 1/1000 миллиметра = 1/25400 дюйма. Это позволяет точно представлять размеры с точностью до 1/1000 мм (= 1 µm) или 1/100 дюйма (= 254 µm). Если дробные значения в дюймах выражены отрицательными степенями двойки, это позволяет точно представлять размеры с точностью до 1/8 дюйма (= 3175 µm), но не до 1/16 дюйма (поскольку 1/16 дюйма не равен целому числу микрометров).

Хранение измерений внутри в общих единицах µm позволяет сравнивать два атрибута размера независимо от единиц, в которых они были созданы; например, 8.5 дюйма будет равняться 215.9 мм, поскольку оба значения хранятся как 215900 µm. Например, служба поиска может сопоставлять атрибуты разрешения на основе равенства их сериализованных представлений независимо от единиц, в которых они были созданы. Использование целых чисел для внутреннего хранения позволяет выполнять точные сравнения на равенство, что не гарантировалось бы при использовании внутреннего представления с плавающей точкой. Обратите внимание: если вы ищете носитель размером U.S. letter в метрических единицах, необходимо искать носитель размером 215.9 x 279.4 мм; округление до целых 216 x 279 мм не даст совпадения.

Экспортируемая константа INCH фактически является коэффициентом преобразования, на который нужно умножить значение в дюймах, чтобы получить значение в µm. Аналогично, экспортируемая константа MM является коэффициентом преобразования, на который нужно умножить значение в мм, чтобы получить значение в µm. Клиент может указать значение разрешения в единицах, отличных от дюймов или мм, предоставив собственный коэффициент преобразования. Однако, поскольку внутренние единицы µm были выбраны с расчётом на поддержку только внешних единиц дюйма и мм, нет гарантии, что коэффициент преобразования для единиц клиента будет целым числом. Если коэффициент преобразования не является целым числом, значения разрешения в единицах клиента не будут храниться точно.