1
0
mirror of https://github.com/mpv-player/mpv synced 2025-01-23 16:13:39 +00:00

DOCS/client_api_examples/README: add qt_opengl

And also adjust the documentation for the other Qt examples to avoid
redundancy.

While we're at it, move the simple example to the top.
This commit is contained in:
wm4 2015-10-11 14:18:52 +02:00
parent b7ba2e2c57
commit d714c8380a

View File

@ -70,6 +70,10 @@ support both methods if possible.
## List of examples ## List of examples
### simple
Very primitive terminal-only example. Shows some most basic API usage.
### cocoa ### cocoa
Shows how to embed the mpv video window in Objective-C/Cocoa. Shows how to embed the mpv video window in Objective-C/Cocoa.
@ -84,25 +88,27 @@ with Cocoa elements from different libraries, it's more robust.
Shows how to embed the mpv video window in Qt (using normal desktop widgets). Shows how to embed the mpv video window in Qt (using normal desktop widgets).
### qt_opengl
Shows how to use mpv's OpenGL video renderer in Qt. This uses the opengl-cb API
for video. Since it does not rely on embedding "foreign" native Windows, it's
usually more robust, potentially faster, and it's easier to control how your
GUI interacts with the video. You can do your own OpenGL rendering on top of
the video as well.
### qml ### qml
Shows how to use mpv's OpenGL video renderer in QtQuick2 with QML. Uses the Shows how to use mpv's OpenGL video renderer in QtQuick2 with QML. Uses the
opengl-cb API for video. Since it does not rely on embedding "foreign" native opengl-cb API for video. Since the video is a normal QML element, it's trivial
Windows, it's usually more robust, potentially faster, and it's easier to to create OSD overlays with QML-native graphical elements as well.
control how your GUI interacts with the video. It's trivial to create OSD
overlays with QML-native graphical elements as well.
### qml_direct ### qml_direct
Alternative example, which typically avoids a FBO indirection. Might be Alternative example, which typically avoids a FBO indirection. Might be
slightly faster, but is less flexible and harder to use. Uses the slightly faster, but is less flexible and harder to use. In particular, the
opengl-cb API for video. video is not a normal QML element. Uses the opengl-cb API for video.
### sdl ### sdl
Show how to embed the mpv OpenGL renderer in SDL. Uses the opengl-cb API for Show how to embed the mpv OpenGL renderer in SDL. Uses the opengl-cb API for
video. video.
### simple
Very primitive terminal-only example. Shows some most basic API usage.