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.
53 _mesa_glthread_allocate_command(struct gl_context
*ctx
,
57 struct glthread_state
*glthread
= ctx
->GLThread
;
58 struct marshal_cmd_base
*cmd_base
;
59 const size_t aligned_size
= ALIGN(size
, 8);
61 if (unlikely(glthread
->batch
->used
+ size
> MARSHAL_MAX_CMD_SIZE
))
62 _mesa_glthread_flush_batch(ctx
);
64 cmd_base
= (struct marshal_cmd_base
*)
65 &glthread
->batch
->buffer
[glthread
->batch
->used
];
66 glthread
->batch
->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
;
99 /* FIXME: dummy functions for non PTHREAD platforms */
101 _mesa_glthread_allocate_command(struct gl_context
*ctx
,
109 _mesa_glthread_is_non_vbo_vertex_attrib_pointer(const struct gl_context
*ctx
)
115 _mesa_glthread_is_non_vbo_draw_elements(const struct gl_context
*ctx
)
122 #define DEBUG_MARSHAL_PRINT_CALLS 0
125 * This is printed when we have fallen back to a sync. This can happen when
126 * MARSHAL_MAX_CMD_SIZE is exceeded.
129 debug_print_sync_fallback(const char *func
)
131 #if DEBUG_MARSHAL_PRINT_CALLS
132 printf("fallback to sync: %s\n", func
);
138 debug_print_sync(const char *func
)
140 #if DEBUG_MARSHAL_PRINT_CALLS
141 printf("sync: %s\n", func
);
146 debug_print_marshal(const char *func
)
148 #if DEBUG_MARSHAL_PRINT_CALLS
149 printf("marshal: %s\n", func
);
154 debug_print_unmarshal(const char *func
)
156 #if DEBUG_MARSHAL_PRINT_CALLS
157 printf("unmarshal: %s\n", func
);
161 struct _glapi_table
*
162 _mesa_create_marshal_table(const struct gl_context
*ctx
);
165 _mesa_unmarshal_dispatch_cmd(struct gl_context
*ctx
, const void *cmd
);
168 _mesa_post_marshal_hook(struct gl_context
*ctx
)
170 /* This can be enabled for debugging whether a failure is a synchronization
171 * problem between the main thread and the worker thread, or a failure in
172 * how we actually marshal.
175 _mesa_glthread_finish(ctx
);
180 * Checks whether we're on a compat context for code-generated
181 * glBindVertexArray().
183 * In order to decide whether a draw call uses only VBOs for vertex and index
184 * buffers, we track the current vertex and index buffer bindings by
185 * glBindBuffer(). However, the index buffer binding is stored in the vertex
186 * array as opposed to the context. If we were to accurately track whether
187 * the index buffer was a user pointer ot not, we'd have to track it per
188 * vertex array, which would mean synchronizing with the client thread and
189 * looking into the hash table to find the actual vertex array object. That's
190 * more tracking than we'd like to do in the main thread, if possible.
192 * Instead, just punt for now and disable threading on apps using vertex
193 * arrays and compat contexts. Apps using vertex arrays can probably use a
197 _mesa_glthread_is_compat_bind_vertex_array(const struct gl_context
*ctx
)
199 return ctx
->API
!= API_OPENGL_CORE
;
202 struct marshal_cmd_Enable
;
203 struct marshal_cmd_ShaderSource
;
204 struct marshal_cmd_Flush
;
205 struct marshal_cmd_BindBuffer
;
206 struct marshal_cmd_BufferData
;
207 struct marshal_cmd_BufferSubData
;
208 struct marshal_cmd_ClearBufferfv
;
211 _mesa_unmarshal_Enable(struct gl_context
*ctx
,
212 const struct marshal_cmd_Enable
*cmd
);
215 _mesa_marshal_Enable(GLenum cap
);
218 _mesa_marshal_ShaderSource(GLuint shader
, GLsizei count
,
219 const GLchar
* const *string
, const GLint
*length
);
222 _mesa_unmarshal_ShaderSource(struct gl_context
*ctx
,
223 const struct marshal_cmd_ShaderSource
*cmd
);
226 _mesa_marshal_Flush(void);
229 _mesa_unmarshal_Flush(struct gl_context
*ctx
,
230 const struct marshal_cmd_Flush
*cmd
);
233 _mesa_marshal_BindBuffer(GLenum target
, GLuint buffer
);
236 _mesa_unmarshal_BindBuffer(struct gl_context
*ctx
,
237 const struct marshal_cmd_BindBuffer
*cmd
);
240 _mesa_unmarshal_BufferData(struct gl_context
*ctx
,
241 const struct marshal_cmd_BufferData
*cmd
);
244 _mesa_marshal_BufferData(GLenum target
, GLsizeiptr size
, const GLvoid
* data
,
248 _mesa_unmarshal_BufferSubData(struct gl_context
*ctx
,
249 const struct marshal_cmd_BufferSubData
*cmd
);
252 _mesa_marshal_BufferSubData(GLenum target
, GLintptr offset
, GLsizeiptr size
,
253 const GLvoid
* data
);
256 _mesa_unmarshal_ClearBufferfv(struct gl_context
*ctx
,
257 const struct marshal_cmd_ClearBufferfv
*cmd
);
260 _mesa_marshal_ClearBufferfv(GLenum buffer
, GLint drawbuffer
,
261 const GLfloat
*value
);
263 #endif /* MARSHAL_H */