PerspectivePositioner

Главная идея PerspectivePositioner — привязать прямоугольный исходник к произвольному четырёхугольнику. Нода берёт входное изображение и растягивает его так, чтобы верхний левый, верхний правый, нижний левый и нижний правый углы оказались в заданных координатах кадра.

В отличие от Transform, где слой остаётся прямоугольным и поворачивается как плоская карточка, PerspectivePositioner меняет геометрию углов независимо. Поэтому ей удобно вставлять графику в экран телефона, телевизор, монитор, билборд, постер, книгу, табличку или любой объект, снятый под углом.

Mapping type определяет характер пересчёта пикселей между исходным прямоугольником и новой формой. Bi-Linear даёт более простое линейное растяжение, а Perspective сохраняет ощущение перспективной плоскости и обычно лучше подходит для реальных кадров, где дальняя сторона объекта визуально сжата.

Координаты углов задаются в нормализованной системе Fusion: X и Y обычно идут от 0 до 1 внутри кадра. X=0 — левый край, X=1 — правый край, Y=0 — нижняя часть, Y=1 — верхняя часть. Значение 0.5 означает центр по соответствующей оси. В примере на скриншоте углы образуют трапецию, из-за чего слой получает перспективный наклон.

Для аккуратной работы важно соблюдать порядок углов. Top Left должен оставаться верхним левым углом вставляемой плоскости, Top Right — верхним правым, Bottom Left — нижним левым, Bottom Right — нижним правым. Если углы пересечь или поменять местами, изображение может вывернуться, сложиться, стать зеркальным или получить резкую диагональную деформацию.

PerspectivePositioner особенно полезен в связке с трекерами. На статичном кадре углы можно выставить вручную. На движущемся объекте чаще используют Tracker, PlanarTracker или ручную анимацию углов, чтобы вставленная графика удерживалась на поверхности на протяжении всего плана.