gfx/angle/extensions/EGL_ANGLE_d3d_share_handle_client_buffer.txt@6474c204b198 (annotated)
gfx/angle/extensions/EGL_ANGLE_d3d_share_handle_client_buffer.txt
Wed, 31 Dec 2014 06:09:35 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Wed, 31 Dec 2014 06:09:35 +0100
- changeset 0
- 6474c204b198
- permissions
- -rw-r--r--
Cloned upstream origin tor-browser at tor-browser-31.3.0esr-4.5-1-build1
revision ID fc1c9ff7c1b2defdbc039f12214767608f46423f for hacking purpose.
| michael@0 | 1 | Name |
| michael@0 | 2 | |
| michael@0 | 3 | ANGLE_d3d_share_handle_client_buffer |
| michael@0 | 4 | |
| michael@0 | 5 | Name Strings |
| michael@0 | 6 | |
| michael@0 | 7 | EGL_ANGLE_d3d_share_handle_client_buffer |
| michael@0 | 8 | |
| michael@0 | 9 | Contributors |
| michael@0 | 10 | |
| michael@0 | 11 | John Bauman |
| michael@0 | 12 | Alastair Patrick |
| michael@0 | 13 | Daniel Koch |
| michael@0 | 14 | |
| michael@0 | 15 | Contacts |
| michael@0 | 16 | |
| michael@0 | 17 | John Bauman, Google Inc. (jbauman 'at' chromium.org) |
| michael@0 | 18 | |
| michael@0 | 19 | Status |
| michael@0 | 20 | |
| michael@0 | 21 | Complete |
| michael@0 | 22 | Implemented (ANGLE r650) |
| michael@0 | 23 | |
| michael@0 | 24 | Version |
| michael@0 | 25 | |
| michael@0 | 26 | Version 3, May 12, 2011 |
| michael@0 | 27 | |
| michael@0 | 28 | Number |
| michael@0 | 29 | |
| michael@0 | 30 | EGL Extension #?? |
| michael@0 | 31 | |
| michael@0 | 32 | Dependencies |
| michael@0 | 33 | |
| michael@0 | 34 | Requires the EGL_ANGLE_surface_d3d_texture_2d_share_handle extension. |
| michael@0 | 35 | |
| michael@0 | 36 | This extension is written against the wording of the EGL 1.4 |
| michael@0 | 37 | Specification. |
| michael@0 | 38 | |
| michael@0 | 39 | Overview |
| michael@0 | 40 | |
| michael@0 | 41 | This extension allows creating EGL surfaces from handles to textures |
| michael@0 | 42 | shared from the Direct3D API or from |
| michael@0 | 43 | EGL_ANGLE_surface_texture_2d_share_handle. |
| michael@0 | 44 | |
| michael@0 | 45 | New Types |
| michael@0 | 46 | |
| michael@0 | 47 | None |
| michael@0 | 48 | |
| michael@0 | 49 | New Procedures and Functions |
| michael@0 | 50 | |
| michael@0 | 51 | None |
| michael@0 | 52 | |
| michael@0 | 53 | New Tokens |
| michael@0 | 54 | |
| michael@0 | 55 | Accepted in the <buftype> parameter of eglCreatePbufferFromClientBuffer: |
| michael@0 | 56 | |
| michael@0 | 57 | EGL_D3D_TEXTURE_2D_SHARE_HANDLE_ANGLE 0x3200 |
| michael@0 | 58 | |
| michael@0 | 59 | Additions to Chapter 3 of the EGL 1.4 Specification (EGL Functions and Errors) |
| michael@0 | 60 | |
| michael@0 | 61 | Replace the last sentence of paragraph 1 of Section 3.5.3 with the |
| michael@0 | 62 | following text. |
| michael@0 | 63 | "Currently, the only client API resources which may be bound in this |
| michael@0 | 64 | fashion are OpenVG VGImage objects and Direct3D share handles." |
| michael@0 | 65 | |
| michael@0 | 66 | Replace the last sentence of paragraph 2 ("To bind a client API...") of |
| michael@0 | 67 | Section 3.5.3 with the following text. |
| michael@0 | 68 | "When <buftype> is EGL_OPENVG_IMAGE, the width and height of the pbuffer |
| michael@0 | 69 | are determined by the width and height of <buffer>. When <buftype> is |
| michael@0 | 70 | EGL_D3D_TEXTURE_2D_SHARE_HANDLE_ANGLE, the width and height are specified |
| michael@0 | 71 | using EGL_WIDTH and EGL_HEIGHT, or else they default to zero. The width |
| michael@0 | 72 | and height must match the dimensions of the texture which the share handle |
| michael@0 | 73 | was created from or else an EGL_BAD_ALLOC error is generated." |
| michael@0 | 74 | |
| michael@0 | 75 | Replace the third paragraph of Section 3.5.3 with the following text. |
| michael@0 | 76 | "<buftype> specifies the type of buffer to be bound. The only allowed values |
| michael@0 | 77 | of <buftype> are EGL_OPENVG_IMAGE and |
| michael@0 | 78 | EGL_D3D_TEXTURE_2D_SHARE_HANDLE_ANGLE". |
| michael@0 | 79 | |
| michael@0 | 80 | Append the following text to the fourth paragraph of Section 3.5.3. |
| michael@0 | 81 | "When <buftype> is EGL_D3D_TEXTURE_2D_SHARE_HANDLE_ANGLE, <buffer> must be |
| michael@0 | 82 | a valid D3D share handle, cast into the type EGLClientBuffer. The handle |
| michael@0 | 83 | may be obtained from the Direct3D9Ex CreateTexture function, from DXGI's |
| michael@0 | 84 | GetSharedHandle method on an ID3D10Texture2D, or from the |
| michael@0 | 85 | EGL_ANGLE_surface_d3d_texture_2d_share_handle extension." |
| michael@0 | 86 | |
| michael@0 | 87 | Issues |
| michael@0 | 88 | |
| michael@0 | 89 | Revision History |
| michael@0 | 90 | |
| michael@0 | 91 | Version 3, 2011/05/12 |
| michael@0 | 92 | - publish |
| michael@0 | 93 | |
| michael@0 | 94 | Version 2, 2011/05/03 |
| michael@0 | 95 | - specify EGL_D3D_TEXTURE_2D_SHARE_HANDLE |
| michael@0 | 96 | - specify error if dimensions don't match |
| michael@0 | 97 | |
| michael@0 | 98 | Version 1, 2011/04/12 - first draft. |
