commit 30de608561e46bcaed202733947636c2a47c2880
author Mathias Heyer <mheyer@nvidia.com> Mon Apr 27 16:18:18 2020 -0700
committer Mathias Heyer <mheyer@nvidia.com> Wed May 06 10:40:15 2020 -0700
tree 7d254e403df9e9b2fbc565d26c5e1263db48ecdb
parent 03e1bfb87c4664d34dc7822fb591841eec747094

NV_pixel_buffer_object: fix example code

GL_STREAM_READ is not available in ES2.0. In fact, EXT_map_buffer_range
was the first time a mapped buffer could be read from legally.
Just use GL_STREAM_DRAW instead. This  is not a major problem, though,
as the usage hints do not affect the legal usage of a buffer and are
taken by the drivers merely as hints, sometimes even being ignored.

https://github.com/KhronosGroup/OpenGL-API/issues/66

extensions/NV/NV_pixel_buffer_object.txt

diff --git a/extensions/NV/NV_pixel_buffer_object.txt b/extensions/NV/NV_pixel_buffer_object.txt
index 632935d..0e8473f 100644
--- a/extensions/NV/NV_pixel_buffer_object.txt
+++ b/extensions/NV/NV_pixel_buffer_object.txt
@@ -21,8 +21,8 @@
 
 Version
 
-    Last Modified Date: October 23rd, 2012
-    Revision: 2.0
+    Last Modified Date: April 27th, 2020
+    Revision: 3.0
 
 Number
 
@@ -552,11 +552,11 @@
 
         glBindBuffer(GL_PIXEL_PACK_BUFFER_NV, imageBuffers[0]);
         glBufferData(GL_PIXEL_PACK_BUFFER_NV, imageSize / 2, NULL,
-                     GL_STREAM_READ);
+                     GL_STREAM_DRAW);
 
         glBindBuffer(GL_PIXEL_PACK_BUFFER_NV, imageBuffers[1]);
         glBufferData(GL_PIXEL_PACK_BUFFER_NV, imageSize / 2, NULL,
-                     GL_STREAM_READ);
+                     GL_STREAM_DRAW);
 
         // Render to framebuffer
         glDrawBuffer(GL_BACK);
@@ -576,12 +576,12 @@
         // Process partial images.  Mapping the buffer waits for
         // outstanding DMA transfers into the buffer to finish.
         glBindBuffer(GL_PIXEL_PACK_BUFFER_NV, imageBuffers[0]);
-        pboMemory1 = glMapBuffer(GL_PIXEL_PACK_BUFFER_NV,
-                                 GL_READ_ONLY);
+        pboMemory1 = glMapBufferRangeEXT(GL_PIXEL_PACK_BUFFER_NV,0,
+                                         imageSize/2, GL_MAP_READ_BIT_EXT);
         processImage(pboMemory1);
         glBindBuffer(GL_PIXEL_PACK_BUFFER_NV, imageBuffers[1]);
-        pboMemory2 = glMapBuffer(GL_PIXEL_PACK_BUFFER_NV,
-                                 GL_READ_ONLY);
+        pboMemory2 = glMapBufferRangeEXT(GL_PIXEL_PACK_BUFFER_NV,0,
+                                         imageSize/2, GL_MAP_READ_BIT_EXT);
         processImage(pboMemory2);
 
         // Unmap the image buffers
@@ -750,6 +750,8 @@
         
 Revision History
 
+    3   04/27/2020 fix example code: GL_STREAM_READ is not available in ES2.0
+                   glMapBufferOES does not allow reading from the mapped pointer.
     2   10/23/2012 more cleanup, interaction with EXT_map_buffer_range
     1   04/19/2012 initial revision
         - took ARB_pixel_buffer_object, stripped everything not applicable to