#pragma once #include #include #include "libmpv/render.h" #include "vo.h" // Helper for finding a parameter value. It returns the direct pointer to the // value, and if not present, just returns the def argument. In particular, if // def is not NULL, this never returns NULL (unless a param value is defined // as accepting NULL, or the libmpv API user is triggering UB). void *get_mpv_render_param(mpv_render_param *params, mpv_render_param_type type, void *def); #define GET_MPV_RENDER_PARAM(params, type, ctype, def) \ (*(ctype *)get_mpv_render_param(params, type, &(ctype){(def)})) typedef int (*mp_render_cb_control_fn)(void *cb_ctx, int *events, uint32_t request, void *data); void mp_render_context_set_control_callback(mpv_render_context *ctx, mp_render_cb_control_fn callback, void *callback_ctx); bool mp_render_context_acquire(mpv_render_context *ctx); struct render_backend { struct mpv_global *global; struct mp_log *log; const struct render_backend_fns *fns; // Set on init, immutable afterwards. int driver_caps; struct mp_hwdec_devices *hwdec_devs; void *priv; }; // Generic backend for rendering via libmpv. This corresponds to vo/vo_driver, // except for rendering via the mpv_render_*() API. (As a consequence it's as // generic as the VO API.) Like with VOs, one backend can support multiple // underlying GPU APIs. struct render_backend_fns { // Returns libmpv error code. In particular, this function has to check for // MPV_RENDER_PARAM_API_TYPE, and silently return MPV_ERROR_NOT_IMPLEMENTED // if the API is not included in this backend. // If this fails, ->destroy() will be called. int (*init)(struct render_backend *ctx, mpv_render_param *params); // Check if the passed IMGFMT_ is supported. bool (*check_format)(struct render_backend *ctx, int imgfmt); // Implementation of mpv_render_context_set_parameter(). Optional. int (*set_parameter)(struct render_backend *ctx, mpv_render_param param); // Like vo_driver.reconfig(). void (*reconfig)(struct render_backend *ctx, struct mp_image_params *params); // Like VOCTRL_RESET. void (*reset)(struct render_backend *ctx); void (*screenshot)(struct render_backend *ctx, struct vo_frame *frame, struct voctrl_screenshot *args); // Like vo_driver.get_image(). struct mp_image *(*get_image)(struct render_backend *ctx, int imgfmt, int w, int h, int stride_align); // This has two purposes: 1. set queue attributes on VO, 2. update the // renderer's OSD pointer. Keep in mind that as soon as the caller releases // the renderer lock, the VO pointer can become invalid. The OSD pointer // will technically remain valid (even though it's a vo field), until it's // unset with this function. // Will be called if vo changes, or if renderer options change. void (*update_external)(struct render_backend *ctx, struct vo *vo); // Update screen area. void (*resize)(struct render_backend *ctx, struct mp_rect *src, struct mp_rect *dst, struct mp_osd_res *osd); // Get target surface size from mpv_render_context_render() arguments. int (*get_target_size)(struct render_backend *ctx, mpv_render_param *params, int *out_w, int *out_h); // Implementation of mpv_render_context_render(). int (*render)(struct render_backend *ctx, mpv_render_param *params, struct vo_frame *frame); // Free all data in ctx->priv. void (*destroy)(struct render_backend *ctx); }; extern const struct render_backend_fns render_backend_gpu;