mirror of
https://gitlab.freedesktop.org/mesa/mesa.git
synced 2026-02-04 21:30:26 +01:00
93bdad3253
While a context only has a single glthread, the context itself can be attached to several threads. Therefore the dispatch table must be updated in all threads before the destruction of glthread. In others words, glthread can only be destroyed safely when the context is deleted. Fixes remaining crashes in the glx-multithread-makecurrent* tests. V2: (Timothy Arceri) updated gl_API.dtd marshal_fail description. Signed-off-by: Gregory Hainaut <gregory.hainaut@gmail.com> Acked-by: Timothy Arceri <tarceri@itsqueeze.com> Acked-by: Marek Olšák <maraeo@gmail.com> Tested-by: Dieter Nützel <Dieter@nuetzel-hh.de> Tested-by: Mike Lothian <mike@fireburn.co.uk>
158 lines
8.4 KiB
DTD
158 lines
8.4 KiB
DTD
<!ELEMENT OpenGLAPI (category?, xi:include?, OpenGLAPI?)+>
|
|
<!ELEMENT category (type*, enum*, function*)*>
|
|
<!ELEMENT type EMPTY>
|
|
<!ELEMENT enum (size*)>
|
|
<!ELEMENT size EMPTY>
|
|
<!ELEMENT function (param*, return?, glx?)*>
|
|
<!ELEMENT param EMPTY>
|
|
<!ELEMENT return EMPTY>
|
|
<!ELEMENT glx EMPTY>
|
|
|
|
<!ELEMENT xi:include (xi:fallback)?>
|
|
<!ATTLIST xi:include
|
|
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude"
|
|
href CDATA #REQUIRED
|
|
parse (xml|text) "xml"
|
|
encoding CDATA #IMPLIED>
|
|
<!ELEMENT xi:fallback ANY>
|
|
<!ATTLIST xi:fallback
|
|
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude">
|
|
|
|
|
|
<!ATTLIST category name NMTOKEN #REQUIRED
|
|
number NMTOKEN #IMPLIED
|
|
window_system NMTOKEN #IMPLIED>
|
|
<!ATTLIST type name NMTOKEN #REQUIRED
|
|
size NMTOKEN #REQUIRED
|
|
float (true | false) "false"
|
|
unsigned (true | false) "false"
|
|
pointer (true | false) "false"
|
|
glx_name NMTOKEN #IMPLIED>
|
|
<!ATTLIST enum name NMTOKEN #REQUIRED
|
|
count CDATA #IMPLIED
|
|
value NMTOKEN #REQUIRED>
|
|
<!ATTLIST function name NMTOKEN #REQUIRED
|
|
alias NMTOKEN #IMPLIED
|
|
vectorequiv NMTOKEN #IMPLIED
|
|
es1 CDATA "none"
|
|
es2 CDATA "none"
|
|
deprecated CDATA "none"
|
|
exec NMTOKEN #IMPLIED
|
|
desktop (true | false) "true"
|
|
marshal NMTOKEN #IMPLIED
|
|
marshal_fail CDATA #IMPLIED>
|
|
<!ATTLIST size name NMTOKEN #REQUIRED
|
|
count NMTOKEN #IMPLIED
|
|
mode (get | set) "set">
|
|
<!ATTLIST param name NMTOKEN #REQUIRED
|
|
type CDATA #REQUIRED
|
|
client_only (true | false) "false"
|
|
count NMTOKEN #IMPLIED
|
|
counter (true | false) "false"
|
|
count_scale NMTOKEN "1"
|
|
output (true | false) "false"
|
|
padding (true | false) "false"
|
|
img_width NMTOKEN #IMPLIED
|
|
img_height NMTOKEN #IMPLIED
|
|
img_depth NMTOKEN #IMPLIED
|
|
img_extent NMTOKEN #IMPLIED
|
|
img_xoff NMTOKEN #IMPLIED
|
|
img_yoff NMTOKEN #IMPLIED
|
|
img_zoff NMTOKEN #IMPLIED
|
|
img_woff NMTOKEN #IMPLIED
|
|
img_format NMTOKEN #IMPLIED
|
|
img_type NMTOKEN #IMPLIED
|
|
img_target NMTOKEN #IMPLIED
|
|
img_send_null (true | false) "false"
|
|
img_null_flag (true | false) "false"
|
|
img_pad_dimensions (true | false) "false"
|
|
variable_param NMTOKENS #IMPLIED>
|
|
<!ATTLIST return type CDATA "void">
|
|
<!ATTLIST glx rop NMTOKEN #IMPLIED
|
|
sop NMTOKEN #IMPLIED
|
|
vendorpriv NMTOKEN #IMPLIED
|
|
large (true | false) "false"
|
|
doubles_in_order (true | false) "false"
|
|
always_array (true | false) "false"
|
|
handcode (true | false | client | server) "false"
|
|
img_reset NMTOKEN #IMPLIED
|
|
dimensions_in_reply (true | false) "false"
|
|
ignore (true | false) "false">
|
|
|
|
<!--
|
|
The various attributes for param and glx have the meanings listed below.
|
|
When adding new functions, please annote them correctly. In most cases this
|
|
will just mean adding a '<glx ignore="true"/>' tag.
|
|
|
|
param:
|
|
name - name of the parameter
|
|
type - fully qualified type (e.g., with "const", etc.)
|
|
client_only - boolean flag set on parameters which are interpreted only
|
|
by the client and are not present in the protocol encoding (e.g.,
|
|
the stride parameters to Map1f, etc.)
|
|
count - for counted arrays (e.g., the 'lists' parameter to glCallLists),
|
|
the parameter or literal that represents the count. For functions
|
|
like glVertex3fv it will be a literal, for others it will be one of
|
|
the parameters.
|
|
counter - this parameter is a counter that will be referenced by the
|
|
'count' attribute in another parameter.
|
|
count_scale - literal value scale factor for the 'count' attribute.
|
|
See ProgramParameters4dvNV for an example.
|
|
output - this parameter is used to store the output of the function.
|
|
variable_param - name of parameter used to determine the number of
|
|
elements referenced by this parameter. This should be the name of a
|
|
single enum parameter. Most of the gl*Parameter[if]v functions use
|
|
this. Additionally, the enums that can be passed should be properly
|
|
annotated.
|
|
img_width / img_height / img_depth / img_extent - name of parameters
|
|
(or hardcoded integer) used for the dimensions of pixel data.
|
|
img_xoff / img_yoff / img_zoff / img_woff - name of parameters used
|
|
for x, y, z, and w offsets of pixel data.
|
|
img_format - name of parameter used as the pixel data format.
|
|
img_type - name of parameter used as the pixel data type.
|
|
img_target - name of parameter used as a texture target. Non-texture
|
|
pixel data should hardcode 0.
|
|
img_send_null - boolean flag to determine if blank pixel data should
|
|
be sent when a NULL pointer is passed. This is only used by
|
|
TexImage1D and TexImage2D.
|
|
img_null_flag - boolean flag to determine if an extra flag is used to
|
|
determine if a NULL pixel pointer was passed. This is used by
|
|
TexSubImage1D, TexSubImage2D, TexImage3D and others.
|
|
img_pad_dimensions - boolean flag to determine if dimension data and
|
|
offset data should be padded to the next even number of dimensions.
|
|
For example, this will insert an empty "height" field after the
|
|
"width" field in the protocol for TexImage1D.
|
|
marshal - One of "sync", "async", "draw", or "custom", defaulting to
|
|
async unless one of the arguments is something we know we can't
|
|
codegen for. If "sync", we finish any queued glthread work and call
|
|
the Mesa implementation directly. If "async", we queue the function
|
|
call to be performed by glthread. If "custom", the prototype will be
|
|
generated but a custom implementation will be present in marshal.c.
|
|
If "draw", it will follow the "async" rules except that "indices" are
|
|
ignored (since they may come from a VBO).
|
|
marshal_fail - an expression that, if it evaluates true, causes glthread
|
|
to switch back to the Mesa implementation and call it directly. Used
|
|
to disable glthread for GL compatibility interactions that we don't
|
|
want to track state for.
|
|
|
|
glx:
|
|
rop - Opcode value for "render" commands
|
|
sop - Opcode value for "single" commands
|
|
vendorpriv - Opcode value for vendor private (or vendor private with
|
|
reply) commands
|
|
large - set to "true" of the render command can use RenderLarge protocol.
|
|
doubles_in_order - older commands always put GLdouble data at the
|
|
start of the render packet. Newer commands (e.g.,
|
|
ProgramEnvParameter4dvARB) put the in the order that they appear
|
|
in the parameter list.
|
|
always_array - some single commands take reply data as an array or as
|
|
return value data (e.g., glGetLightfv). Other single commands take
|
|
reply data only as an array (e.g., glGetClipPlane).
|
|
handcode - some functions are just too complicated to generate
|
|
(e.g., glSeperableFilter2D) or operate only on client-side data
|
|
(e.g., glVertexPointer) and must be handcoded.
|
|
ignore - some functions have an entry in the dispatch table, but aren't
|
|
suitable for protocol implementation (e.g., glLockArraysEXT). This
|
|
also applies to functions that don't have any GLX protocol specified
|
|
(e.g., glGetFogFuncSGIS).
|
|
-->
|