pyglet 2.1.12__py3-none-any.whl → 3.0.dev1__py3-none-any.whl

pyglet/gl/gl_info.py

@@ -1,190 +0,0 @@
-"""Information about version and extensions of current GL implementation.
-
-Usage::
-
-    from pyglet.gl import gl_info
-
-    if gl_info.have_extension('GL_NV_register_combiners'):
-        # ...
-
-If you are using more than one context, you can set up a separate GLInfo
-object for each context.  Call `set_active_context` after switching to the
-context::
-
-    from pyglet.gl.gl_info import GLInfo
-
-    info = GLInfo()
-    info.set_active_context()
-
-    if info.have_version(4, 5):
-        # ...
-
-"""
-from __future__ import annotations
-
-import warnings
-from ctypes import c_char_p, cast
-
-from pyglet.gl.gl import GL_EXTENSIONS, GL_MAJOR_VERSION, GL_MINOR_VERSION, GL_RENDERER, GL_VENDOR, GL_VERSION, GLint
-from pyglet.gl.lib import GLException
-from pyglet.util import asstr
-
-
-def _get_number(parameter: int) -> int:
-    from pyglet.gl.gl import glGetIntegerv
-    number = GLint()
-    glGetIntegerv(parameter, number)
-    return number.value
-
-
-class GLInfo:
-    """Information interface for a single GL context.
-
-    A default instance is created automatically when the first OpenGL context
-    is created.  You can use the module functions as a convenience for
-    this default instance's methods.
-
-    If you are using more than one context, you must call `set_active_context`
-    when the context is active for this `GLInfo` instance.
-    """
-    extensions: set[str]
-    vendor: str = ''
-    renderer: str = ''
-    version: str = '0.0'
-    major_version: int = 0
-    minor_version: int = 0
-    opengl_api: str = 'gl'
-
-    _have_context: bool = False
-    _have_info = False
-
-    def __init__(self) -> None:  # noqa: D107
-        super().__init__()
-        self.extensions = set()
-
-    def set_active_context(self) -> None:
-        """Store information for the currently active context.
-
-        This method is called automatically for the default context.
-        """
-        self._have_context = True
-
-        if not self._have_info:
-
-            from pyglet.gl.gl import GL_NUM_EXTENSIONS, glGetString, glGetStringi
-
-            self.vendor = asstr(cast(glGetString(GL_VENDOR), c_char_p).value)
-            self.renderer = asstr(cast(glGetString(GL_RENDERER), c_char_p).value)
-            self.version = asstr(cast(glGetString(GL_VERSION), c_char_p).value)
-            # NOTE: The version string requirements for gles is a lot stricter
-            #       so using this to rely on detecting the API is not too unreasonable
-            self.opengl_api = "gles" if "opengl es" in self.version.lower() else "gl"
-
-            try:
-                self.major_version = _get_number(GL_MAJOR_VERSION)
-                self.minor_version = _get_number(GL_MINOR_VERSION)
-                num_ext = _get_number(GL_NUM_EXTENSIONS)
-                self.extensions = (asstr(cast(glGetStringi(GL_EXTENSIONS, i), c_char_p).value) for i in range(num_ext))
-                self.extensions = set(self.extensions)
-            except GLException:
-                pass  # GL3 is likely not available
-
-            self._have_info = True
-
-    def remove_active_context(self) -> None:
-        self._have_context = False
-        self._have_info = False
-
-    def have_context(self) -> bool:
-        return self._have_context
-
-    def have_extension(self, extension: str) -> bool:
-        """Determine if an OpenGL extension is available.
-
-        Args:
-            extension:
-                The name of the extension to test for, including its ``GL_`` prefix.
-
-        Returns:
-            True if the extension is provided by the driver.
-        """
-        if not self._have_context:
-            warnings.warn('No GL context created yet.')
-        return extension in self.extensions
-
-    def get_extensions(self) -> set[str]:
-        """Get a set of available OpenGL extensions."""
-        if not self._have_context:
-            warnings.warn('No GL context created yet.')
-        return self.extensions
-
-    def get_version(self) -> tuple[int, int]:
-        """Get the current major and minor version of OpenGL."""
-        if not self._have_context:
-            warnings.warn('No GL context created yet.')
-        return self.major_version, self.minor_version
-
-    def get_version_string(self) -> str:
-        """Get the current OpenGL version string."""
-        if not self._have_context:
-            warnings.warn('No GL context created yet.')
-        return self.version
-
-    def have_version(self, major: int, minor: int = 0) -> bool:
-        """Determine if a version of OpenGL is supported.
-
-        Args:
-            major:
-                The major revision number (typically 1 or 2).
-            minor:
-                The minor revision number.
-
-        Returns:
-            ``True`` if the requested or a later version is supported.
-        """
-        if not self._have_context:
-            warnings.warn('No GL context created yet.')
-        if not self.major_version and not self.minor_version:
-            return False
-
-        return (self.major_version > major or
-                (self.major_version == major and self.minor_version >= minor) or
-                (self.major_version == major and self.minor_version == minor))
-
-    def get_renderer(self) -> str:
-        """Determine the renderer string of the OpenGL context."""
-        if not self._have_context:
-            warnings.warn('No GL context created yet.')
-        return self.renderer
-
-    def get_vendor(self) -> str:
-        """Determine the vendor string of the OpenGL context."""
-        if not self._have_context:
-            warnings.warn('No GL context created yet.')
-        return self.vendor
-
-    def get_opengl_api(self) -> str:
-        """Determine the OpenGL API version.
-
-        Usually ``gl`` or ``gles``.
-        """
-        if not self._have_context:
-            warnings.warn('No GL context created yet.')
-        return self.opengl_api
-
-
-# Single instance useful for apps with only a single context
-# (or all contexts have the same GL driver, a common case).
-_gl_info = GLInfo()
-
-get_extensions = _gl_info.get_extensions
-get_version = _gl_info.get_version
-get_version_string = _gl_info.get_version_string
-have_version = _gl_info.have_version
-get_renderer = _gl_info.get_renderer
-get_vendor = _gl_info.get_vendor
-get_opengl_api = _gl_info.get_opengl_api
-have_extension = _gl_info.have_extension
-have_context = _gl_info.have_context
-remove_active_context = _gl_info.remove_active_context
-set_active_context = _gl_info.set_active_context

pyglet/gl/headless.py

@@ -1,166 +0,0 @@
-from __future__ import annotations
-
-from ctypes import byref
-
-from pyglet import gl
-from pyglet.display.headless import HeadlessCanvas
-from pyglet.libs.egl import egl
-
-
-from .base import DisplayConfig, Config, Context
-
-_fake_gl_attributes = {
-    'double_buffer': 0,
-    'stereo': 0,
-    'aux_buffers': 0,
-    'accum_red_size': 0,
-    'accum_green_size': 0,
-    'accum_blue_size': 0,
-    'accum_alpha_size': 0,
-}
-
-
-class HeadlessConfig(Config):  # noqa: D101
-    def match(self, canvas: HeadlessCanvas) -> list[HeadlessDisplayConfig]:
-        if not isinstance(canvas, HeadlessCanvas):
-            msg = 'Canvas must be an instance of HeadlessCanvas'
-            raise RuntimeError(msg)
-
-        display_connection = canvas.display._display_connection  # noqa: SLF001
-
-        # Construct array of attributes
-        attrs = []
-        for name, value in self.get_gl_attributes():
-            if name == 'double_buffer':
-                continue
-            attr = HeadlessDisplayConfig.attribute_ids.get(name, None)
-            if attr and value is not None:
-                attrs.extend([attr, int(value)])
-        attrs.extend([egl.EGL_SURFACE_TYPE, egl.EGL_PBUFFER_BIT])
-        if self.opengl_api == "gl":
-            attrs.extend([egl.EGL_RENDERABLE_TYPE, egl.EGL_OPENGL_BIT])
-        elif self.opengl_api == "gles":
-            attrs.extend([egl.EGL_RENDERABLE_TYPE, egl.EGL_OPENGL_ES3_BIT])
-        else:
-            msg = f"Unknown OpenGL API: {self.opengl_api}"
-            raise ValueError(msg)
-        attrs.extend([egl.EGL_NONE])
-        attrs_list = (egl.EGLint * len(attrs))(*attrs)
-
-        num_config = egl.EGLint()
-        egl.eglChooseConfig(display_connection, attrs_list, None, 0, byref(num_config))
-        configs = (egl.EGLConfig * num_config.value)()
-        egl.eglChooseConfig(display_connection, attrs_list, configs,
-                            num_config.value, byref(num_config))
-
-        return [HeadlessDisplayConfig(canvas, c, self) for c in configs]
-
-
-class HeadlessDisplayConfig(DisplayConfig):  # noqa: D101
-    canvas: HeadlessCanvas
-    config: HeadlessConfig
-
-    attribute_ids = {  # noqa: RUF012
-        'buffer_size': egl.EGL_BUFFER_SIZE,
-        'level': egl.EGL_LEVEL,  # Not supported
-        'red_size': egl.EGL_RED_SIZE,
-        'green_size': egl.EGL_GREEN_SIZE,
-        'blue_size': egl.EGL_BLUE_SIZE,
-        'alpha_size': egl.EGL_ALPHA_SIZE,
-        'depth_size': egl.EGL_DEPTH_SIZE,
-        'stencil_size': egl.EGL_STENCIL_SIZE,
-        'sample_buffers': egl.EGL_SAMPLE_BUFFERS,
-        'samples': egl.EGL_SAMPLES,
-    }
-
-    def __init__(self, canvas: HeadlessCanvas, egl_config: egl.EGLConfig, config: HeadlessConfig) -> None:  # noqa: D107
-        super().__init__(canvas, config)
-        self._egl_config = egl_config
-        context_attribs = (egl.EGL_CONTEXT_MAJOR_VERSION, config.major_version or 2,
-                           egl.EGL_CONTEXT_MINOR_VERSION, config.minor_version or 0,
-                           egl.EGL_CONTEXT_OPENGL_FORWARD_COMPATIBLE, config.forward_compatible or 0,
-                           egl.EGL_CONTEXT_OPENGL_DEBUG, config.debug or 0,
-                           egl.EGL_NONE)
-        self._context_attrib_array = (egl.EGLint * len(context_attribs))(*context_attribs)
-
-        for name, attr in self.attribute_ids.items():
-            value = egl.EGLint()
-            egl.eglGetConfigAttrib(canvas.display._display_connection, egl_config, attr, byref(value))  # noqa: SLF001
-            setattr(self, name, value.value)
-
-        for name, value in _fake_gl_attributes.items():
-            setattr(self, name, value)
-
-    def compatible(self, canvas: HeadlessCanvas) -> bool:
-        return isinstance(canvas, HeadlessCanvas)
-
-    def create_context(self, share: HeadlessContext | None) -> HeadlessContext:
-        return HeadlessContext(self, share)
-
-
-class HeadlessContext(Context):  # noqa: D101
-    display_connection: egl.EGLDisplay
-    config: HeadlessDisplayConfig
-
-    def __init__(self, config: HeadlessDisplayConfig, share: HeadlessContext | None) -> None:  # noqa: D107
-        super().__init__(config, share)
-
-        self.display_connection = config.canvas.display._display_connection  # noqa: SLF001
-
-        self.egl_context = self._create_egl_context(share)
-        if not self.egl_context:
-            msg = 'Could not create GL context'
-            raise gl.ContextException(msg)
-
-    def _create_egl_context(self, share: HeadlessContext | None) -> egl.EGLContext:
-        if share:
-            share_context = share.egl_context
-        else:
-            share_context = None
-
-        if self.config.opengl_api == "gl":
-            egl.eglBindAPI(egl.EGL_OPENGL_API)
-        elif self.config.opengl_api == "gles":
-            egl.eglBindAPI(egl.EGL_OPENGL_ES_API)
-        return egl.eglCreateContext(self.config.canvas.display._display_connection,  # noqa: SLF001
-                                    self.config._egl_config, share_context,  # noqa: SLF001
-                                    self.config._context_attrib_array)  # noqa: SLF001
-
-    def attach(self, canvas: HeadlessCanvas) -> None:
-        if canvas is self.canvas:
-            return
-
-        super().attach(canvas)
-
-        self.egl_surface = canvas.egl_surface
-        self.set_current()
-
-    def set_current(self) -> None:
-        egl.eglMakeCurrent(
-            self.display_connection, self.egl_surface, self.egl_surface, self.egl_context)
-        super().set_current()
-
-    def detach(self) -> None:
-        if not self.canvas:
-            return
-
-        self.set_current()
-        gl.glFlush()  # needs to be in try/except?
-
-        super().detach()
-
-        egl.eglMakeCurrent(
-            self.display_connection, 0, 0, None)
-        self.egl_surface = None
-
-    def destroy(self) -> None:
-        super().destroy()
-        if self.egl_context:
-            egl.eglDestroyContext(self.display_connection, self.egl_context)
-            self.egl_context = None
-
-    def flip(self) -> None:
-        if not self.egl_surface:
-            return
-
-        egl.eglSwapBuffers(self.display_connection, self.egl_surface)

pyglet/gl/wgl_info.py

@@ -1,36 +0,0 @@
-"""Cached information about version and extensions of current WGL implementation."""
-from __future__ import annotations
-
-import warnings
-from ctypes import c_char_p, cast
-
-from pyglet.gl import gl_info
-from pyglet.gl.gl import GL_EXTENSIONS, glGetString
-from pyglet.gl.lib import MissingFunctionException
-from pyglet.gl.wglext_arb import wglGetExtensionsStringEXT
-from pyglet.util import asstr
-
-
-class WGLInfoException(Exception):  # noqa: D101, N818
-    pass
-
-
-class WGLInfo:  # noqa: D101
-    def get_extensions(self) -> list[str]:
-        if not gl_info.have_context():
-            warnings.warn("Can't query WGL until a context is created.")
-            return []
-
-        try:
-            return asstr(wglGetExtensionsStringEXT()).split()
-        except MissingFunctionException:
-            return asstr(cast(glGetString(GL_EXTENSIONS), c_char_p).value).split()
-
-    def have_extension(self, extension: str) -> bool:
-        return extension in self.get_extensions()
-
-
-_wgl_info = WGLInfo()
-
-get_extensions = _wgl_info.get_extensions
-have_extension = _wgl_info.have_extension