[pyglet] push by useboxnet - Expose pyglet.options["shadow_window"], note about shared contexts... on 2014-05-31 07:41 GMT

[pyg...@googlecode.com]

Revision: fb56054b2596
Branch: default
Author: Juan J. Martínez <j...@usebox.net>
Date: Sat May 31 07:41:42 2014 UTC
Log: Expose pyglet.options["shadow_window"], note about shared contexts

Fixes issue #747.
http://code.google.com/p/pyglet/source/detail?r=fb56054b2596

Modified:
/doc/programming_guide/context.txt
/pyglet/__init__.py

=======================================
--- /doc/programming_guide/context.txt Sun Dec 15 21:05:21 2013 UTC
+++ /doc/programming_guide/context.txt Sat May 31 07:41:42 2014 UTC
@@ -379,7 +379,8 @@
pyglet creates a hidden "shadow" context as soon as :mod:`pyglet.gl` is
imported. By default, all windows will share object space with this shadow
context, so the above steps are generally not needed. The shadow context
also
-allows objects such as textures to be loaded before a window is created.
+allows objects such as textures to be loaded before a window is created
(see
+``shadow_window`` in :data:`pyglet.options` for further details).

When you create a :class:`~pyglet.gl.Context`, you tell pyglet which other
context it will obtain an object space from. By default (when using the
=======================================
--- /pyglet/__init__.py Thu May 8 06:02:29 2014 UTC
+++ /pyglet/__init__.py Sat May 31 07:41:42 2014 UTC
@@ -116,7 +116,12 @@
#: the application window is created, and permits GL objects to be
#: shared between windows even after they've been closed. You can
#: disable the creation of the shadow window by setting this option to
-#: False. Recommended for advanced devlopers only.
+#: False.
+#:
+#: Some OpenGL driver implementations may not support shared OpenGL
+#: contexts and may require disabling the shadow window (and all
resources
+#: must be loaded after the window using them was created).
Recommended
+#: for advanced developers only.
#:
#: **Since:** pyglet 1.1
#: vsync