gallium: No longer allow CPU mapping surfaces directly.
[mesa.git] / src / gallium / include / pipe / p_inlines.h
1 /**************************************************************************
2 *
3 * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas.
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 TUNGSTEN GRAPHICS 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 #ifndef P_INLINES_H
29 #define P_INLINES_H
30
31 #include "p_context.h"
32 #include "p_defines.h"
33 #include "p_screen.h"
34
35
36 #ifdef __cplusplus
37 extern "C" {
38 #endif
39
40
41 /**
42 * Set 'ptr' to point to 'surf' and update reference counting.
43 * The old thing pointed to, if any, will be unreferenced first.
44 * 'surf' may be NULL.
45 */
46 static INLINE void
47 pipe_surface_reference(struct pipe_surface **ptr, struct pipe_surface *surf)
48 {
49 /* bump the refcount first */
50 if (surf) {
51 assert(surf->refcount);
52 surf->refcount++;
53 }
54
55 if (*ptr) {
56 struct pipe_screen *screen;
57 assert((*ptr)->refcount);
58 assert((*ptr)->texture);
59 screen = (*ptr)->texture->screen;
60 screen->tex_surface_release( screen, ptr );
61 assert(!*ptr);
62 }
63
64 *ptr = surf;
65 }
66
67
68 /**
69 * \sa pipe_surface_reference
70 */
71 static INLINE void
72 pipe_texture_reference(struct pipe_texture **ptr,
73 struct pipe_texture *pt)
74 {
75 assert(ptr);
76
77 if (pt) {
78 assert(pt->refcount);
79 pt->refcount++;
80 }
81
82 if (*ptr) {
83 struct pipe_screen *screen = (*ptr)->screen;
84 assert(screen);
85 assert((*ptr)->refcount);
86 screen->texture_release(screen, ptr);
87
88 assert(!*ptr);
89 }
90
91 *ptr = pt;
92 }
93
94
95 static INLINE void
96 pipe_texture_release(struct pipe_texture **ptr)
97 {
98 struct pipe_screen *screen;
99 assert(ptr);
100 screen = (*ptr)->screen;
101 assert((*ptr)->refcount);
102 screen->texture_release(screen, ptr);
103 *ptr = NULL;
104 }
105
106
107 /**
108 * Convenience wrappers for screen buffer functions.
109 */
110
111 static INLINE struct pipe_buffer *
112 pipe_buffer_create( struct pipe_screen *screen,
113 unsigned alignment, unsigned usage, unsigned size )
114 {
115 return screen->buffer_create(screen, alignment, usage, size);
116 }
117
118 static INLINE struct pipe_buffer *
119 pipe_user_buffer_create( struct pipe_screen *screen, void *ptr, unsigned size )
120 {
121 return screen->user_buffer_create(screen, ptr, size);
122 }
123
124 static INLINE void *
125 pipe_buffer_map(struct pipe_screen *screen,
126 struct pipe_buffer *buf,
127 unsigned usage)
128 {
129 return screen->buffer_map(screen, buf, usage);
130 }
131
132 static INLINE void
133 pipe_buffer_unmap(struct pipe_screen *screen,
134 struct pipe_buffer *buf)
135 {
136 screen->buffer_unmap(screen, buf);
137 }
138
139 /* XXX: thread safety issues!
140 */
141 static INLINE void
142 pipe_buffer_reference(struct pipe_screen *screen,
143 struct pipe_buffer **ptr,
144 struct pipe_buffer *buf)
145 {
146 if (buf) {
147 assert(buf->refcount);
148 buf->refcount++;
149 }
150
151 if (*ptr) {
152 assert((*ptr)->refcount);
153 if(--(*ptr)->refcount == 0) {
154 screen->buffer_destroy( screen, *ptr );
155 }
156 }
157
158 *ptr = buf;
159 }
160
161
162 #ifdef __cplusplus
163 }
164 #endif
165
166 #endif /* P_INLINES_H */