Eliminate struct pipe_region.
[mesa.git] / src / mesa / pipe / p_context.h
index b303cee5ccaa18301ea2cc1cb0a8237723f13634..2420d02213ff7868a48a03079819432458561aaf 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;
 
 
 /**
- * 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);
-   void (*max_texture_size)(struct pipe_context *pipe,
-                            GLuint textureType, /* PIPE_TEXTURE_x */
-                            GLuint *maxWidth,
-                            GLuint *maxHeight,
-                            GLuint *maxDepth);
+   boolean (*is_format_supported)( struct pipe_context *pipe,
+                                   uint format );
+
+   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_handle *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);
+   void (*begin_query)(struct pipe_context *pipe, struct pipe_query_object *q);
+   void (*end_query)(struct pipe_context *pipe, struct pipe_query_object *q);
+   void (*wait_query)(struct pipe_context *pipe, struct pipe_query_object *q);
 
    /*
     * 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_alpha_test_state)(struct pipe_context *,
+                                     const struct pipe_alpha_test_state *);
+   void   (*bind_alpha_test_state)(struct pipe_context *, void *);
+   void   (*delete_alpha_test_state)(struct pipe_context *, void *);
+
+   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_state)(struct pipe_context *,
+                                        const struct pipe_depth_stencil_state *);
+   void   (*bind_depth_stencil_state)(struct pipe_context *, void *);
+   void   (*delete_depth_stencil_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 * );
 
@@ -96,96 +134,106 @@ struct pipe_context {
    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_feedback_state)( struct pipe_context *,
+                               const struct pipe_feedback_state *);
 
    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_sampler_units)( struct pipe_context *,
+                              uint num_samplers, const uint *units );
 
    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 * );
+                              unsigned unit,
+                              struct pipe_texture * );
 
    void (*set_viewport_state)( struct pipe_context *,
                                const struct pipe_viewport_state * );
 
-
    /*
-    * Surface functions
-    * This might go away...
+    * Vertex arrays
     */
-   struct pipe_surface *(*surface_alloc)(struct pipe_context *pipe,
-                                         GLuint format);
+   void (*set_vertex_buffer)( struct pipe_context *,
+                              unsigned index,
+                              const struct pipe_vertex_buffer * );
 
-   struct pipe_surface *(*get_tex_surface)(struct pipe_context *pipe,
-                                           struct pipe_mipmap_tree *texture,
-                                           GLuint face, GLuint level,
-                                           GLuint zslice);
+   void (*set_vertex_element)( struct pipe_context *,
+                              unsigned index,
+                              const struct pipe_vertex_element * );
 
    /*
-    * Memory region functions
-    * Some of these may go away...
+    * Vertex feedback
     */
-   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);
+   void (*set_feedback_buffer)(struct pipe_context *,
+                               unsigned index,
+                               const struct pipe_feedback_buffer *);
 
-   GLubyte *(*region_map)(struct pipe_context *pipe, struct pipe_region *r);
-
-   void (*region_unmap)(struct pipe_context *pipe, struct pipe_region *r);
-
-   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);
+   /** 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);
+   /* XXX temporary here, move these to softpipe */
+   void (*get_tile_rgba)(struct pipe_context *pipe, struct pipe_surface *ps,
+                         uint x, uint y, uint w, uint h, float *p);
+   void (*put_tile_rgba)(struct pipe_context *pipe, struct pipe_surface *ps,
+                         uint x, uint y, uint w, uint h, const float *p);
 
-   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);
+   /*
+    * 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);
 
 
    /*
     * 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);
 
 
    /* Flush rendering:
@@ -194,40 +242,4 @@ struct pipe_context {
                  unsigned flags );
 };
 
-
-
-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 */