From dc54385d7199380ebdd34aeadbc6b9242496a1cc Mon Sep 17 00:00:00 2001 From: lifegpc Date: Thu, 20 Mar 2025 20:17:22 +0800 Subject: [PATCH] Add MPV support --- CMakeLists.txt | 23 +- dllmain.cpp | 82 +- include/mpv/client.h | 2032 +++++++++++++++++++++++++++++++++++++++ include/mpv/render.h | 759 +++++++++++++++ include/mpv/render_gl.h | 211 ++++ include/mpv/stream_cb.h | 247 +++++ lib/libmpv.dll.a | Bin 0 -> 454322 bytes patch_config.h.in | 5 + 8 files changed, 3357 insertions(+), 2 deletions(-) create mode 100644 include/mpv/client.h create mode 100644 include/mpv/render.h create mode 100644 include/mpv/render_gl.h create mode 100644 include/mpv/stream_cb.h create mode 100644 lib/libmpv.dll.a create mode 100644 patch_config.h.in diff --git a/CMakeLists.txt b/CMakeLists.txt index f049507..1b7ed0b 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -8,8 +8,22 @@ endif() include_directories("${CMAKE_CURRENT_SOURCE_DIR}/include") +option(USE_LIBMPV "Use libmpv." ON) +option(USE_PLAYER "Use player." OFF) + +if (USE_LIBMPV AND USE_PLAYER) + message(FATAL_ERROR "USE_LIBMPV and USE_PLAYER cannot be both enabled.") +endif() + +if (USE_LIBMPV) + set(HAVE_MPV 1) +elseif (USE_PLAYER) + set(HAVE_PLAYER 1) +endif() + set(DETOURS_LIB "${CMAKE_CURRENT_SOURCE_DIR}/lib/detours.lib") set(PLAYER_LIB "${CMAKE_CURRENT_SOURCE_DIR}/lib/player.lib") +set(LIBMPV_LIB "${CMAKE_CURRENT_SOURCE_DIR}/lib/libmpv.dll.a") set(ENABLE_ICONV OFF CACHE BOOL "Libiconv is not needed.") add_subdirectory(utils) @@ -38,9 +52,16 @@ set(ZLIB_ROOT "${CMAKE_CURRENT_SOURCE_DIR}" CACHE PATH "Zlib is needed.") find_package(ZLIB REQUIRED) add_subdirectory("libzip") +configure_file("${CMAKE_CURRENT_SOURCE_DIR}/patch_config.h.in" "${CMAKE_CURRENT_BINARY_DIR}/patch_config.h") +include_directories("${CMAKE_CURRENT_BINARY_DIR}") + add_library(jewena_patch SHARED dllmain.cpp config.hpp config.cpp vfs.hpp vfs.cpp string_replace_file.hpp string_replace_file.cpp) target_link_libraries(jewena_patch "${DETOURS_LIB}") -target_link_libraries(jewena_patch "${PLAYER_LIB}") +if (USE_LIBMPV) + target_link_libraries(jewena_patch "${LIBMPV_LIB}") +elseif (USE_PLAYER) + target_link_libraries(jewena_patch "${PLAYER_LIB}") +endif() target_link_libraries(jewena_patch utils) target_link_libraries(jewena_patch zip) diff --git a/dllmain.cpp b/dllmain.cpp index aa59edc..56b2531 100644 --- a/dllmain.cpp +++ b/dllmain.cpp @@ -8,7 +8,13 @@ #include "fileop.h" #include #include "string_replace_file.hpp" +#include "patch_config.h" +#if HAVE_PLAYER #include "player.h" +#endif +#if HAVE_MPV +#include "mpv/client.h" +#endif static HFONT(WINAPI *TrueCreateFontW)(int nHeight, int nWidth, int nEscapement, int nOrientation, int fnWeight, DWORD dwItalic, DWORD dwUnderline, DWORD dwStrikeOut, DWORD dwCharSet, DWORD dwOutPrecision, DWORD dwClipPrecision, DWORD dwQuality, DWORD dwPitchAndFamily, LPCWSTR lpFaceName) = CreateFontW; static HFONT(WINAPI *TrueCreateFontA)(int nHeight, int nWidth, int nEscapement, int nOrientation, int fnWeight, DWORD dwItalic, DWORD dwUnderline, DWORD dwStrikeOut, DWORD dwCharSet, DWORD dwOutPrecision, DWORD dwClipPrecision, DWORD dwQuality, DWORD dwPitchAndFamily, LPCSTR lpFaceName) = CreateFontA; @@ -23,21 +29,30 @@ static decltype(GetFileType) *TrueGetFileType = GetFileType; static decltype(GetFileAttributesW) *TrueGetFileAttributesW = GetFileAttributesW; static decltype(GetFileAttributesExW) *TrueGetFileAttributesExW = GetFileAttributesExW; +#if HAVE_PLAYER || HAVE_MPV typedef int64_t(*OpenMediaFileAndGetDuration)(DWORD* duration, const char* arcName, const char* videoName); typedef int64_t(*IsPlaying)(); typedef int64_t(*IsMediaPlaying)(); typedef int64_t(*ReleaseDirectShowGraph)(); +#endif static Config config; static std::wstring defaultFont; static VFS vfs; static StringReplaceFile replaceFile; +#if HAVE_PLAYER static PlayerSession* player = NULL; static PlayerSettings* settings = NULL; +#endif +#if HAVE_MPV +static mpv_handle* player = NULL; +#endif +#if HAVE_PLAYER || HAVE_MPV static OpenMediaFileAndGetDuration OpenMediaFileAndGetDurationFunc = NULL; static IsPlaying IsPlayingFunc = NULL; static IsMediaPlaying IsMediaPlayingFunc = NULL; static ReleaseDirectShowGraph ReleaseDirectShowGraphFunc = NULL; +#endif char* to_utf8(char* target, const char* source, UINT cp) { int count = MultiByteToWideChar(cp, MB_ERR_INVALID_CHARS, source, -1, NULL, 0); @@ -85,6 +100,7 @@ PVOID GetHandle() { return (char*)hModule + 0xf40e0; } +#if HAVE_PLAYER || HAVE_MPV HWND* GetHwndPointer() { HMODULE hModule = GetModuleHandleA(NULL); return (HWND*)((char*)hModule + 0x1e1620); @@ -110,12 +126,17 @@ ReleaseDirectShowGraph GetReleaseDirectShowGraph() { return (ReleaseDirectShowGraph)((char*)hModule + 0xed610); } +#endif + static PVOID h = nullptr; +#if HAVE_PLAYER || HAVE_MPV + int64_t HookedOpenMediaFileAndGetDuration(DWORD* duration, const char* arcName, const char* videoName) { + int64_t ok = 0; + #if HAVE_PLAYER player_free(&player); player_log(AV_LOG_INFO, "BGI: Open Video: %s, %s\n", arcName, videoName); - int64_t ok = 0; if (fileop::exists(videoName)) { player_log(AV_LOG_INFO, "Video file exists: %s\n", videoName); if (!settings) { @@ -159,26 +180,59 @@ int64_t HookedOpenMediaFileAndGetDuration(DWORD* duration, const char* arcName, } goto works; } + #endif + #if HAVE_MPV + if (player) { + mpv_terminate_destroy(player); + player = NULL; + } + if (fileop::exists(videoName)) { + player = mpv_create(); + if (!player) { + goto end; + } + HWND hwnd = *GetHwndPointer(); + int64_t wid = (int64_t)(intptr_t)hwnd; + mpv_set_option(player, "wid", MPV_FORMAT_INT64, &wid); + mpv_set_option_string(player, "config", "no"); + mpv_set_option_string(player, "input-default-bindings", "no"); + mpv_set_option_string(player, "vo", "libmpv"); + const char* cmd[] = { "loadfile", videoName, nullptr }; + mpv_command(player, cmd); + } + #endif end: ok = OpenMediaFileAndGetDurationFunc(duration, arcName, videoName); works: + #if HAVE_PLAYER if (duration) { char tmp[32]; int64_t dur = *duration * 1000; player_ts_make_string(tmp, dur); player_log(AV_LOG_INFO, "Video duration: %s\n", tmp); } + #endif return ok; } int64_t HookedIsPlaying() { + #if HAVE_PLAYER if (player) { return player_is_playing(player); } + #endif + #if HAVE_MPV + if (player) { + int64_t re = 0; + mpv_get_property(player, "core-idle", MPV_FORMAT_FLAG, &re); + return !re; + } + #endif return IsPlayingFunc(); } int64_t HookedIsMediaPlaying() { + #if HAVE_PLAYER if (player) { int64_t re = player_is_playing(player); // 释放播放器，BGI在播放完毕后不会手动释放 @@ -188,16 +242,38 @@ int64_t HookedIsMediaPlaying() { } return re; } + #endif + #if HAVE_MPV + if (player) { + int64_t re = 0; + mpv_get_property(player, "core-idle", MPV_FORMAT_FLAG, &re); + if (re) { + mpv_terminate_destroy(player); + player = NULL; + } + return !re; + } + #endif int64_t re = IsMediaPlayingFunc(); return re; } int64_t HookedReleaseDirectShowGraph() { + #if HAVE_PLAYER player_log(AV_LOG_INFO, "BGI: Close\n"); player_free(&player); + #endif + #if HAVE_MPV + if (player) { + mpv_terminate_destroy(player); + player = NULL; + } + #endif return ReleaseDirectShowGraphFunc(); } +#endif + HFONT WINAPI HookedCreateFontW(int nHeight, int nWidth, int nEscapement, int nOrientation, int fnWeight, DWORD dwItalic, DWORD dwUnderline, DWORD dwStrikeOut, DWORD dwCharSet, DWORD dwOutPrecision, DWORD dwClipPrecision, DWORD dwQuality, DWORD dwPitchAndFamily, LPCWSTR lpFaceName) { std::wstring name(lpFaceName); if (name == L"Meiryo") { @@ -306,16 +382,19 @@ extern "C" __declspec(dllexport) void Attach() { if (defaultFont.empty()) { defaultFont = L"微软雅黑"; } + #if HAVE_PLAYER auto loggingFile = config.configs["loggingFile"]; if (!loggingFile.empty()) { set_player_log_file(loggingFile.c_str(), config.IsAppendLogging() ? 1 : 0, config.LoggingLevel()); } + #endif vfs.AddArchive("jewena-chs.dat"); vfs.AddArchive("video.dat"); DetourTransactionBegin(); DetourUpdateThread(GetCurrentThread()); h = GetHandle(); DetourAttach(&h, (PVOID)jis_to_utf8); + #if HAVE_PLAYER || HAVE_MPV OpenMediaFileAndGetDurationFunc = GetOpenMediaFileAndGetDuration(); DetourAttach(&OpenMediaFileAndGetDurationFunc, HookedOpenMediaFileAndGetDuration); IsPlayingFunc = GetIsPlaying(); @@ -324,6 +403,7 @@ extern "C" __declspec(dllexport) void Attach() { DetourAttach(&IsMediaPlayingFunc, HookedIsMediaPlaying); ReleaseDirectShowGraphFunc = GetReleaseDirectShowGraph(); DetourAttach(&ReleaseDirectShowGraphFunc, HookedReleaseDirectShowGraph); + #endif DetourAttach(&TrueCreateFontW, HookedCreateFontW); DetourAttach(&TrueCreateFontA, HookedCreateFontA); DetourAttach(&TrueCreateFileW, HookedCreateFileW); diff --git a/include/mpv/client.h b/include/mpv/client.h new file mode 100644 index 0000000..8eb5e05 --- /dev/null +++ b/include/mpv/client.h @@ -0,0 +1,2032 @@ +/* Copyright (C) 2017 the mpv developers + * + * Permission to use, copy, modify, and/or distribute this software for any + * purpose with or without fee is hereby granted, provided that the above + * copyright notice and this permission notice appear in all copies. + * + * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +/* + * Note: the client API is licensed under ISC (see above) to enable + * other wrappers outside of mpv. But keep in mind that the + * mpv core is by default still GPLv2+ - unless built with + * -Dgpl=false, which makes it LGPLv2+. + */ + +#ifndef MPV_CLIENT_API_H_ +#define MPV_CLIENT_API_H_ + +#include +#include + +#ifdef _WIN32 +#define MPV_EXPORT __declspec(dllexport) +#define MPV_SELECTANY __declspec(selectany) +#elif defined(__GNUC__) || defined(__clang__) +#define MPV_EXPORT __attribute__((visibility("default"))) +#define MPV_SELECTANY +#else +#define MPV_EXPORT +#define MPV_SELECTANY +#endif + +#ifdef __cpp_decltype +#define MPV_DECLTYPE decltype +#else +#define MPV_DECLTYPE __typeof__ +#endif + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * Mechanisms provided by this API + * ------------------------------- + * + * This API provides general control over mpv playback. It does not give you + * direct access to individual components of the player, only the whole thing. + * It's somewhat equivalent to MPlayer's slave mode. You can send commands, + * retrieve or set playback status or settings with properties, and receive + * events. + * + * The API can be used in two ways: + * 1) Internally in mpv, to provide additional features to the command line + * player. Lua scripting uses this. (Currently there is no plugin API to + * get a client API handle in external user code. It has to be a fixed + * part of the player at compilation time.) + * 2) Using mpv as a library with mpv_create(). This basically allows embedding + * mpv in other applications. + * + * Documentation + * ------------- + * + * The libmpv C API is documented directly in this header. Note that most + * actual interaction with this player is done through + * options/commands/properties, which can be accessed through this API. + * Essentially everything is done with them, including loading a file, + * retrieving playback progress, and so on. + * + * These are documented elsewhere: + * * http://mpv.io/manual/master/#options + * * http://mpv.io/manual/master/#list-of-input-commands + * * http://mpv.io/manual/master/#properties + * + * You can also look at the examples here: + * * https://github.com/mpv-player/mpv-examples/tree/master/libmpv + * + * Event loop + * ---------- + * + * In general, the API user should run an event loop in order to receive events. + * This event loop should call mpv_wait_event(), which will return once a new + * mpv client API is available. It is also possible to integrate client API + * usage in other event loops (e.g. GUI toolkits) with the + * mpv_set_wakeup_callback() function, and then polling for events by calling + * mpv_wait_event() with a 0 timeout. + * + * Note that the event loop is detached from the actual player. Not calling + * mpv_wait_event() will not stop playback. It will eventually congest the + * event queue of your API handle, though. + * + * Synchronous vs. asynchronous calls + * ---------------------------------- + * + * The API allows both synchronous and asynchronous calls. Synchronous calls + * have to wait until the playback core is ready, which currently can take + * an unbounded time (e.g. if network is slow or unresponsive). Asynchronous + * calls just queue operations as requests, and return the result of the + * operation as events. + * + * Asynchronous calls + * ------------------ + * + * The client API includes asynchronous functions. These allow you to send + * requests instantly, and get replies as events at a later point. The + * requests are made with functions carrying the _async suffix, and replies + * are returned by mpv_wait_event() (interleaved with the normal event stream). + * + * A 64 bit userdata value is used to allow the user to associate requests + * with replies. The value is passed as reply_userdata parameter to the request + * function. The reply to the request will have the reply + * mpv_event->reply_userdata field set to the same value as the + * reply_userdata parameter of the corresponding request. + * + * This userdata value is arbitrary and is never interpreted by the API. Note + * that the userdata value 0 is also allowed, but then the client must be + * careful not accidentally interpret the mpv_event->reply_userdata if an + * event is not a reply. (For non-replies, this field is set to 0.) + * + * Asynchronous calls may be reordered in arbitrarily with other synchronous + * and asynchronous calls. If you want a guaranteed order, you need to wait + * until asynchronous calls report completion before doing the next call. + * + * See also the section "Asynchronous command details" in the manpage. + * + * Multithreading + * -------------- + * + * The client API is generally fully thread-safe, unless otherwise noted. + * Currently, there is no real advantage in using more than 1 thread to access + * the client API, since everything is serialized through a single lock in the + * playback core. + * + * Basic environment requirements + * ------------------------------ + * + * This documents basic requirements on the C environment. This is especially + * important if mpv is used as library with mpv_create(). + * + * - The LC_NUMERIC locale category must be set to "C". If your program calls + * setlocale(), be sure not to use LC_ALL, or if you do, reset LC_NUMERIC + * to its sane default: setlocale(LC_NUMERIC, "C"). + * - If a X11 based VO is used, mpv will set the xlib error handler. This error + * handler is process-wide, and there's no proper way to share it with other + * xlib users within the same process. This might confuse GUI toolkits. + * - mpv uses some other libraries that are not library-safe, such as Fribidi + * (used through libass), ALSA, FFmpeg, and possibly more. + * - The FPU precision must be set at least to double precision. + * - On Windows, mpv will call timeBeginPeriod(1). + * - On memory exhaustion, mpv will kill the process. + * - In certain cases, mpv may start sub processes (such as with the ytdl + * wrapper script). + * - Using UNIX IPC (off by default) will override the SIGPIPE signal handler, + * and set it to SIG_IGN. Some invocations of the "subprocess" command will + * also do that. + * - mpv may start sub processes, so overriding SIGCHLD, or waiting on all PIDs + * (such as calling wait()) by the parent process or any other library within + * the process must be avoided. libmpv itself only waits for its own PIDs. + * - If anything in the process registers signal handlers, they must set the + * SA_RESTART flag. Otherwise you WILL get random failures on signals. + * + * Encoding of filenames + * --------------------- + * + * mpv uses UTF-8 everywhere. + * + * On some platforms (like Linux), filenames actually do not have to be UTF-8; + * for this reason libmpv supports non-UTF-8 strings. libmpv uses what the + * kernel uses and does not recode filenames. At least on Linux, passing a + * string to libmpv is like passing a string to the fopen() function. + * + * On Windows, filenames are always UTF-8, libmpv converts between UTF-8 and + * UTF-16 when using win32 API functions. libmpv never uses or accepts + * filenames in the local 8 bit encoding. It does not use fopen() either; + * it uses _wfopen(). + * + * On macOS, filenames and other strings taken/returned by libmpv can have + * inconsistent unicode normalization. This can sometimes lead to problems. + * You have to hope for the best. + * + * Also see the remarks for MPV_FORMAT_STRING. + * + * Embedding the video window + * -------------------------- + * + * Using the render API (in render.h) is recommended. This API requires + * you to create and maintain an OpenGL context, to which you can render + * video using a specific API call. This API does not include keyboard or mouse + * input directly. + * + * There is an older way to embed the native mpv window into your own. You have + * to get the raw window handle, and set it as "wid" option. This works on X11, + * win32, and macOS only. It's much easier to use than the render API, but + * also has various problems. + * + * Also see client API examples and the mpv manpage. There is an extensive + * discussion here: + * https://github.com/mpv-player/mpv-examples/tree/master/libmpv#methods-of-embedding-the-video-window + * + * Compatibility + * ------------- + * + * mpv development doesn't stand still, and changes to mpv internals as well as + * to its interface can cause compatibility issues to client API users. + * + * The API is versioned (see MPV_CLIENT_API_VERSION), and changes to it are + * documented in DOCS/client-api-changes.rst. The C API itself will probably + * remain compatible for a long time, but the functionality exposed by it + * could change more rapidly. For example, it's possible that options are + * renamed, or change the set of allowed values. + * + * Defensive programming should be used to potentially deal with the fact that + * options, commands, and properties could disappear, change their value range, + * or change the underlying datatypes. It might be a good idea to prefer + * MPV_FORMAT_STRING over other types to decouple your code from potential + * mpv changes. + * + * Also see: DOCS/compatibility.rst + * + * Future changes + * -------------- + * + * This are the planned changes that will most likely be done on the next major + * bump of the library: + * + * - remove all symbols that are marked as deprecated + * - reassign enum numerical values to remove gaps + * - disabling all events by default + */ + +/** + * The version is incremented on each API change. The 16 lower bits form the + * minor version number, and the 16 higher bits the major version number. If + * the API becomes incompatible to previous versions, the major version + * number is incremented. This affects only C part, and not properties and + * options. + * + * Every API bump is described in DOCS/client-api-changes.rst + * + * You can use MPV_MAKE_VERSION() and compare the result with integer + * relational operators (<, >, <=, >=). + */ +#define MPV_MAKE_VERSION(major, minor) (((major) << 16) | (minor) | 0UL) +#define MPV_CLIENT_API_VERSION MPV_MAKE_VERSION(2, 3) + +/** + * The API user is allowed to "#define MPV_ENABLE_DEPRECATED 0" before + * including any libmpv headers. Then deprecated symbols will be excluded + * from the headers. (Of course, deprecated properties and commands and + * other functionality will still work.) + */ +#ifndef MPV_ENABLE_DEPRECATED +#define MPV_ENABLE_DEPRECATED 1 +#endif + +/** + * Return the MPV_CLIENT_API_VERSION the mpv source has been compiled with. + */ +MPV_EXPORT unsigned long mpv_client_api_version(void); + +/** + * Client context used by the client API. Every client has its own private + * handle. + */ +typedef struct mpv_handle mpv_handle; + +/** + * List of error codes than can be returned by API functions. 0 and positive + * return values always mean success, negative values are always errors. + */ +typedef enum mpv_error { + /** + * No error happened (used to signal successful operation). + * Keep in mind that many API functions returning error codes can also + * return positive values, which also indicate success. API users can + * hardcode the fact that ">= 0" means success. + */ + MPV_ERROR_SUCCESS = 0, + /** + * The event ringbuffer is full. This means the client is choked, and can't + * receive any events. This can happen when too many asynchronous requests + * have been made, but not answered. Probably never happens in practice, + * unless the mpv core is frozen for some reason, and the client keeps + * making asynchronous requests. (Bugs in the client API implementation + * could also trigger this, e.g. if events become "lost".) + */ + MPV_ERROR_EVENT_QUEUE_FULL = -1, + /** + * Memory allocation failed. + */ + MPV_ERROR_NOMEM = -2, + /** + * The mpv core wasn't configured and initialized yet. See the notes in + * mpv_create(). + */ + MPV_ERROR_UNINITIALIZED = -3, + /** + * Generic catch-all error if a parameter is set to an invalid or + * unsupported value. This is used if there is no better error code. + */ + MPV_ERROR_INVALID_PARAMETER = -4, + /** + * Trying to set an option that doesn't exist. + */ + MPV_ERROR_OPTION_NOT_FOUND = -5, + /** + * Trying to set an option using an unsupported MPV_FORMAT. + */ + MPV_ERROR_OPTION_FORMAT = -6, + /** + * Setting the option failed. Typically this happens if the provided option + * value could not be parsed. + */ + MPV_ERROR_OPTION_ERROR = -7, + /** + * The accessed property doesn't exist. + */ + MPV_ERROR_PROPERTY_NOT_FOUND = -8, + /** + * Trying to set or get a property using an unsupported MPV_FORMAT. + */ + MPV_ERROR_PROPERTY_FORMAT = -9, + /** + * The property exists, but is not available. This usually happens when the + * associated subsystem is not active, e.g. querying audio parameters while + * audio is disabled. + */ + MPV_ERROR_PROPERTY_UNAVAILABLE = -10, + /** + * Error setting or getting a property. + */ + MPV_ERROR_PROPERTY_ERROR = -11, + /** + * General error when running a command with mpv_command and similar. + */ + MPV_ERROR_COMMAND = -12, + /** + * Generic error on loading (usually used with mpv_event_end_file.error). + */ + MPV_ERROR_LOADING_FAILED = -13, + /** + * Initializing the audio output failed. + */ + MPV_ERROR_AO_INIT_FAILED = -14, + /** + * Initializing the video output failed. + */ + MPV_ERROR_VO_INIT_FAILED = -15, + /** + * There was no audio or video data to play. This also happens if the + * file was recognized, but did not contain any audio or video streams, + * or no streams were selected. + */ + MPV_ERROR_NOTHING_TO_PLAY = -16, + /** + * When trying to load the file, the file format could not be determined, + * or the file was too broken to open it. + */ + MPV_ERROR_UNKNOWN_FORMAT = -17, + /** + * Generic error for signaling that certain system requirements are not + * fulfilled. + */ + MPV_ERROR_UNSUPPORTED = -18, + /** + * The API function which was called is a stub only. + */ + MPV_ERROR_NOT_IMPLEMENTED = -19, + /** + * Unspecified error. + */ + MPV_ERROR_GENERIC = -20 +} mpv_error; + +/** + * Return a string describing the error. For unknown errors, the string + * "unknown error" is returned. + * + * @param error error number, see enum mpv_error + * @return A static string describing the error. The string is completely + * static, i.e. doesn't need to be deallocated, and is valid forever. + */ +MPV_EXPORT const char *mpv_error_string(int error); + +/** + * General function to deallocate memory returned by some of the API functions. + * Call this only if it's explicitly documented as allowed. Calling this on + * mpv memory not owned by the caller will lead to undefined behavior. + * + * @param data A valid pointer returned by the API, or NULL. + */ +MPV_EXPORT void mpv_free(void *data); + +/** + * Return the name of this client handle. Every client has its own unique + * name, which is mostly used for user interface purposes. + * + * @return The client name. The string is read-only and is valid until the + * mpv_handle is destroyed. + */ +MPV_EXPORT const char *mpv_client_name(mpv_handle *ctx); + +/** + * Return the ID of this client handle. Every client has its own unique ID. This + * ID is never reused by the core, even if the mpv_handle at hand gets destroyed + * and new handles get allocated. + * + * IDs are never 0 or negative. + * + * Some mpv APIs (not necessarily all) accept a name in the form "@" in + * addition of the proper mpv_client_name(), where "" is the ID in decimal + * form (e.g. "@123"). For example, the "script-message-to" command takes the + * client name as first argument, but also accepts the client ID formatted in + * this manner. + * + * @return The client ID. + */ +MPV_EXPORT int64_t mpv_client_id(mpv_handle *ctx); + +/** + * Create a new mpv instance and an associated client API handle to control + * the mpv instance. This instance is in a pre-initialized state, + * and needs to be initialized to be actually used with most other API + * functions. + * + * Some API functions will return MPV_ERROR_UNINITIALIZED in the uninitialized + * state. You can call mpv_set_property() (or mpv_set_property_string() and + * other variants, and before mpv 0.21.0 mpv_set_option() etc.) to set initial + * options. After this, call mpv_initialize() to start the player, and then use + * e.g. mpv_command() to start playback of a file. + * + * The point of separating handle creation and actual initialization is that + * you can configure things which can't be changed during runtime. + * + * Unlike the command line player, this will have initial settings suitable + * for embedding in applications. The following settings are different: + * - stdin/stdout/stderr and the terminal will never be accessed. This is + * equivalent to setting the --no-terminal option. + * (Technically, this also suppresses C signal handling.) + * - No config files will be loaded. This is roughly equivalent to using + * --config=no. Since libmpv 1.15, you can actually re-enable this option, + * which will make libmpv load config files during mpv_initialize(). If you + * do this, you are strongly encouraged to set the "config-dir" option too. + * (Otherwise it will load the mpv command line player's config.) + * For example: + * mpv_set_option_string(mpv, "config-dir", "/my/path"); // set config root + * mpv_set_option_string(mpv, "config", "yes"); // enable config loading + * (call mpv_initialize() _after_ this) + * - Idle mode is enabled, which means the playback core will enter idle mode + * if there are no more files to play on the internal playlist, instead of + * exiting. This is equivalent to the --idle option. + * - Disable parts of input handling. + * - Most of the different settings can be viewed with the command line player + * by running "mpv --show-profile=libmpv". + * + * All this assumes that API users want a mpv instance that is strictly + * isolated from the command line player's configuration, user settings, and + * so on. You can re-enable disabled features by setting the appropriate + * options. + * + * The mpv command line parser is not available through this API, but you can + * set individual options with mpv_set_property(). Files for playback must be + * loaded with mpv_command() or others. + * + * Note that you should avoid doing concurrent accesses on the uninitialized + * client handle. (Whether concurrent access is definitely allowed or not has + * yet to be decided.) + * + * @return a new mpv client API handle. Returns NULL on error. Currently, this + * can happen in the following situations: + * - out of memory + * - LC_NUMERIC is not set to "C" (see general remarks) + */ +MPV_EXPORT mpv_handle *mpv_create(void); + +/** + * Initialize an uninitialized mpv instance. If the mpv instance is already + * running, an error is returned. + * + * This function needs to be called to make full use of the client API if the + * client API handle was created with mpv_create(). + * + * Only the following options are required to be set _before_ mpv_initialize(): + * - options which are only read at initialization time: + * - config + * - config-dir + * - input-conf + * - load-scripts + * - script + * - player-operation-mode + * - input-app-events (macOS) + * - all encoding mode options + * + * @return error code + */ +MPV_EXPORT int mpv_initialize(mpv_handle *ctx); + +/** + * Disconnect and destroy the mpv_handle. ctx will be deallocated with this + * API call. + * + * If the last mpv_handle is detached, the core player is destroyed. In + * addition, if there are only weak mpv_handles (such as created by + * mpv_create_weak_client() or internal scripts), these mpv_handles will + * be sent MPV_EVENT_SHUTDOWN. This function may block until these clients + * have responded to the shutdown event, and the core is finally destroyed. + */ +MPV_EXPORT void mpv_destroy(mpv_handle *ctx); + +/** + * Similar to mpv_destroy(), but brings the player and all clients down + * as well, and waits until all of them are destroyed. This function blocks. The + * advantage over mpv_destroy() is that while mpv_destroy() merely + * detaches the client handle from the player, this function quits the player, + * waits until all other clients are destroyed (i.e. all mpv_handles are + * detached), and also waits for the final termination of the player. + * + * Since mpv_destroy() is called somewhere on the way, it's not safe to + * call other functions concurrently on the same context. + * + * Since mpv client API version 1.29: + * The first call on any mpv_handle will block until the core is destroyed. + * This means it will wait until other mpv_handle have been destroyed. If you + * want asynchronous destruction, just run the "quit" command, and then react + * to the MPV_EVENT_SHUTDOWN event. + * If another mpv_handle already called mpv_terminate_destroy(), this call will + * not actually block. It will destroy the mpv_handle, and exit immediately, + * while other mpv_handles might still be uninitializing. + * + * Before mpv client API version 1.29: + * If this is called on a mpv_handle that was not created with mpv_create(), + * this function will merely send a quit command and then call + * mpv_destroy(), without waiting for the actual shutdown. + */ +MPV_EXPORT void mpv_terminate_destroy(mpv_handle *ctx); + +/** + * Create a new client handle connected to the same player core as ctx. This + * context has its own event queue, its own mpv_request_event() state, its own + * mpv_request_log_messages() state, its own set of observed properties, and + * its own state for asynchronous operations. Otherwise, everything is shared. + * + * This handle should be destroyed with mpv_destroy() if no longer + * needed. The core will live as long as there is at least 1 handle referencing + * it. Any handle can make the core quit, which will result in every handle + * receiving MPV_EVENT_SHUTDOWN. + * + * This function can not be called before the main handle was initialized with + * mpv_initialize(). The new handle is always initialized, unless ctx=NULL was + * passed. + * + * @param ctx Used to get the reference to the mpv core; handle-specific + * settings and parameters are not used. + * If NULL, this function behaves like mpv_create() (ignores name). + * @param name The client name. This will be returned by mpv_client_name(). If + * the name is already in use, or contains non-alphanumeric + * characters (other than '_'), the name is modified to fit. + * If NULL, an arbitrary name is automatically chosen. + * @return a new handle, or NULL on error + */ +MPV_EXPORT mpv_handle *mpv_create_client(mpv_handle *ctx, const char *name); + +/** + * This is the same as mpv_create_client(), but the created mpv_handle is + * treated as a weak reference. If all mpv_handles referencing a core are + * weak references, the core is automatically destroyed. (This still goes + * through normal uninit of course. Effectively, if the last non-weak mpv_handle + * is destroyed, then the weak mpv_handles receive MPV_EVENT_SHUTDOWN and are + * asked to terminate as well.) + * + * Note if you want to use this like refcounting: you have to be aware that + * mpv_terminate_destroy() _and_ mpv_destroy() for the last non-weak + * mpv_handle will block until all weak mpv_handles are destroyed. + */ +MPV_EXPORT mpv_handle *mpv_create_weak_client(mpv_handle *ctx, const char *name); + +/** + * Load a config file. This loads and parses the file, and sets every entry in + * the config file's default section as if mpv_set_option_string() is called. + * + * The filename should be an absolute path. If it isn't, the actual path used + * is unspecified. (Note: an absolute path starts with '/' on UNIX.) If the + * file wasn't found, MPV_ERROR_INVALID_PARAMETER is returned. + * + * If a fatal error happens when parsing a config file, MPV_ERROR_OPTION_ERROR + * is returned. Errors when setting options as well as other types or errors + * are ignored (even if options do not exist). You can still try to capture + * the resulting error messages with mpv_request_log_messages(). Note that it's + * possible that some options were successfully set even if any of these errors + * happen. + * + * @param filename absolute path to the config file on the local filesystem + * @return error code + */ +MPV_EXPORT int mpv_load_config_file(mpv_handle *ctx, const char *filename); + +/** + * Return the internal time in nanoseconds. This has an arbitrary start offset, + * but will never wrap or go backwards. + * + * Note that this is always the real time, and doesn't necessarily have to do + * with playback time. For example, playback could go faster or slower due to + * playback speed, or due to playback being paused. Use the "time-pos" property + * instead to get the playback status. + * + * Unlike other libmpv APIs, this can be called at absolutely any time (even + * within wakeup callbacks), as long as the context is valid. + * + * Safe to be called from mpv render API threads. + */ +MPV_EXPORT int64_t mpv_get_time_ns(mpv_handle *ctx); + +/** + * Same as mpv_get_time_ns but in microseconds. + */ +MPV_EXPORT int64_t mpv_get_time_us(mpv_handle *ctx); + +/** + * Data format for options and properties. The API functions to get/set + * properties and options support multiple formats, and this enum describes + * them. + */ +typedef enum mpv_format { + /** + * Invalid. Sometimes used for empty values. This is always defined to 0, + * so a normal 0-init of mpv_format (or e.g. mpv_node) is guaranteed to set + * this it to MPV_FORMAT_NONE (which makes some things saner as consequence). + */ + MPV_FORMAT_NONE = 0, + /** + * The basic type is char*. It returns the raw property string, like + * using ${=property} in input.conf (see input.rst). + * + * NULL isn't an allowed value. + * + * Warning: although the encoding is usually UTF-8, this is not always the + * case. File tags often store strings in some legacy codepage, + * and even filenames don't necessarily have to be in UTF-8 (at + * least on Linux). If you pass the strings to code that requires + * valid UTF-8, you have to sanitize it in some way. + * On Windows, filenames are always UTF-8, and libmpv converts + * between UTF-8 and UTF-16 when using win32 API functions. See + * the "Encoding of filenames" section for details. + * + * Example for reading: + * + * char *result = NULL; + * if (mpv_get_property(ctx, "property", MPV_FORMAT_STRING, &result) < 0) + * goto error; + * printf("%s\n", result); + * mpv_free(result); + * + * Or just use mpv_get_property_string(). + * + * Example for writing: + * + * char *value = "the new value"; + * // yep, you pass the address to the variable + * // (needed for symmetry with other types and mpv_get_property) + * mpv_set_property(ctx, "property", MPV_FORMAT_STRING, &value); + * + * Or just use mpv_set_property_string(). + * + */ + MPV_FORMAT_STRING = 1, + /** + * The basic type is char*. It returns the OSD property string, like + * using ${property} in input.conf (see input.rst). In many cases, this + * is the same as the raw string, but in other cases it's formatted for + * display on OSD. It's intended to be human readable. Do not attempt to + * parse these strings. + * + * Only valid when doing read access. The rest works like MPV_FORMAT_STRING. + */ + MPV_FORMAT_OSD_STRING = 2, + /** + * The basic type is int. The only allowed values are 0 ("no") + * and 1 ("yes"). + * + * Example for reading: + * + * int result; + * if (mpv_get_property(ctx, "property", MPV_FORMAT_FLAG, &result) < 0) + * goto error; + * printf("%s\n", result ? "true" : "false"); + * + * Example for writing: + * + * int flag = 1; + * mpv_set_property(ctx, "property", MPV_FORMAT_FLAG, &flag); + */ + MPV_FORMAT_FLAG = 3, + /** + * The basic type is int64_t. + */ + MPV_FORMAT_INT64 = 4, + /** + * The basic type is double. + */ + MPV_FORMAT_DOUBLE = 5, + /** + * The type is mpv_node. + * + * For reading, you usually would pass a pointer to a stack-allocated + * mpv_node value to mpv, and when you're done you call + * mpv_free_node_contents(&node). + * You're expected not to write to the data - if you have to, copy it + * first (which you have to do manually). + * + * For writing, you construct your own mpv_node, and pass a pointer to the + * API. The API will never write to your data (and copy it if needed), so + * you're free to use any form of allocation or memory management you like. + * + * Warning: when reading, always check the mpv_node.format member. For + * example, properties might change their type in future versions + * of mpv, or sometimes even during runtime. + * + * Example for reading: + * + * mpv_node result; + * if (mpv_get_property(ctx, "property", MPV_FORMAT_NODE, &result) < 0) + * goto error; + * printf("format=%d\n", (int)result.format); + * mpv_free_node_contents(&result). + * + * Example for writing: + * + * mpv_node value; + * value.format = MPV_FORMAT_STRING; + * value.u.string = "hello"; + * mpv_set_property(ctx, "property", MPV_FORMAT_NODE, &value); + */ + MPV_FORMAT_NODE = 6, + /** + * Used with mpv_node only. Can usually not be used directly. + */ + MPV_FORMAT_NODE_ARRAY = 7, + /** + * See MPV_FORMAT_NODE_ARRAY. + */ + MPV_FORMAT_NODE_MAP = 8, + /** + * A raw, untyped byte array. Only used only with mpv_node, and only in + * some very specific situations. (Some commands use it.) + */ + MPV_FORMAT_BYTE_ARRAY = 9 +} mpv_format; + +/** + * Generic data storage. + * + * If mpv writes this struct (e.g. via mpv_get_property()), you must not change + * the data. In some cases (mpv_get_property()), you have to free it with + * mpv_free_node_contents(). If you fill this struct yourself, you're also + * responsible for freeing it, and you must not call mpv_free_node_contents(). + */ +typedef struct mpv_node { + union { + char *string; /** valid if format==MPV_FORMAT_STRING */ + int flag; /** valid if format==MPV_FORMAT_FLAG */ + int64_t int64; /** valid if format==MPV_FORMAT_INT64 */ + double double_; /** valid if format==MPV_FORMAT_DOUBLE */ + /** + * valid if format==MPV_FORMAT_NODE_ARRAY + * or if format==MPV_FORMAT_NODE_MAP + */ + struct mpv_node_list *list; + /** + * valid if format==MPV_FORMAT_BYTE_ARRAY + */ + struct mpv_byte_array *ba; + } u; + /** + * Type of the data stored in this struct. This value rules what members in + * the given union can be accessed. The following formats are currently + * defined to be allowed in mpv_node: + * + * MPV_FORMAT_STRING (u.string) + * MPV_FORMAT_FLAG (u.flag) + * MPV_FORMAT_INT64 (u.int64) + * MPV_FORMAT_DOUBLE (u.double_) + * MPV_FORMAT_NODE_ARRAY (u.list) + * MPV_FORMAT_NODE_MAP (u.list) + * MPV_FORMAT_BYTE_ARRAY (u.ba) + * MPV_FORMAT_NONE (no member) + * + * If you encounter a value you don't know, you must not make any + * assumptions about the contents of union u. + */ + mpv_format format; +} mpv_node; + +/** + * (see mpv_node) + */ +typedef struct mpv_node_list { + /** + * Number of entries. Negative values are not allowed. + */ + int num; + /** + * MPV_FORMAT_NODE_ARRAY: + * values[N] refers to value of the Nth item + * + * MPV_FORMAT_NODE_MAP: + * values[N] refers to value of the Nth key/value pair + * + * If num > 0, values[0] to values[num-1] (inclusive) are valid. + * Otherwise, this can be NULL. + */ + mpv_node *values; + /** + * MPV_FORMAT_NODE_ARRAY: + * unused (typically NULL), access is not allowed + * + * MPV_FORMAT_NODE_MAP: + * keys[N] refers to key of the Nth key/value pair. If num > 0, keys[0] to + * keys[num-1] (inclusive) are valid. Otherwise, this can be NULL. + * The keys are in random order. The only guarantee is that keys[N] belongs + * to the value values[N]. NULL keys are not allowed. + */ + char **keys; +} mpv_node_list; + +/** + * (see mpv_node) + */ +typedef struct mpv_byte_array { + /** + * Pointer to the data. In what format the data is stored is up to whatever + * uses MPV_FORMAT_BYTE_ARRAY. + */ + void *data; + /** + * Size of the data pointed to by ptr. + */ + size_t size; +} mpv_byte_array; + +/** + * Frees any data referenced by the node. It doesn't free the node itself. + * Call this only if the mpv client API set the node. If you constructed the + * node yourself (manually), you have to free it yourself. + * + * If node->format is MPV_FORMAT_NONE, this call does nothing. Likewise, if + * the client API sets a node with this format, this function doesn't need to + * be called. (This is just a clarification that there's no danger of anything + * strange happening in these cases.) + */ +MPV_EXPORT void mpv_free_node_contents(mpv_node *node); + +/** + * Set an option. Note that you can't normally set options during runtime. It + * works in uninitialized state (see mpv_create()), and in some cases in at + * runtime. + * + * Using a format other than MPV_FORMAT_NODE is equivalent to constructing a + * mpv_node with the given format and data, and passing the mpv_node to this + * function. + * + * Note: this is semi-deprecated. For most purposes, this is not needed anymore. + * Starting with mpv version 0.21.0 (version 1.23) most options can be set + * with mpv_set_property() (and related functions), and even before + * mpv_initialize(). In some obscure corner cases, using this function + * to set options might still be required (see + * "Inconsistencies between options and properties" in the manpage). Once + * these are resolved, the option setting functions might be fully + * deprecated. + * + * @param name Option name. This is the same as on the mpv command line, but + * without the leading "--". + * @param format see enum mpv_format. + * @param[in] data Option value (according to the format). + * @return error code + */ +MPV_EXPORT int mpv_set_option(mpv_handle *ctx, const char *name, mpv_format format, + void *data); + +/** + * Convenience function to set an option to a string value. This is like + * calling mpv_set_option() with MPV_FORMAT_STRING. + * + * @return error code + */ +MPV_EXPORT int mpv_set_option_string(mpv_handle *ctx, const char *name, const char *data); + +/** + * Send a command to the player. Commands are the same as those used in + * input.conf, except that this function takes parameters in a pre-split + * form. + * + * The commands and their parameters are documented in input.rst. + * + * Does not use OSD and string expansion by default (unlike mpv_command_string() + * and input.conf). + * + * @param[in] args NULL-terminated list of strings. Usually, the first item + * is the command, and the following items are arguments. + * @return error code + */ +MPV_EXPORT int mpv_command(mpv_handle *ctx, const char **args); + +/** + * Same as mpv_command(), but allows passing structured data in any format. + * In particular, calling mpv_command() is exactly like calling + * mpv_command_node() with the format set to MPV_FORMAT_NODE_ARRAY, and + * every arg passed in order as MPV_FORMAT_STRING. + * + * Does not use OSD and string expansion by default. + * + * The args argument can have one of the following formats: + * + * MPV_FORMAT_NODE_ARRAY: + * Positional arguments. Each entry is an argument using an arbitrary + * format (the format must be compatible to the used command). Usually, + * the first item is the command name (as MPV_FORMAT_STRING). The order + * of arguments is as documented in each command description. + * + * MPV_FORMAT_NODE_MAP: + * Named arguments. This requires at least an entry with the key "name" + * to be present, which must be a string, and contains the command name. + * The special entry "_flags" is optional, and if present, must be an + * array of strings, each being a command prefix to apply. All other + * entries are interpreted as arguments. They must use the argument names + * as documented in each command description. Some commands do not + * support named arguments at all, and must use MPV_FORMAT_NODE_ARRAY. + * + * @param[in] args mpv_node with format set to one of the values documented + * above (see there for details) + * @param[out] result Optional, pass NULL if unused. If not NULL, and if the + * function succeeds, this is set to command-specific return + * data. You must call mpv_free_node_contents() to free it + * (again, only if the command actually succeeds). + * Not many commands actually use this at all. + * @return error code (the result parameter is not set on error) + */ +MPV_EXPORT int mpv_command_node(mpv_handle *ctx, mpv_node *args, mpv_node *result); + +/** + * This is essentially identical to mpv_command() but it also returns a result. + * + * Does not use OSD and string expansion by default. + * + * @param[in] args NULL-terminated list of strings. Usually, the first item + * is the command, and the following items are arguments. + * @param[out] result Optional, pass NULL if unused. If not NULL, and if the + * function succeeds, this is set to command-specific return + * data. You must call mpv_free_node_contents() to free it + * (again, only if the command actually succeeds). + * Not many commands actually use this at all. + * @return error code (the result parameter is not set on error) + */ +MPV_EXPORT int mpv_command_ret(mpv_handle *ctx, const char **args, mpv_node *result); + +/** + * Same as mpv_command, but use input.conf parsing for splitting arguments. + * This is slightly simpler, but also more error prone, since arguments may + * need quoting/escaping. + * + * This also has OSD and string expansion enabled by default. + */ +MPV_EXPORT int mpv_command_string(mpv_handle *ctx, const char *args); + +/** + * Same as mpv_command, but run the command asynchronously. + * + * Commands are executed asynchronously. You will receive a + * MPV_EVENT_COMMAND_REPLY event. This event will also have an + * error code set if running the command failed. For commands that + * return data, the data is put into mpv_event_command.result. + * + * The only case when you do not receive an event is when the function call + * itself fails. This happens only if parsing the command itself (or otherwise + * validating it) fails, i.e. the return code of the API call is not 0 or + * positive. + * + * Safe to be called from mpv render API threads. + * + * @param reply_userdata the value mpv_event.reply_userdata of the reply will + * be set to (see section about asynchronous calls) + * @param args NULL-terminated list of strings (see mpv_command()) + * @return error code (if parsing or queuing the command fails) + */ +MPV_EXPORT int mpv_command_async(mpv_handle *ctx, uint64_t reply_userdata, + const char **args); + +/** + * Same as mpv_command_node(), but run it asynchronously. Basically, this + * function is to mpv_command_node() what mpv_command_async() is to + * mpv_command(). + * + * See mpv_command_async() for details. + * + * Safe to be called from mpv render API threads. + * + * @param reply_userdata the value mpv_event.reply_userdata of the reply will + * be set to (see section about asynchronous calls) + * @param args as in mpv_command_node() + * @return error code (if parsing or queuing the command fails) + */ +MPV_EXPORT int mpv_command_node_async(mpv_handle *ctx, uint64_t reply_userdata, + mpv_node *args); + +/** + * Signal to all async requests with the matching ID to abort. This affects + * the following API calls: + * + * mpv_command_async + * mpv_command_node_async + * + * All of these functions take a reply_userdata parameter. This API function + * tells all requests with the matching reply_userdata value to try to return + * as soon as possible. If there are multiple requests with matching ID, it + * aborts all of them. + * + * This API function is mostly asynchronous itself. It will not wait until the + * command is aborted. Instead, the command will terminate as usual, but with + * some work not done. How this is signaled depends on the specific command (for + * example, the "subprocess" command will indicate it by "killed_by_us" set to + * true in the result). How long it takes also depends on the situation. The + * aborting process is completely asynchronous. + * + * Not all commands may support this functionality. In this case, this function + * will have no effect. The same is true if the request using the passed + * reply_userdata has already terminated, has not been started yet, or was + * never in use at all. + * + * You have to be careful of race conditions: the time during which the abort + * request will be effective is _after_ e.g. mpv_command_async() has returned, + * and before the command has signaled completion with MPV_EVENT_COMMAND_REPLY. + * + * @param reply_userdata ID of the request to be aborted (see above) + */ +MPV_EXPORT void mpv_abort_async_command(mpv_handle *ctx, uint64_t reply_userdata); + +/** + * Set a property to a given value. Properties are essentially variables which + * can be queried or set at runtime. For example, writing to the pause property + * will actually pause or unpause playback. + * + * If the format doesn't match with the internal format of the property, access + * usually will fail with MPV_ERROR_PROPERTY_FORMAT. In some cases, the data + * is automatically converted and access succeeds. For example, MPV_FORMAT_INT64 + * is always converted to MPV_FORMAT_DOUBLE, and access using MPV_FORMAT_STRING + * usually invokes a string parser. The same happens when calling this function + * with MPV_FORMAT_NODE: the underlying format may be converted to another + * type if possible. + * + * Using a format other than MPV_FORMAT_NODE is equivalent to constructing a + * mpv_node with the given format and data, and passing the mpv_node to this + * function. (Before API version 1.21, this was different.) + * + * Note: starting with mpv 0.21.0 (client API version 1.23), this can be used to + * set options in general. It even can be used before mpv_initialize() + * has been called. If called before mpv_initialize(), setting properties + * not backed by options will result in MPV_ERROR_PROPERTY_UNAVAILABLE. + * In some cases, properties and options still conflict. In these cases, + * mpv_set_property() accesses the options before mpv_initialize(), and + * the properties after mpv_initialize(). These conflicts will be removed + * in mpv 0.23.0. See mpv_set_option() for further remarks. + * + * @param name The property name. See input.rst for a list of properties. + * @param format see enum mpv_format. + * @param[in] data Option value. + * @return error code + */ +MPV_EXPORT int mpv_set_property(mpv_handle *ctx, const char *name, mpv_format format, + void *data); + +/** + * Convenience function to set a property to a string value. + * + * This is like calling mpv_set_property() with MPV_FORMAT_STRING. + */ +MPV_EXPORT int mpv_set_property_string(mpv_handle *ctx, const char *name, const char *data); + +/** + * Convenience function to delete a property. + * + * This is equivalent to running the command "del [name]". + * + * @param name The property name. See input.rst for a list of properties. + * @return error code + */ +MPV_EXPORT int mpv_del_property(mpv_handle *ctx, const char *name); + +/** + * Set a property asynchronously. You will receive the result of the operation + * as MPV_EVENT_SET_PROPERTY_REPLY event. The mpv_event.error field will contain + * the result status of the operation. Otherwise, this function is similar to + * mpv_set_property(). + * + * Safe to be called from mpv render API threads. + * + * @param reply_userdata see section about asynchronous calls + * @param name The property name. + * @param format see enum mpv_format. + * @param[in] data Option value. The value will be copied by the function. It + * will never be modified by the client API. + * @return error code if sending the request failed + */ +MPV_EXPORT int mpv_set_property_async(mpv_handle *ctx, uint64_t reply_userdata, + const char *name, mpv_format format, void *data); + +/** + * Read the value of the given property. + * + * If the format doesn't match with the internal format of the property, access + * usually will fail with MPV_ERROR_PROPERTY_FORMAT. In some cases, the data + * is automatically converted and access succeeds. For example, MPV_FORMAT_INT64 + * is always converted to MPV_FORMAT_DOUBLE, and access using MPV_FORMAT_STRING + * usually invokes a string formatter. + * + * @param name The property name. + * @param format see enum mpv_format. + * @param[out] data Pointer to the variable holding the option value. On + * success, the variable will be set to a copy of the option + * value. For formats that require dynamic memory allocation, + * you can free the value with mpv_free() (strings) or + * mpv_free_node_contents() (MPV_FORMAT_NODE). + * @return error code + */ +MPV_EXPORT int mpv_get_property(mpv_handle *ctx, const char *name, mpv_format format, + void *data); + +/** + * Return the value of the property with the given name as string. This is + * equivalent to mpv_get_property() with MPV_FORMAT_STRING. + * + * See MPV_FORMAT_STRING for character encoding issues. + * + * On error, NULL is returned. Use mpv_get_property() if you want fine-grained + * error reporting. + * + * @param name The property name. + * @return Property value, or NULL if the property can't be retrieved. Free + * the string with mpv_free(). + */ +MPV_EXPORT char *mpv_get_property_string(mpv_handle *ctx, const char *name); + +/** + * Return the property as "OSD" formatted string. This is the same as + * mpv_get_property_string, but using MPV_FORMAT_OSD_STRING. + * + * @return Property value, or NULL if the property can't be retrieved. Free + * the string with mpv_free(). + */ +MPV_EXPORT char *mpv_get_property_osd_string(mpv_handle *ctx, const char *name); + +/** + * Get a property asynchronously. You will receive the result of the operation + * as well as the property data with the MPV_EVENT_GET_PROPERTY_REPLY event. + * You should check the mpv_event.error field on the reply event. + * + * Safe to be called from mpv render API threads. + * + * @param reply_userdata see section about asynchronous calls + * @param name The property name. + * @param format see enum mpv_format. + * @return error code if sending the request failed + */ +MPV_EXPORT int mpv_get_property_async(mpv_handle *ctx, uint64_t reply_userdata, + const char *name, mpv_format format); + +/** + * Get a notification whenever the given property changes. You will receive + * updates as MPV_EVENT_PROPERTY_CHANGE. Note that this is not very precise: + * for some properties, it may not send updates even if the property changed. + * This depends on the property, and it's a valid feature request to ask for + * better update handling of a specific property. (For some properties, like + * ``clock``, which shows the wall clock, this mechanism doesn't make too + * much sense anyway.) + * + * Property changes are coalesced: the change events are returned only once the + * event queue becomes empty (e.g. mpv_wait_event() would block or return + * MPV_EVENT_NONE), and then only one event per changed property is returned. + * + * You always get an initial change notification. This is meant to initialize + * the user's state to the current value of the property. + * + * Normally, change events are sent only if the property value changes according + * to the requested format. mpv_event_property will contain the property value + * as data member. + * + * Warning: if a property is unavailable or retrieving it caused an error, + * MPV_FORMAT_NONE will be set in mpv_event_property, even if the + * format parameter was set to a different value. In this case, the + * mpv_event_property.data field is invalid. + * + * If the property is observed with the format parameter set to MPV_FORMAT_NONE, + * you get low-level notifications whether the property _may_ have changed, and + * the data member in mpv_event_property will be unset. With this mode, you + * will have to determine yourself whether the property really changed. On the + * other hand, this mechanism can be faster and uses less resources. + * + * Observing a property that doesn't exist is allowed. (Although it may still + * cause some sporadic change events.) + * + * Keep in mind that you will get change notifications even if you change a + * property yourself. Try to avoid endless feedback loops, which could happen + * if you react to the change notifications triggered by your own change. + * + * Only the mpv_handle on which this was called will receive the property + * change events, or can unobserve them. + * + * Safe to be called from mpv render API threads. + * + * @param reply_userdata This will be used for the mpv_event.reply_userdata + * field for the received MPV_EVENT_PROPERTY_CHANGE + * events. (Also see section about asynchronous calls, + * although this function is somewhat different from + * actual asynchronous calls.) + * If you have no use for this, pass 0. + * Also see mpv_unobserve_property(). + * @param name The property name. + * @param format see enum mpv_format. Can be MPV_FORMAT_NONE to omit values + * from the change events. + * @return error code (usually fails only on OOM or unsupported format) + */ +MPV_EXPORT int mpv_observe_property(mpv_handle *mpv, uint64_t reply_userdata, + const char *name, mpv_format format); + +/** + * Undo mpv_observe_property(). This will remove all observed properties for + * which the given number was passed as reply_userdata to mpv_observe_property. + * + * Safe to be called from mpv render API threads. + * + * @param registered_reply_userdata ID that was passed to mpv_observe_property + * @return negative value is an error code, >=0 is number of removed properties + * on success (includes the case when 0 were removed) + */ +MPV_EXPORT int mpv_unobserve_property(mpv_handle *mpv, uint64_t registered_reply_userdata); + +typedef enum mpv_event_id { + /** + * Nothing happened. Happens on timeouts or sporadic wakeups. + */ + MPV_EVENT_NONE = 0, + /** + * Happens when the player quits. The player enters a state where it tries + * to disconnect all clients. Most requests to the player will fail, and + * the client should react to this and quit with mpv_destroy() as soon as + * possible. + */ + MPV_EVENT_SHUTDOWN = 1, + /** + * See mpv_request_log_messages(). + */ + MPV_EVENT_LOG_MESSAGE = 2, + /** + * Reply to a mpv_get_property_async() request. + * See also mpv_event and mpv_event_property. + */ + MPV_EVENT_GET_PROPERTY_REPLY = 3, + /** + * Reply to a mpv_set_property_async() request. + * (Unlike MPV_EVENT_GET_PROPERTY, mpv_event_property is not used.) + */ + MPV_EVENT_SET_PROPERTY_REPLY = 4, + /** + * Reply to a mpv_command_async() or mpv_command_node_async() request. + * See also mpv_event and mpv_event_command. + */ + MPV_EVENT_COMMAND_REPLY = 5, + /** + * Notification before playback start of a file (before the file is loaded). + * See also mpv_event and mpv_event_start_file. + */ + MPV_EVENT_START_FILE = 6, + /** + * Notification after playback end (after the file was unloaded). + * See also mpv_event and mpv_event_end_file. + */ + MPV_EVENT_END_FILE = 7, + /** + * Notification when the file has been loaded (headers were read etc.), and + * decoding starts. + */ + MPV_EVENT_FILE_LOADED = 8, +#if MPV_ENABLE_DEPRECATED + /** + * Idle mode was entered. In this mode, no file is played, and the playback + * core waits for new commands. (The command line player normally quits + * instead of entering idle mode, unless --idle was specified. If mpv + * was started with mpv_create(), idle mode is enabled by default.) + * + * @deprecated This is equivalent to using mpv_observe_property() on the + * "idle-active" property. The event is redundant, and might be + * removed in the far future. As a further warning, this event + * is not necessarily sent at the right point anymore (at the + * start of the program), while the property behaves correctly. + */ + MPV_EVENT_IDLE = 11, + /** + * Sent every time after a video frame is displayed. Note that currently, + * this will be sent in lower frequency if there is no video, or playback + * is paused - but that will be removed in the future, and it will be + * restricted to video frames only. + * + * @deprecated Use mpv_observe_property() with relevant properties instead + * (such as "playback-time"). + */ + MPV_EVENT_TICK = 14, +#endif + /** + * Triggered by the script-message input command. The command uses the + * first argument of the command as client name (see mpv_client_name()) to + * dispatch the message, and passes along all arguments starting from the + * second argument as strings. + * See also mpv_event and mpv_event_client_message. + */ + MPV_EVENT_CLIENT_MESSAGE = 16, + /** + * Happens after video changed in some way. This can happen on resolution + * changes, pixel format changes, or video filter changes. The event is + * sent after the video filters and the VO are reconfigured. Applications + * embedding a mpv window should listen to this event in order to resize + * the window if needed. + * Note that this event can happen sporadically, and you should check + * yourself whether the video parameters really changed before doing + * something expensive. + */ + MPV_EVENT_VIDEO_RECONFIG = 17, + /** + * Similar to MPV_EVENT_VIDEO_RECONFIG. This is relatively uninteresting, + * because there is no such thing as audio output embedding. + */ + MPV_EVENT_AUDIO_RECONFIG = 18, + /** + * Happens when a seek was initiated. Playback stops. Usually it will + * resume with MPV_EVENT_PLAYBACK_RESTART as soon as the seek is finished. + */ + MPV_EVENT_SEEK = 20, + /** + * There was a discontinuity of some sort (like a seek), and playback + * was reinitialized. Usually happens on start of playback and after + * seeking. The main purpose is allowing the client to detect when a seek + * request is finished. + */ + MPV_EVENT_PLAYBACK_RESTART = 21, + /** + * Event sent due to mpv_observe_property(). + * See also mpv_event and mpv_event_property. + */ + MPV_EVENT_PROPERTY_CHANGE = 22, + /** + * Happens if the internal per-mpv_handle ringbuffer overflows, and at + * least 1 event had to be dropped. This can happen if the client doesn't + * read the event queue quickly enough with mpv_wait_event(), or if the + * client makes a very large number of asynchronous calls at once. + * + * Event delivery will continue normally once this event was returned + * (this forces the client to empty the queue completely). + */ + MPV_EVENT_QUEUE_OVERFLOW = 24, + /** + * Triggered if a hook handler was registered with mpv_hook_add(), and the + * hook is invoked. If you receive this, you must handle it, and continue + * the hook with mpv_hook_continue(). + * See also mpv_event and mpv_event_hook. + */ + MPV_EVENT_HOOK = 25, + // Internal note: adjust INTERNAL_EVENT_BASE when adding new events. +} mpv_event_id; + +/** + * Return a string describing the event. For unknown events, NULL is returned. + * + * Note that all events actually returned by the API will also yield a non-NULL + * string with this function. + * + * @param event event ID, see see enum mpv_event_id + * @return A static string giving a short symbolic name of the event. It + * consists of lower-case alphanumeric characters and can include "-" + * characters. This string is suitable for use in e.g. scripting + * interfaces. + * The string is completely static, i.e. doesn't need to be deallocated, + * and is valid forever. + */ +MPV_EXPORT const char *mpv_event_name(mpv_event_id event); + +typedef struct mpv_event_property { + /** + * Name of the property. + */ + const char *name; + /** + * Format of the data field in the same struct. See enum mpv_format. + * This is always the same format as the requested format, except when + * the property could not be retrieved (unavailable, or an error happened), + * in which case the format is MPV_FORMAT_NONE. + */ + mpv_format format; + /** + * Received property value. Depends on the format. This is like the + * pointer argument passed to mpv_get_property(). + * + * For example, for MPV_FORMAT_STRING you get the string with: + * + * char *value = *(char **)(event_property->data); + * + * Note that this is set to NULL if retrieving the property failed (the + * format will be MPV_FORMAT_NONE). + */ + void *data; +} mpv_event_property; + +/** + * Numeric log levels. The lower the number, the more important the message is. + * MPV_LOG_LEVEL_NONE is never used when receiving messages. The string in + * the comment after the value is the name of the log level as used for the + * mpv_request_log_messages() function. + * Unused numeric values are unused, but reserved for future use. + */ +typedef enum mpv_log_level { + MPV_LOG_LEVEL_NONE = 0, /// "no" - disable absolutely all messages + MPV_LOG_LEVEL_FATAL = 10, /// "fatal" - critical/aborting errors + MPV_LOG_LEVEL_ERROR = 20, /// "error" - simple errors + MPV_LOG_LEVEL_WARN = 30, /// "warn" - possible problems + MPV_LOG_LEVEL_INFO = 40, /// "info" - informational message + MPV_LOG_LEVEL_V = 50, /// "v" - noisy informational message + MPV_LOG_LEVEL_DEBUG = 60, /// "debug" - very noisy technical information + MPV_LOG_LEVEL_TRACE = 70, /// "trace" - extremely noisy +} mpv_log_level; + +typedef struct mpv_event_log_message { + /** + * The module prefix, identifies the sender of the message. As a special + * case, if the message buffer overflows, this will be set to the string + * "overflow" (which doesn't appear as prefix otherwise), and the text + * field will contain an informative message. + */ + const char *prefix; + /** + * The log level as string. See mpv_request_log_messages() for possible + * values. The level "no" is never used here. + */ + const char *level; + /** + * The log message. It consists of 1 line of text, and is terminated with + * a newline character. (Before API version 1.6, it could contain multiple + * or partial lines.) + */ + const char *text; + /** + * The same contents as the level field, but as a numeric ID. + * Since API version 1.6. + */ + mpv_log_level log_level; +} mpv_event_log_message; + +/// Since API version 1.9. +typedef enum mpv_end_file_reason { + /** + * The end of file was reached. Sometimes this may also happen on + * incomplete or corrupted files, or if the network connection was + * interrupted when playing a remote file. It also happens if the + * playback range was restricted with --end or --frames or similar. + */ + MPV_END_FILE_REASON_EOF = 0, + /** + * Playback was stopped by an external action (e.g. playlist controls). + */ + MPV_END_FILE_REASON_STOP = 2, + /** + * Playback was stopped by the quit command or player shutdown. + */ + MPV_END_FILE_REASON_QUIT = 3, + /** + * Some kind of error happened that lead to playback abort. Does not + * necessarily happen on incomplete or broken files (in these cases, both + * MPV_END_FILE_REASON_ERROR or MPV_END_FILE_REASON_EOF are possible). + * + * mpv_event_end_file.error will be set. + */ + MPV_END_FILE_REASON_ERROR = 4, + /** + * The file was a playlist or similar. When the playlist is read, its + * entries will be appended to the playlist after the entry of the current + * file, the entry of the current file is removed, and a MPV_EVENT_END_FILE + * event is sent with reason set to MPV_END_FILE_REASON_REDIRECT. Then + * playback continues with the playlist contents. + * Since API version 1.18. + */ + MPV_END_FILE_REASON_REDIRECT = 5, +} mpv_end_file_reason; + +/// Since API version 1.108. +typedef struct mpv_event_start_file { + /** + * Playlist entry ID of the file being loaded now. + */ + int64_t playlist_entry_id; +} mpv_event_start_file; + +typedef struct mpv_event_end_file { + /** + * Corresponds to the values in enum mpv_end_file_reason. + * + * Unknown values should be treated as unknown. + */ + mpv_end_file_reason reason; + /** + * If reason==MPV_END_FILE_REASON_ERROR, this contains a mpv error code + * (one of MPV_ERROR_...) giving an approximate reason why playback + * failed. In other cases, this field is 0 (no error). + * Since API version 1.9. + */ + int error; + /** + * Playlist entry ID of the file that was being played or attempted to be + * played. This has the same value as the playlist_entry_id field in the + * corresponding mpv_event_start_file event. + * Since API version 1.108. + */ + int64_t playlist_entry_id; + /** + * If loading ended, because the playlist entry to be played was for example + * a playlist, and the current playlist entry is replaced with a number of + * other entries. This may happen at least with MPV_END_FILE_REASON_REDIRECT + * (other event types may use this for similar but different purposes in the + * future). In this case, playlist_insert_id will be set to the playlist + * entry ID of the first inserted entry, and playlist_insert_num_entries to + * the total number of inserted playlist entries. Note this in this specific + * case, the ID of the last inserted entry is playlist_insert_id+num-1. + * Beware that depending on circumstances, you may observe the new playlist + * entries before seeing the event (e.g. reading the "playlist" property or + * getting a property change notification before receiving the event). + * Since API version 1.108. + */ + int64_t playlist_insert_id; + /** + * See playlist_insert_id. Only non-0 if playlist_insert_id is valid. Never + * negative. + * Since API version 1.108. + */ + int playlist_insert_num_entries; +} mpv_event_end_file; + +typedef struct mpv_event_client_message { + /** + * Arbitrary arguments chosen by the sender of the message. If num_args > 0, + * you can access args[0] through args[num_args - 1] (inclusive). What + * these arguments mean is up to the sender and receiver. + * None of the valid items are NULL. + */ + int num_args; + const char **args; +} mpv_event_client_message; + +typedef struct mpv_event_hook { + /** + * The hook name as passed to mpv_hook_add(). + */ + const char *name; + /** + * Internal ID that must be passed to mpv_hook_continue(). + */ + uint64_t id; +} mpv_event_hook; + +// Since API version 1.102. +typedef struct mpv_event_command { + /** + * Result data of the command. Note that success/failure is signaled + * separately via mpv_event.error. This field is only for result data + * in case of success. Most commands leave it at MPV_FORMAT_NONE. Set + * to MPV_FORMAT_NONE on failure. + */ + mpv_node result; +} mpv_event_command; + +typedef struct mpv_event { + /** + * One of mpv_event. Keep in mind that later ABI compatible releases might + * add new event types. These should be ignored by the API user. + */ + mpv_event_id event_id; + /** + * This is mainly used for events that are replies to (asynchronous) + * requests. It contains a status code, which is >= 0 on success, or < 0 + * on error (a mpv_error value). Usually, this will be set if an + * asynchronous request fails. + * Used for: + * MPV_EVENT_GET_PROPERTY_REPLY + * MPV_EVENT_SET_PROPERTY_REPLY + * MPV_EVENT_COMMAND_REPLY + */ + int error; + /** + * If the event is in reply to a request (made with this API and this + * API handle), this is set to the reply_userdata parameter of the request + * call. Otherwise, this field is 0. + * Used for: + * MPV_EVENT_GET_PROPERTY_REPLY + * MPV_EVENT_SET_PROPERTY_REPLY + * MPV_EVENT_COMMAND_REPLY + * MPV_EVENT_PROPERTY_CHANGE + * MPV_EVENT_HOOK + */ + uint64_t reply_userdata; + /** + * The meaning and contents of the data member depend on the event_id: + * MPV_EVENT_GET_PROPERTY_REPLY: mpv_event_property* + * MPV_EVENT_PROPERTY_CHANGE: mpv_event_property* + * MPV_EVENT_LOG_MESSAGE: mpv_event_log_message* + * MPV_EVENT_CLIENT_MESSAGE: mpv_event_client_message* + * MPV_EVENT_START_FILE: mpv_event_start_file* (since v1.108) + * MPV_EVENT_END_FILE: mpv_event_end_file* + * MPV_EVENT_HOOK: mpv_event_hook* + * MPV_EVENT_COMMAND_REPLY* mpv_event_command* + * other: NULL + * + * Note: future enhancements might add new event structs for existing or new + * event types. + */ + void *data; +} mpv_event; + +/** + * Convert the given src event to a mpv_node, and set *dst to the result. *dst + * is set to a MPV_FORMAT_NODE_MAP, with fields for corresponding mpv_event and + * mpv_event.data/mpv_event_* fields. + * + * The exact details are not completely documented out of laziness. A start + * is located in the "Events" section of the manpage. + * + * *dst may point to newly allocated memory, or pointers in mpv_event. You must + * copy the entire mpv_node if you want to reference it after mpv_event becomes + * invalid (such as making a new mpv_wait_event() call, or destroying the + * mpv_handle from which it was returned). Call mpv_free_node_contents() to free + * any memory allocations made by this API function. + * + * Safe to be called from mpv render API threads. + * + * @param dst Target. This is not read and fully overwritten. Must be released + * with mpv_free_node_contents(). Do not write to pointers returned + * by it. (On error, this may be left as an empty node.) + * @param src The source event. Not modified (it's not const due to the author's + * prejudice of the C version of const). + * @return error code (MPV_ERROR_NOMEM only, if at all) + */ +MPV_EXPORT int mpv_event_to_node(mpv_node *dst, mpv_event *src); + +/** + * Enable or disable the given event. + * + * Some events are enabled by default. Some events can't be disabled. + * + * (Informational note: currently, all events are enabled by default, except + * MPV_EVENT_TICK.) + * + * Safe to be called from mpv render API threads. + * + * @param event See enum mpv_event_id. + * @param enable 1 to enable receiving this event, 0 to disable it. + * @return error code + */ +MPV_EXPORT int mpv_request_event(mpv_handle *ctx, mpv_event_id event, int enable); + +/** + * Enable or disable receiving of log messages. These are the messages the + * command line player prints to the terminal. This call sets the minimum + * required log level for a message to be received with MPV_EVENT_LOG_MESSAGE. + * + * @param min_level Minimal log level as string. Valid log levels: + * no fatal error warn info v debug trace + * The value "no" disables all messages. This is the default. + * An exception is the value "terminal-default", which uses the + * log level as set by the "--msg-level" option. This works + * even if the terminal is disabled. (Since API version 1.19.) + * Also see mpv_log_level. + * @return error code + */ +MPV_EXPORT int mpv_request_log_messages(mpv_handle *ctx, const char *min_level); + +/** + * Wait for the next event, or until the timeout expires, or if another thread + * makes a call to mpv_wakeup(). Passing 0 as timeout will never wait, and + * is suitable for polling. + * + * The internal event queue has a limited size (per client handle). If you + * don't empty the event queue quickly enough with mpv_wait_event(), it will + * overflow and silently discard further events. If this happens, making + * asynchronous requests will fail as well (with MPV_ERROR_EVENT_QUEUE_FULL). + * + * Only one thread is allowed to call this on the same mpv_handle at a time. + * The API won't complain if more than one thread calls this, but it will cause + * race conditions in the client when accessing the shared mpv_event struct. + * Note that most other API functions are not restricted by this, and no API + * function internally calls mpv_wait_event(). Additionally, concurrent calls + * to different mpv_handles are always safe. + * + * As long as the timeout is 0, this is safe to be called from mpv render API + * threads. + * + * @param timeout Timeout in seconds, after which the function returns even if + * no event was received. A MPV_EVENT_NONE is returned on + * timeout. A value of 0 will disable waiting. Negative values + * will wait with an infinite timeout. + * @return A struct containing the event ID and other data. The pointer (and + * fields in the struct) stay valid until the next mpv_wait_event() + * call, or until the mpv_handle is destroyed. You must not write to + * the struct, and all memory referenced by it will be automatically + * released by the API on the next mpv_wait_event() call, or when the + * context is destroyed. The return value is never NULL. + */ +MPV_EXPORT mpv_event *mpv_wait_event(mpv_handle *ctx, double timeout); + +/** + * Interrupt the current mpv_wait_event() call. This will wake up the thread + * currently waiting in mpv_wait_event(). If no thread is waiting, the next + * mpv_wait_event() call will return immediately (this is to avoid lost + * wakeups). + * + * mpv_wait_event() will receive a MPV_EVENT_NONE if it's woken up due to + * this call. But note that this dummy event might be skipped if there are + * already other events queued. All what counts is that the waiting thread + * is woken up at all. + * + * Safe to be called from mpv render API threads. + */ +MPV_EXPORT void mpv_wakeup(mpv_handle *ctx); + +/** + * Set a custom function that should be called when there are new events. Use + * this if blocking in mpv_wait_event() to wait for new events is not feasible. + * + * Keep in mind that the callback will be called from foreign threads. You + * must not make any assumptions of the environment, and you must return as + * soon as possible (i.e. no long blocking waits). Exiting the callback through + * any other means than a normal return is forbidden (no throwing exceptions, + * no longjmp() calls). You must not change any local thread state (such as + * the C floating point environment). + * + * You are not allowed to call any client API functions inside of the callback. + * In particular, you should not do any processing in the callback, but wake up + * another thread that does all the work. The callback is meant strictly for + * notification only, and is called from arbitrary core parts of the player, + * that make no considerations for reentrant API use or allowing the callee to + * spend a lot of time doing other things. Keep in mind that it's also possible + * that the callback is called from a thread while a mpv API function is called + * (i.e. it can be reentrant). + * + * In general, the client API expects you to call mpv_wait_event() to receive + * notifications, and the wakeup callback is merely a helper utility to make + * this easier in certain situations. Note that it's possible that there's + * only one wakeup callback invocation for multiple events. You should call + * mpv_wait_event() with no timeout until MPV_EVENT_NONE is reached, at which + * point the event queue is empty. + * + * If you actually want to do processing in a callback, spawn a thread that + * does nothing but call mpv_wait_event() in a loop and dispatches the result + * to a callback. + * + * Only one wakeup callback can be set. + * + * @param cb function that should be called if a wakeup is required + * @param d arbitrary userdata passed to cb + */ +MPV_EXPORT void mpv_set_wakeup_callback(mpv_handle *ctx, void (*cb)(void *d), void *d); + +/** + * Block until all asynchronous requests are done. This affects functions like + * mpv_command_async(), which return immediately and return their result as + * events. + * + * This is a helper, and somewhat equivalent to calling mpv_wait_event() in a + * loop until all known asynchronous requests have sent their reply as event, + * except that the event queue is not emptied. + * + * In case you called mpv_suspend() before, this will also forcibly reset the + * suspend counter of the given handle. + */ +MPV_EXPORT void mpv_wait_async_requests(mpv_handle *ctx); + +/** + * A hook is like a synchronous event that blocks the player. You register + * a hook handler with this function. You will get an event, which you need + * to handle, and once things are ready, you can let the player continue with + * mpv_hook_continue(). + * + * Currently, hooks can't be removed explicitly. But they will be implicitly + * removed if the mpv_handle it was registered with is destroyed. This also + * continues the hook if it was being handled by the destroyed mpv_handle (but + * this should be avoided, as it might mess up order of hook execution). + * + * Hook handlers are ordered globally by priority and order of registration. + * Handlers for the same hook with same priority are invoked in order of + * registration (the handler registered first is run first). Handlers with + * lower priority are run first (which seems backward). + * + * See the "Hooks" section in the manpage to see which hooks are currently + * defined. + * + * Some hooks might be reentrant (so you get multiple MPV_EVENT_HOOK for the + * same hook). If this can happen for a specific hook type, it will be + * explicitly documented in the manpage. + * + * Only the mpv_handle on which this was called will receive the hook events, + * or can "continue" them. + * + * @param reply_userdata This will be used for the mpv_event.reply_userdata + * field for the received MPV_EVENT_HOOK events. + * If you have no use for this, pass 0. + * @param name The hook name. This should be one of the documented names. But + * if the name is unknown, the hook event will simply be never + * raised. + * @param priority See remarks above. Use 0 as a neutral default. + * @return error code (usually fails only on OOM) + */ +MPV_EXPORT int mpv_hook_add(mpv_handle *ctx, uint64_t reply_userdata, + const char *name, int priority); + +/** + * Respond to a MPV_EVENT_HOOK event. You must call this after you have handled + * the event. There is no way to "cancel" or "stop" the hook. + * + * Calling this will will typically unblock the player for whatever the hook + * is responsible for (e.g. for the "on_load" hook it lets it continue + * playback). + * + * It is explicitly undefined behavior to call this more than once for each + * MPV_EVENT_HOOK, to pass an incorrect ID, or to call this on a mpv_handle + * different from the one that registered the handler and received the event. + * + * @param id This must be the value of the mpv_event_hook.id field for the + * corresponding MPV_EVENT_HOOK. + * @return error code + */ +MPV_EXPORT int mpv_hook_continue(mpv_handle *ctx, uint64_t id); + +#if MPV_ENABLE_DEPRECATED + +/** + * Return a UNIX file descriptor referring to the read end of a pipe. This + * pipe can be used to wake up a poll() based processing loop. The purpose of + * this function is very similar to mpv_set_wakeup_callback(), and provides + * a primitive mechanism to handle coordinating a foreign event loop and the + * libmpv event loop. The pipe is non-blocking. It's closed when the mpv_handle + * is destroyed. This function always returns the same value (on success). + * + * This is in fact implemented using the same underlying code as for + * mpv_set_wakeup_callback() (though they don't conflict), and it is as if each + * callback invocation writes a single 0 byte to the pipe. When the pipe + * becomes readable, the code calling poll() (or select()) on the pipe should + * read all contents of the pipe and then call mpv_wait_event(c, 0) until + * no new events are returned. The pipe contents do not matter and can just + * be discarded. There is not necessarily one byte per readable event in the + * pipe. For example, the pipes are non-blocking, and mpv won't block if the + * pipe is full. Pipes are normally limited to 4096 bytes, so if there are + * more than 4096 events, the number of readable bytes can not equal the number + * of events queued. Also, it's possible that mpv does not write to the pipe + * once it's guaranteed that the client was already signaled. See the example + * below how to do it correctly. + * + * Example: + * + * int pipefd = mpv_get_wakeup_pipe(mpv); + * if (pipefd < 0) + * error(); + * while (1) { + * struct pollfd pfds[1] = { + * { .fd = pipefd, .events = POLLIN }, + * }; + * // Wait until there are possibly new mpv events. + * poll(pfds, 1, -1); + * if (pfds[0].revents & POLLIN) { + * // Empty the pipe. Doing this before calling mpv_wait_event() + * // ensures that no wakeups are missed. It's not so important to + * // make sure the pipe is really empty (it will just cause some + * // additional wakeups in unlikely corner cases). + * char unused[256]; + * read(pipefd, unused, sizeof(unused)); + * while (1) { + * mpv_event *ev = mpv_wait_event(mpv, 0); + * // If MPV_EVENT_NONE is received, the event queue is empty. + * if (ev->event_id == MPV_EVENT_NONE) + * break; + * // Process the event. + * ... + * } + * } + * } + * + * @deprecated this function will be removed in the future. If you need this + * functionality, use mpv_set_wakeup_callback(), create a pipe + * manually, and call write() on your pipe in the callback. + * + * @return A UNIX FD of the read end of the wakeup pipe, or -1 on error. + * On MS Windows/MinGW, this will always return -1. + */ +MPV_EXPORT int mpv_get_wakeup_pipe(mpv_handle *ctx); + +#endif + +/** + * Defining MPV_CPLUGIN_DYNAMIC_SYM during plugin compilation will replace mpv_* + * functions with function pointers. Those pointer will be initialized when + * loading the plugin. + * + * It is recommended to use this symbol table when targeting Windows. The loader + * does not have notion of global symbols. Loading cplugin into mpv process will + * not allow this plugin to call any of the symbols that may be available in + * other modules. Instead cplugin has to link explicitly to specific PE binary, + * libmpv-2.dll/mpv.exe or any other binary that may have linked mpv statically. + * This limits portability of cplugin as it would need to be compiled separately + * for each of target PE binary that includes mpv's symbols. Which in practice + * is unrealistic, as we want one cplugin to be loaded without those restrictions. + * + * Instead of linking to any PE binary, we create function pointers for all mpv's + * exported symbols. For convenience names of entrypoints are redefined to those + * pointer, so no changes are required in cplugin source code, except of defining + * MPV_CPLUGIN_DYNAMIC_SYM. Those function pointer are exported to make them + * available for mpv to init with correct values during runtime, before calling + * `mpv_open_cplugin`. + * + * Note that those pointers are decorated with `selectany` attribute, so no need + * to worry about multiple definitions, linker will keep only single instance. + */ +#ifdef MPV_CPLUGIN_DYNAMIC_SYM + +#define MPV_DEFINE_SYM_PTR(name) \ + MPV_SELECTANY MPV_EXPORT \ + MPV_DECLTYPE(name) *pfn_##name; + +MPV_DEFINE_SYM_PTR(mpv_client_api_version) +#define mpv_client_api_version pfn_mpv_client_api_version +MPV_DEFINE_SYM_PTR(mpv_error_string) +#define mpv_error_string pfn_mpv_error_string +MPV_DEFINE_SYM_PTR(mpv_free) +#define mpv_free pfn_mpv_free +MPV_DEFINE_SYM_PTR(mpv_client_name) +#define mpv_client_name pfn_mpv_client_name +MPV_DEFINE_SYM_PTR(mpv_client_id) +#define mpv_client_id pfn_mpv_client_id +MPV_DEFINE_SYM_PTR(mpv_create) +#define mpv_create pfn_mpv_create +MPV_DEFINE_SYM_PTR(mpv_initialize) +#define mpv_initialize pfn_mpv_initialize +MPV_DEFINE_SYM_PTR(mpv_destroy) +#define mpv_destroy pfn_mpv_destroy +MPV_DEFINE_SYM_PTR(mpv_terminate_destroy) +#define mpv_terminate_destroy pfn_mpv_terminate_destroy +MPV_DEFINE_SYM_PTR(mpv_create_client) +#define mpv_create_client pfn_mpv_create_client +MPV_DEFINE_SYM_PTR(mpv_create_weak_client) +#define mpv_create_weak_client pfn_mpv_create_weak_client +MPV_DEFINE_SYM_PTR(mpv_load_config_file) +#define mpv_load_config_file pfn_mpv_load_config_file +MPV_DEFINE_SYM_PTR(mpv_get_time_ns) +#define mpv_get_time_ns pfn_mpv_get_time_ns +MPV_DEFINE_SYM_PTR(mpv_get_time_us) +#define mpv_get_time_us pfn_mpv_get_time_us +MPV_DEFINE_SYM_PTR(mpv_free_node_contents) +#define mpv_free_node_contents pfn_mpv_free_node_contents +MPV_DEFINE_SYM_PTR(mpv_set_option) +#define mpv_set_option pfn_mpv_set_option +MPV_DEFINE_SYM_PTR(mpv_set_option_string) +#define mpv_set_option_string pfn_mpv_set_option_string +MPV_DEFINE_SYM_PTR(mpv_command) +#define mpv_command pfn_mpv_command +MPV_DEFINE_SYM_PTR(mpv_command_node) +#define mpv_command_node pfn_mpv_command_node +MPV_DEFINE_SYM_PTR(mpv_command_ret) +#define mpv_command_ret pfn_mpv_command_ret +MPV_DEFINE_SYM_PTR(mpv_command_string) +#define mpv_command_string pfn_mpv_command_string +MPV_DEFINE_SYM_PTR(mpv_command_async) +#define mpv_command_async pfn_mpv_command_async +MPV_DEFINE_SYM_PTR(mpv_command_node_async) +#define mpv_command_node_async pfn_mpv_command_node_async +MPV_DEFINE_SYM_PTR(mpv_abort_async_command) +#define mpv_abort_async_command pfn_mpv_abort_async_command +MPV_DEFINE_SYM_PTR(mpv_set_property) +#define mpv_set_property pfn_mpv_set_property +MPV_DEFINE_SYM_PTR(mpv_set_property_string) +#define mpv_set_property_string pfn_mpv_set_property_string +MPV_DEFINE_SYM_PTR(mpv_del_property) +#define mpv_del_property pfn_mpv_del_property +MPV_DEFINE_SYM_PTR(mpv_set_property_async) +#define mpv_set_property_async pfn_mpv_set_property_async +MPV_DEFINE_SYM_PTR(mpv_get_property) +#define mpv_get_property pfn_mpv_get_property +MPV_DEFINE_SYM_PTR(mpv_get_property_string) +#define mpv_get_property_string pfn_mpv_get_property_string +MPV_DEFINE_SYM_PTR(mpv_get_property_osd_string) +#define mpv_get_property_osd_string pfn_mpv_get_property_osd_string +MPV_DEFINE_SYM_PTR(mpv_get_property_async) +#define mpv_get_property_async pfn_mpv_get_property_async +MPV_DEFINE_SYM_PTR(mpv_observe_property) +#define mpv_observe_property pfn_mpv_observe_property +MPV_DEFINE_SYM_PTR(mpv_unobserve_property) +#define mpv_unobserve_property pfn_mpv_unobserve_property +MPV_DEFINE_SYM_PTR(mpv_event_name) +#define mpv_event_name pfn_mpv_event_name +MPV_DEFINE_SYM_PTR(mpv_event_to_node) +#define mpv_event_to_node pfn_mpv_event_to_node +MPV_DEFINE_SYM_PTR(mpv_request_event) +#define mpv_request_event pfn_mpv_request_event +MPV_DEFINE_SYM_PTR(mpv_request_log_messages) +#define mpv_request_log_messages pfn_mpv_request_log_messages +MPV_DEFINE_SYM_PTR(mpv_wait_event) +#define mpv_wait_event pfn_mpv_wait_event +MPV_DEFINE_SYM_PTR(mpv_wakeup) +#define mpv_wakeup pfn_mpv_wakeup +MPV_DEFINE_SYM_PTR(mpv_set_wakeup_callback) +#define mpv_set_wakeup_callback pfn_mpv_set_wakeup_callback +MPV_DEFINE_SYM_PTR(mpv_wait_async_requests) +#define mpv_wait_async_requests pfn_mpv_wait_async_requests +MPV_DEFINE_SYM_PTR(mpv_hook_add) +#define mpv_hook_add pfn_mpv_hook_add +MPV_DEFINE_SYM_PTR(mpv_hook_continue) +#define mpv_hook_continue pfn_mpv_hook_continue +MPV_DEFINE_SYM_PTR(mpv_get_wakeup_pipe) +#define mpv_get_wakeup_pipe pfn_mpv_get_wakeup_pipe + +#endif + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/mpv/render.h b/include/mpv/render.h new file mode 100644 index 0000000..862ffde --- /dev/null +++ b/include/mpv/render.h @@ -0,0 +1,759 @@ +/* Copyright (C) 2018 the mpv developers + * + * Permission to use, copy, modify, and/or distribute this software for any + * purpose with or without fee is hereby granted, provided that the above + * copyright notice and this permission notice appear in all copies. + * + * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#ifndef MPV_CLIENT_API_RENDER_H_ +#define MPV_CLIENT_API_RENDER_H_ + +#include "client.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * Overview + * -------- + * + * This API can be used to make mpv render using supported graphic APIs (such + * as OpenGL). It can be used to handle video display. + * + * The renderer needs to be created with mpv_render_context_create() before + * you start playback (or otherwise cause a VO to be created). Then (with most + * backends) mpv_render_context_render() can be used to explicitly render the + * current video frame. Use mpv_render_context_set_update_callback() to get + * notified when there is a new frame to draw. + * + * Preferably rendering should be done in a separate thread. If you call + * normal libmpv API functions on the renderer thread, deadlocks can result + * (these are made non-fatal with timeouts, but user experience will obviously + * suffer). See "Threading" section below. + * + * You can output and embed video without this API by setting the mpv "wid" + * option to a native window handle (see "Embedding the video window" section + * in the client.h header). In general, using the render API is recommended, + * because window embedding can cause various issues, especially with GUI + * toolkits and certain platforms. + * + * Supported backends + * ------------------ + * + * OpenGL: via MPV_RENDER_API_TYPE_OPENGL, see render_gl.h header. + * Software: via MPV_RENDER_API_TYPE_SW, see section "Software renderer" + * + * Threading + * --------- + * + * You are recommended to do rendering on a separate thread than normal libmpv + * use. + * + * The mpv_render_* functions can be called from any thread, under the + * following conditions: + * - only one of the mpv_render_* functions can be called at the same time + * (unless they belong to different mpv cores created by mpv_create()) + * - never can be called from within the callbacks set with + * mpv_set_wakeup_callback() or mpv_render_context_set_update_callback() + * - if the OpenGL backend is used, for all functions the OpenGL context + * must be "current" in the calling thread, and it must be the same OpenGL + * context as the mpv_render_context was created with. Otherwise, undefined + * behavior will occur. + * - the thread does not call libmpv API functions other than the mpv_render_* + * functions, except APIs which are declared as safe (see below). Likewise, + * there must be no lock or wait dependency from the render thread to a + * thread using other libmpv functions. Basically, the situation that your + * render thread waits for a "not safe" libmpv API function to return must + * not happen. If you ignore this requirement, deadlocks can happen, which + * are made non-fatal with timeouts; then playback quality will be degraded, + * and the message + * mpv_render_context_render() not being called or stuck. + * is logged. If you set MPV_RENDER_PARAM_ADVANCED_CONTROL, you promise that + * this won't happen, and must absolutely guarantee it, or a real deadlock + * will freeze the mpv core thread forever. + * + * libmpv functions which are safe to call from a render thread are: + * - functions marked with "Safe to be called from mpv render API threads." + * - client.h functions which don't have an explicit or implicit mpv_handle + * parameter + * - mpv_render_* functions; but only for the same mpv_render_context pointer. + * If the pointer is different, mpv_render_context_free() is not safe. (The + * reason is that if MPV_RENDER_PARAM_ADVANCED_CONTROL is set, it may have + * to process still queued requests from the core, which it can do only for + * the current context, while requests for other contexts would deadlock. + * Also, it may have to wait and block for the core to terminate the video + * chain to make sure no resources are used after context destruction.) + * - if the mpv_handle parameter refers to a different mpv core than the one + * you're rendering for (very obscure, but allowed) + * + * Note about old libmpv version: + * + * Before API version 1.105 (basically in mpv 0.29.x), simply enabling + * MPV_RENDER_PARAM_ADVANCED_CONTROL could cause deadlock issues. This can + * be worked around by setting the "vd-lavc-dr" option to "no". + * In addition, you were required to call all mpv_render*() API functions + * from the same thread on which mpv_render_context_create() was originally + * run (for the same the mpv_render_context). Not honoring it led to UB + * (deadlocks, use of invalid mp_thread handles), even if you moved your GL + * context to a different thread correctly. + * These problems were addressed in API version 1.105 (mpv 0.30.0). + * + * Context and handle lifecycle + * ---------------------------- + * + * Video initialization will fail if the render context was not initialized yet + * (with mpv_render_context_create()), or it will revert to a VO that creates + * its own window. + * + * Currently, there can be only 1 mpv_render_context at a time per mpv core. + * + * Calling mpv_render_context_free() while a VO is using the render context is + * active will disable video. + * + * You must free the context with mpv_render_context_free() before the mpv core + * is destroyed. If this doesn't happen, undefined behavior will result. + * + * Software renderer + * ----------------- + * + * MPV_RENDER_API_TYPE_SW provides an extremely simple (but slow) renderer to + * memory surfaces. You probably don't want to use this. Use other render API + * types, or other methods of video embedding. + * + * Use mpv_render_context_create() with MPV_RENDER_PARAM_API_TYPE set to + * MPV_RENDER_API_TYPE_SW. + * + * Call mpv_render_context_render() with various MPV_RENDER_PARAM_SW_* fields + * to render the video frame to an in-memory surface. The following fields are + * required: MPV_RENDER_PARAM_SW_SIZE, MPV_RENDER_PARAM_SW_FORMAT, + * MPV_RENDER_PARAM_SW_STRIDE, MPV_RENDER_PARAM_SW_POINTER. + * + * This method of rendering is very slow, because everything, including color + * conversion, scaling, and OSD rendering, is done on the CPU, single-threaded. + * In particular, large video or display sizes, as well as presence of OSD or + * subtitles can make it too slow for realtime. As with other software rendering + * VOs, setting "sw-fast" may help. Enabling or disabling zimg may help, + * depending on the platform. + * + * In addition, certain multimedia job creation measures like HDR may not work + * properly, and will have to be manually handled by for example inserting + * filters. + * + * This API is not really suitable to extract individual frames from video etc. + * (basically non-playback uses) - there are better libraries for this. It can + * be used this way, but it may be clunky and tricky. + * + * Further notes: + * - MPV_RENDER_PARAM_FLIP_Y is currently ignored (unsupported) + * - MPV_RENDER_PARAM_DEPTH is ignored (meaningless) + */ + +/** + * Opaque context, returned by mpv_render_context_create(). + */ +typedef struct mpv_render_context mpv_render_context; + +/** + * Parameters for mpv_render_param (which is used in a few places such as + * mpv_render_context_create(). + * + * Also see mpv_render_param for conventions and how to use it. + */ +typedef enum mpv_render_param_type { + /** + * Not a valid value, but also used to terminate a params array. Its value + * is always guaranteed to be 0 (even if the ABI changes in the future). + */ + MPV_RENDER_PARAM_INVALID = 0, + /** + * The render API to use. Valid for mpv_render_context_create(). + * + * Type: char* + * + * Defined APIs: + * + * MPV_RENDER_API_TYPE_OPENGL: + * OpenGL desktop 2.1 or later (preferably core profile compatible to + * OpenGL 3.2), or OpenGLES 2.0 or later. + * Providing MPV_RENDER_PARAM_OPENGL_INIT_PARAMS is required. + * It is expected that an OpenGL context is valid and "current" when + * calling mpv_render_* functions (unless specified otherwise). It + * must be the same context for the same mpv_render_context. + */ + MPV_RENDER_PARAM_API_TYPE = 1, + /** + * Required parameters for initializing the OpenGL renderer. Valid for + * mpv_render_context_create(). + * Type: mpv_opengl_init_params* + */ + MPV_RENDER_PARAM_OPENGL_INIT_PARAMS = 2, + /** + * Describes a GL render target. Valid for mpv_render_context_render(). + * Type: mpv_opengl_fbo* + */ + MPV_RENDER_PARAM_OPENGL_FBO = 3, + /** + * Control flipped rendering. Valid for mpv_render_context_render(). + * Type: int* + * If the value is set to 0, render normally. Otherwise, render it flipped, + * which is needed e.g. when rendering to an OpenGL default framebuffer + * (which has a flipped coordinate system). + */ + MPV_RENDER_PARAM_FLIP_Y = 4, + /** + * Control surface depth. Valid for mpv_render_context_render(). + * Type: int* + * This implies the depth of the surface passed to the render function in + * bits per channel. If omitted or set to 0, the renderer will assume 8. + * Typically used to control dithering. + */ + MPV_RENDER_PARAM_DEPTH = 5, + /** + * ICC profile blob. Valid for mpv_render_context_set_parameter(). + * Type: mpv_byte_array* + * Set an ICC profile for use with the "icc-profile-auto" option. (If the + * option is not enabled, the ICC data will not be used.) + */ + MPV_RENDER_PARAM_ICC_PROFILE = 6, + /** + * Ambient light in lux. Valid for mpv_render_context_set_parameter(). + * Type: int* + * This can be used for automatic gamma correction. + */ + MPV_RENDER_PARAM_AMBIENT_LIGHT = 7, + /** + * X11 Display, sometimes used for hwdec. Valid for + * mpv_render_context_create(). The Display must stay valid for the lifetime + * of the mpv_render_context. + * Type: Display* + */ + MPV_RENDER_PARAM_X11_DISPLAY = 8, + /** + * Wayland display, sometimes used for hwdec. Valid for + * mpv_render_context_create(). The wl_display must stay valid for the + * lifetime of the mpv_render_context. + * Type: struct wl_display* + */ + MPV_RENDER_PARAM_WL_DISPLAY = 9, + /** + * Better control about rendering and enabling some advanced features. Valid + * for mpv_render_context_create(). + * + * This conflates multiple requirements the API user promises to abide if + * this option is enabled: + * + * - The API user's render thread, which is calling the mpv_render_*() + * functions, never waits for the core. Otherwise deadlocks can happen. + * See "Threading" section. + * - The callback set with mpv_render_context_set_update_callback() can now + * be called even if there is no new frame. The API user should call the + * mpv_render_context_update() function, and interpret the return value + * for whether a new frame should be rendered. + * - Correct functionality is impossible if the update callback is not set, + * or not set soon enough after mpv_render_context_create() (the core can + * block while waiting for you to call mpv_render_context_update(), and + * if the update callback is not correctly set, it will deadlock, or + * block for too long). + * + * In general, setting this option will enable the following features (and + * possibly more): + * + * - "Direct rendering", which means the player decodes directly to a + * texture, which saves a copy per video frame ("vd-lavc-dr" option + * needs to be enabled, and the rendering backend as well as the + * underlying GPU API/driver needs to have support for it). + * - Rendering screenshots with the GPU API if supported by the backend + * (instead of using a suboptimal software fallback via libswscale). + * + * Warning: do not just add this without reading the "Threading" section + * above, and then wondering that deadlocks happen. The + * requirements are tricky. But also note that even if advanced + * control is disabled, not adhering to the rules will lead to + * playback problems. Enabling advanced controls simply makes + * violating these rules fatal. + * + * Type: int*: 0 for disable (default), 1 for enable + */ + MPV_RENDER_PARAM_ADVANCED_CONTROL = 10, + /** + * Return information about the next frame to render. Valid for + * mpv_render_context_get_info(). + * + * Type: mpv_render_frame_info* + * + * It strictly returns information about the _next_ frame. The implication + * is that e.g. mpv_render_context_update()'s return value will have + * MPV_RENDER_UPDATE_FRAME set, and the user is supposed to call + * mpv_render_context_render(). If there is no next frame, then the + * return value will have is_valid set to 0. + */ + MPV_RENDER_PARAM_NEXT_FRAME_INFO = 11, + /** + * Enable or disable video timing. Valid for mpv_render_context_render(). + * + * Type: int*: 0 for disable, 1 for enable (default) + * + * When video is timed to audio, the player attempts to render video a bit + * ahead, and then do a blocking wait until the target display time is + * reached. This blocks mpv_render_context_render() for up to the amount + * specified with the "video-timing-offset" global option. You can set + * this parameter to 0 to disable this kind of waiting. If you do, it's + * recommended to use the target time value in mpv_render_frame_info to + * wait yourself, or to set the "video-timing-offset" to 0 instead. + * + * Disabling this without doing anything in addition will result in A/V sync + * being slightly off. + */ + MPV_RENDER_PARAM_BLOCK_FOR_TARGET_TIME = 12, + /** + * Use to skip rendering in mpv_render_context_render(). + * + * Type: int*: 0 for rendering (default), 1 for skipping + * + * If this is set, you don't need to pass a target surface to the render + * function (and if you do, it's completely ignored). This can still call + * into the lower level APIs (i.e. if you use OpenGL, the OpenGL context + * must be set). + * + * Be aware that the render API will consider this frame as having been + * rendered. All other normal rules also apply, for example about whether + * you have to call mpv_render_context_report_swap(). It also does timing + * in the same way. + */ + MPV_RENDER_PARAM_SKIP_RENDERING = 13, + /** + * Deprecated. Not supported. Use MPV_RENDER_PARAM_DRM_DISPLAY_V2 instead. + * Type : struct mpv_opengl_drm_params* + */ + MPV_RENDER_PARAM_DRM_DISPLAY = 14, + /** + * DRM draw surface size, contains draw surface dimensions. + * Valid for mpv_render_context_create(). + * Type : struct mpv_opengl_drm_draw_surface_size* + */ + MPV_RENDER_PARAM_DRM_DRAW_SURFACE_SIZE = 15, + /** + * DRM display, contains drm display handles. + * Valid for mpv_render_context_create(). + * Type : struct mpv_opengl_drm_params_v2* + */ + MPV_RENDER_PARAM_DRM_DISPLAY_V2 = 16, + /** + * MPV_RENDER_API_TYPE_SW only: rendering target surface size, mandatory. + * Valid for MPV_RENDER_API_TYPE_SW & mpv_render_context_render(). + * Type: int[2] (e.g.: int s[2] = {w, h}; param.data = &s[0];) + * + * The video frame is transformed as with other VOs. Typically, this means + * the video gets scaled and black bars are added if the video size or + * aspect ratio mismatches with the target size. + */ + MPV_RENDER_PARAM_SW_SIZE = 17, + /** + * MPV_RENDER_API_TYPE_SW only: rendering target surface pixel format, + * mandatory. + * Valid for MPV_RENDER_API_TYPE_SW & mpv_render_context_render(). + * Type: char* (e.g.: char *f = "rgb0"; param.data = f;) + * + * Valid values are: + * "rgb0", "bgr0", "0bgr", "0rgb" + * 4 bytes per pixel RGB, 1 byte (8 bit) per component, component bytes + * with increasing address from left to right (e.g. "rgb0" has r at + * address 0), the "0" component contains uninitialized garbage (often + * the value 0, but not necessarily; the bad naming is inherited from + * FFmpeg) + * Pixel alignment size: 4 bytes + * "rgb24" + * 3 bytes per pixel RGB. This is strongly discouraged because it is + * very slow. + * Pixel alignment size: 1 bytes + * other + * The API may accept other pixel formats, using mpv internal format + * names, as long as it's internally marked as RGB, has exactly 1 + * plane, and is supported as conversion output. It is not a good idea + * to rely on any of these. Their semantics and handling could change. + */ + MPV_RENDER_PARAM_SW_FORMAT = 18, + /** + * MPV_RENDER_API_TYPE_SW only: rendering target surface bytes per line, + * mandatory. + * Valid for MPV_RENDER_API_TYPE_SW & mpv_render_context_render(). + * Type: size_t* + * + * This is the number of bytes between a pixel (x, y) and (x, y + 1) on the + * target surface. It must be a multiple of the pixel size, and have space + * for the surface width as specified by MPV_RENDER_PARAM_SW_SIZE. + * + * Both stride and pointer value should be a multiple of 64 to facilitate + * fast SIMD operation. Lower alignment might trigger slower code paths, + * and in the worst case, will copy the entire target frame. If mpv is built + * with zimg (and zimg is not disabled), the performance impact might be + * less. + * In either cases, the pointer and stride must be aligned at least to the + * pixel alignment size. Otherwise, crashes and undefined behavior is + * possible on platforms which do not support unaligned accesses (either + * through normal memory access or aligned SIMD memory access instructions). + */ + MPV_RENDER_PARAM_SW_STRIDE = 19, + /* + * MPV_RENDER_API_TYPE_SW only: rendering target surface pixel data pointer, + * mandatory. + * Valid for MPV_RENDER_API_TYPE_SW & mpv_render_context_render(). + * Type: void* + * + * This points to the first pixel at the left/top corner (0, 0). In + * particular, each line y starts at (pointer + stride * y). Upon rendering, + * all data between pointer and (pointer + stride * h) is overwritten. + * Whether the padding between (w, y) and (0, y + 1) is overwritten is left + * unspecified (it should not be, but unfortunately some scaler backends + * will do it anyway). It is assumed that even the padding after the last + * line (starting at bytepos(w, h) until (pointer + stride * h)) is + * writable. + * + * See MPV_RENDER_PARAM_SW_STRIDE for alignment requirements. + */ + MPV_RENDER_PARAM_SW_POINTER = 20, +} mpv_render_param_type; + +/** + * For backwards compatibility with the old naming of + * MPV_RENDER_PARAM_DRM_DRAW_SURFACE_SIZE + */ +#define MPV_RENDER_PARAM_DRM_OSD_SIZE MPV_RENDER_PARAM_DRM_DRAW_SURFACE_SIZE + +/** + * Used to pass arbitrary parameters to some mpv_render_* functions. The + * meaning of the data parameter is determined by the type, and each + * MPV_RENDER_PARAM_* documents what type the value must point to. + * + * Each value documents the required data type as the pointer you cast to + * void* and set on mpv_render_param.data. For example, if MPV_RENDER_PARAM_FOO + * documents the type as Something* , then the code should look like this: + * + * Something foo = {...}; + * mpv_render_param param; + * param.type = MPV_RENDER_PARAM_FOO; + * param.data = & foo; + * + * Normally, the data field points to exactly 1 object. If the type is char*, + * it points to a 0-terminated string. + * + * In all cases (unless documented otherwise) the pointers need to remain + * valid during the call only. Unless otherwise documented, the API functions + * will not write to the params array or any data pointed to it. + * + * As a convention, parameter arrays are always terminated by type==0. There + * is no specific order of the parameters required. The order of the 2 fields in + * this struct is guaranteed (even after ABI changes). + */ +typedef struct mpv_render_param { + enum mpv_render_param_type type; + void *data; +} mpv_render_param; + + +/** + * Predefined values for MPV_RENDER_PARAM_API_TYPE. + */ +// See render_gl.h +#define MPV_RENDER_API_TYPE_OPENGL "opengl" +// See section "Software renderer" +#define MPV_RENDER_API_TYPE_SW "sw" + +/** + * Flags used in mpv_render_frame_info.flags. Each value represents a bit in it. + */ +typedef enum mpv_render_frame_info_flag { + /** + * Set if there is actually a next frame. If unset, there is no next frame + * yet, and other flags and fields that require a frame to be queued will + * be unset. + * + * This is set for _any_ kind of frame, even for redraw requests. + * + * Note that when this is unset, it simply means no new frame was + * decoded/queued yet, not necessarily that the end of the video was + * reached. A new frame can be queued after some time. + * + * If the return value of mpv_render_context_render() had the + * MPV_RENDER_UPDATE_FRAME flag set, this flag will usually be set as well, + * unless the frame is rendered, or discarded by other asynchronous events. + */ + MPV_RENDER_FRAME_INFO_PRESENT = 1 << 0, + /** + * If set, the frame is not an actual new video frame, but a redraw request. + * For example if the video is paused, and an option that affects video + * rendering was changed (or any other reason), an update request can be + * issued and this flag will be set. + * + * Typically, redraw frames will not be subject to video timing. + * + * Implies MPV_RENDER_FRAME_INFO_PRESENT. + */ + MPV_RENDER_FRAME_INFO_REDRAW = 1 << 1, + /** + * If set, this is supposed to reproduce the previous frame perfectly. This + * is usually used for certain "video-sync" options ("display-..." modes). + * Typically the renderer will blit the video from a FBO. Unset otherwise. + * + * Implies MPV_RENDER_FRAME_INFO_PRESENT. + */ + MPV_RENDER_FRAME_INFO_REPEAT = 1 << 2, + /** + * If set, the player timing code expects that the user thread blocks on + * vsync (by either delaying the render call, or by making a call to + * mpv_render_context_report_swap() at vsync time). + * + * Implies MPV_RENDER_FRAME_INFO_PRESENT. + */ + MPV_RENDER_FRAME_INFO_BLOCK_VSYNC = 1 << 3, +} mpv_render_frame_info_flag; + +/** + * Information about the next video frame that will be rendered. Can be + * retrieved with MPV_RENDER_PARAM_NEXT_FRAME_INFO. + */ +typedef struct mpv_render_frame_info { + /** + * A bitset of mpv_render_frame_info_flag values (i.e. multiple flags are + * combined with bitwise or). + */ + uint64_t flags; + /** + * Absolute time at which the frame is supposed to be displayed. This is in + * the same unit and base as the time returned by mpv_get_time_us(). For + * frames that are redrawn, or if vsync locked video timing is used (see + * "video-sync" option), then this can be 0. The "video-timing-offset" + * option determines how much "headroom" the render thread gets (but a high + * enough frame rate can reduce it anyway). mpv_render_context_render() will + * normally block until the time is elapsed, unless you pass it + * MPV_RENDER_PARAM_BLOCK_FOR_TARGET_TIME = 0. + */ + int64_t target_time; +} mpv_render_frame_info; + +/** + * Initialize the renderer state. Depending on the backend used, this will + * access the underlying GPU API and initialize its own objects. + * + * You must free the context with mpv_render_context_free(). Not doing so before + * the mpv core is destroyed may result in memory leaks or crashes. + * + * Currently, only at most 1 context can exists per mpv core (it represents the + * main video output). + * + * You should pass the following parameters: + * - MPV_RENDER_PARAM_API_TYPE to select the underlying backend/GPU API. + * - Backend-specific init parameter, like MPV_RENDER_PARAM_OPENGL_INIT_PARAMS. + * - Setting MPV_RENDER_PARAM_ADVANCED_CONTROL and following its rules is + * strongly recommended. + * - If you want to use hwdec, possibly hwdec interop resources. + * + * @param res set to the context (on success) or NULL (on failure). The value + * is never read and always overwritten. + * @param mpv handle used to get the core (the mpv_render_context won't depend + * on this specific handle, only the core referenced by it) + * @param params an array of parameters, terminated by type==0. It's left + * unspecified what happens with unknown parameters. At least + * MPV_RENDER_PARAM_API_TYPE is required, and most backends will + * require another backend-specific parameter. + * @return error code, including but not limited to: + * MPV_ERROR_UNSUPPORTED: the OpenGL version is not supported + * (or required extensions are missing) + * MPV_ERROR_NOT_IMPLEMENTED: an unknown API type was provided, or + * support for the requested API was not + * built in the used libmpv binary. + * MPV_ERROR_INVALID_PARAMETER: at least one of the provided parameters was + * not valid. + */ +MPV_EXPORT int mpv_render_context_create(mpv_render_context **res, mpv_handle *mpv, + mpv_render_param *params); + +/** + * Attempt to change a single parameter. Not all backends and parameter types + * support all kinds of changes. + * + * @param ctx a valid render context + * @param param the parameter type and data that should be set + * @return error code. If a parameter could actually be changed, this returns + * success, otherwise an error code depending on the parameter type + * and situation. + */ +MPV_EXPORT int mpv_render_context_set_parameter(mpv_render_context *ctx, + mpv_render_param param); + +/** + * Retrieve information from the render context. This is NOT a counterpart to + * mpv_render_context_set_parameter(), because you generally can't read + * parameters set with it, and this function is not meant for this purpose. + * Instead, this is for communicating information from the renderer back to the + * user. See mpv_render_param_type; entries which support this function + * explicitly mention it, and for other entries you can assume it will fail. + * + * You pass param with param.type set and param.data pointing to a variable + * of the required data type. The function will then overwrite that variable + * with the returned value (at least on success). + * + * @param ctx a valid render context + * @param param the parameter type and data that should be retrieved + * @return error code. If a parameter could actually be retrieved, this returns + * success, otherwise an error code depending on the parameter type + * and situation. MPV_ERROR_NOT_IMPLEMENTED is used for unknown + * param.type, or if retrieving it is not supported. + */ +MPV_EXPORT int mpv_render_context_get_info(mpv_render_context *ctx, + mpv_render_param param); + +typedef void (*mpv_render_update_fn)(void *cb_ctx); + +/** + * Set the callback that notifies you when a new video frame is available, or + * if the video display configuration somehow changed and requires a redraw. + * Similar to mpv_set_wakeup_callback(), you must not call any mpv API from + * the callback, and all the other listed restrictions apply (such as not + * exiting the callback by throwing exceptions). + * + * This can be called from any thread, except from an update callback. In case + * of the OpenGL backend, no OpenGL state or API is accessed. + * + * Calling this will raise an update callback immediately. + * + * @param callback callback(callback_ctx) is called if the frame should be + * redrawn + * @param callback_ctx opaque argument to the callback + */ +MPV_EXPORT void mpv_render_context_set_update_callback(mpv_render_context *ctx, + mpv_render_update_fn callback, + void *callback_ctx); + +/** + * The API user is supposed to call this when the update callback was invoked + * (like all mpv_render_* functions, this has to happen on the render thread, + * and _not_ from the update callback itself). + * + * This is optional if MPV_RENDER_PARAM_ADVANCED_CONTROL was not set (default). + * Otherwise, it's a hard requirement that this is called after each update + * callback. If multiple update callback happened, and the function could not + * be called sooner, it's OK to call it once after the last callback. + * + * If an update callback happens during or after this function, the function + * must be called again at the soonest possible time. + * + * If MPV_RENDER_PARAM_ADVANCED_CONTROL was set, this will do additional work + * such as allocating textures for the video decoder. + * + * @return a bitset of mpv_render_update_flag values (i.e. multiple flags are + * combined with bitwise or). Typically, this will tell the API user + * what should happen next. E.g. if the MPV_RENDER_UPDATE_FRAME flag is + * set, mpv_render_context_render() should be called. If flags unknown + * to the API user are set, or if the return value is 0, nothing needs + * to be done. + */ +MPV_EXPORT uint64_t mpv_render_context_update(mpv_render_context *ctx); + +/** + * Flags returned by mpv_render_context_update(). Each value represents a bit + * in the function's return value. + */ +typedef enum mpv_render_update_flag { + /** + * A new video frame must be rendered. mpv_render_context_render() must be + * called. + */ + MPV_RENDER_UPDATE_FRAME = 1 << 0, +} mpv_render_context_flag; + +/** + * Render video. + * + * Typically renders the video to a target surface provided via mpv_render_param + * (the details depend on the backend in use). Options like "panscan" are + * applied to determine which part of the video should be visible and how the + * video should be scaled. You can change these options at runtime by using the + * mpv property API. + * + * The renderer will reconfigure itself every time the target surface + * configuration (such as size) is changed. + * + * This function implicitly pulls a video frame from the internal queue and + * renders it. If no new frame is available, the previous frame is redrawn. + * The update callback set with mpv_render_context_set_update_callback() + * notifies you when a new frame was added. The details potentially depend on + * the backends and the provided parameters. + * + * Generally, libmpv will invoke your update callback some time before the video + * frame should be shown, and then lets this function block until the supposed + * display time. This will limit your rendering to video FPS. You can prevent + * this by setting the "video-timing-offset" global option to 0. (This applies + * only to "audio" video sync mode.) + * + * You should pass the following parameters: + * - Backend-specific target object, such as MPV_RENDER_PARAM_OPENGL_FBO. + * - Possibly transformations, such as MPV_RENDER_PARAM_FLIP_Y. + * + * @param ctx a valid render context + * @param params an array of parameters, terminated by type==0. Which parameters + * are required depends on the backend. It's left unspecified what + * happens with unknown parameters. + * @return error code + */ +MPV_EXPORT int mpv_render_context_render(mpv_render_context *ctx, mpv_render_param *params); + +/** + * Tell the renderer that a frame was flipped at the given time. This is + * optional, but can help the player to achieve better timing. + * + * Note that calling this at least once informs libmpv that you will use this + * function. If you use it inconsistently, expect bad video playback. + * + * If this is called while no video is initialized, it is ignored. + * + * @param ctx a valid render context + */ +MPV_EXPORT void mpv_render_context_report_swap(mpv_render_context *ctx); + +/** + * Destroy the mpv renderer state. + * + * If video is still active (e.g. a file playing), video will be disabled + * forcefully. + * + * @param ctx a valid render context. After this function returns, this is not + * a valid pointer anymore. NULL is also allowed and does nothing. + */ +MPV_EXPORT void mpv_render_context_free(mpv_render_context *ctx); + +#ifdef MPV_CPLUGIN_DYNAMIC_SYM + +MPV_DEFINE_SYM_PTR(mpv_render_context_create) +#define mpv_render_context_create pfn_mpv_render_context_create +MPV_DEFINE_SYM_PTR(mpv_render_context_set_parameter) +#define mpv_render_context_set_parameter pfn_mpv_render_context_set_parameter +MPV_DEFINE_SYM_PTR(mpv_render_context_get_info) +#define mpv_render_context_get_info pfn_mpv_render_context_get_info +MPV_DEFINE_SYM_PTR(mpv_render_context_set_update_callback) +#define mpv_render_context_set_update_callback pfn_mpv_render_context_set_update_callback +MPV_DEFINE_SYM_PTR(mpv_render_context_update) +#define mpv_render_context_update pfn_mpv_render_context_update +MPV_DEFINE_SYM_PTR(mpv_render_context_render) +#define mpv_render_context_render pfn_mpv_render_context_render +MPV_DEFINE_SYM_PTR(mpv_render_context_report_swap) +#define mpv_render_context_report_swap pfn_mpv_render_context_report_swap +MPV_DEFINE_SYM_PTR(mpv_render_context_free) +#define mpv_render_context_free pfn_mpv_render_context_free + +#endif + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/mpv/render_gl.h b/include/mpv/render_gl.h new file mode 100644 index 0000000..aa2719d --- /dev/null +++ b/include/mpv/render_gl.h @@ -0,0 +1,211 @@ +/* Copyright (C) 2018 the mpv developers + * + * Permission to use, copy, modify, and/or distribute this software for any + * purpose with or without fee is hereby granted, provided that the above + * copyright notice and this permission notice appear in all copies. + * + * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#ifndef MPV_CLIENT_API_RENDER_GL_H_ +#define MPV_CLIENT_API_RENDER_GL_H_ + +#include "render.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * OpenGL backend + * -------------- + * + * This header contains definitions for using OpenGL with the render.h API. + * + * OpenGL interop + * -------------- + * + * The OpenGL backend has some special rules, because OpenGL itself uses + * implicit per-thread contexts, which causes additional API problems. + * + * This assumes the OpenGL context lives on a certain thread controlled by the + * API user. All mpv_render_* APIs have to be assumed to implicitly use the + * OpenGL context if you pass a mpv_render_context using the OpenGL backend, + * unless specified otherwise. + * + * The OpenGL context is indirectly accessed through the OpenGL function + * pointers returned by the get_proc_address callback in mpv_opengl_init_params. + * Generally, mpv will not load the system OpenGL library when using this API. + * + * OpenGL state + * ------------ + * + * OpenGL has a large amount of implicit state. All the mpv functions mentioned + * above expect that the OpenGL state is reasonably set to OpenGL standard + * defaults. Likewise, mpv will attempt to leave the OpenGL context with + * standard defaults. The following state is excluded from this: + * + * - the glViewport state + * - the glScissor state (but GL_SCISSOR_TEST is in its default value) + * - glBlendFuncSeparate() state (but GL_BLEND is in its default value) + * - glClearColor() state + * - mpv may overwrite the callback set with glDebugMessageCallback() + * - mpv always disables GL_DITHER at init + * + * Messing with the state could be avoided by creating shared OpenGL contexts, + * but this is avoided for the sake of compatibility and interoperability. + * + * On OpenGL 2.1, mpv will strictly call functions like glGenTextures() to + * create OpenGL objects. You will have to do the same. This ensures that + * objects created by mpv and the API users don't clash. Also, legacy state + * must be either in its defaults, or not interfere with core state. + * + * API use + * ------- + * + * The mpv_render_* API is used. That API supports multiple backends, and this + * section documents specifics for the OpenGL backend. + * + * Use mpv_render_context_create() with MPV_RENDER_PARAM_API_TYPE set to + * MPV_RENDER_API_TYPE_OPENGL, and MPV_RENDER_PARAM_OPENGL_INIT_PARAMS provided. + * + * Call mpv_render_context_render() with MPV_RENDER_PARAM_OPENGL_FBO to render + * the video frame to an FBO. + * + * Hardware decoding + * ----------------- + * + * Hardware decoding via this API is fully supported, but requires some + * additional setup. (At least if direct hardware decoding modes are wanted, + * instead of copying back surface data from GPU to CPU RAM.) + * + * There may be certain requirements on the OpenGL implementation: + * + * - Windows: ANGLE is required (although in theory GL/DX interop could be used) + * - Intel/Linux: EGL is required, and also the native display resource needs + * to be provided (e.g. MPV_RENDER_PARAM_X11_DISPLAY for X11 and + * MPV_RENDER_PARAM_WL_DISPLAY for Wayland) + * - nVidia/Linux: Both GLX and EGL should work (GLX is required if vdpau is + * used, e.g. due to old drivers.) + * - macOS: CGL is required (CGLGetCurrentContext() returning non-NULL) + * - iOS: EAGL is required (EAGLContext.currentContext returning non-nil) + * + * Once these things are setup, hardware decoding can be enabled/disabled at + * any time by setting the "hwdec" property. + */ + +/** + * For initializing the mpv OpenGL state via MPV_RENDER_PARAM_OPENGL_INIT_PARAMS. + */ +typedef struct mpv_opengl_init_params { + /** + * This retrieves OpenGL function pointers, and will use them in subsequent + * operation. + * Usually, you can simply call the GL context APIs from this callback (e.g. + * glXGetProcAddressARB or wglGetProcAddress), but some APIs do not always + * return pointers for all standard functions (even if present); in this + * case you have to compensate by looking up these functions yourself when + * libmpv wants to resolve them through this callback. + * libmpv will not normally attempt to resolve GL functions on its own, nor + * does it link to GL libraries directly. + */ + void *(*get_proc_address)(void *ctx, const char *name); + /** + * Value passed as ctx parameter to get_proc_address(). + */ + void *get_proc_address_ctx; +} mpv_opengl_init_params; + +/** + * For MPV_RENDER_PARAM_OPENGL_FBO. + */ +typedef struct mpv_opengl_fbo { + /** + * Framebuffer object name. This must be either a valid FBO generated by + * glGenFramebuffers() that is complete and color-renderable, or 0. If the + * value is 0, this refers to the OpenGL default framebuffer. + */ + int fbo; + /** + * Valid dimensions. This must refer to the size of the framebuffer. This + * must always be set. + */ + int w, h; + /** + * Underlying texture internal format (e.g. GL_RGBA8), or 0 if unknown. If + * this is the default framebuffer, this can be an equivalent. + */ + int internal_format; +} mpv_opengl_fbo; + +/** + * Deprecated. For MPV_RENDER_PARAM_DRM_DISPLAY. + */ +typedef struct mpv_opengl_drm_params { + int fd; + int crtc_id; + int connector_id; + struct _drmModeAtomicReq **atomic_request_ptr; + int render_fd; +} mpv_opengl_drm_params; + +/** + * For MPV_RENDER_PARAM_DRM_DRAW_SURFACE_SIZE. + */ +typedef struct mpv_opengl_drm_draw_surface_size { + /** + * size of the draw plane surface in pixels. + */ + int width, height; +} mpv_opengl_drm_draw_surface_size; + +/** + * For MPV_RENDER_PARAM_DRM_DISPLAY_V2. + */ +typedef struct mpv_opengl_drm_params_v2 { + /** + * DRM fd (int). Set to -1 if invalid. + */ + int fd; + + /** + * Currently used crtc id + */ + int crtc_id; + + /** + * Currently used connector id + */ + int connector_id; + + /** + * Pointer to a drmModeAtomicReq pointer that is being used for the renderloop. + * This pointer should hold a pointer to the atomic request pointer + * The atomic request pointer is usually changed at every renderloop. + */ + struct _drmModeAtomicReq **atomic_request_ptr; + + /** + * DRM render node. Used for VAAPI interop. + * Set to -1 if invalid. + */ + int render_fd; +} mpv_opengl_drm_params_v2; + + +/** + * For backwards compatibility with the old naming of mpv_opengl_drm_draw_surface_size + */ +#define mpv_opengl_drm_osd_size mpv_opengl_drm_draw_surface_size + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/include/mpv/stream_cb.h b/include/mpv/stream_cb.h new file mode 100644 index 0000000..9ae6f31 --- /dev/null +++ b/include/mpv/stream_cb.h @@ -0,0 +1,247 @@ +/* Copyright (C) 2017 the mpv developers + * + * Permission to use, copy, modify, and/or distribute this software for any + * purpose with or without fee is hereby granted, provided that the above + * copyright notice and this permission notice appear in all copies. + * + * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + */ + +#ifndef MPV_CLIENT_API_STREAM_CB_H_ +#define MPV_CLIENT_API_STREAM_CB_H_ + +#include "client.h" + +#ifdef __cplusplus +extern "C" { +#endif + +/** + * Warning: this API is not stable yet. + * + * Overview + * -------- + * + * This API can be used to make mpv read from a stream with a custom + * implementation. This interface is inspired by funopen on BSD and + * fopencookie on linux. The stream is backed by user-defined callbacks + * which can implement customized open, read, seek, size and close behaviors. + * + * Usage + * ----- + * + * Register your stream callbacks with the mpv_stream_cb_add_ro() function. You + * have to provide a mpv_stream_cb_open_ro_fn callback to it (open_fn argument). + * + * Once registered, you can `loadfile myprotocol://myfile`. Your open_fn will be + * invoked with the URI and you must fill out the provided mpv_stream_cb_info + * struct. This includes your stream callbacks (like read_fn), and an opaque + * cookie, which will be passed as the first argument to all the remaining + * stream callbacks. + * + * Note that your custom callbacks must not invoke libmpv APIs as that would + * cause a deadlock. (Unless you call a different mpv_handle than the one the + * callback was registered for, and the mpv_handles refer to different mpv + * instances.) + * + * Stream lifetime + * --------------- + * + * A stream remains valid until its close callback has been called. It's up to + * libmpv to call the close callback, and the libmpv user cannot close it + * directly with the stream_cb API. + * + * For example, if you consider your custom stream to become suddenly invalid + * (maybe because the underlying stream died), libmpv will continue using your + * stream. All you can do is returning errors from each callback, until libmpv + * gives up and closes it. + * + * Protocol registration and lifetime + * ---------------------------------- + * + * Protocols remain registered until the mpv instance is terminated. This means + * in particular that it can outlive the mpv_handle that was used to register + * it, but once mpv_terminate_destroy() is called, your registered callbacks + * will not be called again. + * + * Protocol unregistration is finished after the mpv core has been destroyed + * (e.g. after mpv_terminate_destroy() has returned). + * + * If you do not call mpv_terminate_destroy() yourself (e.g. plugin-style code), + * you will have to deal with the registration or even streams outliving your + * code. Here are some possible ways to do this: + * - call mpv_terminate_destroy(), which destroys the core, and will make sure + * all streams are closed once this function returns + * - you refcount all resources your stream "cookies" reference, so that it + * doesn't matter if streams live longer than expected + * - create "cancellation" semantics: after your protocol has been unregistered, + * notify all your streams that are still opened, and make them drop all + * referenced resources - then return errors from the stream callbacks as + * long as the stream is still opened + * + */ + +/** + * Read callback used to implement a custom stream. The semantics of the + * callback match read(2) in blocking mode. Short reads are allowed (you can + * return less bytes than requested, and libmpv will retry reading the rest + * with another call). If no data can be immediately read, the callback must + * block until there is new data. A return of 0 will be interpreted as final + * EOF, although libmpv might retry the read, or seek to a different position. + * + * @param cookie opaque cookie identifying the stream, + * returned from mpv_stream_cb_open_fn + * @param buf buffer to read data into + * @param size of the buffer + * @return number of bytes read into the buffer + * @return 0 on EOF + * @return -1 on error + */ +typedef int64_t (*mpv_stream_cb_read_fn)(void *cookie, char *buf, uint64_t nbytes); + +/** + * Seek callback used to implement a custom stream. + * + * Note that mpv will issue a seek to position 0 immediately after opening. This + * is used to test whether the stream is seekable (since seekability might + * depend on the URI contents, not just the protocol). Return + * MPV_ERROR_UNSUPPORTED if seeking is not implemented for this stream. This + * seek also serves to establish the fact that streams start at position 0. + * + * This callback can be NULL, in which it behaves as if always returning + * MPV_ERROR_UNSUPPORTED. + * + * @param cookie opaque cookie identifying the stream, + * returned from mpv_stream_cb_open_fn + * @param offset target absolute stream position + * @return the resulting offset of the stream + * MPV_ERROR_UNSUPPORTED or MPV_ERROR_GENERIC if the seek failed + */ +typedef int64_t (*mpv_stream_cb_seek_fn)(void *cookie, int64_t offset); + +/** + * Size callback used to implement a custom stream. + * + * Return MPV_ERROR_UNSUPPORTED if no size is known. + * + * This callback can be NULL, in which it behaves as if always returning + * MPV_ERROR_UNSUPPORTED. + * + * @param cookie opaque cookie identifying the stream, + * returned from mpv_stream_cb_open_fn + * @return the total size in bytes of the stream + */ +typedef int64_t (*mpv_stream_cb_size_fn)(void *cookie); + +/** + * Close callback used to implement a custom stream. + * + * @param cookie opaque cookie identifying the stream, + * returned from mpv_stream_cb_open_fn + */ +typedef void (*mpv_stream_cb_close_fn)(void *cookie); + +/** + * Cancel callback used to implement a custom stream. + * + * This callback is used to interrupt any current or future read and seek + * operations. It will be called from a separate thread than the demux + * thread, and should not block. + * + * This callback can be NULL. + * + * Available since API 1.106. + * + * @param cookie opaque cookie identifying the stream, + * returned from mpv_stream_cb_open_fn + */ +typedef void (*mpv_stream_cb_cancel_fn)(void *cookie); + +/** + * See mpv_stream_cb_open_ro_fn callback. + */ +typedef struct mpv_stream_cb_info { + /** + * Opaque user-provided value, which will be passed to the other callbacks. + * The close callback will be called to release the cookie. It is not + * interpreted by mpv. It doesn't even need to be a valid pointer. + * + * The user sets this in the mpv_stream_cb_open_ro_fn callback. + */ + void *cookie; + + /** + * Callbacks set by the user in the mpv_stream_cb_open_ro_fn callback. Some + * of them are optional, and can be left unset. + * + * The following callbacks are mandatory: read_fn, close_fn + */ + mpv_stream_cb_read_fn read_fn; + mpv_stream_cb_seek_fn seek_fn; + mpv_stream_cb_size_fn size_fn; + mpv_stream_cb_close_fn close_fn; + mpv_stream_cb_cancel_fn cancel_fn; /* since API 1.106 */ +} mpv_stream_cb_info; + +/** + * Open callback used to implement a custom read-only (ro) stream. The user + * must set the callback fields in the passed info struct. The cookie field + * also can be set to store state associated to the stream instance. + * + * Note that the info struct is valid only for the duration of this callback. + * You can't change the callbacks or the pointer to the cookie at a later point. + * + * Each stream instance created by the open callback can have different + * callbacks. + * + * The close_fn callback will terminate the stream instance. The pointers to + * your callbacks and cookie will be discarded, and the callbacks will not be + * called again. + * + * @param user_data opaque user data provided via mpv_stream_cb_add() + * @param uri name of the stream to be opened (with protocol prefix) + * @param info fields which the user should fill + * @return 0 on success, MPV_ERROR_LOADING_FAILED if the URI cannot be opened. + */ +typedef int (*mpv_stream_cb_open_ro_fn)(void *user_data, char *uri, + mpv_stream_cb_info *info); + +/** + * Add a custom stream protocol. This will register a protocol handler under + * the given protocol prefix, and invoke the given callbacks if an URI with the + * matching protocol prefix is opened. + * + * The "ro" is for read-only - only read-only streams can be registered with + * this function. + * + * The callback remains registered until the mpv core is registered. + * + * If a custom stream with the same name is already registered, then the + * MPV_ERROR_INVALID_PARAMETER error is returned. + * + * @param protocol protocol prefix, for example "foo" for "foo://" URIs + * @param user_data opaque pointer passed into the mpv_stream_cb_open_fn + * callback. + * @return error code + */ +MPV_EXPORT int mpv_stream_cb_add_ro(mpv_handle *ctx, const char *protocol, void *user_data, + mpv_stream_cb_open_ro_fn open_fn); + +#ifdef MPV_CPLUGIN_DYNAMIC_SYM + +MPV_DEFINE_SYM_PTR(mpv_stream_cb_add_ro) +#define mpv_stream_cb_add_ro pfn_mpv_stream_cb_add_ro + +#endif + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/lib/libmpv.dll.a b/lib/libmpv.dll.a new file mode 100644 index 0000000000000000000000000000000000000000..70f4dd293ea1aa36e608a35deeb898a5dece8688 GIT binary patch literal 454322 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 literal 0 HcmV?d00001 diff --git a/patch_config.h.in b/patch_config.h.in new file mode 100644 index 0000000..fa28b04 --- /dev/null +++ b/patch_config.h.in @@ -0,0 +1,5 @@ +#ifndef _PATCH_CONFIG_H +#define _PATCH_CONFIG_H +#cmakedefine HAVE_MPV @HAVE_MPV@ +#cmakedefine HAVE_PLAYER @HAVE_PLAYER@ +#endif