gallium: rename pipe_buffer_handle to pipe_buffer, rework pipebuffer/ code
[mesa.git] / src / mesa / pipe / p_context.h
index 533840c5557c654107bc248164ffe4ef1a4bf546..37464c88a13393b474bd1d975042bd1a61712892 100644 (file)
 #ifndef PIPE_CONTEXT_H
 #define PIPE_CONTEXT_H
 
-#include "main/mtypes.h"
 #include "p_state.h"
 
 
-/* Drawing currently kludged up via the existing tnl/ module.  
- */
-struct vertex_buffer;
+struct pipe_state_cache;
 
+/* Opaque driver handles:
+ */
+struct pipe_query;
 
 /**
- * Software pipeline rendering context.  Basically a collection of
- * state setting functions, plus VBO drawing entrypoint.
+ * Gallium rendering context.  Basically:
+ *  - state setting functions
+ *  - VBO drawing functions
+ *  - surface functions
+ *  - device queries
  */
 struct pipe_context {
+   struct pipe_winsys *winsys;
+
+   void *priv;  /** context private data (for DRI for example) */
 
    void (*destroy)( struct pipe_context * );
 
    /*
     * Queries
     */
-   const GLuint *(*supported_formats)(struct pipe_context *pipe,
-                                      GLuint *numFormats);
+   /** type is one of PIPE_SURFACE, PIPE_TEXTURE, etc. */
+   boolean (*is_format_supported)( struct pipe_context *pipe,
+                                   enum pipe_format format, uint type );
+
+   const char *(*get_name)( struct pipe_context *pipe );
+
+   const char *(*get_vendor)( struct pipe_context *pipe );
+
+   int (*get_param)( struct pipe_context *pipe, int param );
+   float (*get_paramf)( struct pipe_context *pipe, int param );
+
 
    /*
-    * Drawing
+    * Drawing.  
+    * Return false on fallbacks (temporary??)
     */
-   void (*draw_vb)( struct pipe_context *pipe,
-                   struct vertex_buffer *VB );
+   boolean (*draw_arrays)( struct pipe_context *pipe,
+                          unsigned mode, unsigned start, unsigned count);
 
-   void (*draw_vertices)( struct pipe_context *pipe,
-                          GLuint mode,
-                          GLuint numVertex, const GLfloat *verts,
-                          GLuint numAttribs, const GLuint attribs[]);
+   boolean (*draw_elements)( struct pipe_context *pipe,
+                            struct pipe_buffer *indexBuffer,
+                            unsigned indexSize,
+                            unsigned mode, unsigned start, unsigned count);
 
    /** Clear a surface to given value (no scissor; clear whole surface) */
    void (*clear)(struct pipe_context *pipe, struct pipe_surface *ps,
-                 GLuint clearValue);
+                 unsigned clearValue);
 
-   /** occlusion counting (XXX this may be temporary - we should probably
-    * have generic query objects with begin/end methods)
+   /**
+    * Query objects
     */
-   void (*reset_occlusion_counter)(struct pipe_context *pipe);
-   GLuint (*get_occlusion_counter)(struct pipe_context *pipe);
+   struct pipe_query *(*create_query)( struct pipe_context *pipe,
+                                              unsigned query_type );
+
+   void (*destroy_query)(struct pipe_context *pipe,
+                         struct pipe_query *q);
+
+   void (*begin_query)(struct pipe_context *pipe, struct pipe_query *q);
+   void (*end_query)(struct pipe_context *pipe, struct pipe_query *q);
+
+   boolean (*get_query_result)(struct pipe_context *pipe, 
+                               struct pipe_query *q,
+                               boolean wait,
+                               uint64 *result);
 
    /*
     * State functions
     */
-   void (*set_alpha_test_state)( struct pipe_context *,
-                                 const struct pipe_alpha_test_state * );
-
-   void (*set_blend_state)( struct pipe_context *,
-                            const struct pipe_blend_state * );
-
+   void * (*create_blend_state)(struct pipe_context *,
+                                const struct pipe_blend_state *);
+   void   (*bind_blend_state)(struct pipe_context *, void *);
+   void   (*delete_blend_state)(struct pipe_context *, void  *);
+
+   void * (*create_sampler_state)(struct pipe_context *,
+                                  const struct pipe_sampler_state *);
+   void   (*bind_sampler_state)(struct pipe_context *, unsigned unit, void *);
+   void   (*delete_sampler_state)(struct pipe_context *, void *);
+
+   void * (*create_rasterizer_state)(struct pipe_context *,
+                                     const struct pipe_rasterizer_state *);
+   void   (*bind_rasterizer_state)(struct pipe_context *, void *);
+   void   (*delete_rasterizer_state)(struct pipe_context *, void *);
+
+   void * (*create_depth_stencil_alpha_state)(struct pipe_context *,
+                                        const struct pipe_depth_stencil_alpha_state *);
+   void   (*bind_depth_stencil_alpha_state)(struct pipe_context *, void *);
+   void   (*delete_depth_stencil_alpha_state)(struct pipe_context *, void *);
+
+   void * (*create_fs_state)(struct pipe_context *,
+                             const struct pipe_shader_state *);
+   void   (*bind_fs_state)(struct pipe_context *, void *);
+   void   (*delete_fs_state)(struct pipe_context *, void *);
+
+   void * (*create_vs_state)(struct pipe_context *,
+                             const struct pipe_shader_state *);
+   void   (*bind_vs_state)(struct pipe_context *, void *);
+   void   (*delete_vs_state)(struct pipe_context *, void *);
+
+   /* The following look more properties than states.
+    * maybe combine a few of them into states or pass them
+    * in the bind calls to the state */
    void (*set_blend_color)( struct pipe_context *,
                             const struct pipe_blend_color * );
 
    void (*set_clip_state)( struct pipe_context *,
                           const struct pipe_clip_state * );
 
-   void (*set_clear_color_state)( struct pipe_context *,
-                                  const struct pipe_clear_color_state * );
-
-   void (*set_depth_state)( struct pipe_context *,
-                              const struct pipe_depth_state * );
+   void (*set_constant_buffer)( struct pipe_context *,
+                                uint shader, uint index,
+                                const struct pipe_constant_buffer *buf );
 
    void (*set_framebuffer_state)( struct pipe_context *,
                                   const struct pipe_framebuffer_state * );
 
-   void (*set_fs_state)( struct pipe_context *,
-                        const struct pipe_fs_state * );
-
    void (*set_polygon_stipple)( struct pipe_context *,
                                const struct pipe_poly_stipple * );
 
-   void (*set_setup_state)( struct pipe_context *,
-                           const struct pipe_setup_state * );
-
    void (*set_scissor_state)( struct pipe_context *,
                               const struct pipe_scissor_state * );
 
-   void (*set_stencil_state)( struct pipe_context *,
-                              const struct pipe_stencil_state * );
-
-   void (*set_sampler_state)( struct pipe_context *,
-                              GLuint unit,
-                              const struct pipe_sampler_state * );
 
-   void (*set_texture_state)( struct pipe_context *,
-                              GLuint unit,
-                              struct pipe_mipmap_tree * );
+   /* Currently a sampler is constrained to sample from a single texture:
+    */
+   void (*set_sampler_texture)( struct pipe_context *,
+                               unsigned sampler,
+                               struct pipe_texture * );
 
    void (*set_viewport_state)( struct pipe_context *,
                                const struct pipe_viewport_state * );
 
-
-   /*
-    * Surface functions
-    * This might go away...
-    */
-   struct pipe_surface *(*surface_alloc)(struct pipe_context *pipe,
-                                         GLuint format);
-
-   struct pipe_surface *(*get_tex_surface)(struct pipe_context *pipe,
-                                           struct pipe_mipmap_tree *texture,
-                                           GLuint face, GLuint level,
-                                           GLuint zslice);
-
    /*
-    * Memory region functions
-    * Some of these may go away...
+    * Vertex arrays
     */
-   struct pipe_region *(*region_alloc)(struct pipe_context *pipe,
-                                       GLuint cpp, GLuint width, GLuint height,
-                                       GLbitfield flags);
-
-   void (*region_release)(struct pipe_context *pipe, struct pipe_region **r);
-
-   void (*region_idle)(struct pipe_context *pipe, struct pipe_region *region);
-
-   GLubyte *(*region_map)(struct pipe_context *pipe, struct pipe_region *r);
-
-   void (*region_unmap)(struct pipe_context *pipe, struct pipe_region *r);
+   void (*set_vertex_buffer)( struct pipe_context *,
+                              unsigned index,
+                              const struct pipe_vertex_buffer * );
 
-   void (*region_data)(struct pipe_context *pipe,
-                       struct pipe_region *dest,
-                       GLuint dest_offset,
-                       GLuint destx, GLuint desty,
-                       const void *src, GLuint src_stride,
-                       GLuint srcx, GLuint srcy, GLuint width, GLuint height);
+   void (*set_vertex_element)( struct pipe_context *,
+                              unsigned index,
+                              const struct pipe_vertex_element * );
 
-   void (*region_copy)(struct pipe_context *pipe,
-                       struct pipe_region *dest,
-                       GLuint dest_offset,
-                       GLuint destx, GLuint desty,
-                       struct pipe_region *src,        /* don't make this const - 
-                                                  need to map/unmap */
-                       GLuint src_offset,
-                       GLuint srcx, GLuint srcy, GLuint width, GLuint height);
 
-   void (*region_fill)(struct pipe_context *pipe,
-                       struct pipe_region *dst,
-                       GLuint dst_offset,
-                       GLuint dstx, GLuint dsty,
-                       GLuint width, GLuint height,
-                       GLuint value);
+   /** Get a surface which is a "view" into a texture */
+   struct pipe_surface *(*get_tex_surface)(struct pipe_context *pipe,
+                                           struct pipe_texture *texture,
+                                           unsigned face, unsigned level,
+                                           unsigned zslice);
+
+   /** Get a block of raw pixel data from a surface */
+   void (*get_tile)(struct pipe_context *pipe,
+                    struct pipe_surface *ps,
+                    uint x, uint y, uint w, uint h,
+                    void *p, int dst_stride);
+   /** Put a block of raw pixel data into a surface */
+   void (*put_tile)(struct pipe_context *pipe,
+                    struct pipe_surface *ps,
+                    uint x, uint y, uint w, uint h,
+                    const void *p, int src_stride);
 
 
-   /* Buffer management functions need to be exposed as well.  A pipe
-    * buffer may be used as a texture, render target or vertex/index
-    * buffer, or some combination according to flags.  
+   /*
+    * Surface functions
     */
+   void (*surface_data)(struct pipe_context *pipe,
+                       struct pipe_surface *dest,
+                       unsigned destx, unsigned desty,
+                       const void *src, unsigned src_stride,
+                       unsigned srcx, unsigned srcy,
+                       unsigned width, unsigned height);
+
+   void (*surface_copy)(struct pipe_context *pipe,
+                       struct pipe_surface *dest,
+                       unsigned destx, unsigned desty,
+                       struct pipe_surface *src, /* don't make this const - 
+                                                    need to map/unmap */
+                       unsigned srcx, unsigned srcy,
+                       unsigned width, unsigned height);
+
+   void (*surface_fill)(struct pipe_context *pipe,
+                       struct pipe_surface *dst,
+                       unsigned dstx, unsigned dsty,
+                       unsigned width, unsigned height,
+                       unsigned value);
 
-   struct pipe_buffer_handle *(*create_buffer)(struct pipe_context *pipe, 
-                                              unsigned alignment,
-                                              unsigned flags );
-
-   void *(*buffer_map)( struct pipe_context *pipe, 
-                       struct pipe_buffer_handle *buf,
-                       unsigned flags );
-   
-   void (*buffer_unmap)( struct pipe_context *pipe, 
-                        struct pipe_buffer_handle *buf );
-
-   struct pipe_buffer_handle *(*buffer_reference)( struct pipe_context *pipe,
-                                                  struct pipe_buffer_handle *buf );
-
-   void (*buffer_unreference)( struct pipe_context *pipe, 
-                              struct pipe_buffer_handle **buf );
-
-   void (*buffer_data)(struct pipe_context *pipe, 
-                      struct pipe_buffer_handle *buf,
-                      unsigned size, const void *data );
-
-   void (*buffer_subdata)(struct pipe_context *pipe, 
-                         struct pipe_buffer_handle *buf,
-                         unsigned long offset, 
-                         unsigned long size, 
-                         const void *data);
-
-   void (*buffer_get_subdata)(struct pipe_context *pipe, 
-                             struct pipe_buffer_handle *buf,
-                             unsigned long offset, 
-                             unsigned long size, 
-                             void *data);
 
    /*
     * Texture functions
     */
-   GLboolean (*mipmap_tree_layout)( struct pipe_context *pipe,
-                                    struct pipe_mipmap_tree *mt );
+   void (*texture_create)(struct pipe_context *pipe,
+                         struct pipe_texture **pt);
+
+   void (*texture_release)(struct pipe_context *pipe,
+                          struct pipe_texture **pt);
 
 
-   /* Simple flush/finish support:
+   /* Flush rendering:
     */
    void (*flush)( struct pipe_context *pipe,
                  unsigned flags );
-
-   void (*wait_idle)( struct pipe_context *pipe );
-
-   void (*flush_frontbuffer)( struct pipe_context *pipe );
 };
 
-
-
-static INLINE void
-pipe_region_reference(struct pipe_region **dst, struct pipe_region *src)
-{
-   assert(*dst == NULL);
-   if (src) {
-      src->refcount++;
-      *dst = src;
-   }
-}
-
-
-static INLINE void
-pipe_surface_reference(struct pipe_surface **dst, struct pipe_surface *src)
-{
-   assert(*dst == NULL);
-   if (src) {
-      src->refcount++;
-      *dst = src;
-   }
-}
-
-static INLINE void
-pipe_surface_unreference(struct pipe_surface **ps)
-{
-   assert(*ps);
-   (*ps)->refcount--;
-   if ((*ps)->refcount <= 0) {
-      /* XXX need a proper surface->free method */
-      free(*ps);
-   }
-   *ps = NULL;
-}
-
-
 #endif /* PIPE_CONTEXT_H */