mirror of https://github.com/mpv-player/mpv
101 lines
3.8 KiB
C
101 lines
3.8 KiB
C
#ifndef MPGL_HWDEC_H_
|
|
#define MPGL_HWDEC_H_
|
|
|
|
#include "common.h"
|
|
#include "video/hwdec.h"
|
|
|
|
struct gl_hwdec {
|
|
const struct gl_hwdec_driver *driver;
|
|
struct mp_log *log;
|
|
struct mpv_global *global;
|
|
GL *gl;
|
|
struct mp_hwdec_devices *devs;
|
|
// GLSL extensions required to sample textures from this.
|
|
const char **glsl_extensions;
|
|
// For free use by hwdec driver
|
|
void *priv;
|
|
// For working around the vdpau vs. vaapi mess.
|
|
bool probing;
|
|
// Used in overlay mode only.
|
|
float overlay_colorkey[4];
|
|
};
|
|
|
|
struct gl_hwdec_plane {
|
|
GLuint gl_texture;
|
|
GLenum gl_target;
|
|
// Like struct gl_format.format (GL_RED etc.). Currently to detect
|
|
// GL_LUMINANCE_ALPHA and integer formats - can be left to 0 otherwise.
|
|
GLenum gl_format;
|
|
int tex_w, tex_h; // allocated texture size
|
|
};
|
|
|
|
struct gl_hwdec_frame {
|
|
struct gl_hwdec_plane planes[4];
|
|
bool vdpau_fields;
|
|
};
|
|
|
|
struct gl_hwdec_driver {
|
|
// Name of the interop backend. This is used for informational purposes only.
|
|
const char *name;
|
|
// Used to explicitly request a specific API.
|
|
enum hwdec_type api;
|
|
// The hardware surface IMGFMT_ that must be passed to map_image later.
|
|
// If the test_format callback is set, this field is ignored!
|
|
int imgfmt;
|
|
// Dosn't load this unless requested by name.
|
|
bool testing_only;
|
|
// Create the hwdec device. It must add it to hw->devs, if applicable.
|
|
int (*create)(struct gl_hwdec *hw);
|
|
// Prepare for rendering video. (E.g. create textures.)
|
|
// Called on initialization, and every time the video size changes.
|
|
// *params must be set to the format the hw textures return.
|
|
int (*reinit)(struct gl_hwdec *hw, struct mp_image_params *params);
|
|
// Return textures that contain a copy or reference of the given hw_image.
|
|
// The textures mirror the format returned by the reinit params argument.
|
|
// The textures must remain valid until unmap is called.
|
|
// hw_image remains referenced by the caller until unmap is called.
|
|
int (*map_frame)(struct gl_hwdec *hw, struct mp_image *hw_image,
|
|
struct gl_hwdec_frame *out_frame);
|
|
// Must be idempotent.
|
|
void (*unmap)(struct gl_hwdec *hw);
|
|
|
|
void (*destroy)(struct gl_hwdec *hw);
|
|
|
|
// Optional callback for checking input format support.
|
|
bool (*test_format)(struct gl_hwdec *hw, int imgfmt);
|
|
|
|
// The following functions provide an alternative API. Each gl_hwdec_driver
|
|
// must have either map_frame or overlay_frame set (not both or none), and
|
|
// if overlay_frame is set, it operates in overlay mode. In this mode,
|
|
// OSD etc. is rendered via OpenGL, but the video is rendered as a separate
|
|
// layer below it.
|
|
// Non-overlay mode is strictly preferred, so try not to use overlay mode.
|
|
|
|
// Set the given frame as overlay, replacing the previous one.
|
|
// hw_image==NULL is passed to clear the overlay.
|
|
int (*overlay_frame)(struct gl_hwdec *hw, struct mp_image *hw_image);
|
|
|
|
// Move overlay position within the "window".
|
|
void (*overlay_adjust)(struct gl_hwdec *hw,
|
|
struct mp_rect *src, struct mp_rect *dst);
|
|
};
|
|
|
|
struct gl_hwdec *gl_hwdec_load_api(struct mp_log *log, GL *gl,
|
|
struct mpv_global *g,
|
|
struct mp_hwdec_devices *devs,
|
|
enum hwdec_type api);
|
|
|
|
struct gl_hwdec *gl_hwdec_load(struct mp_log *log, GL *gl,
|
|
struct mpv_global *g,
|
|
struct mp_hwdec_devices *devs,
|
|
const char *name);
|
|
|
|
int gl_hwdec_validate_opt(struct mp_log *log, const m_option_t *opt,
|
|
struct bstr name, struct bstr param);
|
|
|
|
void gl_hwdec_uninit(struct gl_hwdec *hwdec);
|
|
|
|
bool gl_hwdec_test_format(struct gl_hwdec *hwdec, int imgfmt);
|
|
|
|
#endif
|