# Copyright 2018 The dm_control Authors # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # ============================================================================== """An EGL context for headless accelerated OpenGL rendering on GPU devices.""" import atexit import ctypes import os PYOPENGL_PLATFORM = os.environ.get('PYOPENGL_PLATFORM') if not PYOPENGL_PLATFORM: os.environ['PYOPENGL_PLATFORM'] = 'egl' elif PYOPENGL_PLATFORM.lower() != 'egl': raise ImportError( 'Cannot use EGL rendering platform. ' 'The PYOPENGL_PLATFORM environment variable is set to {!r} ' '(should be either unset or \'egl\').') from mujoco.egl import egl_ext as EGL from OpenGL import error def create_initialized_egl_device_display(): """Creates an initialized EGL display directly on a device.""" all_devices = EGL.eglQueryDevicesEXT() selected_device = os.environ.get('MUJOCO_EGL_DEVICE_ID', None) if selected_device is None: candidates = all_devices else: device_idx = int(selected_device) if not 0 <= device_idx < len(all_devices): raise RuntimeError( f'The MUJOCO_EGL_DEVICE_ID environment variable must be an integer ' f'between 0 and {len(all_devices)-1} (inclusive), got {device_idx}.') candidates = all_devices[device_idx:device_idx + 1] for device in candidates: display = EGL.eglGetPlatformDisplayEXT( EGL.EGL_PLATFORM_DEVICE_EXT, device, None) if display != EGL.EGL_NO_DISPLAY and EGL.eglGetError() == EGL.EGL_SUCCESS: # `eglInitialize` may or may not raise an exception on failure depending # on how PyOpenGL is configured. We therefore catch a `GLError` and also # manually check the output of `eglGetError()` here. try: initialized = EGL.eglInitialize(display, None, None) except error.GLError: pass else: if initialized == EGL.EGL_TRUE and EGL.eglGetError() == EGL.EGL_SUCCESS: return display return EGL.EGL_NO_DISPLAY EGL_DISPLAY = create_initialized_egl_device_display() if EGL_DISPLAY == EGL.EGL_NO_DISPLAY: raise ImportError( 'Cannot initialize a EGL device display. This likely means that your EGL ' 'driver does not support the PLATFORM_DEVICE extension, which is ' 'required for creating a headless rendering context.') atexit.register(EGL.eglTerminate, EGL_DISPLAY) EGL_ATTRIBUTES = ( EGL.EGL_RED_SIZE, 8, EGL.EGL_GREEN_SIZE, 8, EGL.EGL_BLUE_SIZE, 8, EGL.EGL_ALPHA_SIZE, 8, EGL.EGL_DEPTH_SIZE, 24, EGL.EGL_STENCIL_SIZE, 8, EGL.EGL_COLOR_BUFFER_TYPE, EGL.EGL_RGB_BUFFER, EGL.EGL_SURFACE_TYPE, EGL.EGL_PBUFFER_BIT, EGL.EGL_RENDERABLE_TYPE, EGL.EGL_OPENGL_BIT, EGL.EGL_NONE ) class GLContext: """An EGL context for headless accelerated OpenGL rendering on GPU devices.""" def __init__(self, max_width, max_height): del max_width, max_height # unused num_configs = ctypes.c_long() config_size = 1 config = EGL.EGLConfig() EGL.eglReleaseThread() EGL.eglChooseConfig( EGL_DISPLAY, EGL_ATTRIBUTES, ctypes.byref(config), config_size, num_configs) if num_configs.value < 1: raise RuntimeError( 'EGL failed to find a framebuffer configuration that matches the ' 'desired attributes: {}'.format(EGL_ATTRIBUTES)) EGL.eglBindAPI(EGL.EGL_OPENGL_API) self._context = EGL.eglCreateContext( EGL_DISPLAY, config, EGL.EGL_NO_CONTEXT, None) if not self._context: raise RuntimeError('Cannot create an EGL context.') def make_current(self): if not EGL.eglMakeCurrent( EGL_DISPLAY, EGL.EGL_NO_SURFACE, EGL.EGL_NO_SURFACE, self._context): raise RuntimeError('Failed to make the EGL context current.') def free(self): """Frees resources associated with this context.""" if self._context: current_context = EGL.eglGetCurrentContext() if current_context and self._context.address == current_context.address: EGL.eglMakeCurrent(EGL_DISPLAY, EGL.EGL_NO_SURFACE, EGL.EGL_NO_SURFACE, EGL.EGL_NO_CONTEXT) EGL.eglDestroyContext(EGL_DISPLAY, self._context) EGL.eglReleaseThread() self._context = None def __del__(self): self.free()