Get Video Track Dimensions
MediaPlayer
0
Что это
Pure-функция, возвращающая размеры (ширину и высоту) видеодорожки для заданного индекса трека и формата. Используется для получения исходного разрешения видео в пикселях.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (MediaPlayer Object Reference) — объект медиаплеера, у которого запрашиваются размеры
- Track Index (Integer) — индекс видеотрека (0 — первый, 1 — второй и т.д.)
- Format Index (Integer) — индекс формата внутри трека (обычно 0 для основного формата)
Выходы (данные):
- Return Value (IntPoint) — размеры видео: X = ширина, Y = высота в пикселях; если трек или формат не найден, возвращается (0, 0)
Когда используется
- Для отображения информации о видео (например, в UI-виджете с текстом «Разрешение: 1920×1080»).
- Для подстройки размера элемента воспроизведения (Media Texture, Media Player Widget) под фактическое разрешение видео.
- Для расчёта пропорций или scale при рендеринге.
Типичные проблемы
- Передача неверного индекса трека или формата — видеотрек может отсутствовать (например, медиа содержит только аудио), и функция вернёт (0,0). Перед вызовом стоит проверить количество треков через
GetNumTracksилиGetSelectedVideoTrackIndex. - Вызов до готовности медиа — до наступления события
OnMediaOpenedилиOnMediaReadyвидео ещё не загружено, и размеры могут быть нулевыми. Выполняйте запрос только после успешного открытия медиафайла. - Ошибка интерпретации результата — если видео имеет нестандартное соотношение сторон (например, квадратные пиксели в анаморфном контенте), возвращаемое разрешение может не совпадать с физическим размером экрана; учитывайте пиксельный аспект (Pixel Aspect Ratio) при необходимости.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.