mesa: Restore 78-column wrapping of license text in C-style comments.
[mesa.git] / src / mesa / main / fbobject.h
1 /*
2 * Mesa 3-D graphics library
3 * Version: 7.1
4 *
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 *
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the "Software"),
9 * to deal in the Software without restriction, including without limitation
10 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
13 *
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
16 *
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
21 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
22 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
23 * OTHER DEALINGS IN THE SOFTWARE.
24 */
25
26
27 #ifndef FBOBJECT_H
28 #define FBOBJECT_H
29
30 #include "compiler.h"
31 #include "glheader.h"
32
33 struct gl_context;
34 struct gl_texture_object;
35
36
37 /**
38 * Is the given FBO a user-created FBO?
39 */
40 static inline GLboolean
41 _mesa_is_user_fbo(const struct gl_framebuffer *fb)
42 {
43 return fb->Name != 0;
44 }
45
46
47 /**
48 * Is the given FBO a window system FBO (like an X window)?
49 */
50 static inline GLboolean
51 _mesa_is_winsys_fbo(const struct gl_framebuffer *fb)
52 {
53 return fb->Name == 0;
54 }
55
56
57
58 extern void
59 _mesa_init_fbobjects(struct gl_context *ctx);
60
61 extern struct gl_framebuffer *
62 _mesa_get_incomplete_framebuffer(void);
63
64 extern struct gl_renderbuffer *
65 _mesa_lookup_renderbuffer(struct gl_context *ctx, GLuint id);
66
67 extern struct gl_framebuffer *
68 _mesa_lookup_framebuffer(struct gl_context *ctx, GLuint id);
69
70 extern struct gl_renderbuffer_attachment *
71 _mesa_get_attachment(struct gl_context *ctx, struct gl_framebuffer *fb,
72 GLenum attachment);
73
74
75 /** Return the texture image for a renderbuffer attachment */
76 static inline struct gl_texture_image *
77 _mesa_get_attachment_teximage(struct gl_renderbuffer_attachment *att)
78 {
79 assert(att->Type == GL_TEXTURE);
80 return att->Texture->Image[att->CubeMapFace][att->TextureLevel];
81 }
82
83
84 /** Return the (const) texture image for a renderbuffer attachment */
85 static inline const struct gl_texture_image *
86 _mesa_get_attachment_teximage_const(const struct gl_renderbuffer_attachment *att)
87 {
88 assert(att->Type == GL_TEXTURE);
89 return att->Texture->Image[att->CubeMapFace][att->TextureLevel];
90 }
91
92
93 extern void
94 _mesa_remove_attachment(struct gl_context *ctx,
95 struct gl_renderbuffer_attachment *att);
96
97 extern void
98 _mesa_set_texture_attachment(struct gl_context *ctx,
99 struct gl_framebuffer *fb,
100 struct gl_renderbuffer_attachment *att,
101 struct gl_texture_object *texObj,
102 GLenum texTarget, GLuint level, GLuint zoffset);
103
104 extern void
105 _mesa_set_renderbuffer_attachment(struct gl_context *ctx,
106 struct gl_renderbuffer_attachment *att,
107 struct gl_renderbuffer *rb);
108
109 extern void
110 _mesa_framebuffer_renderbuffer(struct gl_context *ctx,
111 struct gl_framebuffer *fb,
112 GLenum attachment, struct gl_renderbuffer *rb);
113
114 extern void
115 _mesa_validate_framebuffer(struct gl_context *ctx, struct gl_framebuffer *fb);
116
117 extern GLboolean
118 _mesa_has_depthstencil_combined(const struct gl_framebuffer *fb);
119
120 extern void
121 _mesa_test_framebuffer_completeness(struct gl_context *ctx,
122 struct gl_framebuffer *fb);
123
124 extern GLboolean
125 _mesa_is_legal_color_format(const struct gl_context *ctx, GLenum baseFormat);
126
127 extern GLenum
128 _mesa_base_fbo_format(struct gl_context *ctx, GLenum internalFormat);
129
130 extern GLboolean GLAPIENTRY
131 _mesa_IsRenderbuffer(GLuint renderbuffer);
132
133 extern void GLAPIENTRY
134 _mesa_BindRenderbuffer(GLenum target, GLuint renderbuffer);
135
136 extern void GLAPIENTRY
137 _mesa_DeleteRenderbuffers(GLsizei n, const GLuint *renderbuffers);
138
139 extern void GLAPIENTRY
140 _mesa_GenRenderbuffers(GLsizei n, GLuint *renderbuffers);
141
142 extern void GLAPIENTRY
143 _mesa_RenderbufferStorage(GLenum target, GLenum internalformat,
144 GLsizei width, GLsizei height);
145
146 extern void GLAPIENTRY
147 _mesa_RenderbufferStorageMultisample(GLenum target, GLsizei samples,
148 GLenum internalformat,
149 GLsizei width, GLsizei height);
150
151 extern void GLAPIENTRY
152 _es_RenderbufferStorageEXT(GLenum target, GLenum internalFormat,
153 GLsizei width, GLsizei height);
154
155 extern void GLAPIENTRY
156 _mesa_EGLImageTargetRenderbufferStorageOES(GLenum target, GLeglImageOES image);
157
158 extern void GLAPIENTRY
159 _mesa_GetRenderbufferParameteriv(GLenum target, GLenum pname,
160 GLint *params);
161
162 extern GLboolean GLAPIENTRY
163 _mesa_IsFramebuffer(GLuint framebuffer);
164
165 extern void GLAPIENTRY
166 _mesa_BindFramebuffer(GLenum target, GLuint framebuffer);
167
168 extern void GLAPIENTRY
169 _mesa_DeleteFramebuffers(GLsizei n, const GLuint *framebuffers);
170
171 extern void GLAPIENTRY
172 _mesa_GenFramebuffers(GLsizei n, GLuint *framebuffers);
173
174 extern GLenum GLAPIENTRY
175 _mesa_CheckFramebufferStatus(GLenum target);
176
177 extern void GLAPIENTRY
178 _mesa_FramebufferTexture1D(GLenum target, GLenum attachment,
179 GLenum textarget, GLuint texture, GLint level);
180
181 extern void GLAPIENTRY
182 _mesa_FramebufferTexture2D(GLenum target, GLenum attachment,
183 GLenum textarget, GLuint texture, GLint level);
184
185 extern void GLAPIENTRY
186 _mesa_FramebufferTexture3D(GLenum target, GLenum attachment,
187 GLenum textarget, GLuint texture,
188 GLint level, GLint zoffset);
189
190 extern void GLAPIENTRY
191 _mesa_FramebufferTextureLayer(GLenum target, GLenum attachment,
192 GLuint texture, GLint level, GLint layer);
193
194 extern void GLAPIENTRY
195 _mesa_FramebufferRenderbuffer(GLenum target, GLenum attachment,
196 GLenum renderbuffertarget,
197 GLuint renderbuffer);
198
199 extern void GLAPIENTRY
200 _mesa_GetFramebufferAttachmentParameteriv(GLenum target, GLenum attachment,
201 GLenum pname, GLint *params);
202
203 extern void GLAPIENTRY
204 _mesa_GenerateMipmap(GLenum target);
205
206
207 extern void GLAPIENTRY
208 _mesa_BlitFramebuffer(GLint srcX0, GLint srcY0, GLint srcX1, GLint srcY1,
209 GLint dstX0, GLint dstY0, GLint dstX1, GLint dstY1,
210 GLbitfield mask, GLenum filter);
211
212 extern void GLAPIENTRY
213 _mesa_InvalidateSubFramebuffer(GLenum target, GLsizei numAttachments,
214 const GLenum *attachments, GLint x, GLint y,
215 GLsizei width, GLsizei height);
216
217 extern void GLAPIENTRY
218 _mesa_InvalidateFramebuffer(GLenum target, GLsizei numAttachments,
219 const GLenum *attachments);
220
221 extern void GLAPIENTRY
222 _mesa_DiscardFramebufferEXT(GLenum target, GLsizei numAttachments,
223 const GLenum *attachments);
224
225 #endif /* FBOBJECT_H */