kc3-lang/angle/extensions/EGL_ANGLE_external_context_and_surface.txt

Branch - branch -main

• Show log

  Commit

• Hash : 384a29a8
  Author :
  Date : 2023-07-27T10:51:07
  

  Reland: GL: Remove EGL_EXTERNAL_CONTEXT_SAVE_STATE_ANGLE
  
  Now that Chromium no longer uses it.
  
  This is a reland of:
  
  https://chromium-review.googlesource.com/c/angle/angle/+/4724768
  
  Bug: angleproject:5509
  Change-Id: I650e598580539fbe404f2ec4b56b20b56b948f6c
  Reviewed-on: https://chromium-review.googlesource.com/c/angle/angle/+/4903079
  Reviewed-by: Geoff Lang <geofflang@chromium.org>
  Commit-Queue: Shahbaz Youssefi <syoussefi@chromium.org>
  

Download

• extensions/EGL_ANGLE_external_context_and_surface.txt

• Name
  
      ANGLE_external_context_and_surface
  
  Name Strings
  
      EGL_ANGLE_external_context_and_surface
  
  Contributors
  
      Peng Huang
      Shahbaz Youssefi
  
  Contacts
  
      Shahbaz Youssefi, Google (syoussefi 'at' google.com)
  
  Status
  
      Draft
  
  Version
  
      Version 2, July 24, 2023
  
  Number
  
      EGL Extension #??
  
  Dependencies
  
      This extension is written against the wording of the EGL 1.4
      Specification.
  
  Overview
  
      This extension allows plugging an external OpenGL context and surface to
      the OpenGL backend of ANGLE.
  
  New Types
  
      None
  
  New Procedures and Functions
  
      void eglAcquireExternalContextANGLE(
          EGLDisplay dpy);
      void eglReleaseExternalContextANGLE(
          EGLDisplay dpy);
  
  New Tokens
  
      Accepted as an attribute name in the <*attrib_list> argument to
      eglCreateContext:
  
          EGL_EXTERNAL_CONTEXT_ANGLE 0x348E
  
      Accepted in the <buftype> parameter of eglCreatePbufferFromClientBuffer:
  
          EGL_EXTERNAL_SURFACE_ANGLE 0x348F
  
  Additions to the EGL 1.4 Specification
  
      Add the following to section 3.7.1 "Creating Rendering Contexts":
  
      EGL_EXTERNAL_CONTEXT_ANGLE indicates whether the context is externally
      managed, and that no internal context is created.
      In this case, the context must be made current by the application before
      calling other EGL or GL functions that may access the context.
  
      Add the following to section 3.5.3 "Binding Off-Screen Rendering Surfaces
      To Client Buffers":
  
      EGL_EXTERNAL_SURFACE_ANGLE indicates whether the surface is externally
      managed, and that no internal surface is created.
      In this case, the surface must be made current by the application before
      calling other EGL or GL functions that may access the surface.
  
      Add the following to section 3.7.3 "Binding Contexts and Drawables":
  
      Before making a call that uses a context created with
      EGL_EXTERNAL_CONTEXT_ANGLE, the context must be synchronized from external.
      eglAcquireExternalContextANGLE can be called to perform this
      synchronization, ensuring that the implementation is up-to-date with
      respect to changes that external has made to the context.
  
      Before the application (external) can continue using the context after the
      implementation has modified it, the context must be synchronized to
      external, restoring the state from when the external context was
      "acquired".
      eglReleaseExternalContextANGLE can be called to perform this
      synchronization, ensuring that the context is restored to its original
      state from before the eglAcquireExternalContextANGLE call.
  
  Issues
  
      None yet.
  
  Revision History
  
      Rev.    Date         Author     Changes
      ----  -------------  ---------  ----------------------------------------
        1   Jan 7, 2021    penghuang  Initial version
        2   July 24, 2023  syoussefi  Add eglAcquireExternalContextANGLE, and
                                        eglReleaseExternalContextANGLE
        3   July 27, 2023  syoussefi  Remove EGL_EXTERNAL_CONTEXT_SAVE_STATE_ANGLE
  

Download