| Name |
| |
| OES_mapbuffer |
| |
| Name Strings |
| |
| GL_OES_mapbuffer |
| |
| Contact |
| |
| Aaftab Munshi (amunshi@ati.com) |
| |
| Notice |
| |
| Copyright (c) 2005-2013 The Khronos Group Inc. Copyright terms at |
| http://www.khronos.org/registry/speccopyright.html |
| |
| Specification Update Policy |
| |
| Khronos-approved extension specifications are updated in response to |
| issues and bugs prioritized by the Khronos OpenGL ES Working Group. For |
| extensions which have been promoted to a core Specification, fixes will |
| first appear in the latest version of that core Specification, and will |
| eventually be backported to the extension document. This policy is |
| described in more detail at |
| https://www.khronos.org/registry/OpenGL/docs/update_policy.php |
| |
| IP Status |
| |
| None. |
| |
| Status |
| |
| Ratified by the Khronos BOP, July 22, 2005. |
| |
| Version |
| |
| Last Modifed Date: March 31, 2013 |
| |
| Number |
| |
| OpenGL ES Extension #29 |
| |
| Dependencies |
| |
| OpenGL ES 1.1 is required. |
| |
| Overview |
| |
| This extension adds to the vertex buffer object functionality supported |
| by OpenGL ES 1.1 or ES 2.0 by allowing the entire data storage of a |
| buffer object to be mapped into the client's address space. |
| |
| Issues |
| |
| |
| New Tokens |
| |
| Accepted by the <access> parameter of MapBufferOES: |
| |
| WRITE_ONLY_OES 0x88B9 |
| |
| Accepted by the <value> parameter of GetBufferParameteriv: |
| |
| BUFFER_ACCESS_OES 0x88BB |
| BUFFER_MAPPED_OES 0x88BC |
| |
| Accepted by the <pname> parameter of GetBufferPointervOES: |
| |
| BUFFER_MAP_POINTER_OES 0x88BD |
| |
| New Procedures and Functions |
| |
| void GetBufferPointervOES(enum target, enum pname, void** params) |
| |
| void *MapBufferOES(enum target, enum access) |
| |
| boolean UnmapBufferOES(enum target) |
| |
| Please refer to the OpenGL 2.0 specification for details on how |
| these functions work. One departure from desktop OpenGL 2.0 is |
| that the <access> parameter to MapBufferOES must be WRITE_ONLY_OES. |
| |
| Note that any portion of a mapped buffer that is not written |
| will retain its original contents. |
| |
| Errors |
| |
| None. |
| |
| New State |
| |
| (table 6.8) |
| Initial |
| Get Value Type Get Command Value Description |
| --------- ---- ----------- ----- ----------- |
| BUFFER_ACCESS_OES Z1 GetBufferParameteriv WRITE_ONLY_OES buffer map flag |
| BUFFER_MAPPED_OES B GetBufferParameteriv FALSE buffer map flag |
| BUFFER_MAP_POINTER_OES Y GetBufferPointervOES NULL mapped buffer pointer |
| |
| Revision History |
| |
| 03/31/2013 Benj Lipchak Clarify that unwritten data is preserved |
| 11/12/2007 Benj Lipchak Mention only WRITE_ONLY access is allowed, |
| some additional tokens needed |
| 11/05/2007 Benj Lipchak Change API version requirement, fix typos |
| 09/19/2007 Benj Lipchak Added OES suffixes, GetBufferPointervOES |
| 07/06/2005 Aaftab Munshi Created the extension |