1/**************************************************************************
2 *
3 * Copyright 2007-2009 VMware, Inc.
4 * All Rights Reserved.
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
13 *
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
16 * of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 *
26 **************************************************************************/
27
28/**
29 * @file
30 * Software rasterizer winsys.
31 */
32
33
34#ifndef SW_WINSYS_H
35#define SW_WINSYS_H
36
37
38#include "pipe/p_compiler.h" /* for boolean */
39#include "pipe/p_format.h"
40#include "state_tracker/winsys_handle.h"
41
42#ifdef __cplusplus
43extern "C" {
44#endif
45
46
47struct pipe_screen;
48struct pipe_context;
49struct pipe_resource;
50struct pipe_box;
51
52/**
53 * Opaque pointer.
54 */
55struct sw_displaytarget;
56
57
58/**
59 * This is the interface that sw expects any window system
60 * hosting it to implement.
61 *
62 * sw is for the most part a self sufficient driver. The only thing it
63 * does not know is how to display a surface.
64 */
65struct sw_winsys
66{
67   void
68   (*destroy)( struct sw_winsys *ws );
69
70   boolean
71   (*is_displaytarget_format_supported)( struct sw_winsys *ws,
72                                         unsigned tex_usage,
73                                         enum pipe_format format );
74
75   /**
76    * Allocate storage for a render target.
77    *
78    * Often surfaces which are meant to be blitted to the front screen (i.e.,
79    * display targets) must be allocated with special characteristics, memory
80    * pools, or obtained directly from the windowing system.
81    *
82    * This callback is invoked by the pipe_screen when creating a texture marked
83    * with the PIPE_BIND_DISPLAY_TARGET flag to get the underlying
84    * storage.
85    */
86   struct sw_displaytarget *
87   (*displaytarget_create)( struct sw_winsys *ws,
88                            unsigned tex_usage,
89                            enum pipe_format format,
90                            unsigned width, unsigned height,
91                            unsigned alignment,
92                            const void *front_private,
93                            unsigned *stride );
94
95   /**
96    * Used to implement texture_from_handle.
97    */
98   struct sw_displaytarget *
99   (*displaytarget_from_handle)( struct sw_winsys *ws,
100                                 const struct pipe_resource *templat,
101                                 struct winsys_handle *whandle,
102                                 unsigned *stride );
103
104   /**
105    * Used to implement texture_get_handle.
106    */
107   boolean
108   (*displaytarget_get_handle)( struct sw_winsys *ws,
109                                struct sw_displaytarget *dt,
110                                struct winsys_handle *whandle );
111
112   /**
113    * \param flags  bitmask of PIPE_TRANSFER_x flags
114    */
115   void *
116   (*displaytarget_map)( struct sw_winsys *ws,
117                         struct sw_displaytarget *dt,
118                         unsigned flags );
119
120   void
121   (*displaytarget_unmap)( struct sw_winsys *ws,
122                           struct sw_displaytarget *dt );
123
124   /**
125    * @sa pipe_screen:flush_frontbuffer.
126    *
127    * This call will likely become asynchronous eventually.
128    */
129   void
130   (*displaytarget_display)( struct sw_winsys *ws,
131                             struct sw_displaytarget *dt,
132                             void *context_private,
133                             struct pipe_box *box );
134
135   void
136   (*displaytarget_destroy)( struct sw_winsys *ws,
137                             struct sw_displaytarget *dt );
138};
139
140
141
142#ifdef __cplusplus
143}
144#endif
145
146#endif /* SW_WINSYS_H */
147