1Name 2 3 OES_mapbuffer 4 5Name Strings 6 7 GL_OES_mapbuffer 8 9Contact 10 11 Aaftab Munshi (amunshi@ati.com) 12 13Notice 14 15 Copyright (c) 2005-2013 The Khronos Group Inc. Copyright terms at 16 http://www.khronos.org/registry/speccopyright.html 17 18Specification Update Policy 19 20 Khronos-approved extension specifications are updated in response to 21 issues and bugs prioritized by the Khronos OpenGL ES Working Group. For 22 extensions which have been promoted to a core Specification, fixes will 23 first appear in the latest version of that core Specification, and will 24 eventually be backported to the extension document. This policy is 25 described in more detail at 26 https://www.khronos.org/registry/OpenGL/docs/update_policy.php 27 28IP Status 29 30 None. 31 32Status 33 34 Ratified by the Khronos BOP, July 22, 2005. 35 36Version 37 38 Last Modifed Date: March 31, 2013 39 40Number 41 42 OpenGL ES Extension #29 43 44Dependencies 45 46 OpenGL ES 1.1 is required. 47 48Overview 49 50 This extension adds to the vertex buffer object functionality supported 51 by OpenGL ES 1.1 or ES 2.0 by allowing the entire data storage of a 52 buffer object to be mapped into the client's address space. 53 54Issues 55 56 57New Tokens 58 59 Accepted by the <access> parameter of MapBufferOES: 60 61 WRITE_ONLY_OES 0x88B9 62 63 Accepted by the <value> parameter of GetBufferParameteriv: 64 65 BUFFER_ACCESS_OES 0x88BB 66 BUFFER_MAPPED_OES 0x88BC 67 68 Accepted by the <pname> parameter of GetBufferPointervOES: 69 70 BUFFER_MAP_POINTER_OES 0x88BD 71 72New Procedures and Functions 73 74 void GetBufferPointervOES(enum target, enum pname, void** params) 75 76 void *MapBufferOES(enum target, enum access) 77 78 boolean UnmapBufferOES(enum target) 79 80 Please refer to the OpenGL 2.0 specification for details on how 81 these functions work. One departure from desktop OpenGL 2.0 is 82 that the <access> parameter to MapBufferOES must be WRITE_ONLY_OES. 83 84 Note that any portion of a mapped buffer that is not written 85 will retain its original contents. 86 87Errors 88 89 None. 90 91New State 92 93(table 6.8) 94 Initial 95Get Value Type Get Command Value Description 96--------- ---- ----------- ----- ----------- 97BUFFER_ACCESS_OES Z1 GetBufferParameteriv WRITE_ONLY_OES buffer map flag 98BUFFER_MAPPED_OES B GetBufferParameteriv FALSE buffer map flag 99BUFFER_MAP_POINTER_OES Y GetBufferPointervOES NULL mapped buffer pointer 100 101Revision History 102 103 03/31/2013 Benj Lipchak Clarify that unwritten data is preserved 104 11/12/2007 Benj Lipchak Mention only WRITE_ONLY access is allowed, 105 some additional tokens needed 106 11/05/2007 Benj Lipchak Change API version requirement, fix typos 107 09/19/2007 Benj Lipchak Added OES suffixes, GetBufferPointervOES 108 07/06/2005 Aaftab Munshi Created the extension 109