VideoReader

Создайте объект считать видеофайлы

Описание

Используйте VideoReader возразите, чтобы считать файлы, содержащие видеоданные. Объект содержит информацию о видеофайле и позволяет вам считать данные из видео. Можно создать VideoReader объект с помощью VideoReader функция, информация о запросе о видео с помощью свойств объектов, и затем читают видео, используя функции объекта.

Для получения дополнительной информации смотрите Поддерживаемые Форматы видео и Форматы аудиофайла.

Создание

Синтаксис

v = VideoReader(filename)

v = VideoReader(filename,Name,Value)

Описание

пример

v = VideoReader(filename) создает объект v считать видеоданные из файла с именем filename.

пример

v = VideoReader(filename,Name,Value) устанавливает свойства CurrentTimeТег, и UserData использование пар "имя-значение". Например, VideoReader('myfile.mp4','CurrentTime',1.2) начинает читать 1.2 секунды в видео. Можно задать несколько пар "имя-значение". Заключите каждое имя свойства в одинарные кавычки, сопровождаемые соответствующим значением.

Входные параметры

развернуть все

`filename` FileName
вектор символов | строковый скаляр

Имя файла в виде вектора символов или строкового скаляра.

Для получения дополнительной информации смотрите Поддерживаемые Форматы видео и Форматы аудиофайла.

Пример: 'myFile.mp4'

Пример: '../dir/videos/myFile.avi'

Типы данных: char | string

Свойства

развернуть все

VideoReader объект имеет свойства, которые содержат информацию о видеофайле. Свойства только для чтения, кроме CurrentTimeТег, и UserData. Можно просмотреть или изменить значение свойства после создания объекта. Например, эта команда находит значение Duration свойство VideoReader объект, v.

D = v.Duration;

`BitsPerPixel` — Биты на пиксель видеоданных
числовой скаляр

Это свойство доступно только для чтения.

Биты на пиксель видеоданных в виде числового скаляра.

Типы данных: double

`CurrentTime` — Метка времени видеокадра, чтобы читать
числовой скаляр

Метка времени видеокадра, чтобы читать в виде числового скаляра. Метка времени задана в секундах от запуска видеофайла. Значение CurrentTime может быть между нулем и длительностью видео.

На некоторых платформах, когда вы создаете VideoReader объект, 'CurrentTime' свойство может содержать значение близко к, но не точно, нуль. Это изменение значения 'CurrentTime' свойство происходит из-за различий в как каждый видео чтений и процессы платформы.

Пример: 5.6

Типы данных: double

`Duration` — Длина файла
числовой скаляр

Это свойство доступно только для чтения.

Длина файла в секундах в виде числового скаляра.

Типы данных: double

`FrameRate` — Количество видеокадров в секунду
числовой скаляр

Это свойство доступно только для чтения.

Количество видеокадров в секунду в виде числового скаляра. Для видео переменной частоты кадров, FrameRate средняя частота кадров.

Примечание: Для OS X Йосемити (Версия 10.10) и позже, MPEG-4/H.264 файлы записанное использование VideoWriter вопроизведите правильно, но отобразите неточную частоту кадров.

Типы данных: double

`Height` — Высота видеокадра
числовой скаляр

Это свойство доступно только для чтения.

Высота видеокадра в пикселях в виде числового скаляра.

Типы данных: double

`Name` FileName
вектор символов | строковый скаляр

Это свойство доступно только для чтения.

Имя файла в виде вектора символов или строкового скаляра.

Типы данных: char | string

`NumFrames` — Количество систем координат в видеопотоке
числовой скаляр

Это свойство доступно только для чтения.

Количество систем координат в видеопотоке в виде числового скаляра.

Примечание

Для определенных видео длины, значения NumFrames свойство не сразу доступно. Получить NumFrames свойство, введите v.NumFrames в командной строке.

Типы данных: double

`Path` — Полный путь к видеофайлу
вектор символов | строковый скаляр

Это свойство доступно только для чтения.

Полный путь к видеофайлу, сопоставленному с читателем, возражает в виде вектора символов или строкового скаляра.

Типы данных: char | string

`Tag` — Типовой текст
`''` (значение по умолчанию) | вектор символов | строковый скаляр

Типовой текст в виде вектора символов или строкового скаляра.

Пример: 'Experiment 109'

Типы данных: char | string

`UserData` — Пользовательские данные
`[]` (значение по умолчанию) | любой тип данных

Пользовательские данные в виде значения любого типа данных.

`VideoFormat` — Представление MATLAB^® формата видео
вектор символов | строковый скаляр

Это свойство доступно только для чтения.

Представление MATLAB формата видео в виде вектора символов или строкового скаляра.

Типы файлов, за исключением файлов Motion JPEG 2000, имеют один из них VideoFormat значения.

VideoFormat	Значение `VideoFormat`
AVI или MPEG 4 файла с видео RGB24	`'RGB24'`
Файлы AVI с индексируемым видео	`'Indexed'`
Файлы AVI с полутоновым видео	`'Grayscale'`

Файлы Motion JPEG 2000, имейте один из следующего VideoFormat значения.

Формат данных изображения	Значение `VideoFormat`
Одно полоса `uint8`	`'Mono8'`
Одно полоса `int8`	`'Mono8 Signed'`
Одно полоса `uint16`	`'Mono16'`
Одно полоса `int16`	`'Mono16 Signed'`
`uint8` с тремя полосами	`'RGB24'`
`int8` с тремя полосами	`'RGB24 Signed'`
`uint16` с тремя полосами	`'RGB48'`
`int16` с тремя полосами	`'RGB48 Signed'`

Типы данных: char | string

`Width` — Ширина видеокадра
числовой скаляр

Это свойство доступно только для чтения.

Ширина видеокадра в пикселях в виде числового скаляра.

Типы данных: double

Функции объекта

`hasFrame`	Определите, доступен ли видеокадр в чтение
`read`	Считайте один или несколько видеокадров
`readFrame`	Считайте следующий видеокадр
`VideoReader.getFileFormats`	Форматы файлов, что `VideoReader` поддержки

Примеры

свернуть все

Создание видео объекта и чтения VideoReader

Скрипт Open Live Script

Создайте VideoReader объект для файла ролика в качестве примера xylophone.mp4.

v = VideoReader('xylophone.mp4');

Считайте все системы координат из видео, одна система координат за один раз.

while hasFrame(v)
    frame = readFrame(v);
end

Отобразите информацию о последней системе координат, возвращенной readFrame.

whos frame

  Name         Size                Bytes  Class    Attributes

  frame      240x320x3            230400  uint8

Считайте видеокадры, запускающиеся в определенное время

Создайте видео объект читателя и считайте видеокадры, запускающиеся в определенное время.

Создайте объект считать файл ролика в качестве примера xylophone.mp4.

v = VideoReader('xylophone.mp4');

Задайте чтение, чтобы начать 2,5 секунды с начала видео.

v.CurrentTime = 2.5;

Создайте объект осей отобразить систему координат. Затем продолжите читать и отображать видеокадры, пока больше систем координат не будет доступно в чтение.

currAxes = axes;
while hasFrame(v)
    vidFrame = readFrame(v);
    image(vidFrame, 'Parent', currAxes);
    currAxes.Visible = 'off';
    pause(1/v.FrameRate);
end

Считайте видеокадры Используя индекс системы координат

Скрипт Open Live Script

Создайте видео объект читателя и считайте один или несколько видеокадров с помощью индексов системы координат.

Создайте VideoReader объект для файла ролика в качестве примера xylophone.mp4.

v = VideoReader('xylophone.mp4');

Только для чтения первый видеокадр.

frame = read(v,1);

Только для чтения последний видеокадр.

frame = read(v,Inf);

Считайте системы координат 5 - 10.

frames = read(v,[5 10]);

Читайте из 50-й системы координат в конец видеофайла.

frames = read(v,[50 Inf]);

Считайте видео Используя индекс системы координат и время взаимозаменяемо

Скрипт Open Live Script

Считайте систему координат из видео путем определения индекса системы координат, и затем считайте остающиеся системы координат видео одна система координат за один раз.

Создайте VideoReader возразите и отобразите значение CurrentTime свойство. Для этого видео, нулевого значения для CurrentTime свойство указывает, что никакие системы координат не были считаны из видео.

vidObj = VideoReader('xylophone.mp4');
vidObj.CurrentTime

ans = 0

Считайте 20-ю систему координат из видео путем определения индекса системы координат. Затем отобразите значение CurrentTime свойство. read метод автоматически обновляет CurrentTime свойство отразить, что 20-я система координат была считана. На этом шаге, вызове readFrame функция возвратила бы 21-ю систему координат.

frame20 = read(vidObj,20);
vidObj.CurrentTime

ans = 0.6667

Считайте остающиеся системы координат видео с помощью readFrame метод. readFrame метод возвращает систему координат, соответствующую времени в CurrentTime свойство. Например, этот код читает и отображает системы координат, запускающиеся в 21-й системе координат, и продолжается, пока больше нет систем координат, чтобы читать.

while(hasFrame(vidObj))
    frame = readFrame(vidObj);
    imshow(frame);
    title(sprintf('Current Time = %.3f sec', vidObj.CurrentTime));
    pause(2/vidObj.FrameRate);
end

Figure contains an axes. The axes with title Current Time = 4.700 sec contains an object of type image.

Ограничения

Для некоторого AVI, MOV или файлов MP4 на Windows^®, с помощью readFrame функционируйте, чтобы читать, все системы координат в файле могут привести к различному количеству систем координат, чем значение, возвращенное NumFrames свойство VideoReader объект.

Советы

macOS платформа больше не поддерживает определенные более старые форматы видеофайла. Считать такие файлы с помощью VideoReader:
- Откройте видеофайл с помощью проигрывателя QuickTime. Если проигрыватель обнаруживает файл, чтобы быть более старого формата, то он автоматически преобразует файл в более новый формат.
- Сохраните недавно конвертированный видеофайл.
- Используйте VideoReader считать этот недавно конвертированный видеофайл.

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Указания и ограничения по применению:

Генерация кода для VideoReader поддержки большинство форматов, синтаксисов, методов и функций с нижеследующими ограничениями.

Генерация кода графического процессора
Сгенерируйте код CUDA® для NVIDIA® графические процессоры с помощью GPU Coder™.

Указания и ограничения по применению:

С Пакетом Поддержки MATLAB Coder™ для NVIDIA^® Jetson^® и NVIDIA Платформы Drive™, можно сгенерировать код CUDA^® для VideoReader MATLAB возразите, чтобы считать файлы, содержащие видеоданные на целевом компьютере NVIDIA.

Чтобы изучить, как сгенерировать код CUDA для чтения видеофайлов на NVIDIA, предназначаются при помощи VideoReader функционируйте, см. Видеофайлы Чтения на Оборудовании NVIDIA (Пакет Поддержки MATLAB Coder для NVIDIA, Джетсон и NVIDIA УПРАВЛЯЮТ Платформами).

Сгенерированный код использует Library API GStreamer, чтобы считать видеофайлы. Необходимо установить библиотеку GStreamer (v1.0 или выше) на целевой платформе NVIDIA.
Для генерации кода только файл (контейнер) поддерживаются форматы и кодеки, которые совместимы с GStreamer.
Для генерации кода, VideoReader функция требует полного пути к видеофайлу на целевом компьютере.
Методы и функции:
- read и readFrame — Генерация кода не поддерживает дополнительный позиционный параметр native.
- VideoReader.getFileFormats — Генерация кода не поддерживает этот метод.

Смотрите также

mmfileinfo | VideoWriter

Темы

Чтение видеофайлов

Представленный в R2010b

Документация

VideoReader

Описание

Создание

Синтаксис

Описание

Входные параметры

`filename` FileName
вектор символов | строковый скаляр

Свойства

`BitsPerPixel` — Биты на пиксель видеоданных
числовой скаляр

`CurrentTime` — Метка времени видеокадра, чтобы читать
числовой скаляр

`Duration` — Длина файла
числовой скаляр

`FrameRate` — Количество видеокадров в секунду
числовой скаляр

`Height` — Высота видеокадра
числовой скаляр

`Name` FileName
вектор символов | строковый скаляр

`NumFrames` — Количество систем координат в видеопотоке
числовой скаляр

`Path` — Полный путь к видеофайлу
вектор символов | строковый скаляр

`Tag` — Типовой текст
`''` (значение по умолчанию) | вектор символов | строковый скаляр

`UserData` — Пользовательские данные
`[]` (значение по умолчанию) | любой тип данных

`VideoFormat` — Представление MATLAB^® формата видео
вектор символов | строковый скаляр

`Width` — Ширина видеокадра
числовой скаляр

Функции объекта

Примеры

Создание видео объекта и чтения VideoReader

Считайте видеокадры, запускающиеся в определенное время

Считайте видеокадры Используя индекс системы координат

Считайте видео Используя индекс системы координат и время взаимозаменяемо

Ограничения

Советы

Расширенные возможности

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Генерация кода графического процессора
Сгенерируйте код CUDA® для NVIDIA® графические процессоры с помощью GPU Coder™.

Смотрите также

Темы

Документация MATLAB

Поддержка

Документация

VideoReader

Описание

Создание

Синтаксис

Описание

Входные параметры

filename FileName вектор символов | строковый скаляр

Свойства

BitsPerPixel — Биты на пиксель видеоданных числовой скаляр

CurrentTime — Метка времени видеокадра, чтобы читать числовой скаляр

Duration — Длина файла числовой скаляр

FrameRate — Количество видеокадров в секунду числовой скаляр

Height — Высота видеокадра числовой скаляр

Name FileName вектор символов | строковый скаляр

NumFrames — Количество систем координат в видеопотоке числовой скаляр

Path — Полный путь к видеофайлу вектор символов | строковый скаляр

Tag — Типовой текст '' (значение по умолчанию) | вектор символов | строковый скаляр

UserData — Пользовательские данные [] (значение по умолчанию) | любой тип данных

VideoFormat — Представление MATLAB® формата видео вектор символов | строковый скаляр

Width — Ширина видеокадра числовой скаляр

Функции объекта

Примеры

Создание видео объекта и чтения VideoReader

Считайте видеокадры, запускающиеся в определенное время

Считайте видеокадры Используя индекс системы координат

Считайте видео Используя индекс системы координат и время взаимозаменяемо

Ограничения

Советы

Расширенные возможности

Генерация кода C/C++ Генерация кода C и C++ с помощью MATLAB® Coder™.

Генерация кода графического процессора Сгенерируйте код CUDA® для NVIDIA® графические процессоры с помощью GPU Coder™.

Смотрите также

Темы

Документация MATLAB

Поддержка

`filename` FileName
вектор символов | строковый скаляр

`BitsPerPixel` — Биты на пиксель видеоданных
числовой скаляр

`CurrentTime` — Метка времени видеокадра, чтобы читать
числовой скаляр

`Duration` — Длина файла
числовой скаляр

`FrameRate` — Количество видеокадров в секунду
числовой скаляр

`Height` — Высота видеокадра
числовой скаляр

`Name` FileName
вектор символов | строковый скаляр

`NumFrames` — Количество систем координат в видеопотоке
числовой скаляр

`Path` — Полный путь к видеофайлу
вектор символов | строковый скаляр

`Tag` — Типовой текст
`''` (значение по умолчанию) | вектор символов | строковый скаляр

`UserData` — Пользовательские данные
`[]` (значение по умолчанию) | любой тип данных

`VideoFormat` — Представление MATLAB^® формата видео
вектор символов | строковый скаляр

`Width` — Ширина видеокадра
числовой скаляр

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Генерация кода графического процессора
Сгенерируйте код CUDA® для NVIDIA® графические процессоры с помощью GPU Coder™.