Name EXT_multiview_window Name Strings EGL_EXT_multiview_window Contributors Acorn Pooley Greg Roth Contacts Greg Roth (groth 'at' nvidia.com) Status Complete Version Version 3, Sept 03, 2011 Number EGL Extension #42 Dependencies Requires EGL 1.4 Written against the EGL 1.4 specification. Overview Adds support for creating an onscreen EGLSurface containing multiple color buffers. EXT_multi_draw_buffers can be used with this extension to render and display multiple color buffers to a supported device. New Types None New Procedures and Functions None New Tokens Accepted as an attribute in the parameter of CreateWindowSurface: EGL_MULTIVIEW_VIEW_COUNT_EXT 0x3134 Additions to Chapter 3 of the EGL 1.2 Specification: Additions to section 3.5.1 (Creating On-Screen Rendering Surfaces) Alter the end of the second paragraph: Attributes that can be specified in include EGL_RENDER_BUFFER, EGL_VG_COLORSPACE, EGL_VG_ALPHA_FORMAT, and EGL_MULTIVIEW_VIEW_COUNT_EXT. Add before the last paragraph of section 3.5.1: EGL_MULTIVIEW_VIEW_COUNT_EXT specifies how many multiview color buffers should be created for the surface. Each color buffer has the same properties as the primary color buffer as specified by window and surface attributes. The default value of EGL_MULTIVIEW_VIEW_COUNT_EXT is one. EGL may not be able to create as many multiview color buffers as EGL_MULTIVIEW_VIEW_COUNT_EXT specifies. To determine the number of multiview color buffers created by a context, call eglQueryContext (see section 3.7.4). Add to the last paragraph of section 3.5.1: If the value specified for EGL_MULTIVIEW_VIEW_COUNT_EXT is less than one, an EGL_BAD_PARAMETER error is generated. If the value specified for EGL_MULTIVIEW_VIEW_COUNT_EXT is greater than one and the does not support multiple multiview color buffers, an EGL_BAD_MATCH error is generated. Additions to section 3.5.6 (Surface Attributes) Add to table 3.5, "Queryable surface attributes and types" Attribute Type Description --------- ---- ----------- EGL_MULTIVIEW_VIEW_COUNT_EXT integer Requested multiview color buffers Add before the last paragraph describing eglQuerySurface: Querying EGL_MULTIVIEW_VIEW_COUNT_EXT for a window surface returns the number of multiview color buffers requested. For a pbuffer or pixmap surface, the contents of are not modified. To determine the actual number of multiview color buffers created by a context, call eglQueryContext (see section 3.7.4). Additions to section 3.7.4 (Context Queries) Add before the last paragraph describing eglQueryContext: Querying EGL_MULTIVIEW_VIEW_COUNT_EXT returns the number of multiview color buffers created. The value returned depends on properties of both the context, and the surface to which the context is bound. Issues None Revision History Version 3, 03 Sept 2011 EXTify add support for multiple or single depth buffer. Version 2, 02 Aug 2011 Responses to feedback. Version 1, 14 April 2011 First draft.