Класс Size2DSyntax

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

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

Архитектура

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

Хранение размеров во внутренних единицах мкм позволяет сравнивать два атрибута размера без учета единиц, в которых они были созданы; например, 8,5 дюймов будет эквивалентно 215,9 мм, поскольку оба хранятся как 215900 мкм. Например, служба поиска может сопоставить атрибуты разрешения, основываясь на равенстве их сериализованных представлений независимо от единиц, в которых они были созданы. Использование целых чисел для внутреннего хранения позволяет выполнять точные сравнения на равенство, что не гарантируется при использовании внутреннего представления с плавающей точкой. Обратите внимание, что если вы ищете U.S. letter размерные медиафайлы в метрических единицах, вам необходимо искать размер медиафайла 215,9 x 279,4 мм; округление до целых 216 x 279 мм не будет соответствовать.

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