[Mesa-dev] [PATCH mesa 1/7] docs/specs: remove upstreamed spec EGL_MESA_platform_surfaceless

Eric Engestrom eric.engestrom at imgtec.com
Wed Nov 22 17:59:35 UTC 2017


Spec is now available on Khronos:
https://www.khronos.org/registry/EGL/extensions/MESA/EGL_MESA_platform_surfaceless.txt

Signed-off-by: Eric Engestrom <eric.engestrom at imgtec.com>
---
 docs/specs/EGL_MESA_platform_surfaceless.txt | 120 ---------------------------
 1 file changed, 120 deletions(-)
 delete mode 100644 docs/specs/EGL_MESA_platform_surfaceless.txt

diff --git a/docs/specs/EGL_MESA_platform_surfaceless.txt b/docs/specs/EGL_MESA_platform_surfaceless.txt
deleted file mode 100644
index 871ee509c55e13c55987..00000000000000000000
--- a/docs/specs/EGL_MESA_platform_surfaceless.txt
+++ /dev/null
@@ -1,120 +0,0 @@
-Name
-
-    MESA_platform_surfaceless
-
-Name Strings
-
-    EGL_MESA_platform_surfaceless
-
-Contributors
-
-    Chad Versace <chadversary at google.com>
-    Haixia Shi <hshi at google.com>
-    Stéphane Marchesin <marcheu at google.com>
-    Zach Reizner <zachr at chromium.org>
-    Gurchetan Singh <gurchetansingh at google.com>
-
-Contacts
-
-    Chad Versace <chadversary at google.com>
-
-Status
-
-    DRAFT
-
-Version
-
-    Version 2, 2016-10-13
-
-Number
-
-    EGL Extension #TODO
-
-Extension Type
-
-    EGL client extension
-
-Dependencies
-
-    Requires EGL 1.5 or later; or EGL 1.4 with EGL_EXT_platform_base.
-
-    This extension is written against the EGL 1.5 Specification (draft
-    20140122).
-
-    This extension interacts with EGL_EXT_platform_base as follows. If the
-    implementation supports EGL_EXT_platform_base, then text regarding
-    eglGetPlatformDisplay applies also to eglGetPlatformDisplayEXT;
-    eglCreatePlatformWindowSurface to eglCreatePlatformWindowSurfaceEXT; and
-    eglCreatePlatformPixmapSurface to eglCreatePlatformPixmapSurfaceEXT.
-
-Overview
-
-    This extension defines a new EGL platform, the "surfaceless" platform. This
-    platfom's defining property is that it has no native surfaces, and hence
-    neither eglCreatePlatformWindowSurface nor eglCreatePlatformPixmapSurface
-    can be used. The platform is independent of any native window system.
-
-    The platform's intended use case is for enabling OpenGL and OpenGL ES
-    applications on systems where no window system exists. However, the
-    platform's permitted usage is not restricted to this case.  Since the
-    platform is independent of any native window system, it may also be used on
-    systems where a window system is present.
-
-New Types
-
-    None
-
-New Procedures and Functions
-
-    None
-
-New Tokens
-
-    Accepted as the <platform> argument of eglGetPlatformDisplay:
-
-        EGL_PLATFORM_SURFACELESS_MESA           0x31DD
-
-Additions to the EGL Specification
-
-    None.
-
-New Behavior
-
-    To determine if the EGL implementation supports this extension, clients
-    should query the EGL_EXTENSIONS string of EGL_NO_DISPLAY.
-
-    To obtain an EGLDisplay on the surfaceless platform, call
-    eglGetPlatformDisplay with <platform> set to EGL_PLATFORM_SURFACELESS_MESA.
-    The <native_display> parameter must be EGL_DEFAULT_DISPLAY.
-
-    eglCreatePlatformWindowSurface fails when called with a <display> that
-    belongs to the surfaceless platform. It returns EGL_NO_SURFACE and
-    generates EGL_BAD_NATIVE_WINDOW. The justification for this unconditional
-    failure is that the surfaceless platform has no native windows, and
-    therefore the <native_window> parameter is always invalid.
-
-    Likewise, eglCreatePlatformPixmapSurface also fails when called with a
-    <display> that belongs to the surfaceless platform.  It returns
-    EGL_NO_SURFACE and generates EGL_BAD_NATIVE_PIXMAP.
-
-    The surfaceless platform imposes no platform-specific restrictions on the
-    creation of pbuffers, as eglCreatePbufferSurface has no native surface
-    parameter.  Specifically, if the EGLDisplay advertises an EGLConfig whose
-    EGL_SURFACE_TYPE attribute contains EGL_PBUFFER_BIT, then the EGLDisplay
-    permits the creation of pbuffers with that config.
-
-Issues
-
-    None.
-
-Revision History
-
-    Version 2, 2016-10-13 (Chad Versace)
-        - Assign enum values
-        - Define interfactions with EGL 1.4 and EGL_EXT_platform_base.
-        - Add Gurchetan as contributor, as he implemented the pbuffer support.
-
-    Version 1, 2016-09-23 (Chad Versace)
-        - Initial version
-        - Posted for review at
-          https://lists.freedesktop.org/archives/mesa-dev/2016-September/129549.html
-- 
Cheers,
  Eric



More information about the mesa-dev mailing list