Класс QAbstractVideoFilter

Класс QAbstractVideoFilter представляет собой фильтр, который применяется к кадрам видео, получаемым типом VideoOutput. Подробнее...

Этот класс был представлен в Qt 5.5.

• Список всех членов, включая унаследованные

Свойства

• active : bool

Открытые функции

Сигналы

Подробное описание

QAbstractVideoFilter предоставляет удобный способ для приложений запускать обработку изображений, алгоритмы компьютерного зрения или любые общие преобразования или вычисления на выходе типа VideoOutput, независимо от источника (видео или камера). Предоставляя простой интерфейс, он позволяет приложениям и сторонним разработчикам легко разрабатывать типы QML, которые обеспечивают алгоритмы обработки изображений с использованием популярных фреймворков, таких как OpenCV. Благодаря тесной интеграции с последними этапами конвейера видео Qt Multimedia, также возможны ускоренные и, возможно, бессопововые решения: например, плагин, предоставляющий алгоритмы на основе OpenCL, может использовать OpenGL-совместимость OpenCL для использования текстур OpenGL, созданных ускоренным аппаратным декодером видео, без дополнительных чтений и копий.

Примечание: QAbstractVideoFilter не всегда является лучшим выбором. Для применения эффектов или преобразований с помощью шейдеров OpenGL к изображению, отображаемому на экране, следует использовать стандартный подход Qt Quick с использованием элементов ShaderEffect в сочетании с VideoOutput. VideoFilter не является заменой этому. Он скорее ориентирован на выполнение вычислений (которые не обязательно изменяют отображаемое на экране изображение) и алгоритмы компьютерного зрения, предоставляемые сторонними фреймворками.

QAbstractVideoFilter предназначен для наследования. Подклассы затем регистрируются в движке QML, чтобы их можно было использовать в качестве типа QML. Список фильтров назначается типу VideoOutput через свойство filters.

Один фильтр представляет собой одно преобразование или шаг обработки кадра видео. Выводом является измененный кадр видео, некоторые произвольные данные или оба. Например, преобразования изображений приведут к другому изображению, а алгоритм для обнаружения объектов на изображении, скорее всего, предоставит список прямоугольников.

Произвольные данные могут быть представлены как свойства подкласса QAbstractVideoFilter и экземпляров QObject или QJSValue, передаваемых в его сигналы. Что именно представляют собой эти свойства и сигналы, зависит от отдельных фильтров видео. Завершение операций может быть указано сигналами. Вычисления, которые не приводят к изменению изображения, пропускают входное изображение, чтобы после них можно было разместить последующие фильтры.

Свойства, установленные в QAbstractVideoFilter, служат входом для вычислений, аналогично тому, как задаются значения униформы в типах ShaderEffect. Измененные значения свойств используются при обработке следующего кадра видео.

Типичное использование заключается в наследовании от QAbstractVideoFilter и QVideoFilterRunnable:

class MyFilterRunnable : public QVideoFilterRunnable {
public:
    QVideoFrame run(QVideoFrame *input, const QVideoSurfaceFormat &surfaceFormat, RunFlags flags) { ... }
};

class MyFilter : public QAbstractVideoFilter {
public:
    QVideoFilterRunnable *createFilterRunnable() { return new MyFilterRunnable; }
signals:
    void finished(QObject *result);
};

int main(int argc, char **argv) {
    ...
    qmlRegisterType<MyFilter>("my.uri", 1, 0, "MyFilter");
    ...
}

Таким образом, MyFilter доступен из QML:

import my.uri 1.0

Camera {
    id: camera
}
MyFilter {
    id: filter
    // set properties, they can also be animated
    onFinished: console.log("results of the computation: " + result)
}
VideoOutput {
    source: camera
    filters: [ filter ]
    anchors.fill: parent
}

Это также позволяет предоставлять фильтры в плагинах QML отдельно от приложения.

См. также VideoOutput, Camera, MediaPlayer и QVideoFilterRunnable.

Документация по функциям-членам

QAbstractVideoFilter::QAbstractVideoFilter(QObject *parent = nullptr)

Конструирует новый экземпляр QAbstractVideoFilter с родительским объектом parent.

[pure virtual] QVideoFilterRunnable *QAbstractVideoFilter::createFilterRunnable()

Функция-фабрика для создания нового экземпляра подкласса QVideoFilterRunnable, соответствующего этому фильтру.

Эта функция вызывается в потоке, в котором графический движок Qt Quick выполняет отрисовку, с привязанным контекстом OpenGL. Владение возвращаемым экземпляром передается: возвращаемый экземпляр будет существовать в потоке отрисовки и будет автоматически уничтожен при необходимости.

Как правило, реализации функции просто создают новый экземпляр QVideoFilterRunnable, передавая this в конструктор, так как выполняющие фильтры должны знать свой связанный экземпляр QAbstractVideoFilter для доступа к динамическим свойствам и, при необходимости, для выдачи сигналов.