client API: docs: some clarifications

This commit is contained in:
wm4 2014-06-07 10:53:45 +02:00
parent a1000962e3
commit d64bd9efa1
1 changed files with 7 additions and 1 deletions

View File

@ -118,8 +118,11 @@ extern "C" {
* - If a X11 based VO is used, mpv will set the xlib error handler. This error * - 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 * 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. * 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), LittleCMS, ALSA, FFmpeg, and possibly more.
* - The FPU precision must be set at least to double precision. * - The FPU precision must be set at least to double precision.
* - On Windows, mpv will call timeBeginPeriod(1). * - On Windows, mpv will call timeBeginPeriod(1).
* - On memory exhaustion, mpv will kill the process.
* *
* Embedding the video window * Embedding the video window
* -------------------------- * --------------------------
@ -131,6 +134,8 @@ extern "C" {
* Both on X11 and win32, the player will fill the window referenced by the * Both on X11 and win32, the player will fill the window referenced by the
* "wid" option fully and letterbox the video (i.e. add black bars if the * "wid" option fully and letterbox the video (i.e. add black bars if the
* aspect ratio of the window and the video mismatch). * aspect ratio of the window and the video mismatch).
*
* On OSX, embedding is not yet possible, because Cocoa makes this non-trivial.
*/ */
/** /**
@ -1177,7 +1182,8 @@ void mpv_set_wakeup_callback(mpv_handle *ctx, void (*cb)(void *d), void *d);
* a primitive mechanism to handle coordinating a foreign event loop and the * a primitive mechanism to handle coordinating a foreign event loop and the
* libmpv event loop. * libmpv event loop.
* *
* This is in fact implemented using mpv_set_wakeup_callback(), and each * 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 * 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 * 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 * read all contents of the pipe and then call mpv_wait_event(c, 0) until