gallium: Explain what happens if buffer_flush_mapped_range isn't called.
authorJosé Fonseca <jfonseca@vmware.com>
Wed, 18 Mar 2009 16:54:25 +0000 (16:54 +0000)
committerJosé Fonseca <jfonseca@vmware.com>
Fri, 20 Mar 2009 18:34:24 +0000 (18:34 +0000)
src/gallium/include/pipe/p_screen.h

index ed3a026..ceac755 100644 (file)
@@ -223,6 +223,13 @@ struct pipe_screen {
     * specified to buffer_map_range. This is different from the 
     * ARB_map_buffer_range semantics because we don't forbid multiple mappings 
     * of the same buffer (yet).
+    * 
+    * If the buffer was mapped for writing and no buffer_flush_mapped_range 
+    * call was done until the buffer_unmap is called then the pipe driver will
+    * assumed that the whole buffer was written. This is for backward 
+    * compatibility purposes and may affect performance -- the state tracker 
+    * should always specify exactly what got written while the buffer was 
+    * mapped.  
     */
    void (*buffer_flush_mapped_range)( struct pipe_screen *screen,
                                       struct pipe_buffer *buf,