2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * (C) Copyright IBM Corporation 2006
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * BRIAN PAUL OR IBM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
22 * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
23 * OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
30 * Functions for the GL_APPLE_vertex_array_object extension.
33 * The code in this file borrows a lot from bufferobj.c. There's a certain
34 * amount of cruft left over from that origin that may be unnecessary.
36 * \author Ian Romanick <idr@us.ibm.com>
45 #if FEATURE_ARB_vertex_buffer_object
46 #include "bufferobj.h"
49 #include "glapi/dispatch.h"
53 * Look up the array object for the given ID.
56 * Either a pointer to the array object with the specified ID or \c NULL for
57 * a non-existent ID. The spec defines ID 0 as being technically
61 static INLINE
struct gl_array_object
*
62 lookup_arrayobj(GLcontext
*ctx
, GLuint id
)
66 : (struct gl_array_object
*) _mesa_HashLookup(ctx
->Shared
->ArrayObjects
,
72 * For all the vertex arrays in the array object, unbind any pointers
73 * to any buffer objects (VBOs).
74 * This is done just prior to array object destruction.
77 unbind_array_object_vbos(GLcontext
*ctx
, struct gl_array_object
*obj
)
81 _mesa_reference_buffer_object(ctx
, &obj
->Vertex
.BufferObj
, NULL
);
82 _mesa_reference_buffer_object(ctx
, &obj
->Normal
.BufferObj
, NULL
);
83 _mesa_reference_buffer_object(ctx
, &obj
->Color
.BufferObj
, NULL
);
84 _mesa_reference_buffer_object(ctx
, &obj
->SecondaryColor
.BufferObj
, NULL
);
85 _mesa_reference_buffer_object(ctx
, &obj
->FogCoord
.BufferObj
, NULL
);
86 _mesa_reference_buffer_object(ctx
, &obj
->Index
.BufferObj
, NULL
);
87 _mesa_reference_buffer_object(ctx
, &obj
->EdgeFlag
.BufferObj
, NULL
);
89 for (i
= 0; i
< MAX_TEXTURE_COORD_UNITS
; i
++)
90 _mesa_reference_buffer_object(ctx
, &obj
->TexCoord
[i
].BufferObj
, NULL
);
92 for (i
= 0; i
< VERT_ATTRIB_MAX
; i
++)
93 _mesa_reference_buffer_object(ctx
, &obj
->VertexAttrib
[i
].BufferObj
,NULL
);
98 * Allocate and initialize a new vertex array object.
100 * This function is intended to be called via
101 * \c dd_function_table::NewArrayObject.
103 struct gl_array_object
*
104 _mesa_new_array_object( GLcontext
*ctx
, GLuint name
)
106 struct gl_array_object
*obj
= CALLOC_STRUCT(gl_array_object
);
108 _mesa_initialize_array_object(ctx
, obj
, name
);
114 * Delete an array object.
116 * This function is intended to be called via
117 * \c dd_function_table::DeleteArrayObject.
120 _mesa_delete_array_object( GLcontext
*ctx
, struct gl_array_object
*obj
)
123 unbind_array_object_vbos(ctx
, obj
);
124 _glthread_DESTROY_MUTEX(obj
->Mutex
);
130 * Set ptr to arrayObj w/ reference counting.
133 _mesa_reference_array_object(GLcontext
*ctx
,
134 struct gl_array_object
**ptr
,
135 struct gl_array_object
*arrayObj
)
137 if (*ptr
== arrayObj
)
141 /* Unreference the old array object */
142 GLboolean deleteFlag
= GL_FALSE
;
143 struct gl_array_object
*oldObj
= *ptr
;
145 _glthread_LOCK_MUTEX(oldObj
->Mutex
);
146 ASSERT(oldObj
->RefCount
> 0);
149 printf("ArrayObj %p %d DECR to %d\n",
150 (void *) oldObj
, oldObj
->Name
, oldObj
->RefCount
);
152 deleteFlag
= (oldObj
->RefCount
== 0);
153 _glthread_UNLOCK_MUTEX(oldObj
->Mutex
);
156 ASSERT(ctx
->Driver
.DeleteArrayObject
);
157 ctx
->Driver
.DeleteArrayObject(ctx
, oldObj
);
165 /* reference new array object */
166 _glthread_LOCK_MUTEX(arrayObj
->Mutex
);
167 if (arrayObj
->RefCount
== 0) {
168 /* this array's being deleted (look just above) */
169 /* Not sure this can every really happen. Warn if it does. */
170 _mesa_problem(NULL
, "referencing deleted array object");
174 arrayObj
->RefCount
++;
176 printf("ArrayObj %p %d INCR to %d\n",
177 (void *) arrayObj
, arrayObj
->Name
, arrayObj
->RefCount
);
181 _glthread_UNLOCK_MUTEX(arrayObj
->Mutex
);
188 init_array(GLcontext
*ctx
,
189 struct gl_client_array
*array
, GLint size
, GLint type
)
193 array
->Format
= GL_RGBA
; /* only significant for GL_EXT_vertex_array_bgra */
197 array
->Enabled
= GL_FALSE
;
198 array
->Normalized
= GL_FALSE
;
199 #if FEATURE_ARB_vertex_buffer_object
200 /* Vertex array buffers */
201 array
->BufferObj
= ctx
->Array
.NullBufferObj
;
207 * Initialize a gl_array_object's arrays.
210 _mesa_initialize_array_object( GLcontext
*ctx
,
211 struct gl_array_object
*obj
,
218 _glthread_INIT_MUTEX(obj
->Mutex
);
221 /* Init the individual arrays */
222 init_array(ctx
, &obj
->Vertex
, 4, GL_FLOAT
);
223 init_array(ctx
, &obj
->Normal
, 3, GL_FLOAT
);
224 init_array(ctx
, &obj
->Color
, 4, GL_FLOAT
);
225 init_array(ctx
, &obj
->SecondaryColor
, 4, GL_FLOAT
);
226 init_array(ctx
, &obj
->FogCoord
, 1, GL_FLOAT
);
227 init_array(ctx
, &obj
->Index
, 1, GL_FLOAT
);
228 for (i
= 0; i
< MAX_TEXTURE_COORD_UNITS
; i
++) {
229 init_array(ctx
, &obj
->TexCoord
[i
], 4, GL_FLOAT
);
231 init_array(ctx
, &obj
->EdgeFlag
, 1, GL_BOOL
);
232 for (i
= 0; i
< VERT_ATTRIB_MAX
; i
++) {
233 init_array(ctx
, &obj
->VertexAttrib
[i
], 4, GL_FLOAT
);
236 #if FEATURE_point_size_array
237 init_array(ctx
, &obj
->PointSize
, 1, GL_FLOAT
);
243 * Add the given array object to the array object pool.
246 _mesa_save_array_object( GLcontext
*ctx
, struct gl_array_object
*obj
)
249 /* insert into hash table */
250 _mesa_HashInsert(ctx
->Shared
->ArrayObjects
, obj
->Name
, obj
);
256 * Remove the given array object from the array object pool.
257 * Do not deallocate the array object though.
260 _mesa_remove_array_object( GLcontext
*ctx
, struct gl_array_object
*obj
)
263 /* remove from hash table */
264 _mesa_HashRemove(ctx
->Shared
->ArrayObjects
, obj
->Name
);
269 /**********************************************************************/
271 /**********************************************************************/
277 * The binding could be done more efficiently by comparing the non-NULL
278 * pointers in the old and new objects. The only arrays that are "dirty" are
279 * the ones that are non-NULL in either object.
282 _mesa_BindVertexArrayAPPLE( GLuint id
)
284 GET_CURRENT_CONTEXT(ctx
);
285 struct gl_array_object
* const oldObj
= ctx
->Array
.ArrayObj
;
286 struct gl_array_object
*newObj
= NULL
;
287 ASSERT_OUTSIDE_BEGIN_END(ctx
);
289 ASSERT(oldObj
!= NULL
);
291 if ( oldObj
->Name
== id
)
292 return; /* rebinding the same array object- no change */
295 * Get pointer to new array object (newObj)
298 /* The spec says there is no array object named 0, but we use
299 * one internally because it simplifies things.
301 newObj
= ctx
->Array
.DefaultArrayObj
;
304 /* non-default array object */
305 newObj
= lookup_arrayobj(ctx
, id
);
307 /* If this is a new array object id, allocate an array object now.
309 newObj
= (*ctx
->Driver
.NewArrayObject
)(ctx
, id
);
311 _mesa_error(ctx
, GL_OUT_OF_MEMORY
, "glBindVertexArrayAPPLE");
314 _mesa_save_array_object(ctx
, newObj
);
318 ctx
->NewState
|= _NEW_ARRAY
;
319 ctx
->Array
.NewState
|= _NEW_ARRAY_ALL
;
320 _mesa_reference_array_object(ctx
, &ctx
->Array
.ArrayObj
, newObj
);
322 /* Pass BindVertexArray call to device driver */
323 if (ctx
->Driver
.BindArrayObject
&& newObj
)
324 (*ctx
->Driver
.BindArrayObject
)( ctx
, newObj
);
329 * Delete a set of array objects.
331 * \param n Number of array objects to delete.
332 * \param ids Array of \c n array object IDs.
335 _mesa_DeleteVertexArraysAPPLE(GLsizei n
, const GLuint
*ids
)
337 GET_CURRENT_CONTEXT(ctx
);
339 ASSERT_OUTSIDE_BEGIN_END(ctx
);
342 _mesa_error(ctx
, GL_INVALID_VALUE
, "glDeleteVertexArrayAPPLE(n)");
346 _glthread_LOCK_MUTEX(ctx
->Shared
->Mutex
);
348 for (i
= 0; i
< n
; i
++) {
349 struct gl_array_object
*obj
= lookup_arrayobj(ctx
, ids
[i
]);
352 ASSERT( obj
->Name
== ids
[i
] );
354 /* If the array object is currently bound, the spec says "the binding
355 * for that object reverts to zero and the default vertex array
358 if ( obj
== ctx
->Array
.ArrayObj
) {
359 CALL_BindVertexArrayAPPLE( ctx
->Exec
, (0) );
362 /* The ID is immediately freed for re-use */
363 _mesa_remove_array_object(ctx
, obj
);
365 /* Unreference the array object.
366 * If refcount hits zero, the object will be deleted.
368 _mesa_reference_array_object(ctx
, &obj
, NULL
);
372 _glthread_UNLOCK_MUTEX(ctx
->Shared
->Mutex
);
377 * Generate a set of unique array object IDs and store them in \c arrays.
379 * \param n Number of IDs to generate.
380 * \param arrays Array of \c n locations to store the IDs.
383 _mesa_GenVertexArraysAPPLE(GLsizei n
, GLuint
*arrays
)
385 GET_CURRENT_CONTEXT(ctx
);
388 ASSERT_OUTSIDE_BEGIN_END(ctx
);
391 _mesa_error(ctx
, GL_INVALID_VALUE
, "glGenVertexArraysAPPLE");
400 * This must be atomic (generation and allocation of array object IDs)
402 _glthread_LOCK_MUTEX(ctx
->Shared
->Mutex
);
404 first
= _mesa_HashFindFreeKeyBlock(ctx
->Shared
->ArrayObjects
, n
);
406 /* Allocate new, empty array objects and return identifiers */
407 for (i
= 0; i
< n
; i
++) {
408 struct gl_array_object
*obj
;
409 GLuint name
= first
+ i
;
411 obj
= (*ctx
->Driver
.NewArrayObject
)( ctx
, name
);
413 _glthread_UNLOCK_MUTEX(ctx
->Shared
->Mutex
);
414 _mesa_error(ctx
, GL_OUT_OF_MEMORY
, "glGenVertexArraysAPPLE");
417 _mesa_save_array_object(ctx
, obj
);
418 arrays
[i
] = first
+ i
;
421 _glthread_UNLOCK_MUTEX(ctx
->Shared
->Mutex
);
426 * Determine if ID is the name of an array object.
428 * \param id ID of the potential array object.
429 * \return \c GL_TRUE if \c id is the name of a array object,
430 * \c GL_FALSE otherwise.
433 _mesa_IsVertexArrayAPPLE( GLuint id
)
435 struct gl_array_object
* obj
;
436 GET_CURRENT_CONTEXT(ctx
);
437 ASSERT_OUTSIDE_BEGIN_END_WITH_RETVAL(ctx
, GL_FALSE
);
442 _glthread_LOCK_MUTEX(ctx
->Shared
->Mutex
);
443 obj
= lookup_arrayobj(ctx
, id
);
444 _glthread_UNLOCK_MUTEX(ctx
->Shared
->Mutex
);
446 return (obj
!= NULL
) ? GL_TRUE
: GL_FALSE
;