mirror of
https://github.com/mpv-player/mpv
synced 2024-12-25 16:33:02 +00:00
1a2319f3e4
Long planned. Leads to some sanity. There still are some rather gross things. Especially g_groups is ugly, and a hack that can hopefully be removed. (There is a plan for it, but whether it's implemented depends on how much energy is left.)
415 lines
14 KiB
C
415 lines
14 KiB
C
/*
|
|
* Copyright (C) Aaron Holtzman - Aug 1999
|
|
*
|
|
* Strongly modified, most parts rewritten: A'rpi/ESP-team - 2000-2001
|
|
* (C) MPlayer developers
|
|
*
|
|
* This file is part of mpv.
|
|
*
|
|
* mpv is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* mpv 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 General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with mpv. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef MPLAYER_VIDEO_OUT_H
|
|
#define MPLAYER_VIDEO_OUT_H
|
|
|
|
#include <inttypes.h>
|
|
#include <stdbool.h>
|
|
|
|
#include "video/img_format.h"
|
|
#include "common/common.h"
|
|
#include "options/options.h"
|
|
|
|
enum {
|
|
// VO needs to redraw
|
|
VO_EVENT_EXPOSE = 1 << 0,
|
|
// VO needs to update state to a new window size
|
|
VO_EVENT_RESIZE = 1 << 1,
|
|
// The ICC profile needs to be reloaded
|
|
VO_EVENT_ICC_PROFILE_CHANGED = 1 << 2,
|
|
// Some other window state changed (position, window state, fps)
|
|
VO_EVENT_WIN_STATE = 1 << 3,
|
|
// The ambient light conditions changed and need to be reloaded
|
|
VO_EVENT_AMBIENT_LIGHTING_CHANGED = 1 << 4,
|
|
// Special mechanism for making resizing with Cocoa react faster
|
|
VO_EVENT_LIVE_RESIZING = 1 << 5,
|
|
// Window fullscreen state changed via external influence.
|
|
VO_EVENT_FULLSCREEN_STATE = 1 << 6,
|
|
|
|
// Set of events the player core may be interested in.
|
|
VO_EVENTS_USER = VO_EVENT_RESIZE | VO_EVENT_WIN_STATE |
|
|
VO_EVENT_FULLSCREEN_STATE,
|
|
};
|
|
|
|
enum mp_voctrl {
|
|
/* signal a device reset seek */
|
|
VOCTRL_RESET = 1,
|
|
/* Handle input and redraw events, called by vo_check_events() */
|
|
VOCTRL_CHECK_EVENTS,
|
|
/* signal a device pause */
|
|
VOCTRL_PAUSE,
|
|
/* start/resume playback */
|
|
VOCTRL_RESUME,
|
|
|
|
VOCTRL_SET_PANSCAN,
|
|
VOCTRL_SET_EQUALIZER, // struct voctrl_set_equalizer_args*
|
|
VOCTRL_GET_EQUALIZER, // struct voctrl_get_equalizer_args*
|
|
|
|
/* private to vo_opengl */
|
|
VOCTRL_LOAD_HWDEC_API,
|
|
|
|
// Redraw the image previously passed to draw_image() (basically, repeat
|
|
// the previous draw_image call). If this is handled, the OSD should also
|
|
// be updated and redrawn. Optional; emulated if not available.
|
|
VOCTRL_REDRAW_FRAME,
|
|
|
|
VOCTRL_FULLSCREEN,
|
|
VOCTRL_ONTOP,
|
|
VOCTRL_BORDER,
|
|
VOCTRL_ALL_WORKSPACES,
|
|
|
|
VOCTRL_GET_FULLSCREEN,
|
|
|
|
VOCTRL_UPDATE_WINDOW_TITLE, // char*
|
|
VOCTRL_UPDATE_PLAYBACK_STATE, // struct voctrl_playback_state*
|
|
|
|
VOCTRL_PERFORMANCE_DATA, // struct voctrl_performance_data*
|
|
|
|
VOCTRL_SET_CURSOR_VISIBILITY, // bool*
|
|
|
|
VOCTRL_KILL_SCREENSAVER,
|
|
VOCTRL_RESTORE_SCREENSAVER,
|
|
|
|
VOCTRL_SET_DEINTERLACE,
|
|
VOCTRL_GET_DEINTERLACE,
|
|
|
|
// Return or set window size (not-fullscreen mode only - if fullscreened,
|
|
// these must access the not-fullscreened window size only).
|
|
VOCTRL_GET_UNFS_WINDOW_SIZE, // int[2] (w/h)
|
|
VOCTRL_SET_UNFS_WINDOW_SIZE, // int[2] (w/h)
|
|
|
|
VOCTRL_GET_WIN_STATE, // int* (VO_WIN_STATE_* flags)
|
|
|
|
// char *** (NULL terminated array compatible with CONF_TYPE_STRING_LIST)
|
|
// names for displays the window is on
|
|
VOCTRL_GET_DISPLAY_NAMES,
|
|
|
|
// Retrieve window contents. (Normal screenshots use vo_get_current_frame().)
|
|
VOCTRL_SCREENSHOT_WIN, // struct mp_image**
|
|
|
|
VOCTRL_UPDATE_RENDER_OPTS,
|
|
|
|
VOCTRL_GET_ICC_PROFILE, // bstr*
|
|
VOCTRL_GET_AMBIENT_LUX, // int*
|
|
VOCTRL_GET_DISPLAY_FPS, // double*
|
|
|
|
VOCTRL_GET_PREF_DEINT, // int*
|
|
};
|
|
|
|
// VOCTRL_SET_EQUALIZER
|
|
struct voctrl_set_equalizer_args {
|
|
const char *name;
|
|
int value;
|
|
};
|
|
|
|
// VOCTRL_GET_EQUALIZER
|
|
struct voctrl_get_equalizer_args {
|
|
const char *name;
|
|
int *valueptr;
|
|
};
|
|
|
|
// VOCTRL_GET_WIN_STATE
|
|
#define VO_WIN_STATE_MINIMIZED 1
|
|
|
|
#define VO_TRUE true
|
|
#define VO_FALSE false
|
|
#define VO_ERROR -1
|
|
#define VO_NOTAVAIL -2
|
|
#define VO_NOTIMPL -3
|
|
|
|
// VOCTRL_UPDATE_PLAYBACK_STATE
|
|
struct voctrl_playback_state {
|
|
bool taskbar_progress;
|
|
bool playing;
|
|
bool paused;
|
|
int percent_pos;
|
|
};
|
|
|
|
// VOCTRL_PERFORMANCE_DATA
|
|
struct voctrl_performance_entry {
|
|
// Times are in microseconds
|
|
uint64_t last, avg, peak;
|
|
};
|
|
|
|
struct voctrl_performance_data {
|
|
struct voctrl_performance_entry upload, render, present;
|
|
};
|
|
|
|
enum {
|
|
// VO does handle mp_image_params.rotate in 90 degree steps
|
|
VO_CAP_ROTATE90 = 1 << 0,
|
|
// VO does framedrop itself (vo_vdpau). Untimed/encoding VOs never drop.
|
|
VO_CAP_FRAMEDROP = 1 << 1,
|
|
};
|
|
|
|
#define VO_MAX_REQ_FRAMES 10
|
|
|
|
struct vo;
|
|
struct osd_state;
|
|
struct mp_image;
|
|
struct mp_image_params;
|
|
|
|
struct vo_extra {
|
|
struct input_ctx *input_ctx;
|
|
struct osd_state *osd;
|
|
struct encode_lavc_context *encode_lavc_ctx;
|
|
struct mpv_opengl_cb_context *opengl_cb_context;
|
|
void (*wakeup_cb)(void *ctx);
|
|
void *wakeup_ctx;
|
|
};
|
|
|
|
struct vo_frame {
|
|
// If > 0, realtime when frame should be shown, in mp_time_us() units.
|
|
// If 0, present immediately.
|
|
int64_t pts;
|
|
// Approximate frame duration, in us.
|
|
int duration;
|
|
// Realtime of estimated distance between 2 vsync events.
|
|
double vsync_interval;
|
|
// "ideal" display time within the vsync
|
|
double vsync_offset;
|
|
// "ideal" frame duration (can be different from num_vsyncs*vsync_interval
|
|
// up to a vsync) - valid for the entire frame, i.e. not changed for repeats
|
|
double ideal_frame_duration;
|
|
// how often the frame will be repeated (does not include OSD redraws)
|
|
int num_vsyncs;
|
|
// Set if the current frame is repeated from the previous. It's guaranteed
|
|
// that the current is the same as the previous one, even if the image
|
|
// pointer is different.
|
|
// The repeat flag is set if exactly the same frame should be rendered
|
|
// again (and the OSD does not need to be redrawn).
|
|
// A repeat frame can be redrawn, in which case repeat==redraw==true, and
|
|
// OSD should be updated.
|
|
bool redraw, repeat;
|
|
// The frame is not in movement - e.g. redrawing while paused.
|
|
bool still;
|
|
// Frames are output as fast as possible, with implied vsync blocking.
|
|
bool display_synced;
|
|
// The current frame to be drawn.
|
|
// Warning: When OSD should be redrawn in --force-window --idle mode, this
|
|
// can be NULL. The VO should draw a black background, OSD on top.
|
|
struct mp_image *current;
|
|
// List of future images, starting with the current one. This does not
|
|
// care about repeated frames - it simply contains the next real frames.
|
|
// vo_set_queue_params() sets how many future frames this should include.
|
|
// The actual number of frames delivered to the VO can be lower.
|
|
// frames[0] is current, frames[1] is the next frame.
|
|
// Note that some future frames may never be sent as current frame to the
|
|
// VO if frames are dropped.
|
|
int num_frames;
|
|
struct mp_image *frames[VO_MAX_REQ_FRAMES];
|
|
// ID for frames[0] (== current). If current==NULL, the number is
|
|
// meaningless. Otherwise, it's an unique ID for the frame. The ID for
|
|
// a frame is guaranteed not to change (instant redraws will use the same
|
|
// ID). frames[n] has the ID frame_id+n, with the guarantee that frame
|
|
// drops or reconfigs will keep the guarantee.
|
|
// The ID is never 0 (unless num_frames==0). IDs are strictly monotonous.
|
|
uint64_t frame_id;
|
|
};
|
|
|
|
struct vo_driver {
|
|
// Encoding functionality, which can be invoked via --o only.
|
|
bool encode;
|
|
|
|
// VO_CAP_* bits
|
|
int caps;
|
|
|
|
// Disable video timing, push frames as quickly as possible, never redraw.
|
|
bool untimed;
|
|
|
|
const char *name;
|
|
const char *description;
|
|
|
|
/*
|
|
* returns: zero on successful initialization, non-zero on error.
|
|
*/
|
|
int (*preinit)(struct vo *vo);
|
|
|
|
/*
|
|
* Whether the given image format is supported and config() will succeed.
|
|
* format: one of IMGFMT_*
|
|
* returns: 0 on not supported, otherwise 1
|
|
*/
|
|
int (*query_format)(struct vo *vo, int format);
|
|
|
|
/*
|
|
* Initialize or reconfigure the display driver.
|
|
* params: video parameters, like pixel format and frame size
|
|
* returns: < 0 on error, >= 0 on success
|
|
*/
|
|
int (*reconfig)(struct vo *vo, struct mp_image_params *params);
|
|
|
|
/*
|
|
* Control interface
|
|
*/
|
|
int (*control)(struct vo *vo, uint32_t request, void *data);
|
|
|
|
/*
|
|
* Render the given frame to the VO's backbuffer. This operation will be
|
|
* followed by a draw_osd and a flip_page[_timed] call.
|
|
* mpi belongs to the VO; the VO must free it eventually.
|
|
*
|
|
* This also should draw the OSD.
|
|
*
|
|
* Deprecated for draw_frame. A VO should have only either callback set.
|
|
*/
|
|
void (*draw_image)(struct vo *vo, struct mp_image *mpi);
|
|
|
|
/* Render the given frame. Note that this is also called when repeating
|
|
* or redrawing frames.
|
|
*/
|
|
void (*draw_frame)(struct vo *vo, struct vo_frame *frame);
|
|
|
|
/*
|
|
* Blit/Flip buffer to the screen. Must be called after each frame!
|
|
*/
|
|
void (*flip_page)(struct vo *vo);
|
|
|
|
/* These optional callbacks can be provided if the GUI framework used by
|
|
* the VO requires entering a message loop for receiving events and does
|
|
* not call vo_wakeup() from a separate thread when there are new events.
|
|
*
|
|
* wait_events() will wait for new events, until the timeout expires, or the
|
|
* function is interrupted. wakeup() is used to possibly interrupt the
|
|
* event loop (wakeup() itself must be thread-safe, and not call any other
|
|
* VO functions; it's the only vo_driver function with this requirement).
|
|
* wakeup() should behave like a binary semaphore; if wait_events() is not
|
|
* being called while wakeup() is, the next wait_events() call should exit
|
|
* immediately.
|
|
*/
|
|
void (*wakeup)(struct vo *vo);
|
|
void (*wait_events)(struct vo *vo, int64_t until_time_us);
|
|
|
|
/*
|
|
* Closes driver. Should restore the original state of the system.
|
|
*/
|
|
void (*uninit)(struct vo *vo);
|
|
|
|
// Size of private struct for automatic allocation (0 doesn't allocate)
|
|
int priv_size;
|
|
|
|
// If not NULL, it's copied into the newly allocated private struct.
|
|
const void *priv_defaults;
|
|
|
|
// List of options to parse into priv struct (requires priv_size to be set)
|
|
// This will register them as global options (with options_prefix), and
|
|
// copy the current value at VO creation time to the priv struct.
|
|
const struct m_option *options;
|
|
|
|
// All options in the above array are prefixed with this string. (It's just
|
|
// for convenience and makes no difference in semantics.)
|
|
const char *options_prefix;
|
|
|
|
// Registers global options that go to a separate options struct.
|
|
const struct m_sub_options *global_opts;
|
|
};
|
|
|
|
struct vo {
|
|
const struct vo_driver *driver;
|
|
struct mp_log *log; // Using e.g. "[vo/vdpau]" as prefix
|
|
void *priv;
|
|
struct mpv_global *global;
|
|
struct vo_x11_state *x11;
|
|
struct vo_w32_state *w32;
|
|
struct vo_cocoa_state *cocoa;
|
|
struct vo_wayland_state *wayland;
|
|
struct mp_hwdec_devices *hwdec_devs;
|
|
struct input_ctx *input_ctx;
|
|
struct osd_state *osd;
|
|
struct encode_lavc_context *encode_lavc_ctx;
|
|
struct vo_internal *in;
|
|
struct vo_extra extra;
|
|
|
|
// --- The following fields are generally only changed during initialization.
|
|
|
|
bool probing;
|
|
|
|
// --- The following fields are only changed with vo_reconfig(), and can
|
|
// be accessed unsynchronized (read-only).
|
|
|
|
int config_ok; // Last config call was successful?
|
|
struct mp_image_params *params; // Configured parameters (as in vo_reconfig)
|
|
|
|
// --- The following fields can be accessed only by the VO thread, or from
|
|
// anywhere _if_ the VO thread is suspended (use vo->dispatch).
|
|
|
|
struct m_config_cache *opts_cache; // cache for ->opts
|
|
struct mp_vo_opts *opts;
|
|
|
|
bool want_redraw; // redraw as soon as possible
|
|
|
|
// current window state
|
|
int dwidth;
|
|
int dheight;
|
|
float monitor_par;
|
|
};
|
|
|
|
struct mpv_global;
|
|
struct vo *init_best_video_out(struct mpv_global *global, struct vo_extra *ex);
|
|
int vo_reconfig(struct vo *vo, struct mp_image_params *p);
|
|
|
|
int vo_control(struct vo *vo, int request, void *data);
|
|
void vo_control_async(struct vo *vo, int request, void *data);
|
|
bool vo_is_ready_for_frame(struct vo *vo, int64_t next_pts);
|
|
void vo_queue_frame(struct vo *vo, struct vo_frame *frame);
|
|
void vo_wait_frame(struct vo *vo);
|
|
bool vo_still_displaying(struct vo *vo);
|
|
bool vo_has_frame(struct vo *vo);
|
|
void vo_redraw(struct vo *vo);
|
|
bool vo_want_redraw(struct vo *vo);
|
|
void vo_seek_reset(struct vo *vo);
|
|
void vo_destroy(struct vo *vo);
|
|
void vo_set_paused(struct vo *vo, bool paused);
|
|
int64_t vo_get_drop_count(struct vo *vo);
|
|
void vo_increment_drop_count(struct vo *vo, int64_t n);
|
|
int64_t vo_get_delayed_count(struct vo *vo);
|
|
void vo_query_formats(struct vo *vo, uint8_t *list);
|
|
void vo_event(struct vo *vo, int event);
|
|
int vo_query_and_reset_events(struct vo *vo, int events);
|
|
struct mp_image *vo_get_current_frame(struct vo *vo);
|
|
void vo_set_queue_params(struct vo *vo, int64_t offset_us, int num_req_frames);
|
|
int vo_get_num_req_frames(struct vo *vo);
|
|
int64_t vo_get_vsync_interval(struct vo *vo);
|
|
double vo_get_estimated_vsync_interval(struct vo *vo);
|
|
double vo_get_estimated_vsync_jitter(struct vo *vo);
|
|
double vo_get_display_fps(struct vo *vo);
|
|
double vo_get_delay(struct vo *vo);
|
|
void vo_discard_timing_info(struct vo *vo);
|
|
|
|
void vo_wakeup(struct vo *vo);
|
|
void vo_wait_default(struct vo *vo, int64_t until_time);
|
|
|
|
struct mp_keymap {
|
|
int from;
|
|
int to;
|
|
};
|
|
int lookup_keymap_table(const struct mp_keymap *map, int key);
|
|
|
|
struct mp_osd_res;
|
|
void vo_get_src_dst_rects(struct vo *vo, struct mp_rect *out_src,
|
|
struct mp_rect *out_dst, struct mp_osd_res *out_osd);
|
|
|
|
struct vo_frame *vo_frame_ref(struct vo_frame *frame);
|
|
|
|
#endif /* MPLAYER_VIDEO_OUT_H */
|