src/gallium/drivers/r300/r300_winsys.h

   1 /*
   2  * Copyright 2008 Corbin Simpson <MostAwesomeDude@gmail.com>
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the "Software"),
   6  * to deal in the Software without restriction, including without limitation
   7  * on the rights to use, copy, modify, merge, publish, distribute, sub
   8  * license, and/or sell copies of the Software, and to permit persons to whom
   9  * the Software is furnished to do so, subject to the following conditions:
  10  *
  11  * The above copyright notice and this permission notice (including the next
  12  * paragraph) shall be included in all copies or substantial portions of the
  13  * Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
  18  * THE AUTHOR(S) AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
  19  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  20  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  21  * USE OR OTHER DEALINGS IN THE SOFTWARE. */
  22
  23 #ifndef R300_WINSYS_H
  24 #define R300_WINSYS_H
  25
  26 /* The public interface header for the r300 pipe driver.
  27  * Any winsys hosting this pipe needs to implement r300_winsys and then
  28  * call r300_create_screen to start things. */
  29
  30 #include "pipe/p_defines.h"
  31 #include "pipe/p_state.h"
  32
  33 #include "r300_defines.h"
  34
  35 struct r300_winsys_screen;
  36
  37 /* Creates a new r300 screen. */
  38 struct pipe_screen* r300_create_screen(struct r300_winsys_screen *rws);
  39
  40 struct r300_winsys_buffer;
  41
  42 /* XXX: this is just a bandaid on larger problems in
  43  * r300_screen_buffer.h which doesn't seem to be fully ported to
  44  * gallium-resources.
  45  */
  46 #define R300_BIND_OQBO  (1<<21)
  47
  48
  49 enum r300_value_id {
  50     R300_VID_PCI_ID,
  51     R300_VID_GB_PIPES,
  52     R300_VID_Z_PIPES,
  53     R300_VID_SQUARE_TILING_SUPPORT
  54 };
  55
  56 struct r300_winsys_screen {
  57     void (*destroy)(struct r300_winsys_screen *ws);
  58
  59     /**
  60      * Buffer management. Buffer attributes are mostly fixed over its lifetime.
  61      *
  62      * Remember that gallium gets to choose the interface it needs, and the
  63      * window systems must then implement that interface (rather than the
  64      * other way around...).
  65      *
  66      * usage is a bitmask of R300_WINSYS_BUFFER_USAGE_PIXEL/VERTEX/INDEX/CONSTANT. This
  67      * usage argument is only an optimization hint, not a guarantee, therefore
  68      * proper behavior must be observed in all circumstances.
  69      *
  70      * alignment indicates the client's alignment requirements, eg for
  71      * SSE instructions.
  72      */
  73     struct r300_winsys_buffer *(*buffer_create)(struct r300_winsys_screen *ws,
  74                                                 unsigned alignment,
  75                                                 unsigned usage,
  76                                                 unsigned size);
  77
  78     /**
  79      * Map the entire data store of a buffer object into the client's address.
  80      * flags is bitmask of R300_WINSYS_BUFFER_USAGE_CPU_READ/WRITE flags.
  81      */
  82     void *(*buffer_map)( struct r300_winsys_screen *ws,
  83                          struct r300_winsys_buffer *buf,
  84                          unsigned usage);
  85
  86     void (*buffer_unmap)( struct r300_winsys_screen *ws,
  87                           struct r300_winsys_buffer *buf );
  88
  89     void (*buffer_destroy)( struct r300_winsys_buffer *buf );
  90
  91
  92     void (*buffer_reference)(struct r300_winsys_screen *rws,
  93                              struct r300_winsys_buffer **pdst,
  94                              struct r300_winsys_buffer *src);
  95
  96     boolean (*buffer_references)(struct r300_winsys_buffer *a,
  97                                  struct r300_winsys_buffer *b);
  98
  99     void (*buffer_flush_range)(struct r300_winsys_screen *rws,
 100                                struct r300_winsys_buffer *buf,
 101                                unsigned offset,
 102                                unsigned length);
 103
 104     /* Add a pipe_resource to the list of buffer objects to validate. */
 105     boolean (*add_buffer)(struct r300_winsys_screen *winsys,
 106                           struct r300_winsys_buffer *buf,
 107                           uint32_t rd,
 108                           uint32_t wd);
 109
 110
 111     /* Revalidate all currently setup pipe_buffers.
 112      * Returns TRUE if a flush is required. */
 113     boolean (*validate)(struct r300_winsys_screen* winsys);
 114
 115     /* Check to see if there's room for commands. */
 116     boolean (*check_cs)(struct r300_winsys_screen* winsys, int size);
 117
 118     /* Start a command emit. */
 119     void (*begin_cs)(struct r300_winsys_screen* winsys,
 120                      int size,
 121                      const char* file,
 122                      const char* function,
 123                      int line);
 124
 125     /* Write a dword to the command buffer. */
 126     void (*write_cs_dword)(struct r300_winsys_screen* winsys, uint32_t dword);
 127
 128     /* Write a relocated dword to the command buffer. */
 129     void (*write_cs_reloc)(struct r300_winsys_screen *winsys,
 130                            struct r300_winsys_buffer *buf,
 131                            uint32_t rd,
 132                            uint32_t wd,
 133                            uint32_t flags);
 134
 135     /* Finish a command emit. */
 136     void (*end_cs)(struct r300_winsys_screen* winsys,
 137                    const char* file,
 138                    const char* function,
 139                    int line);
 140
 141     /* Flush the CS. */
 142     void (*flush_cs)(struct r300_winsys_screen* winsys);
 143
 144     /* winsys flush - callback from winsys when flush required */
 145     void (*set_flush_cb)(struct r300_winsys_screen *winsys,
 146                          void (*flush_cb)(void *), void *data);
 147
 148     void (*reset_bos)(struct r300_winsys_screen *winsys);
 149
 150     void (*buffer_get_tiling)(struct r300_winsys_screen *winsys,
 151                               struct r300_winsys_buffer *buffer,
 152                               enum r300_buffer_tiling *microtiled,
 153                               enum r300_buffer_tiling *macrotiled);
 154
 155     void (*buffer_set_tiling)(struct r300_winsys_screen *winsys,
 156                               struct r300_winsys_buffer *buffer,
 157                               uint32_t pitch,
 158                               enum r300_buffer_tiling microtiled,
 159                               enum r300_buffer_tiling macrotiled);
 160
 161     uint32_t (*get_value)(struct r300_winsys_screen *winsys,
 162                           enum r300_value_id vid);
 163
 164     struct r300_winsys_buffer *(*buffer_from_handle)(struct r300_winsys_screen *winsys,
 165                                                      struct pipe_screen *screen,
 166                                                      struct winsys_handle *whandle,
 167                                                      unsigned *stride);
 168     boolean (*buffer_get_handle)(struct r300_winsys_screen *winsys,
 169                                  struct r300_winsys_buffer *buffer,
 170                                  unsigned stride,
 171                                  struct winsys_handle *whandle);
 172
 173     boolean (*is_buffer_referenced)(struct r300_winsys_screen *winsys,
 174                                     struct r300_winsys_buffer *buffer);
 175
 176
 177 };
 178
 179 struct r300_winsys_screen *
 180 r300_winsys_screen(struct pipe_screen *screen);
 181
 182 #endif /* R300_WINSYS_H */