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 parameter of MapBufferOES: WRITE_ONLY_OES 0x88B9 Accepted by the parameter of GetBufferParameteriv: BUFFER_ACCESS_OES 0x88BB BUFFER_MAPPED_OES 0x88BC Accepted by the 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 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