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"
36 struct marshal_cmd_base
39 * Type of command. See enum marshal_dispatch_cmd_id.
44 * Size of command, in multiples of 4 bytes, including cmd_base.
52 _mesa_glthread_allocate_command(struct gl_context
*ctx
,
56 struct glthread_state
*glthread
= ctx
->GLThread
;
57 struct marshal_cmd_base
*cmd_base
;
59 if (unlikely(glthread
->batch
->used
+ size
> MARSHAL_MAX_CMD_SIZE
))
60 _mesa_glthread_flush_batch(ctx
);
62 cmd_base
= (struct marshal_cmd_base
*)
63 &glthread
->batch
->buffer
[glthread
->batch
->used
];
64 glthread
->batch
->used
+= size
;
65 cmd_base
->cmd_id
= cmd_id
;
66 cmd_base
->cmd_size
= size
;
71 * Instead of conditionally handling marshaling previously-bound user vertex
72 * array data in draw calls (deprecated and removed in GL core), we just
73 * disable threading at the point where the user sets a user vertex array.
76 _mesa_glthread_is_non_vbo_vertex_attrib_pointer(const struct gl_context
*ctx
)
78 struct glthread_state
*glthread
= ctx
->GLThread
;
80 return ctx
->API
!= API_OPENGL_CORE
&& !glthread
->vertex_array_is_vbo
;
84 * Instead of conditionally handling marshaling immediate index data in draw
85 * calls (deprecated and removed in GL core), we just disable threading.
88 _mesa_glthread_is_non_vbo_draw_elements(const struct gl_context
*ctx
)
90 struct glthread_state
*glthread
= ctx
->GLThread
;
92 return ctx
->API
!= API_OPENGL_CORE
&& !glthread
->element_array_is_vbo
;
97 /* FIXME: dummy functions for non PTHREAD platforms */
99 _mesa_glthread_allocate_command(struct gl_context
*ctx
,
107 _mesa_glthread_is_non_vbo_vertex_attrib_pointer(const struct gl_context
*ctx
)
113 _mesa_glthread_is_non_vbo_draw_elements(const struct gl_context
*ctx
)
120 #define DEBUG_MARSHAL_PRINT_CALLS 0
123 * This is printed when we have fallen back to a sync. This can happen when
124 * MARSHAL_MAX_CMD_SIZE is exceeded.
127 debug_print_sync_fallback(const char *func
)
129 #if DEBUG_MARSHAL_PRINT_CALLS
130 printf("fallback to sync: %s\n", func
);
136 debug_print_sync(const char *func
)
138 #if DEBUG_MARSHAL_PRINT_CALLS
139 printf("sync: %s\n", func
);
144 debug_print_marshal(const char *func
)
146 #if DEBUG_MARSHAL_PRINT_CALLS
147 printf("marshal: %s\n", func
);
152 debug_print_unmarshal(const char *func
)
154 #if DEBUG_MARSHAL_PRINT_CALLS
155 printf("unmarshal: %s\n", func
);
159 struct _glapi_table
*
160 _mesa_create_marshal_table(const struct gl_context
*ctx
);
163 _mesa_unmarshal_dispatch_cmd(struct gl_context
*ctx
, const void *cmd
);
166 _mesa_post_marshal_hook(struct gl_context
*ctx
)
168 /* This can be enabled for debugging whether a failure is a synchronization
169 * problem between the main thread and the worker thread, or a failure in
170 * how we actually marshal.
173 _mesa_glthread_finish(ctx
);
178 * Checks whether we're on a compat context for code-generated
179 * glBindVertexArray().
181 * In order to decide whether a draw call uses only VBOs for vertex and index
182 * buffers, we track the current vertex and index buffer bindings by
183 * glBindBuffer(). However, the index buffer binding is stored in the vertex
184 * array as opposed to the context. If we were to accurately track whether
185 * the index buffer was a user pointer ot not, we'd have to track it per
186 * vertex array, which would mean synchronizing with the client thread and
187 * looking into the hash table to find the actual vertex array object. That's
188 * more tracking than we'd like to do in the main thread, if possible.
190 * Instead, just punt for now and disable threading on apps using vertex
191 * arrays and compat contexts. Apps using vertex arrays can probably use a
195 _mesa_glthread_is_compat_bind_vertex_array(const struct gl_context
*ctx
)
197 return ctx
->API
!= API_OPENGL_CORE
;
200 struct marshal_cmd_ShaderSource
;
201 struct marshal_cmd_Flush
;
202 struct marshal_cmd_BindBuffer
;
203 struct marshal_cmd_BufferData
;
204 struct marshal_cmd_BufferSubData
;
205 struct marshal_cmd_ClearBufferfv
;
208 _mesa_marshal_ShaderSource(GLuint shader
, GLsizei count
,
209 const GLchar
* const *string
, const GLint
*length
);
212 _mesa_unmarshal_ShaderSource(struct gl_context
*ctx
,
213 const struct marshal_cmd_ShaderSource
*cmd
);
216 _mesa_marshal_Flush(void);
219 _mesa_unmarshal_Flush(struct gl_context
*ctx
,
220 const struct marshal_cmd_Flush
*cmd
);
223 _mesa_marshal_BindBuffer(GLenum target
, GLuint buffer
);
226 _mesa_unmarshal_BindBuffer(struct gl_context
*ctx
,
227 const struct marshal_cmd_BindBuffer
*cmd
);
230 _mesa_unmarshal_BufferData(struct gl_context
*ctx
,
231 const struct marshal_cmd_BufferData
*cmd
);
234 _mesa_marshal_BufferData(GLenum target
, GLsizeiptr size
, const GLvoid
* data
,
238 _mesa_unmarshal_BufferSubData(struct gl_context
*ctx
,
239 const struct marshal_cmd_BufferSubData
*cmd
);
242 _mesa_marshal_BufferSubData(GLenum target
, GLintptr offset
, GLsizeiptr size
,
243 const GLvoid
* data
);
246 _mesa_unmarshal_ClearBufferfv(struct gl_context
*ctx
,
247 const struct marshal_cmd_ClearBufferfv
*cmd
);
250 _mesa_marshal_ClearBufferfv(GLenum buffer
, GLint drawbuffer
,
251 const GLfloat
*value
);
253 #endif /* MARSHAL_H */