[Mesa-dev] [PATCH 3/3] specs: Add EGL_MESA_platform_device

[Adam Jackson]

This extension name is bad, but I don't have an idea for a better one.

Signed-off-by: Adam Jackson <ajax at redhat.com>
---
 docs/specs/EGL_MESA_platform_device.txt | 94 +++++++++++++++++++++++++++++++++
 1 file changed, 94 insertions(+)
 create mode 100644 docs/specs/EGL_MESA_platform_device.txt

diff --git a/docs/specs/EGL_MESA_platform_device.txt b/docs/specs/EGL_MESA_platform_device.txt
new file mode 100644
index 0000000000..56ceb27f3b
--- /dev/null
+++ b/docs/specs/EGL_MESA_platform_device.txt
@@ -0,0 +1,94 @@
+Name
+
+    MESA_platform_device
+
+Name Strings
+
+    EGL_MESA_platform_device
+
+Contributors
+
+    Adam Jackson <ajax at redhat.com>
+
+Contacts
+
+    Adam Jackson <ajax at redhat.com>
+
+Status
+
+    DRAFT
+
+Version
+
+    Version 1, 2017-07-14
+
+Number
+
+    EGL Extension #TODO
+
+Extension Type
+
+    EGL device extension
+
+Dependencies
+
+    Requires EGL_EXT_platform_base and EGL_EXT_device_base.
+
+    EGL_EXT_platform_device trivially interacts with this extension.
+
+    This extension is written against the EGL 1.5 Specification.
+
+Overview
+
+    A system may support multiple devices and multiple window systems. For
+    example, a Wayland environment may drive multiple GPUs and support both
+    GLX and EGL clients. In order to realize this, the implementation must
+    allow the client to specify both device and platform explicitly.
+
+    The EGL_EXT_platform_device extension enables the client to create a
+    display from a device, but does so by overloading the native_display
+    argument to eglGetPlatformDisplay; the user passes the device as the
+    native display, and presumably the EGL picks a sensible default for the
+    window system.
+
+    EGL_MESA_platform_device differs by passing the device as an attribute
+    to eglGetPlatformDisplay. This allows the client to name both the device
+    and the platform.
+
+New Types
+
+    None
+
+New Procedures and Functions
+
+    None
+
+New Tokens
+
+    None
+
+Additions to the EGL Specification
+
+    None
+
+New Behavior
+
+    If EGL_DEVICE_EXT is specified as an attribute for eglGetPlatformDisplay,
+    the value of the attribute is interpreted as an EGLDeviceEXT as returned
+    by eglQueryDevicesEXT. The platform will attempt to initialize using
+    exactly the specified device. If the attribute does not name a known
+    EGLDeviceEXT, EGL_BAD_DEVICE_EXT is generated. If the device and platform
+    are not compatible for any reason, EGL_BAD_MATCH is generated.
+
+    If EGL_EXT_platform_device is supported, passing EGL_DEVICE_EXT as an
+    attribute to eglGetPlatformDisplay(EGL_PLATFORM_DEVICE_EXT) is
+    undefined.
+
+Issues
+
+    None
+
+Revision History
+
+    Version 1, 2017-07-14 (Adam Jackson)
+        - Initial version
-- 
2.13.3