mirror of
https://code.videolan.org/videolan/vlc
synced 2024-09-24 20:48:52 +02:00
include: vlc_opengl_filter: import filter.h from modules/
Import the filter.h header into the include/ so that new implementations can be written without using headers from modules/. This enables cleaner approach to write test driver using filters, which was used when testing the OpenGL implementation and the matching interop for emscripten.
This commit is contained in:
parent
5c83ea9745
commit
18bcf2bf33
160
include/vlc_opengl_filter.h
Normal file
160
include/vlc_opengl_filter.h
Normal file
@ -0,0 +1,160 @@
|
||||
/*****************************************************************************
|
||||
* vlc_opengl_filter.h
|
||||
*****************************************************************************
|
||||
* Copyright (C) 2020 VLC authors and VideoLAN
|
||||
* Copyright (C) 2020-2023 Videolabs
|
||||
*
|
||||
* Authors: Alexandre Janniaux <ajanni@videolabs.io>
|
||||
*
|
||||
* This program is free software; you can redistribute it and/or modify it
|
||||
* under the terms of the GNU Lesser General Public License as published by
|
||||
* the Free Software Foundation; either version 2.1 of the License, or
|
||||
* (at your option) any later version.
|
||||
*
|
||||
* This program is distributed in the hope that it will be useful,
|
||||
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
* GNU Lesser General Public License for more details.
|
||||
*
|
||||
* You should have received a copy of the GNU Lesser General Public License
|
||||
* along with this program; if not, write to the Free Software Foundation,
|
||||
* Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
|
||||
*****************************************************************************/
|
||||
|
||||
#ifndef VLC_OPENGL_FILTER_H
|
||||
#define VLC_OPENGL_FILTER_H
|
||||
|
||||
#include <vlc_tick.h>
|
||||
#include <vlc_es.h>
|
||||
|
||||
struct vlc_gl_filter;
|
||||
struct vlc_gl_picture;
|
||||
struct vlc_gl_format;
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C"
|
||||
{
|
||||
#endif
|
||||
|
||||
struct vlc_gl_tex_size {
|
||||
unsigned width;
|
||||
unsigned height;
|
||||
};
|
||||
|
||||
struct vlc_gl_input_meta {
|
||||
vlc_tick_t pts;
|
||||
unsigned plane;
|
||||
const vlc_video_dovi_metadata_t *dovi_rpu;
|
||||
};
|
||||
|
||||
typedef int
|
||||
vlc_gl_filter_open_fn(struct vlc_gl_filter *filter,
|
||||
const config_chain_t *config,
|
||||
const struct vlc_gl_format *glfmt,
|
||||
struct vlc_gl_tex_size *size_out);
|
||||
|
||||
#define set_callback_opengl_filter(open) \
|
||||
{ \
|
||||
vlc_gl_filter_open_fn *fn = open; \
|
||||
(void) fn; \
|
||||
set_callback(fn); \
|
||||
}
|
||||
|
||||
struct vlc_gl_filter_ops {
|
||||
/**
|
||||
* Draw the result of the filter to the current framebuffer
|
||||
*/
|
||||
int (*draw)(struct vlc_gl_filter *filter, const struct vlc_gl_picture *pic,
|
||||
const struct vlc_gl_input_meta *meta);
|
||||
|
||||
/**
|
||||
* Free filter resources
|
||||
*/
|
||||
void (*close)(struct vlc_gl_filter *filter);
|
||||
|
||||
/**
|
||||
* Request a (responsive) filter to adapt its output size (optional)
|
||||
*
|
||||
* A responsive filter is a filter for which the size of the produced
|
||||
* pictures depends on the output (e.g. display) size rather than the
|
||||
* input. This is for example the case for a renderer.
|
||||
*
|
||||
* A new output size is requested (size_out). The filter is authorized to
|
||||
* change the size_out to enforce its own constraints.
|
||||
*
|
||||
* In addition, it may request to the previous filter (if any) an optimal
|
||||
* size it wants to receive. If set to non-zero value, this previous filter
|
||||
* will receive this size as its requested size (and so on).
|
||||
*
|
||||
* \retval true if the resize is accepted (possibly with a modified
|
||||
* size_out)
|
||||
* \retval false if the resize is rejected (included on error)
|
||||
*/
|
||||
int (*request_output_size)(struct vlc_gl_filter *filter,
|
||||
struct vlc_gl_tex_size *size_out,
|
||||
struct vlc_gl_tex_size *optimal_in);
|
||||
|
||||
/**
|
||||
* Callback to notify input size changes
|
||||
*
|
||||
* When a filter changes its output size as a result of
|
||||
* request_output_size(), the next filter is notified by this callback.
|
||||
*/
|
||||
void (*on_input_size_change)(struct vlc_gl_filter *filter,
|
||||
const struct vlc_gl_tex_size *size);
|
||||
};
|
||||
|
||||
/**
|
||||
* OpenGL filter, in charge of a rendering pass.
|
||||
*/
|
||||
struct vlc_gl_filter {
|
||||
vlc_object_t obj;
|
||||
module_t *module;
|
||||
|
||||
const struct vlc_gl_api *api;
|
||||
const struct vlc_gl_format *glfmt_in;
|
||||
|
||||
struct {
|
||||
/**
|
||||
* An OpenGL filter may either operate on the input RGBA picture, or on
|
||||
* individual input planes (without chroma conversion) separately.
|
||||
*
|
||||
* In practice, this is useful for deinterlace filters.
|
||||
*
|
||||
* This flag must be set by the filter module (default is false).
|
||||
*/
|
||||
bool filter_planes;
|
||||
|
||||
/**
|
||||
* A blend filter draws over the input picture (without reading it).
|
||||
*
|
||||
* Meaningless if filter_planes is true.
|
||||
*
|
||||
* This flag must be set by the filter module (default is false).
|
||||
*/
|
||||
bool blend;
|
||||
|
||||
/**
|
||||
* Request MSAA level.
|
||||
*
|
||||
* This value must be set by the filter module (default is 0, which
|
||||
* means disabled).
|
||||
*
|
||||
* Meaningless if filter_planes is true.
|
||||
*
|
||||
* The actual MSAA level may be overwritten to 0 if multisampling is
|
||||
* not supported, or to a higher value if another filter rendering on
|
||||
* the same framebuffer requested a higher MSAA level.
|
||||
*/
|
||||
unsigned msaa_level;
|
||||
} config;
|
||||
|
||||
const struct vlc_gl_filter_ops *ops;
|
||||
void *sys;
|
||||
};
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif
|
@ -19,141 +19,4 @@
|
||||
* Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
|
||||
*****************************************************************************/
|
||||
|
||||
#ifndef VLC_GL_FILTER_H
|
||||
#define VLC_GL_FILTER_H
|
||||
|
||||
#include <vlc_tick.h>
|
||||
#include <vlc_es.h>
|
||||
|
||||
struct vlc_gl_filter;
|
||||
struct vlc_gl_picture;
|
||||
struct vlc_gl_format;
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C"
|
||||
{
|
||||
#endif
|
||||
|
||||
struct vlc_gl_tex_size {
|
||||
unsigned width;
|
||||
unsigned height;
|
||||
};
|
||||
|
||||
struct vlc_gl_input_meta {
|
||||
vlc_tick_t pts;
|
||||
unsigned plane;
|
||||
const vlc_video_dovi_metadata_t *dovi_rpu;
|
||||
};
|
||||
|
||||
typedef int
|
||||
vlc_gl_filter_open_fn(struct vlc_gl_filter *filter,
|
||||
const config_chain_t *config,
|
||||
const struct vlc_gl_format *glfmt,
|
||||
struct vlc_gl_tex_size *size_out);
|
||||
|
||||
#define set_callback_opengl_filter(open) \
|
||||
{ \
|
||||
vlc_gl_filter_open_fn *fn = open; \
|
||||
(void) fn; \
|
||||
set_callback(fn) \
|
||||
}
|
||||
|
||||
struct vlc_gl_filter_ops {
|
||||
/**
|
||||
* Draw the result of the filter to the current framebuffer
|
||||
*/
|
||||
int (*draw)(struct vlc_gl_filter *filter, const struct vlc_gl_picture *pic,
|
||||
const struct vlc_gl_input_meta *meta);
|
||||
|
||||
/**
|
||||
* Free filter resources
|
||||
*/
|
||||
void (*close)(struct vlc_gl_filter *filter);
|
||||
|
||||
/**
|
||||
* Request a (responsive) filter to adapt its output size (optional)
|
||||
*
|
||||
* A responsive filter is a filter for which the size of the produced
|
||||
* pictures depends on the output (e.g. display) size rather than the
|
||||
* input. This is for example the case for a renderer.
|
||||
*
|
||||
* A new output size is requested (size_out). The filter is authorized to
|
||||
* change the size_out to enforce its own constraints.
|
||||
*
|
||||
* In addition, it may request to the previous filter (if any) an optimal
|
||||
* size it wants to receive. If set to non-zero value, this previous filter
|
||||
* will receive this size as its requested size (and so on).
|
||||
*
|
||||
* \retval true if the resize is accepted (possibly with a modified
|
||||
* size_out)
|
||||
* \retval false if the resize is rejected (included on error)
|
||||
*/
|
||||
int (*request_output_size)(struct vlc_gl_filter *filter,
|
||||
struct vlc_gl_tex_size *size_out,
|
||||
struct vlc_gl_tex_size *optimal_in);
|
||||
|
||||
/**
|
||||
* Callback to notify input size changes
|
||||
*
|
||||
* When a filter changes its output size as a result of
|
||||
* request_output_size(), the next filter is notified by this callback.
|
||||
*/
|
||||
void (*on_input_size_change)(struct vlc_gl_filter *filter,
|
||||
const struct vlc_gl_tex_size *size);
|
||||
};
|
||||
|
||||
/**
|
||||
* OpenGL filter, in charge of a rendering pass.
|
||||
*/
|
||||
struct vlc_gl_filter {
|
||||
vlc_object_t obj;
|
||||
module_t *module;
|
||||
|
||||
struct vlc_gl_t *gl;
|
||||
const struct vlc_gl_api *api;
|
||||
const struct vlc_gl_format *glfmt_in;
|
||||
|
||||
struct {
|
||||
/**
|
||||
* An OpenGL filter may either operate on the input RGBA picture, or on
|
||||
* individual input planes (without chroma conversion) separately.
|
||||
*
|
||||
* In practice, this is useful for deinterlace filters.
|
||||
*
|
||||
* This flag must be set by the filter module (default is false).
|
||||
*/
|
||||
bool filter_planes;
|
||||
|
||||
/**
|
||||
* A blend filter draws over the input picture (without reading it).
|
||||
*
|
||||
* Meaningless if filter_planes is true.
|
||||
*
|
||||
* This flag must be set by the filter module (default is false).
|
||||
*/
|
||||
bool blend;
|
||||
|
||||
/**
|
||||
* Request MSAA level.
|
||||
*
|
||||
* This value must be set by the filter module (default is 0, which
|
||||
* means disabled).
|
||||
*
|
||||
* Meaningless if filter_planes is true.
|
||||
*
|
||||
* The actual MSAA level may be overwritten to 0 if multisampling is
|
||||
* not supported, or to a higher value if another filter rendering on
|
||||
* the same framebuffer requested a higher MSAA level.
|
||||
*/
|
||||
unsigned msaa_level;
|
||||
} config;
|
||||
|
||||
const struct vlc_gl_filter_ops *ops;
|
||||
void *sys;
|
||||
};
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif
|
||||
#include <vlc_opengl_filter.h>
|
||||
|
@ -84,6 +84,7 @@ pluginsinclude_HEADERS = \
|
||||
../include/vlc_objects.h \
|
||||
../include/vlc_opengl.h \
|
||||
../include/vlc_opengl_interop.h \
|
||||
../include/vlc_opengl_filter.h \
|
||||
../include/vlc_picture.h \
|
||||
../include/vlc_picture_fifo.h \
|
||||
../include/vlc_picture_pool.h \
|
||||
|
Loading…
Reference in New Issue
Block a user