15bd8deadSopenharmony_ciName 25bd8deadSopenharmony_ci 35bd8deadSopenharmony_ci OES_mapbuffer 45bd8deadSopenharmony_ci 55bd8deadSopenharmony_ciName Strings 65bd8deadSopenharmony_ci 75bd8deadSopenharmony_ci GL_OES_mapbuffer 85bd8deadSopenharmony_ci 95bd8deadSopenharmony_ciContact 105bd8deadSopenharmony_ci 115bd8deadSopenharmony_ci Aaftab Munshi (amunshi@ati.com) 125bd8deadSopenharmony_ci 135bd8deadSopenharmony_ciNotice 145bd8deadSopenharmony_ci 155bd8deadSopenharmony_ci Copyright (c) 2005-2013 The Khronos Group Inc. Copyright terms at 165bd8deadSopenharmony_ci http://www.khronos.org/registry/speccopyright.html 175bd8deadSopenharmony_ci 185bd8deadSopenharmony_ciSpecification Update Policy 195bd8deadSopenharmony_ci 205bd8deadSopenharmony_ci Khronos-approved extension specifications are updated in response to 215bd8deadSopenharmony_ci issues and bugs prioritized by the Khronos OpenGL ES Working Group. For 225bd8deadSopenharmony_ci extensions which have been promoted to a core Specification, fixes will 235bd8deadSopenharmony_ci first appear in the latest version of that core Specification, and will 245bd8deadSopenharmony_ci eventually be backported to the extension document. This policy is 255bd8deadSopenharmony_ci described in more detail at 265bd8deadSopenharmony_ci https://www.khronos.org/registry/OpenGL/docs/update_policy.php 275bd8deadSopenharmony_ci 285bd8deadSopenharmony_ciIP Status 295bd8deadSopenharmony_ci 305bd8deadSopenharmony_ci None. 315bd8deadSopenharmony_ci 325bd8deadSopenharmony_ciStatus 335bd8deadSopenharmony_ci 345bd8deadSopenharmony_ci Ratified by the Khronos BOP, July 22, 2005. 355bd8deadSopenharmony_ci 365bd8deadSopenharmony_ciVersion 375bd8deadSopenharmony_ci 385bd8deadSopenharmony_ci Last Modifed Date: March 31, 2013 395bd8deadSopenharmony_ci 405bd8deadSopenharmony_ciNumber 415bd8deadSopenharmony_ci 425bd8deadSopenharmony_ci OpenGL ES Extension #29 435bd8deadSopenharmony_ci 445bd8deadSopenharmony_ciDependencies 455bd8deadSopenharmony_ci 465bd8deadSopenharmony_ci OpenGL ES 1.1 is required. 475bd8deadSopenharmony_ci 485bd8deadSopenharmony_ciOverview 495bd8deadSopenharmony_ci 505bd8deadSopenharmony_ci This extension adds to the vertex buffer object functionality supported 515bd8deadSopenharmony_ci by OpenGL ES 1.1 or ES 2.0 by allowing the entire data storage of a 525bd8deadSopenharmony_ci buffer object to be mapped into the client's address space. 535bd8deadSopenharmony_ci 545bd8deadSopenharmony_ciIssues 555bd8deadSopenharmony_ci 565bd8deadSopenharmony_ci 575bd8deadSopenharmony_ciNew Tokens 585bd8deadSopenharmony_ci 595bd8deadSopenharmony_ci Accepted by the <access> parameter of MapBufferOES: 605bd8deadSopenharmony_ci 615bd8deadSopenharmony_ci WRITE_ONLY_OES 0x88B9 625bd8deadSopenharmony_ci 635bd8deadSopenharmony_ci Accepted by the <value> parameter of GetBufferParameteriv: 645bd8deadSopenharmony_ci 655bd8deadSopenharmony_ci BUFFER_ACCESS_OES 0x88BB 665bd8deadSopenharmony_ci BUFFER_MAPPED_OES 0x88BC 675bd8deadSopenharmony_ci 685bd8deadSopenharmony_ci Accepted by the <pname> parameter of GetBufferPointervOES: 695bd8deadSopenharmony_ci 705bd8deadSopenharmony_ci BUFFER_MAP_POINTER_OES 0x88BD 715bd8deadSopenharmony_ci 725bd8deadSopenharmony_ciNew Procedures and Functions 735bd8deadSopenharmony_ci 745bd8deadSopenharmony_ci void GetBufferPointervOES(enum target, enum pname, void** params) 755bd8deadSopenharmony_ci 765bd8deadSopenharmony_ci void *MapBufferOES(enum target, enum access) 775bd8deadSopenharmony_ci 785bd8deadSopenharmony_ci boolean UnmapBufferOES(enum target) 795bd8deadSopenharmony_ci 805bd8deadSopenharmony_ci Please refer to the OpenGL 2.0 specification for details on how 815bd8deadSopenharmony_ci these functions work. One departure from desktop OpenGL 2.0 is 825bd8deadSopenharmony_ci that the <access> parameter to MapBufferOES must be WRITE_ONLY_OES. 835bd8deadSopenharmony_ci 845bd8deadSopenharmony_ci Note that any portion of a mapped buffer that is not written 855bd8deadSopenharmony_ci will retain its original contents. 865bd8deadSopenharmony_ci 875bd8deadSopenharmony_ciErrors 885bd8deadSopenharmony_ci 895bd8deadSopenharmony_ci None. 905bd8deadSopenharmony_ci 915bd8deadSopenharmony_ciNew State 925bd8deadSopenharmony_ci 935bd8deadSopenharmony_ci(table 6.8) 945bd8deadSopenharmony_ci Initial 955bd8deadSopenharmony_ciGet Value Type Get Command Value Description 965bd8deadSopenharmony_ci--------- ---- ----------- ----- ----------- 975bd8deadSopenharmony_ciBUFFER_ACCESS_OES Z1 GetBufferParameteriv WRITE_ONLY_OES buffer map flag 985bd8deadSopenharmony_ciBUFFER_MAPPED_OES B GetBufferParameteriv FALSE buffer map flag 995bd8deadSopenharmony_ciBUFFER_MAP_POINTER_OES Y GetBufferPointervOES NULL mapped buffer pointer 1005bd8deadSopenharmony_ci 1015bd8deadSopenharmony_ciRevision History 1025bd8deadSopenharmony_ci 1035bd8deadSopenharmony_ci 03/31/2013 Benj Lipchak Clarify that unwritten data is preserved 1045bd8deadSopenharmony_ci 11/12/2007 Benj Lipchak Mention only WRITE_ONLY access is allowed, 1055bd8deadSopenharmony_ci some additional tokens needed 1065bd8deadSopenharmony_ci 11/05/2007 Benj Lipchak Change API version requirement, fix typos 1075bd8deadSopenharmony_ci 09/19/2007 Benj Lipchak Added OES suffixes, GetBufferPointervOES 1085bd8deadSopenharmony_ci 07/06/2005 Aaftab Munshi Created the extension 109