[vlc-commits] gl: document opengl_vtable_t struct

[Thomas Guillem]

vlc | branch: master | Thomas Guillem <thomas at gllm.fr> | Fri Aug 25 13:20:59 2017 +0200| [ac396018a2cc93e14d0870f8bd4dece0e74c4a34] | committer: Thomas Guillem

gl: document opengl_vtable_t struct

> http://git.videolan.org/gitweb.cgi/vlc.git/?a=commit;h=ac396018a2cc93e14d0870f8bd4dece0e74c4a34
---

 modules/video_output/opengl/internal.h | 21 ++++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/modules/video_output/opengl/internal.h b/modules/video_output/opengl/internal.h
index b76edcddfa..6f9817e74a 100644
--- a/modules/video_output/opengl/internal.h
+++ b/modules/video_output/opengl/internal.h
@@ -123,22 +123,25 @@ typedef struct {
     PFNGLGETSHADERIVPROC   GetShaderiv;
     PFNGLGETSHADERINFOLOGPROC GetShaderInfoLog;
 
+    /* Buffers commands */
     PFNGLGENBUFFERSPROC    GenBuffers;
     PFNGLBINDBUFFERPROC    BindBuffer;
     PFNGLBUFFERDATAPROC    BufferData;
+    PFNGLDELETEBUFFERSPROC DeleteBuffers;
+
+    /* Commands used for PBO and/or Persistent mapping */
 #ifdef VLCGL_HAS_PBO
-    PFNGLBUFFERSUBDATAPROC          BufferSubData;
+    PFNGLBUFFERSUBDATAPROC          BufferSubData; /* can be NULL */
 #endif
 #ifdef VLCGL_HAS_MAP_PERSISTENT
-    PFNGLBUFFERSTORAGEPROC          BufferStorage;
-    PFNGLMAPBUFFERRANGEPROC         MapBufferRange;
-    PFNGLFLUSHMAPPEDBUFFERRANGEPROC FlushMappedBufferRange;
-    PFNGLUNMAPBUFFERPROC            UnmapBuffer;
-    PFNGLFENCESYNCPROC              FenceSync;
-    PFNGLDELETESYNCPROC             DeleteSync;
-    PFNGLCLIENTWAITSYNCPROC         ClientWaitSync;
+    PFNGLBUFFERSTORAGEPROC          BufferStorage; /* can be NULL */
+    PFNGLMAPBUFFERRANGEPROC         MapBufferRange; /* can be NULL */
+    PFNGLFLUSHMAPPEDBUFFERRANGEPROC FlushMappedBufferRange; /* can be NULL */
+    PFNGLUNMAPBUFFERPROC            UnmapBuffer; /* can be NULL */
+    PFNGLFENCESYNCPROC              FenceSync; /* can be NULL */
+    PFNGLDELETESYNCPROC             DeleteSync; /* can be NULL */
+    PFNGLCLIENTWAITSYNCPROC         ClientWaitSync; /* can be NULL */
 #endif
-    PFNGLDELETEBUFFERSPROC DeleteBuffers;
 
 #if defined(_WIN32)
     PFNGLACTIVETEXTUREPROC  ActiveTexture;