blob: abd692da5dafae92c92696c8bb8713b89f574f84 [file] [log] [blame]
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