• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Name
2
3    EXT_multiview_window
4
5Name Strings
6
7    EGL_EXT_multiview_window
8
9Contributors
10
11    Acorn Pooley
12    Greg Roth
13
14Contacts
15
16    Greg Roth (groth 'at' nvidia.com)
17
18Status
19
20    Complete
21
22Version
23
24    Version 3, Sept 03, 2011
25
26Number
27
28    EGL Extension #42
29
30Dependencies
31
32    Requires EGL 1.4
33
34    Written against the EGL 1.4 specification.
35
36Overview
37
38    Adds support for creating an onscreen EGLSurface containing
39    multiple color buffers.
40
41    EXT_multi_draw_buffers can be used with this extension to
42    render and display multiple color buffers to a supported
43    device.
44
45New Types
46
47    None
48
49New Procedures and Functions
50
51    None
52
53New Tokens
54
55    Accepted as an attribute in the <attrib_list> parameter of
56    CreateWindowSurface:
57
58        EGL_MULTIVIEW_VIEW_COUNT_EXT        0x3134
59
60Additions to Chapter 3 of the EGL 1.2 Specification:
61
62    Additions to section 3.5.1 (Creating On-Screen Rendering Surfaces)
63
64    Alter the end of the second paragraph:
65
66        Attributes that can be specified in <attrib_list> include
67        EGL_RENDER_BUFFER, EGL_VG_COLORSPACE, EGL_VG_ALPHA_FORMAT, and
68        EGL_MULTIVIEW_VIEW_COUNT_EXT.
69
70    Add before the last paragraph of section 3.5.1:
71
72        EGL_MULTIVIEW_VIEW_COUNT_EXT specifies how many multiview color
73        buffers should be created for the surface. Each color buffer has
74        the same properties as the primary color buffer as specified by
75        window and surface attributes. The default value of
76        EGL_MULTIVIEW_VIEW_COUNT_EXT is one.
77
78        EGL may not be able to create as many multiview color buffers as
79        EGL_MULTIVIEW_VIEW_COUNT_EXT specifies. To determine the number
80        of multiview color buffers created by a context, call
81        eglQueryContext (see section 3.7.4).
82
83    Add to the last paragraph of section 3.5.1:
84
85        If the value specified for EGL_MULTIVIEW_VIEW_COUNT_EXT is less
86        than one, an EGL_BAD_PARAMETER error is generated. If the value
87        specified for EGL_MULTIVIEW_VIEW_COUNT_EXT is greater than one
88        and the <config> does not support multiple multiview color
89        buffers, an EGL_BAD_MATCH error is generated.
90
91    Additions to section 3.5.6 (Surface Attributes)
92
93    Add to table 3.5, "Queryable surface attributes and types"
94
95        Attribute                    Type       Description
96        ---------                    ----       -----------
97        EGL_MULTIVIEW_VIEW_COUNT_EXT  integer    Requested multiview
98                                                color buffers
99
100    Add before the last paragraph describing eglQuerySurface:
101
102        Querying EGL_MULTIVIEW_VIEW_COUNT_EXT for a window surface
103        returns the number of multiview color buffers requested. For a
104        pbuffer or pixmap surface, the contents of <value> are not
105        modified. To determine the actual number of multiview color
106        buffers created by a context, call eglQueryContext (see
107        section 3.7.4).
108
109
110    Additions to section 3.7.4 (Context Queries)
111
112    Add before the last paragraph describing eglQueryContext:
113
114        Querying EGL_MULTIVIEW_VIEW_COUNT_EXT returns the number of
115        multiview color buffers created. The value returned depends on
116        properties of both the context, and the surface to which the
117        context is bound.
118
119Issues
120
121    None
122
123Revision History
124    Version 3, 03 Sept 2011 EXTify add support for multiple or single depth buffer.
125    Version 2, 02 Aug 2011 Responses to feedback.
126    Version 1, 14 April 2011 First draft.
127