xref: /aosp_15_r20/external/mesa3d/src/mesa/main/renderbuffer.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1 /*
2  * Mesa 3-D graphics library
3  *
4  * Copyright (C) 1999-2005  Brian Paul   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 "Software"),
8  * to deal in the Software without restriction, including without limitation
9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10  * and/or sell copies of the Software, and to permit persons to whom the
11  * Software is furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included
14  * in all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
20  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22  * OTHER DEALINGS IN THE SOFTWARE.
23  */
24 
25 
26 #ifndef RENDERBUFFER_H
27 #define RENDERBUFFER_H
28 
29 #include "util/glheader.h"
30 #include "menums.h"
31 
32 #ifdef __cplusplus
33 extern "C" {
34 #endif
35 
36 struct gl_context;
37 struct gl_framebuffer;
38 struct gl_renderbuffer;
39 
40 extern void
41 _mesa_init_renderbuffer(struct gl_renderbuffer *rb, GLuint name);
42 
43 extern void
44 _mesa_attach_and_own_rb(struct gl_framebuffer *fb,
45                         gl_buffer_index bufferName,
46                         struct gl_renderbuffer *rb);
47 
48 extern void
49 _mesa_attach_and_reference_rb(struct gl_framebuffer *fb,
50                               gl_buffer_index bufferName,
51                               struct gl_renderbuffer *rb);
52 
53 extern void
54 _mesa_remove_renderbuffer(struct gl_framebuffer *fb,
55                           gl_buffer_index bufferName);
56 
57 extern void
58 _mesa_reference_renderbuffer_(struct gl_renderbuffer **ptr,
59                               struct gl_renderbuffer *rb);
60 
61 static inline void
_mesa_reference_renderbuffer(struct gl_renderbuffer ** ptr,struct gl_renderbuffer * rb)62 _mesa_reference_renderbuffer(struct gl_renderbuffer **ptr,
63                              struct gl_renderbuffer *rb)
64 {
65    if (*ptr != rb)
66       _mesa_reference_renderbuffer_(ptr, rb);
67 }
68 
69 void
70 _mesa_map_renderbuffer(struct gl_context *ctx,
71                        struct gl_renderbuffer *rb,
72                        GLuint x, GLuint y, GLuint w, GLuint h,
73                        GLbitfield mode,
74                        GLubyte **mapOut, GLint *rowStrideOut,
75                        bool flip_y);
76 
77 void
78 _mesa_unmap_renderbuffer(struct gl_context *ctx,
79                          struct gl_renderbuffer *rb);
80 
81 void
82 _mesa_regen_renderbuffer_surface(struct gl_context *ctx,
83                                  struct gl_renderbuffer *rb);
84 void
85 _mesa_update_renderbuffer_surface(struct gl_context *ctx,
86                                   struct gl_renderbuffer *rb);
87 #ifdef __cplusplus
88 }
89 #endif
90 
91 #endif /* RENDERBUFFER_H */
92