Класс Size2DSyntax

public abstract class Size2DSyntax
extends Object
implements Serializable, Cloneable

Класс Size2DSyntax является абстрактным базовым классом, предоставляющим общее реализацию всех атрибутов, обозначающих размер в двух измерениях.

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

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

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

Значения X и Y измерения атрибута размера в двух измерениях хранятся в памяти как целые числа в единицах микрометров (мкм), где 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 × 279,4 мм; округление до целых 216 × 279 мм не будет соответствовать.

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