mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-20 08:41:07 +00:00
gl: add a scary note about initializing thread support for the winsys
We cannot do it as the winsys may crash if we initialize too late. Example, GLX contexts with Intel drivers: Intel requires the X Display to be the same in order to share GL resources across GL contexts. These GL contexts are generally accessed from different threads. Without winsys support it is nearly impossible to guarentee that concurrent access will not occur. This concurrent access could result in crashes or abortion by the winsys (xcb). https://bugzilla.gnome.org/show_bug.cgi?id=731525
This commit is contained in:
parent
5fd0dc505e
commit
bcce615263
1 changed files with 8 additions and 0 deletions
|
@ -30,6 +30,14 @@
|
||||||
* #GstGLDisplay represents a connection to the underlying windowing system.
|
* #GstGLDisplay represents a connection to the underlying windowing system.
|
||||||
* Elements are required to make use of #GstContext to share and propogate
|
* Elements are required to make use of #GstContext to share and propogate
|
||||||
* a #GstGLDisplay.
|
* a #GstGLDisplay.
|
||||||
|
*
|
||||||
|
* <note>Certain window systems require a special function to be called to
|
||||||
|
* initialize threading support. As this GStreamer GL library does not preclude
|
||||||
|
* concurrent access to the windowing system, it is strongly advised that
|
||||||
|
* applications ensure that threading support has been initialized before any
|
||||||
|
* other toolkit/library functionality is accessed. Failure to do so could
|
||||||
|
* result in sudden application abortion during execution. The most notably
|
||||||
|
* example of such a function is X11's XInitThreads().</note>
|
||||||
*/
|
*/
|
||||||
|
|
||||||
#ifdef HAVE_CONFIG_H
|
#ifdef HAVE_CONFIG_H
|
||||||
|
|
Loading…
Reference in a new issue