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

[Nicolai Hähnle]

On 02.08.2017 22:24, Adam Jackson wrote:
> This extension name is bad, but I don't have an idea for a better one.

EGL_MESA_explicit_device
EGL_MESA_device_selection

?

Anyway, for the series:

Acked-by: Nicolai Hähnle <nicolai.haehnle at amd.com>


> 
> 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
> 


-- 
Lerne, wie die Welt wirklich ist,
Aber vergiss niemals, wie sie sein sollte.