Класс 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).

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

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