Класс Size2DSyntax

Значение атрибута размера в двух измерениях состоит из двух элементов: X измерения и Y измерения. Атрибут размера в двух измерениях может быть создан путём предоставления двух значений и указания единиц измерения этих значений. Предоставляются методы для возвращения значений атрибута размера в двух измерениях, указывающие единицы измерения, в которых эти значения должны быть возвращены. Две наиболее распространённые единицы измерения размера — дюймы (in) и миллиметры (mm), и экспортированные константы 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 — это коэффициент преобразования, с помощью которого нужно умножить значение в мм, чтобы получить значение в мкм. Клиент может указать значение разрешения в единицах, отличных от дюймов или мм, предоставив собственный коэффициент преобразования. Однако, так как внутренние единицы мкм были выбраны с учётом только внешних единиц дюймов и мм, нет гарантии, что коэффициент преобразования для единиц клиента будет целым числом. Если коэффициент преобразования не является целым числом, значения разрешения в единицах клиента не будут храниться точно.