mirror of https://github.com/mpv-player/mpv
308 lines
10 KiB
C
308 lines
10 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 MPlayer.
|
|
*
|
|
* MPlayer 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.
|
|
*
|
|
* MPlayer 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 MPlayer; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*/
|
|
|
|
#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"
|
|
|
|
#define VO_EVENT_EXPOSE 1
|
|
#define VO_EVENT_RESIZE 2
|
|
#define VO_EVENT_ICC_PROFILE_PATH_CHANGED 4
|
|
|
|
enum mp_voctrl {
|
|
/* signal a device reset seek */
|
|
VOCTRL_RESET = 1,
|
|
/* Handle input and redraw events, called by vo_check_events() */
|
|
VOCTRL_CHECK_EVENTS,
|
|
/* used to switch to fullscreen */
|
|
VOCTRL_FULLSCREEN,
|
|
/* signal a device pause */
|
|
VOCTRL_PAUSE,
|
|
/* start/resume playback */
|
|
VOCTRL_RESUME,
|
|
|
|
VOCTRL_GET_PANSCAN,
|
|
VOCTRL_SET_PANSCAN,
|
|
VOCTRL_SET_EQUALIZER, // struct voctrl_set_equalizer_args*
|
|
VOCTRL_GET_EQUALIZER, // struct voctrl_get_equalizer_args*
|
|
|
|
/* for hardware decoding */
|
|
VOCTRL_GET_HWDEC_INFO, // struct mp_hwdec_info*
|
|
|
|
VOCTRL_REDRAW_FRAME,
|
|
|
|
VOCTRL_ONTOP,
|
|
VOCTRL_BORDER,
|
|
VOCTRL_UPDATE_WINDOW_TITLE, // char*
|
|
|
|
VOCTRL_SET_CURSOR_VISIBILITY, // bool*
|
|
|
|
VOCTRL_KILL_SCREENSAVER,
|
|
VOCTRL_RESTORE_SCREENSAVER,
|
|
|
|
VOCTRL_SET_DEINTERLACE,
|
|
VOCTRL_GET_DEINTERLACE,
|
|
|
|
VOCTRL_WINDOW_TO_OSD_COORDS, // float[2] (x/y)
|
|
VOCTRL_GET_WINDOW_SIZE, // int[2] (w/h)
|
|
VOCTRL_SET_WINDOW_SIZE, // int[2] (w/h)
|
|
|
|
// The VO is supposed to set "known" fields, and leave the others
|
|
// untouched or set to 0.
|
|
// imgfmt/w/h/d_w/d_h can be omitted for convenience.
|
|
VOCTRL_GET_COLORSPACE, // struct mp_image_params*
|
|
|
|
VOCTRL_SCREENSHOT, // struct voctrl_screenshot_args*
|
|
|
|
VOCTRL_SET_COMMAND_LINE, // char**
|
|
|
|
VOCTRL_GET_ICC_PROFILE_PATH, // char**
|
|
|
|
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_SCREENSHOT
|
|
struct voctrl_screenshot_args {
|
|
// 0: Save image of the currently displayed video frame, in original
|
|
// resolution.
|
|
// 1: Save full screenshot of the window. Should contain OSD, EOSD, and the
|
|
// scaled video.
|
|
// The value of this variable can be ignored if only a single method is
|
|
// implemented.
|
|
int full_window;
|
|
// Will be set to a newly allocated image, that contains the screenshot.
|
|
// The caller has to free the image with talloc_free().
|
|
// It is not specified whether the image data is a copy or references the
|
|
// image data directly.
|
|
// Is never NULL. (Failure has to be indicated by returning VO_FALSE.)
|
|
struct mp_image *out_image;
|
|
// Whether the VO rendered OSD/subtitles into out_image
|
|
bool has_osd;
|
|
};
|
|
|
|
#define VO_TRUE true
|
|
#define VO_FALSE false
|
|
#define VO_ERROR -1
|
|
#define VO_NOTAVAIL -2
|
|
#define VO_NOTIMPL -3
|
|
|
|
#define VOFLAG_FLIPPING 0x08
|
|
#define VOFLAG_HIDDEN 0x10 //< Use to create a hidden window
|
|
#define VOFLAG_STEREO 0x20 //< Use to create a stereo-capable window
|
|
#define VOFLAG_GL_DEBUG 0x40 // Hint to request debug OpenGL context
|
|
#define VOFLAG_ALPHA 0x80 // Hint to request alpha framebuffer
|
|
|
|
// VO does handle mp_image_params.rotate in 90 degree steps
|
|
#define VO_CAP_ROTATE90 1
|
|
|
|
#define VO_MAX_QUEUE 5
|
|
|
|
struct vo;
|
|
struct osd_state;
|
|
struct mp_image;
|
|
struct mp_image_params;
|
|
|
|
struct vo_driver {
|
|
// Encoding functionality, which can be invoked via --o only.
|
|
bool encode;
|
|
|
|
// VO_CAP_* bits
|
|
int caps;
|
|
|
|
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 a bitmask of VFCAP_* values
|
|
*/
|
|
int (*query_format)(struct vo *vo, uint32_t format);
|
|
|
|
/*
|
|
* Optional. Can be used to convert the input image into something VO
|
|
* internal, such as GPU surfaces. Ownership of mpi is passed to the
|
|
* function, and the returned image is owned by the caller.
|
|
* The following guarantees are given:
|
|
* - mpi has the format with which the VO was configured
|
|
* - the returned image can be arbitrary, and the VO merely manages its
|
|
* lifetime
|
|
* - images passed to draw_image are always passed through this function
|
|
* - the maximum number of images kept alive is not over vo->max_video_queue
|
|
* - if vo->max_video_queue is large enough, some images may be buffered ahead
|
|
*/
|
|
struct mp_image *(*filter_image)(struct vo *vo, struct mp_image *mpi);
|
|
|
|
/*
|
|
* Initialize or reconfigure the display driver.
|
|
* params: video parameters, like pixel format and frame size
|
|
* flags: combination of VOFLAG_ values
|
|
* returns: < 0 on error, >= 0 on success
|
|
*/
|
|
int (*reconfig)(struct vo *vo, struct mp_image_params *params, int flags);
|
|
|
|
/*
|
|
* 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 caller; if the VO needs it longer, it has to create
|
|
* a new reference to mpi.
|
|
*/
|
|
void (*draw_image)(struct vo *vo, struct mp_image *mpi);
|
|
|
|
/*
|
|
* Draws OSD to the screen buffer
|
|
*/
|
|
void (*draw_osd)(struct vo *vo, struct osd_state *osd);
|
|
|
|
/*
|
|
* Blit/Flip buffer to the screen. Must be called after each frame!
|
|
* pts_us is the frame presentation time, linked to mp_time_us().
|
|
* pts_us is 0 if the frame should be presented immediately.
|
|
* duration is estimated time in us until the next frame is shown.
|
|
* duration is -1 if it is unknown or unset.
|
|
*/
|
|
void (*flip_page)(struct vo *vo);
|
|
void (*flip_page_timed)(struct vo *vo, int64_t pts_us, int duration);
|
|
|
|
/*
|
|
* 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 privsize to be set)
|
|
const struct m_option *options;
|
|
};
|
|
|
|
struct vo {
|
|
struct mp_log *log; // Using e.g. "[vo/vdpau]" as prefix
|
|
int config_ok; // Last config call was successful?
|
|
struct mp_image_params *params; // Configured parameters (as in vo_reconfig)
|
|
|
|
bool probing;
|
|
|
|
bool untimed; // non-interactive, don't do sleep calls in playloop
|
|
|
|
bool want_redraw; // visible frame wrong (window resize), needs refresh
|
|
bool hasframe; // >= 1 frame has been drawn, so redraw is possible
|
|
double wakeup_period; // if > 0, this sets the maximum wakeup period for event polling
|
|
|
|
double flip_queue_offset; // queue flip events at most this much in advance
|
|
int max_video_queue; // queue this many decoded video frames (<=VO_MAX_QUEUE)
|
|
|
|
// Frames to display; the next (i.e. oldest, lowest PTS) image has index 0.
|
|
struct mp_image *video_queue[VO_MAX_QUEUE];
|
|
int num_video_queue;
|
|
|
|
const struct vo_driver *driver;
|
|
void *priv;
|
|
struct mp_vo_opts *opts;
|
|
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 encode_lavc_context *encode_lavc_ctx;
|
|
struct input_ctx *input_ctx;
|
|
int event_fd; // check_events() should be called when this has input
|
|
|
|
// current window state
|
|
int dwidth;
|
|
int dheight;
|
|
float monitor_par;
|
|
|
|
char *window_title;
|
|
};
|
|
|
|
struct mpv_global;
|
|
struct vo *init_best_video_out(struct mpv_global *global,
|
|
struct input_ctx *input_ctx,
|
|
struct encode_lavc_context *encode_lavc_ctx);
|
|
int vo_reconfig(struct vo *vo, struct mp_image_params *p, int flags);
|
|
|
|
int vo_control(struct vo *vo, uint32_t request, void *data);
|
|
void vo_queue_image(struct vo *vo, struct mp_image *mpi);
|
|
int vo_redraw_frame(struct vo *vo);
|
|
bool vo_get_want_redraw(struct vo *vo);
|
|
bool vo_has_next_frame(struct vo *vo, bool eof);
|
|
double vo_get_next_pts(struct vo *vo, int index);
|
|
bool vo_needs_new_image(struct vo *vo);
|
|
void vo_new_frame_imminent(struct vo *vo);
|
|
void vo_draw_osd(struct vo *vo, struct osd_state *osd);
|
|
void vo_flip_page(struct vo *vo, int64_t pts_us, int duration);
|
|
void vo_check_events(struct vo *vo);
|
|
void vo_seek_reset(struct vo *vo);
|
|
void vo_destroy(struct vo *vo);
|
|
|
|
const char *vo_get_window_title(struct vo *vo);
|
|
|
|
// NULL terminated array of all drivers
|
|
extern const struct vo_driver *video_out_drivers[];
|
|
|
|
struct mp_keymap {
|
|
int from;
|
|
int to;
|
|
};
|
|
int lookup_keymap_table(const struct mp_keymap *map, int key);
|
|
|
|
void vo_mouse_movement(struct vo *vo, int posx, int posy);
|
|
void vo_drop_files(struct vo *vo, int num_files, char **files);
|
|
|
|
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);
|
|
|
|
#endif /* MPLAYER_VIDEO_OUT_H */
|