summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--src/mesa/pipe/p_winsys.h38
1 files changed, 18 insertions, 20 deletions
diff --git a/src/mesa/pipe/p_winsys.h b/src/mesa/pipe/p_winsys.h
index 2861e03c9e5..73ac61c33a2 100644
--- a/src/mesa/pipe/p_winsys.h
+++ b/src/mesa/pipe/p_winsys.h
@@ -29,13 +29,13 @@
#define P_WINSYS_H
-/* This is the interface that softpipe requires any window system
- * hosting it to implement. This is the only include file in softpipe
+/**
+ * This is the interface that Gallium3D requires any window system
+ * hosting it to implement. This is the only include file in Gallium3D
* which is public.
- */
-
-
-/* Pipe drivers are (meant to be!) independent of both GL and the
+ *
+ *
+ * Gallium3D drivers are (meant to be!) independent of both GL and the
* window system. The window system provides a buffer manager and a
* set of additional hooks for things like command buffer submission,
* etc.
@@ -45,33 +45,33 @@
* etc.
*/
-struct pipe_buffer_handle;
-struct pipe_winsys {
+/** Opaque type */
+struct pipe_buffer_handle;
- /* Do any special operations to ensure frontbuffer contents are
+struct pipe_winsys
+{
+ /**
+ * Do any special operations to ensure frontbuffer contents are
* displayed, eg copy fake frontbuffer.
*/
void (*flush_frontbuffer)( struct pipe_winsys *sws );
- /* debug output
- */
+ /** for debug output */
void (*printf)( struct pipe_winsys *sws,
const char *, ... );
/* The buffer manager is modeled after the dri_bufmgr interface,
- * but this is the subset that softpipe cares about. Remember that
- * softpipe gets to choose the interface it needs, and the window
+ * but this is the subset that gallium cares about. Remember that
+ * gallium gets to choose the interface it needs, and the window
* systems must then implement that interface (rather than the
* other way around...).
- *
- * Softpipe only really wants to make system memory allocations,
- * right??
*/
struct pipe_buffer_handle *(*buffer_create)(struct pipe_winsys *sws,
unsigned alignment );
+ /** flags is bitmask of PIPE_BUFFER_FLAG_READ/WRITE */
void *(*buffer_map)( struct pipe_winsys *sws,
struct pipe_buffer_handle *buf,
unsigned flags );
@@ -101,12 +101,10 @@ struct pipe_winsys {
void *data);
- /* Wait for any hw swapbuffers, etc. to finish:
- */
+ /** Wait for any hw swapbuffers, etc. to finish */
void (*wait_idle)( struct pipe_winsys *sws );
- /* Queries:
- */
+ /** Queries */
const char *(*get_name)( struct pipe_winsys *sws );
};