2 * Copyright © 2012 Intel Corporation
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 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
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
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 NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
26 * Declarations of functions related to marshalling GL calls from a client
27 * thread to a server thread.
33 #include "main/glthread.h"
34 #include "main/context.h"
35 #include "main/macros.h"
37 struct marshal_cmd_base
40 * Type of command. See enum marshal_dispatch_cmd_id.
45 * Size of command, in multiples of 4 bytes, including cmd_base.
51 _mesa_glthread_allocate_command(struct gl_context
*ctx
,
55 struct glthread_state
*glthread
= ctx
->GLThread
;
56 struct glthread_batch
*next
= &glthread
->batches
[glthread
->next
];
57 struct marshal_cmd_base
*cmd_base
;
58 const size_t aligned_size
= ALIGN(size
, 8);
60 if (unlikely(next
->used
+ size
> MARSHAL_MAX_CMD_SIZE
)) {
61 _mesa_glthread_flush_batch(ctx
);
62 next
= &glthread
->batches
[glthread
->next
];
65 cmd_base
= (struct marshal_cmd_base
*)&next
->buffer
[next
->used
];
66 next
->used
+= aligned_size
;
67 cmd_base
->cmd_id
= cmd_id
;
68 cmd_base
->cmd_size
= aligned_size
;
73 * Instead of conditionally handling marshaling previously-bound user vertex
74 * array data in draw calls (deprecated and removed in GL core), we just
75 * disable threading at the point where the user sets a user vertex array.
78 _mesa_glthread_is_non_vbo_vertex_attrib_pointer(const struct gl_context
*ctx
)
80 struct glthread_state
*glthread
= ctx
->GLThread
;
82 return ctx
->API
!= API_OPENGL_CORE
&& !glthread
->vertex_array_is_vbo
;
86 * Instead of conditionally handling marshaling immediate index data in draw
87 * calls (deprecated and removed in GL core), we just disable threading.
90 _mesa_glthread_is_non_vbo_draw_elements(const struct gl_context
*ctx
)
92 struct glthread_state
*glthread
= ctx
->GLThread
;
94 return ctx
->API
!= API_OPENGL_CORE
&& !glthread
->element_array_is_vbo
;
97 #define DEBUG_MARSHAL_PRINT_CALLS 0
100 * This is printed when we have fallen back to a sync. This can happen when
101 * MARSHAL_MAX_CMD_SIZE is exceeded.
104 debug_print_sync_fallback(const char *func
)
106 #if DEBUG_MARSHAL_PRINT_CALLS
107 printf("fallback to sync: %s\n", func
);
113 debug_print_sync(const char *func
)
115 #if DEBUG_MARSHAL_PRINT_CALLS
116 printf("sync: %s\n", func
);
121 debug_print_marshal(const char *func
)
123 #if DEBUG_MARSHAL_PRINT_CALLS
124 printf("marshal: %s\n", func
);
129 debug_print_unmarshal(const char *func
)
131 #if DEBUG_MARSHAL_PRINT_CALLS
132 printf("unmarshal: %s\n", func
);
136 struct _glapi_table
*
137 _mesa_create_marshal_table(const struct gl_context
*ctx
);
140 _mesa_unmarshal_dispatch_cmd(struct gl_context
*ctx
, const void *cmd
);
143 _mesa_post_marshal_hook(struct gl_context
*ctx
)
145 /* This can be enabled for debugging whether a failure is a synchronization
146 * problem between the main thread and the worker thread, or a failure in
147 * how we actually marshal.
150 _mesa_glthread_finish(ctx
);
155 * Checks whether we're on a compat context for code-generated
156 * glBindVertexArray().
158 * In order to decide whether a draw call uses only VBOs for vertex and index
159 * buffers, we track the current vertex and index buffer bindings by
160 * glBindBuffer(). However, the index buffer binding is stored in the vertex
161 * array as opposed to the context. If we were to accurately track whether
162 * the index buffer was a user pointer ot not, we'd have to track it per
163 * vertex array, which would mean synchronizing with the client thread and
164 * looking into the hash table to find the actual vertex array object. That's
165 * more tracking than we'd like to do in the main thread, if possible.
167 * Instead, just punt for now and disable threading on apps using vertex
168 * arrays and compat contexts. Apps using vertex arrays can probably use a
172 _mesa_glthread_is_compat_bind_vertex_array(const struct gl_context
*ctx
)
174 return ctx
->API
!= API_OPENGL_CORE
;
177 struct marshal_cmd_Enable
;
178 struct marshal_cmd_ShaderSource
;
179 struct marshal_cmd_Flush
;
180 struct marshal_cmd_BindBuffer
;
181 struct marshal_cmd_BufferData
;
182 struct marshal_cmd_BufferSubData
;
183 struct marshal_cmd_NamedBufferData
;
184 struct marshal_cmd_NamedBufferSubData
;
185 struct marshal_cmd_ClearBuffer
;
186 #define marshal_cmd_ClearBufferfv marshal_cmd_ClearBuffer
187 #define marshal_cmd_ClearBufferiv marshal_cmd_ClearBuffer
188 #define marshal_cmd_ClearBufferuiv marshal_cmd_ClearBuffer
189 #define marshal_cmd_ClearBufferfi marshal_cmd_ClearBuffer
192 _mesa_unmarshal_Enable(struct gl_context
*ctx
,
193 const struct marshal_cmd_Enable
*cmd
);
196 _mesa_marshal_Enable(GLenum cap
);
199 _mesa_marshal_ShaderSource(GLuint shader
, GLsizei count
,
200 const GLchar
* const *string
, const GLint
*length
);
203 _mesa_unmarshal_ShaderSource(struct gl_context
*ctx
,
204 const struct marshal_cmd_ShaderSource
*cmd
);
207 _mesa_marshal_Flush(void);
210 _mesa_unmarshal_Flush(struct gl_context
*ctx
,
211 const struct marshal_cmd_Flush
*cmd
);
214 _mesa_marshal_BindBuffer(GLenum target
, GLuint buffer
);
217 _mesa_unmarshal_BindBuffer(struct gl_context
*ctx
,
218 const struct marshal_cmd_BindBuffer
*cmd
);
221 _mesa_unmarshal_BufferData(struct gl_context
*ctx
,
222 const struct marshal_cmd_BufferData
*cmd
);
225 _mesa_marshal_BufferData(GLenum target
, GLsizeiptr size
, const GLvoid
* data
,
229 _mesa_unmarshal_BufferSubData(struct gl_context
*ctx
,
230 const struct marshal_cmd_BufferSubData
*cmd
);
233 _mesa_marshal_BufferSubData(GLenum target
, GLintptr offset
, GLsizeiptr size
,
234 const GLvoid
* data
);
237 _mesa_unmarshal_NamedBufferData(struct gl_context
*ctx
,
238 const struct marshal_cmd_NamedBufferData
*cmd
);
241 _mesa_marshal_NamedBufferData(GLuint buffer
, GLsizeiptr size
,
242 const GLvoid
* data
, GLenum usage
);
245 _mesa_unmarshal_NamedBufferSubData(struct gl_context
*ctx
,
246 const struct marshal_cmd_NamedBufferSubData
*cmd
);
249 _mesa_marshal_NamedBufferSubData(GLuint buffer
, GLintptr offset
, GLsizeiptr size
,
250 const GLvoid
* data
);
253 _mesa_unmarshal_ClearBufferfv(struct gl_context
*ctx
,
254 const struct marshal_cmd_ClearBuffer
*cmd
);
257 _mesa_marshal_ClearBufferfv(GLenum buffer
, GLint drawbuffer
,
258 const GLfloat
*value
);
261 _mesa_unmarshal_ClearBufferiv(struct gl_context
*ctx
,
262 const struct marshal_cmd_ClearBuffer
*cmd
);
265 _mesa_marshal_ClearBufferiv(GLenum buffer
, GLint drawbuffer
,
269 _mesa_unmarshal_ClearBufferuiv(struct gl_context
*ctx
,
270 const struct marshal_cmd_ClearBuffer
*cmd
);
273 _mesa_marshal_ClearBufferuiv(GLenum buffer
, GLint drawbuffer
,
274 const GLuint
*value
);
277 _mesa_unmarshal_ClearBufferfi(struct gl_context
*ctx
,
278 const struct marshal_cmd_ClearBuffer
*cmd
);
281 _mesa_marshal_ClearBufferfi(GLenum buffer
, GLint drawbuffer
,
282 const GLfloat depth
, const GLint stencil
);
284 #endif /* MARSHAL_H */