summaryrefslogtreecommitdiffstats
path: root/docs/specs
diff options
context:
space:
mode:
authorNicolai Hähnle <[email protected]>2017-01-24 13:10:01 +0100
committerNicolai Hähnle <[email protected]>2017-02-06 17:41:10 +0100
commit6b0d390184fe44842f63d2026df653e0feeaf918 (patch)
treec133e49fb3751fa7473afccfcbfd364147465729 /docs/specs
parent7be0e602ed82d25b9f0db77748618c663d9cbfe7 (diff)
docs: add EGL_MESA_drm_image_formats extension proposal
Diffstat (limited to 'docs/specs')
-rw-r--r--docs/specs/EGL_MESA_drm_image_formats.txt98
-rw-r--r--docs/specs/enums.txt5
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