Get Video Track Aspect Ratio
MediaPlayer
0
Что это
Pure-функция, возвращает соотношение сторон (aspect ratio) текущего видео‑трека медиаплеера. Не требует exec-соединения — данные берутся напрямую из состояния плеера.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (MediaPlayer Object Reference) — плеер, для которого запрашивается соотношение сторон.
Выходы (данные):
- Return Value (Float) — отношение ширины к высоте видео (например, 1.7778 для 16:9).
Когда используется
- Для расчёта размеров UI-элементов под видео (например, контейнер с сохранением пропорций).
- Для проверки формата видео перед наложением субтитров или графики.
Типичные проблемы
- Вызов до того, как медиафайл открыт (MediaPlayer не в состоянии
HasMedia), — возвращает 0.0. - Вызов на плеере, который воспроизводит только аудио или не имеет видео‑трека, — возвращает 0.0.
- Путаница с пиксельным соотношением сторон (Sample Aspect Ratio) — функция возвращает именно дисплейное соотношение (Display Aspect Ratio).
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.