diff options
author | Nicolai Hähnle <[email protected]> | 2017-01-24 13:10:01 +0100 |
---|---|---|
committer | Nicolai Hähnle <[email protected]> | 2017-02-06 17:41:10 +0100 |
commit | 6b0d390184fe44842f63d2026df653e0feeaf918 (patch) | |
tree | c133e49fb3751fa7473afccfcbfd364147465729 | |
parent | 7be0e602ed82d25b9f0db77748618c663d9cbfe7 (diff) |
docs: add EGL_MESA_drm_image_formats extension proposal
-rw-r--r-- | docs/specs/EGL_MESA_drm_image_formats.txt | 98 | ||||
-rw-r--r-- | docs/specs/enums.txt | 5 |
2 files changed, 103 insertions, 0 deletions
diff --git a/docs/specs/EGL_MESA_drm_image_formats.txt b/docs/specs/EGL_MESA_drm_image_formats.txt new file mode 100644 index 00000000000..77fbe9df35f --- /dev/null +++ b/docs/specs/EGL_MESA_drm_image_formats.txt @@ -0,0 +1,98 @@ +Name + + MESA_drm_image_formats + +Name Strings + + EGL_MESA_drm_image_formats + +Contributors + + Nicolai Hähnle <[email protected]> + Qiang Yu <[email protected]> + +Contact + + Nicolai Hähnle <[email protected]> + +Status + + Proposal + +Version + + Version 1, January 26, 2017 + +Number + + EGL Extension #?? + +Dependencies + + This extension requires the EGL_MESA_drm_image extension. + + This extension is written against the wording of EGL_MESA_drm_image + specification. + +Overview + + This extension extends the functionality of EGL_MESA_drm_image by adding + additional formats required by Glamor for use with DRM buffers. + +IP Status + + Open-source; freely implementable. + +New Procedures and Functions + + None + +New Tokens + + Accepted as values for the EGL_IMAGE_FORMAT_MESA attribute: + + EGL_DRM_BUFFER_FORMAT_ARGB2101010_MESA 0x3290 + EGL_DRM_BUFFER_FORMAT_ARGB1555_MESA 0x3291 + EGL_DRM_BUFFER_FORMAT_RGB565_MESA 0x3292 + +Additions to the EGL_MESA_drm_image Specification: + + Remove the sentence "The only format specified ..." from the paragraph + describing eglCreateDRMImageMESA and add the following paragraph: + + The formats specified for use with EGL_DRM_BUFFER_FORMAT_MESA are: + + * EGL_DRM_BUFFER_FORMAT_ARGB32_MESA, where each pixel is a CPU-endian + 32-bit quantity, with alpha in the upper 8 bits, then red, then green, + then blue, + + * EGL_DRM_BUFFER_FORMAT_ARGB2101010_MESA, where each pixel is a CPU- + endian, 32-bit quantity, with alpha in the most significant 2 bits, + followed by 10 bits each for red, green, and blue, + + * EGL_DRM_BUFFER_FORMAT_ARGB1555_MESA, where each pixel is a CPU-endian + 16-bit quantity, with alpha in the most significant bit, followed by + 5 bits each for red, green, and blue, and + + * EGL_DRM_BUFFER_FORMAT_RGB565_MESA, where each pixel is a CPU-endian + 16-bit quantity, with red in the 5 most significant bits, followed by + 6 bits of green and 5 bits of blue. + +Issues + + 1. Should we expose the full set of channel permutations for the formats, + e.g. ABGR2101010, RGBA1010102, and BGRA1010102 in addition to + ARGB2101010? + + RESOLVED: No. + + DISCUSSION: The original extension sets a precedent of only exposing one + of the possible permutations of 8-bit channel formats. It is also not + clear where the additional permutations would be used. For example, + Glamor has a fixed mapping from pixmap/screen depth to format that + doesn't allow for the other permutations. + +Revision History + + Version 1, January, 2017 + Initial draft (Nicolai Hähnle) diff --git a/docs/specs/enums.txt b/docs/specs/enums.txt index 1caa2845943..b69f1e02c9e 100644 --- a/docs/specs/enums.txt +++ b/docs/specs/enums.txt @@ -76,6 +76,11 @@ EGL_MESA_platform_gbm EGL_MESA_platform_surfaceless EGL_PLATFORM_SURFACELESS_MESA 0x31DD +EGL_MESA_drm_image + EGL_DRM_BUFFER_FORMAT_ARGB2101010_MESA 0x3290 + EGL_DRM_BUFFER_FORMAT_ARGB1555_MESA 0x3291 + EGL_DRM_BUFFER_FORMAT_RGB565_MESA 0x3292 + EGL_WL_bind_wayland_display EGL_TEXTURE_FORMAT 0x3080 EGL_WAYLAND_BUFFER_WL 0x31D5 |