dd.h revision 4a49301e
1/**
2 * \file dd.h
3 * Device driver interfaces.
4 */
5
6/*
7 * Mesa 3-D graphics library
8 * Version:  6.5.2
9 *
10 * Copyright (C) 1999-2006  Brian Paul   All Rights Reserved.
11 *
12 * Permission is hereby granted, free of charge, to any person obtaining a
13 * copy of this software and associated documentation files (the "Software"),
14 * to deal in the Software without restriction, including without limitation
15 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
16 * and/or sell copies of the Software, and to permit persons to whom the
17 * Software is furnished to do so, subject to the following conditions:
18 *
19 * The above copyright notice and this permission notice shall be included
20 * in all copies or substantial portions of the Software.
21 *
22 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
23 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
24 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
25 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
26 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
27 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
28 */
29
30
31#ifndef DD_INCLUDED
32#define DD_INCLUDED
33
34/* THIS FILE ONLY INCLUDED BY mtypes.h !!!!! */
35
36struct gl_pixelstore_attrib;
37struct gl_display_list;
38
39#if FEATURE_ARB_vertex_buffer_object
40/* Modifies GL_MAP_UNSYNCHRONIZED_BIT to allow driver to fail (return
41 * NULL) if buffer is unavailable for immediate mapping.
42 *
43 * Does GL_MAP_INVALIDATE_RANGE_BIT do this?  It seems so, but it
44 * would require more book-keeping in the driver than seems necessary
45 * at this point.
46 *
47 * Does GL_MAP_INVALDIATE_BUFFER_BIT do this?  Not really -- we don't
48 * want to provoke the driver to throw away the old storage, we will
49 * respect the contents of already referenced data.
50 */
51#define MESA_MAP_NOWAIT_BIT       0x0040
52#endif
53
54
55/**
56 * Device driver function table.
57 * Core Mesa uses these function pointers to call into device drivers.
58 * Most of these functions directly correspond to OpenGL state commands.
59 * Core Mesa will call these functions after error checking has been done
60 * so that the drivers don't have to worry about error testing.
61 *
62 * Vertex transformation/clipping/lighting is patched into the T&L module.
63 * Rasterization functions are patched into the swrast module.
64 *
65 * Note: when new functions are added here, the drivers/common/driverfuncs.c
66 * file should be updated too!!!
67 */
68struct dd_function_table {
69   /**
70    * Return a string as needed by glGetString().
71    * Only the GL_RENDERER query must be implemented.  Otherwise, NULL can be
72    * returned.
73    */
74   const GLubyte * (*GetString)( GLcontext *ctx, GLenum name );
75
76   /**
77    * Notify the driver after Mesa has made some internal state changes.
78    *
79    * This is in addition to any state change callbacks Mesa may already have
80    * made.
81    */
82   void (*UpdateState)( GLcontext *ctx, GLbitfield new_state );
83
84   /**
85    * Get the width and height of the named buffer/window.
86    *
87    * Mesa uses this to determine when the driver's window size has changed.
88    * XXX OBSOLETE: this function will be removed in the future.
89    */
90   void (*GetBufferSize)( GLframebuffer *buffer,
91                          GLuint *width, GLuint *height );
92
93   /**
94    * Resize the given framebuffer to the given size.
95    * XXX OBSOLETE: this function will be removed in the future.
96    */
97   void (*ResizeBuffers)( GLcontext *ctx, GLframebuffer *fb,
98                          GLuint width, GLuint height);
99
100   /**
101    * Called whenever an error is generated.
102    * __GLcontextRec::ErrorValue contains the error value.
103    */
104   void (*Error)( GLcontext *ctx );
105
106   /**
107    * This is called whenever glFinish() is called.
108    */
109   void (*Finish)( GLcontext *ctx );
110
111   /**
112    * This is called whenever glFlush() is called.
113    */
114   void (*Flush)( GLcontext *ctx );
115
116   /**
117    * Clear the color/depth/stencil/accum buffer(s).
118    * \param buffers  a bitmask of BUFFER_BIT_* flags indicating which
119    *                 renderbuffers need to be cleared.
120    */
121   void (*Clear)( GLcontext *ctx, GLbitfield buffers );
122
123   /**
124    * Execute glAccum command.
125    */
126   void (*Accum)( GLcontext *ctx, GLenum op, GLfloat value );
127
128
129   /**
130    * Execute glRasterPos, updating the ctx->Current.Raster fields
131    */
132   void (*RasterPos)( GLcontext *ctx, const GLfloat v[4] );
133
134   /**
135    * \name Image-related functions
136    */
137   /*@{*/
138
139   /**
140    * Called by glDrawPixels().
141    * \p unpack describes how to unpack the source image data.
142    */
143   void (*DrawPixels)( GLcontext *ctx,
144		       GLint x, GLint y, GLsizei width, GLsizei height,
145		       GLenum format, GLenum type,
146		       const struct gl_pixelstore_attrib *unpack,
147		       const GLvoid *pixels );
148
149   /**
150    * Called by glReadPixels().
151    */
152   void (*ReadPixels)( GLcontext *ctx,
153		       GLint x, GLint y, GLsizei width, GLsizei height,
154		       GLenum format, GLenum type,
155		       const struct gl_pixelstore_attrib *unpack,
156		       GLvoid *dest );
157
158   /**
159    * Called by glCopyPixels().
160    */
161   void (*CopyPixels)( GLcontext *ctx, GLint srcx, GLint srcy,
162                       GLsizei width, GLsizei height,
163                       GLint dstx, GLint dsty, GLenum type );
164
165   /**
166    * Called by glBitmap().
167    */
168   void (*Bitmap)( GLcontext *ctx,
169		   GLint x, GLint y, GLsizei width, GLsizei height,
170		   const struct gl_pixelstore_attrib *unpack,
171		   const GLubyte *bitmap );
172   /*@}*/
173
174
175   /**
176    * \name Texture image functions
177    */
178   /*@{*/
179
180   /**
181    * Choose texture format.
182    *
183    * This is called by the \c _mesa_store_tex[sub]image[123]d() fallback
184    * functions.  The driver should examine \p internalFormat and return a
185    * pointer to an appropriate gl_texture_format.
186    */
187   GLuint (*ChooseTextureFormat)( GLcontext *ctx, GLint internalFormat,
188                                     GLenum srcFormat, GLenum srcType );
189
190   /**
191    * Called by glTexImage1D().
192    *
193    * \param target user specified.
194    * \param format user specified.
195    * \param type user specified.
196    * \param pixels user specified.
197    * \param packing indicates the image packing of pixels.
198    * \param texObj is the target texture object.
199    * \param texImage is the target texture image.  It will have the texture \p
200    * width, \p height, \p depth, \p border and \p internalFormat information.
201    *
202    * \p retainInternalCopy is returned by this function and indicates whether
203    * core Mesa should keep an internal copy of the texture image.
204    *
205    * Drivers should call a fallback routine from texstore.c if needed.
206    */
207   void (*TexImage1D)( GLcontext *ctx, GLenum target, GLint level,
208                       GLint internalFormat,
209                       GLint width, GLint border,
210                       GLenum format, GLenum type, const GLvoid *pixels,
211                       const struct gl_pixelstore_attrib *packing,
212                       struct gl_texture_object *texObj,
213                       struct gl_texture_image *texImage );
214
215   /**
216    * Called by glTexImage2D().
217    *
218    * \sa dd_function_table::TexImage1D.
219    */
220   void (*TexImage2D)( GLcontext *ctx, GLenum target, GLint level,
221                       GLint internalFormat,
222                       GLint width, GLint height, GLint border,
223                       GLenum format, GLenum type, const GLvoid *pixels,
224                       const struct gl_pixelstore_attrib *packing,
225                       struct gl_texture_object *texObj,
226                       struct gl_texture_image *texImage );
227
228   /**
229    * Called by glTexImage3D().
230    *
231    * \sa dd_function_table::TexImage1D.
232    */
233   void (*TexImage3D)( GLcontext *ctx, GLenum target, GLint level,
234                       GLint internalFormat,
235                       GLint width, GLint height, GLint depth, GLint border,
236                       GLenum format, GLenum type, const GLvoid *pixels,
237                       const struct gl_pixelstore_attrib *packing,
238                       struct gl_texture_object *texObj,
239                       struct gl_texture_image *texImage );
240
241   /**
242    * Called by glTexSubImage1D().
243    *
244    * \param target user specified.
245    * \param level user specified.
246    * \param xoffset user specified.
247    * \param yoffset user specified.
248    * \param zoffset user specified.
249    * \param width user specified.
250    * \param height user specified.
251    * \param depth user specified.
252    * \param format user specified.
253    * \param type user specified.
254    * \param pixels user specified.
255    * \param packing indicates the image packing of pixels.
256    * \param texObj is the target texture object.
257    * \param texImage is the target texture image.  It will have the texture \p
258    * width, \p height, \p border and \p internalFormat information.
259    *
260    * The driver should use a fallback routine from texstore.c if needed.
261    */
262   void (*TexSubImage1D)( GLcontext *ctx, GLenum target, GLint level,
263                          GLint xoffset, GLsizei width,
264                          GLenum format, GLenum type,
265                          const GLvoid *pixels,
266                          const struct gl_pixelstore_attrib *packing,
267                          struct gl_texture_object *texObj,
268                          struct gl_texture_image *texImage );
269
270   /**
271    * Called by glTexSubImage2D().
272    *
273    * \sa dd_function_table::TexSubImage1D.
274    */
275   void (*TexSubImage2D)( GLcontext *ctx, GLenum target, GLint level,
276                          GLint xoffset, GLint yoffset,
277                          GLsizei width, GLsizei height,
278                          GLenum format, GLenum type,
279                          const GLvoid *pixels,
280                          const struct gl_pixelstore_attrib *packing,
281                          struct gl_texture_object *texObj,
282                          struct gl_texture_image *texImage );
283
284   /**
285    * Called by glTexSubImage3D().
286    *
287    * \sa dd_function_table::TexSubImage1D.
288    */
289   void (*TexSubImage3D)( GLcontext *ctx, GLenum target, GLint level,
290                          GLint xoffset, GLint yoffset, GLint zoffset,
291                          GLsizei width, GLsizei height, GLint depth,
292                          GLenum format, GLenum type,
293                          const GLvoid *pixels,
294                          const struct gl_pixelstore_attrib *packing,
295                          struct gl_texture_object *texObj,
296                          struct gl_texture_image *texImage );
297
298   /**
299    * Called by glGetTexImage().
300    */
301   void (*GetTexImage)( GLcontext *ctx, GLenum target, GLint level,
302                        GLenum format, GLenum type, GLvoid *pixels,
303                        struct gl_texture_object *texObj,
304                        struct gl_texture_image *texImage );
305
306   /**
307    * Called by glCopyTexImage1D().
308    *
309    * Drivers should use a fallback routine from texstore.c if needed.
310    */
311   void (*CopyTexImage1D)( GLcontext *ctx, GLenum target, GLint level,
312                           GLenum internalFormat, GLint x, GLint y,
313                           GLsizei width, GLint border );
314
315   /**
316    * Called by glCopyTexImage2D().
317    *
318    * Drivers should use a fallback routine from texstore.c if needed.
319    */
320   void (*CopyTexImage2D)( GLcontext *ctx, GLenum target, GLint level,
321                           GLenum internalFormat, GLint x, GLint y,
322                           GLsizei width, GLsizei height, GLint border );
323
324   /**
325    * Called by glCopyTexSubImage1D().
326    *
327    * Drivers should use a fallback routine from texstore.c if needed.
328    */
329   void (*CopyTexSubImage1D)( GLcontext *ctx, GLenum target, GLint level,
330                              GLint xoffset,
331                              GLint x, GLint y, GLsizei width );
332   /**
333    * Called by glCopyTexSubImage2D().
334    *
335    * Drivers should use a fallback routine from texstore.c if needed.
336    */
337   void (*CopyTexSubImage2D)( GLcontext *ctx, GLenum target, GLint level,
338                              GLint xoffset, GLint yoffset,
339                              GLint x, GLint y,
340                              GLsizei width, GLsizei height );
341   /**
342    * Called by glCopyTexSubImage3D().
343    *
344    * Drivers should use a fallback routine from texstore.c if needed.
345    */
346   void (*CopyTexSubImage3D)( GLcontext *ctx, GLenum target, GLint level,
347                              GLint xoffset, GLint yoffset, GLint zoffset,
348                              GLint x, GLint y,
349                              GLsizei width, GLsizei height );
350
351   /**
352    * Called by glGenerateMipmap() or when GL_GENERATE_MIPMAP_SGIS is enabled.
353    */
354   void (*GenerateMipmap)(GLcontext *ctx, GLenum target,
355                          struct gl_texture_object *texObj);
356
357   /**
358    * Called by glTexImage[123]D when user specifies a proxy texture
359    * target.
360    *
361    * \return GL_TRUE if the proxy test passes, or GL_FALSE if the test fails.
362    */
363   GLboolean (*TestProxyTexImage)(GLcontext *ctx, GLenum target,
364                                  GLint level, GLint internalFormat,
365                                  GLenum format, GLenum type,
366                                  GLint width, GLint height,
367                                  GLint depth, GLint border);
368   /*@}*/
369
370
371   /**
372    * \name Compressed texture functions
373    */
374   /*@{*/
375
376   /**
377    * Called by glCompressedTexImage1D().
378    *
379    * \param target user specified.
380    * \param format user specified.
381    * \param type user specified.
382    * \param pixels user specified.
383    * \param packing indicates the image packing of pixels.
384    * \param texObj is the target texture object.
385    * \param texImage is the target texture image.  It will have the texture \p
386    * width, \p height, \p depth, \p border and \p internalFormat information.
387    *
388    * \a retainInternalCopy is returned by this function and indicates whether
389    * core Mesa should keep an internal copy of the texture image.
390    */
391   void (*CompressedTexImage1D)( GLcontext *ctx, GLenum target,
392                                 GLint level, GLint internalFormat,
393                                 GLsizei width, GLint border,
394                                 GLsizei imageSize, const GLvoid *data,
395                                 struct gl_texture_object *texObj,
396                                 struct gl_texture_image *texImage );
397   /**
398    * Called by glCompressedTexImage2D().
399    *
400    * \sa dd_function_table::CompressedTexImage1D.
401    */
402   void (*CompressedTexImage2D)( GLcontext *ctx, GLenum target,
403                                 GLint level, GLint internalFormat,
404                                 GLsizei width, GLsizei height, GLint border,
405                                 GLsizei imageSize, const GLvoid *data,
406                                 struct gl_texture_object *texObj,
407                                 struct gl_texture_image *texImage );
408   /**
409    * Called by glCompressedTexImage3D().
410    *
411    * \sa dd_function_table::CompressedTexImage3D.
412    */
413   void (*CompressedTexImage3D)( GLcontext *ctx, GLenum target,
414                                 GLint level, GLint internalFormat,
415                                 GLsizei width, GLsizei height, GLsizei depth,
416                                 GLint border,
417                                 GLsizei imageSize, const GLvoid *data,
418                                 struct gl_texture_object *texObj,
419                                 struct gl_texture_image *texImage );
420
421   /**
422    * Called by glCompressedTexSubImage1D().
423    *
424    * \param target user specified.
425    * \param level user specified.
426    * \param xoffset user specified.
427    * \param yoffset user specified.
428    * \param zoffset user specified.
429    * \param width user specified.
430    * \param height user specified.
431    * \param depth user specified.
432    * \param imageSize user specified.
433    * \param data user specified.
434    * \param texObj is the target texture object.
435    * \param texImage is the target texture image.  It will have the texture \p
436    * width, \p height, \p depth, \p border and \p internalFormat information.
437    */
438   void (*CompressedTexSubImage1D)(GLcontext *ctx, GLenum target, GLint level,
439                                   GLint xoffset, GLsizei width,
440                                   GLenum format,
441                                   GLsizei imageSize, const GLvoid *data,
442                                   struct gl_texture_object *texObj,
443                                   struct gl_texture_image *texImage);
444   /**
445    * Called by glCompressedTexSubImage2D().
446    *
447    * \sa dd_function_table::CompressedTexImage3D.
448    */
449   void (*CompressedTexSubImage2D)(GLcontext *ctx, GLenum target, GLint level,
450                                   GLint xoffset, GLint yoffset,
451                                   GLsizei width, GLint height,
452                                   GLenum format,
453                                   GLsizei imageSize, const GLvoid *data,
454                                   struct gl_texture_object *texObj,
455                                   struct gl_texture_image *texImage);
456   /**
457    * Called by glCompressedTexSubImage3D().
458    *
459    * \sa dd_function_table::CompressedTexImage3D.
460    */
461   void (*CompressedTexSubImage3D)(GLcontext *ctx, GLenum target, GLint level,
462                                   GLint xoffset, GLint yoffset, GLint zoffset,
463                                   GLsizei width, GLint height, GLint depth,
464                                   GLenum format,
465                                   GLsizei imageSize, const GLvoid *data,
466                                   struct gl_texture_object *texObj,
467                                   struct gl_texture_image *texImage);
468
469
470   /**
471    * Called by glGetCompressedTexImage.
472    */
473   void (*GetCompressedTexImage)(GLcontext *ctx, GLenum target, GLint level,
474                                 GLvoid *img,
475                                 struct gl_texture_object *texObj,
476                                 struct gl_texture_image *texImage);
477
478   /*@}*/
479
480   /**
481    * \name Texture object functions
482    */
483   /*@{*/
484
485   /**
486    * Called by glBindTexture().
487    */
488   void (*BindTexture)( GLcontext *ctx, GLenum target,
489                        struct gl_texture_object *tObj );
490
491   /**
492    * Called to allocate a new texture object.
493    * A new gl_texture_object should be returned.  The driver should
494    * attach to it any device-specific info it needs.
495    */
496   struct gl_texture_object * (*NewTextureObject)( GLcontext *ctx, GLuint name,
497                                                   GLenum target );
498   /**
499    * Called when a texture object is about to be deallocated.
500    *
501    * Driver should delete the gl_texture_object object and anything
502    * hanging off of it.
503    */
504   void (*DeleteTexture)( GLcontext *ctx, struct gl_texture_object *tObj );
505
506   /**
507    * Called to allocate a new texture image object.
508    */
509   struct gl_texture_image * (*NewTextureImage)( GLcontext *ctx );
510
511   /**
512    * Called to free tImage->Data.
513    */
514   void (*FreeTexImageData)( GLcontext *ctx, struct gl_texture_image *tImage );
515
516   /** Map texture image data into user space */
517   void (*MapTexture)( GLcontext *ctx, struct gl_texture_object *tObj );
518   /** Unmap texture images from user space */
519   void (*UnmapTexture)( GLcontext *ctx, struct gl_texture_object *tObj );
520
521   /**
522    * Note: no context argument.  This function doesn't initially look
523    * like it belongs here, except that the driver is the only entity
524    * that knows for sure how the texture memory is allocated - via
525    * the above callbacks.  There is then an argument that the driver
526    * knows what memcpy paths might be fast.  Typically this is invoked with
527    *
528    * to -- a pointer into texture memory allocated by NewTextureImage() above.
529    * from -- a pointer into client memory or a mesa temporary.
530    * sz -- nr bytes to copy.
531    */
532   void* (*TextureMemCpy)( void *to, const void *from, size_t sz );
533
534   /**
535    * Called by glAreTextureResident().
536    */
537   GLboolean (*IsTextureResident)( GLcontext *ctx,
538                                   struct gl_texture_object *t );
539
540   /**
541    * Called by glActiveTextureARB() to set current texture unit.
542    */
543   void (*ActiveTexture)( GLcontext *ctx, GLuint texUnitNumber );
544
545   /**
546    * Called when the texture's color lookup table is changed.
547    *
548    * If \p tObj is NULL then the shared texture palette
549    * gl_texture_object::Palette is to be updated.
550    */
551   void (*UpdateTexturePalette)( GLcontext *ctx,
552                                 struct gl_texture_object *tObj );
553   /*@}*/
554
555
556   /**
557    * \name Imaging functionality
558    */
559   /*@{*/
560   void (*CopyColorTable)( GLcontext *ctx,
561			   GLenum target, GLenum internalformat,
562			   GLint x, GLint y, GLsizei width );
563
564   void (*CopyColorSubTable)( GLcontext *ctx,
565			      GLenum target, GLsizei start,
566			      GLint x, GLint y, GLsizei width );
567
568   void (*CopyConvolutionFilter1D)( GLcontext *ctx, GLenum target,
569				    GLenum internalFormat,
570				    GLint x, GLint y, GLsizei width );
571
572   void (*CopyConvolutionFilter2D)( GLcontext *ctx, GLenum target,
573				    GLenum internalFormat,
574				    GLint x, GLint y,
575				    GLsizei width, GLsizei height );
576   /*@}*/
577
578
579   /**
580    * \name Vertex/fragment program functions
581    */
582   /*@{*/
583   /** Bind a vertex/fragment program */
584   void (*BindProgram)(GLcontext *ctx, GLenum target, struct gl_program *prog);
585   /** Allocate a new program */
586   struct gl_program * (*NewProgram)(GLcontext *ctx, GLenum target, GLuint id);
587   /** Delete a program */
588   void (*DeleteProgram)(GLcontext *ctx, struct gl_program *prog);
589   /** Notify driver that a program string has been specified. */
590   void (*ProgramStringNotify)(GLcontext *ctx, GLenum target,
591			       struct gl_program *prog);
592
593   /** Query if program can be loaded onto hardware */
594   GLboolean (*IsProgramNative)(GLcontext *ctx, GLenum target,
595				struct gl_program *prog);
596
597   /*@}*/
598
599
600   /**
601    * \name State-changing functions.
602    *
603    * \note drawing functions are above.
604    *
605    * These functions are called by their corresponding OpenGL API functions.
606    * They are \e also called by the gl_PopAttrib() function!!!
607    * May add more functions like these to the device driver in the future.
608    */
609   /*@{*/
610   /** Specify the alpha test function */
611   void (*AlphaFunc)(GLcontext *ctx, GLenum func, GLfloat ref);
612   /** Set the blend color */
613   void (*BlendColor)(GLcontext *ctx, const GLfloat color[4]);
614   /** Set the blend equation */
615   void (*BlendEquationSeparate)(GLcontext *ctx, GLenum modeRGB, GLenum modeA);
616   /** Specify pixel arithmetic */
617   void (*BlendFuncSeparate)(GLcontext *ctx,
618                             GLenum sfactorRGB, GLenum dfactorRGB,
619                             GLenum sfactorA, GLenum dfactorA);
620   /** Specify clear values for the color buffers */
621   void (*ClearColor)(GLcontext *ctx, const GLfloat color[4]);
622   /** Specify the clear value for the depth buffer */
623   void (*ClearDepth)(GLcontext *ctx, GLclampd d);
624   /** Specify the clear value for the color index buffers */
625   void (*ClearIndex)(GLcontext *ctx, GLuint index);
626   /** Specify the clear value for the stencil buffer */
627   void (*ClearStencil)(GLcontext *ctx, GLint s);
628   /** Specify a plane against which all geometry is clipped */
629   void (*ClipPlane)(GLcontext *ctx, GLenum plane, const GLfloat *equation );
630   /** Enable and disable writing of frame buffer color components */
631   void (*ColorMask)(GLcontext *ctx, GLboolean rmask, GLboolean gmask,
632                     GLboolean bmask, GLboolean amask );
633   /** Cause a material color to track the current color */
634   void (*ColorMaterial)(GLcontext *ctx, GLenum face, GLenum mode);
635   /** Specify whether front- or back-facing facets can be culled */
636   void (*CullFace)(GLcontext *ctx, GLenum mode);
637   /** Define front- and back-facing polygons */
638   void (*FrontFace)(GLcontext *ctx, GLenum mode);
639   /** Specify the value used for depth buffer comparisons */
640   void (*DepthFunc)(GLcontext *ctx, GLenum func);
641   /** Enable or disable writing into the depth buffer */
642   void (*DepthMask)(GLcontext *ctx, GLboolean flag);
643   /** Specify mapping of depth values from NDC to window coordinates */
644   void (*DepthRange)(GLcontext *ctx, GLclampd nearval, GLclampd farval);
645   /** Specify the current buffer for writing */
646   void (*DrawBuffer)( GLcontext *ctx, GLenum buffer );
647   /** Specify the buffers for writing for fragment programs*/
648   void (*DrawBuffers)( GLcontext *ctx, GLsizei n, const GLenum *buffers );
649   /** Enable or disable server-side gl capabilities */
650   void (*Enable)(GLcontext *ctx, GLenum cap, GLboolean state);
651   /** Specify fog parameters */
652   void (*Fogfv)(GLcontext *ctx, GLenum pname, const GLfloat *params);
653   /** Specify implementation-specific hints */
654   void (*Hint)(GLcontext *ctx, GLenum target, GLenum mode);
655   /** Control the writing of individual bits in the color index buffers */
656   void (*IndexMask)(GLcontext *ctx, GLuint mask);
657   /** Set light source parameters.
658    * Note: for GL_POSITION and GL_SPOT_DIRECTION, params will have already
659    * been transformed to eye-space.
660    */
661   void (*Lightfv)(GLcontext *ctx, GLenum light,
662		   GLenum pname, const GLfloat *params );
663   /** Set the lighting model parameters */
664   void (*LightModelfv)(GLcontext *ctx, GLenum pname, const GLfloat *params);
665   /** Specify the line stipple pattern */
666   void (*LineStipple)(GLcontext *ctx, GLint factor, GLushort pattern );
667   /** Specify the width of rasterized lines */
668   void (*LineWidth)(GLcontext *ctx, GLfloat width);
669   /** Specify a logical pixel operation for color index rendering */
670   void (*LogicOpcode)(GLcontext *ctx, GLenum opcode);
671   void (*PointParameterfv)(GLcontext *ctx, GLenum pname,
672                            const GLfloat *params);
673   /** Specify the diameter of rasterized points */
674   void (*PointSize)(GLcontext *ctx, GLfloat size);
675   /** Select a polygon rasterization mode */
676   void (*PolygonMode)(GLcontext *ctx, GLenum face, GLenum mode);
677   /** Set the scale and units used to calculate depth values */
678   void (*PolygonOffset)(GLcontext *ctx, GLfloat factor, GLfloat units);
679   /** Set the polygon stippling pattern */
680   void (*PolygonStipple)(GLcontext *ctx, const GLubyte *mask );
681   /* Specifies the current buffer for reading */
682   void (*ReadBuffer)( GLcontext *ctx, GLenum buffer );
683   /** Set rasterization mode */
684   void (*RenderMode)(GLcontext *ctx, GLenum mode );
685   /** Define the scissor box */
686   void (*Scissor)(GLcontext *ctx, GLint x, GLint y, GLsizei w, GLsizei h);
687   /** Select flat or smooth shading */
688   void (*ShadeModel)(GLcontext *ctx, GLenum mode);
689   /** OpenGL 2.0 two-sided StencilFunc */
690   void (*StencilFuncSeparate)(GLcontext *ctx, GLenum face, GLenum func,
691                               GLint ref, GLuint mask);
692   /** OpenGL 2.0 two-sided StencilMask */
693   void (*StencilMaskSeparate)(GLcontext *ctx, GLenum face, GLuint mask);
694   /** OpenGL 2.0 two-sided StencilOp */
695   void (*StencilOpSeparate)(GLcontext *ctx, GLenum face, GLenum fail,
696                             GLenum zfail, GLenum zpass);
697   /** Control the generation of texture coordinates */
698   void (*TexGen)(GLcontext *ctx, GLenum coord, GLenum pname,
699		  const GLfloat *params);
700   /** Set texture environment parameters */
701   void (*TexEnv)(GLcontext *ctx, GLenum target, GLenum pname,
702                  const GLfloat *param);
703   /** Set texture parameters */
704   void (*TexParameter)(GLcontext *ctx, GLenum target,
705                        struct gl_texture_object *texObj,
706                        GLenum pname, const GLfloat *params);
707   /** Set the viewport */
708   void (*Viewport)(GLcontext *ctx, GLint x, GLint y, GLsizei w, GLsizei h);
709   /*@}*/
710
711
712   /**
713    * \name State-query functions
714    *
715    * Return GL_TRUE if query was completed, GL_FALSE otherwise.
716    */
717   /*@{*/
718   /** Return the value or values of a selected parameter */
719   GLboolean (*GetBooleanv)(GLcontext *ctx, GLenum pname, GLboolean *result);
720   /** Return the value or values of a selected parameter */
721   GLboolean (*GetDoublev)(GLcontext *ctx, GLenum pname, GLdouble *result);
722   /** Return the value or values of a selected parameter */
723   GLboolean (*GetFloatv)(GLcontext *ctx, GLenum pname, GLfloat *result);
724   /** Return the value or values of a selected parameter */
725   GLboolean (*GetIntegerv)(GLcontext *ctx, GLenum pname, GLint *result);
726   /** Return the value or values of a selected parameter */
727   GLboolean (*GetInteger64v)(GLcontext *ctx, GLenum pname, GLint64 *result);
728   /** Return the value or values of a selected parameter */
729   GLboolean (*GetPointerv)(GLcontext *ctx, GLenum pname, GLvoid **result);
730   /*@}*/
731
732
733   /**
734    * \name Vertex/pixel buffer object functions
735    */
736#if FEATURE_ARB_vertex_buffer_object
737   /*@{*/
738   void (*BindBuffer)( GLcontext *ctx, GLenum target,
739		       struct gl_buffer_object *obj );
740
741   struct gl_buffer_object * (*NewBufferObject)( GLcontext *ctx, GLuint buffer,
742						 GLenum target );
743
744   void (*DeleteBuffer)( GLcontext *ctx, struct gl_buffer_object *obj );
745
746   GLboolean (*BufferData)( GLcontext *ctx, GLenum target, GLsizeiptrARB size,
747                            const GLvoid *data, GLenum usage,
748                            struct gl_buffer_object *obj );
749
750   void (*BufferSubData)( GLcontext *ctx, GLenum target, GLintptrARB offset,
751			  GLsizeiptrARB size, const GLvoid *data,
752			  struct gl_buffer_object *obj );
753
754   void (*GetBufferSubData)( GLcontext *ctx, GLenum target,
755			     GLintptrARB offset, GLsizeiptrARB size,
756			     GLvoid *data, struct gl_buffer_object *obj );
757
758   void * (*MapBuffer)( GLcontext *ctx, GLenum target, GLenum access,
759			struct gl_buffer_object *obj );
760
761   void (*CopyBufferSubData)( GLcontext *ctx,
762                              struct gl_buffer_object *src,
763                              struct gl_buffer_object *dst,
764                              GLintptr readOffset, GLintptr writeOffset,
765                              GLsizeiptr size );
766
767   /* May return NULL if MESA_MAP_NOWAIT_BIT is set in access:
768    */
769   void * (*MapBufferRange)( GLcontext *ctx, GLenum target,
770                             GLintptr offset, GLsizeiptr length, GLbitfield access,
771                             struct gl_buffer_object *obj);
772
773   void (*FlushMappedBufferRange) (GLcontext *ctx, GLenum target,
774                                   GLintptr offset, GLsizeiptr length,
775                                   struct gl_buffer_object *obj);
776
777   GLboolean (*UnmapBuffer)( GLcontext *ctx, GLenum target,
778			     struct gl_buffer_object *obj );
779   /*@}*/
780#endif
781
782   /**
783    * \name Functions for GL_EXT_framebuffer_object
784    */
785#if FEATURE_EXT_framebuffer_object
786   /*@{*/
787   struct gl_framebuffer * (*NewFramebuffer)(GLcontext *ctx, GLuint name);
788   struct gl_renderbuffer * (*NewRenderbuffer)(GLcontext *ctx, GLuint name);
789   void (*BindFramebuffer)(GLcontext *ctx, GLenum target,
790                           struct gl_framebuffer *fb, struct gl_framebuffer *fbread);
791   void (*FramebufferRenderbuffer)(GLcontext *ctx,
792                                   struct gl_framebuffer *fb,
793                                   GLenum attachment,
794                                   struct gl_renderbuffer *rb);
795   void (*RenderTexture)(GLcontext *ctx,
796                         struct gl_framebuffer *fb,
797                         struct gl_renderbuffer_attachment *att);
798   void (*FinishRenderTexture)(GLcontext *ctx,
799                               struct gl_renderbuffer_attachment *att);
800   void (*ValidateFramebuffer)(GLcontext *ctx,
801                               struct gl_framebuffer *fb);
802   /*@}*/
803#endif
804#if FEATURE_EXT_framebuffer_blit
805   void (*BlitFramebuffer)(GLcontext *ctx,
806                           GLint srcX0, GLint srcY0, GLint srcX1, GLint srcY1,
807                           GLint dstX0, GLint dstY0, GLint dstX1, GLint dstY1,
808                           GLbitfield mask, GLenum filter);
809#endif
810
811   /**
812    * \name Query objects
813    */
814   /*@{*/
815   struct gl_query_object * (*NewQueryObject)(GLcontext *ctx, GLuint id);
816   void (*DeleteQuery)(GLcontext *ctx, struct gl_query_object *q);
817   void (*BeginQuery)(GLcontext *ctx, struct gl_query_object *q);
818   void (*EndQuery)(GLcontext *ctx, struct gl_query_object *q);
819   void (*CheckQuery)(GLcontext *ctx, struct gl_query_object *q);
820   void (*WaitQuery)(GLcontext *ctx, struct gl_query_object *q);
821   /*@}*/
822
823
824   /**
825    * \name Vertex Array objects
826    */
827   /*@{*/
828   struct gl_array_object * (*NewArrayObject)(GLcontext *ctx, GLuint id);
829   void (*DeleteArrayObject)(GLcontext *ctx, struct gl_array_object *obj);
830   void (*BindArrayObject)(GLcontext *ctx, struct gl_array_object *obj);
831   /*@}*/
832
833   /**
834    * \name GLSL-related functions (ARB extensions and OpenGL 2.x)
835    */
836   /*@{*/
837   void (*AttachShader)(GLcontext *ctx, GLuint program, GLuint shader);
838   void (*BindAttribLocation)(GLcontext *ctx, GLuint program, GLuint index,
839                              const GLcharARB *name);
840   void (*CompileShader)(GLcontext *ctx, GLuint shader);
841   GLuint (*CreateShader)(GLcontext *ctx, GLenum type);
842   GLuint (*CreateProgram)(GLcontext *ctx);
843   void (*DeleteProgram2)(GLcontext *ctx, GLuint program);
844   void (*DeleteShader)(GLcontext *ctx, GLuint shader);
845   void (*DetachShader)(GLcontext *ctx, GLuint program, GLuint shader);
846   void (*GetActiveAttrib)(GLcontext *ctx, GLuint program, GLuint index,
847                           GLsizei maxLength, GLsizei * length, GLint * size,
848                           GLenum * type, GLcharARB * name);
849   void (*GetActiveUniform)(GLcontext *ctx, GLuint program, GLuint index,
850                            GLsizei maxLength, GLsizei *length, GLint *size,
851                            GLenum *type, GLcharARB *name);
852   void (*GetAttachedShaders)(GLcontext *ctx, GLuint program, GLsizei maxCount,
853                              GLsizei *count, GLuint *obj);
854   GLint (*GetAttribLocation)(GLcontext *ctx, GLuint program,
855                              const GLcharARB *name);
856   GLuint (*GetHandle)(GLcontext *ctx, GLenum pname);
857   void (*GetProgramiv)(GLcontext *ctx, GLuint program,
858                        GLenum pname, GLint *params);
859   void (*GetProgramInfoLog)(GLcontext *ctx, GLuint program, GLsizei bufSize,
860                             GLsizei *length, GLchar *infoLog);
861   void (*GetShaderiv)(GLcontext *ctx, GLuint shader,
862                       GLenum pname, GLint *params);
863   void (*GetShaderInfoLog)(GLcontext *ctx, GLuint shader, GLsizei bufSize,
864                            GLsizei *length, GLchar *infoLog);
865   void (*GetShaderSource)(GLcontext *ctx, GLuint shader, GLsizei maxLength,
866                           GLsizei *length, GLcharARB *sourceOut);
867   void (*GetUniformfv)(GLcontext *ctx, GLuint program, GLint location,
868                        GLfloat *params);
869   void (*GetUniformiv)(GLcontext *ctx, GLuint program, GLint location,
870                        GLint *params);
871   GLint (*GetUniformLocation)(GLcontext *ctx, GLuint program,
872                               const GLcharARB *name);
873   GLboolean (*IsProgram)(GLcontext *ctx, GLuint name);
874   GLboolean (*IsShader)(GLcontext *ctx, GLuint name);
875   void (*LinkProgram)(GLcontext *ctx, GLuint program);
876   void (*ShaderSource)(GLcontext *ctx, GLuint shader, const GLchar *source);
877   void (*Uniform)(GLcontext *ctx, GLint location, GLsizei count,
878                   const GLvoid *values, GLenum type);
879   void (*UniformMatrix)(GLcontext *ctx, GLint cols, GLint rows,
880                         GLint location, GLsizei count,
881                         GLboolean transpose, const GLfloat *values);
882   void (*UseProgram)(GLcontext *ctx, GLuint program);
883   void (*ValidateProgram)(GLcontext *ctx, GLuint program);
884   /* XXX many more to come */
885   /*@}*/
886
887
888   /**
889    * \name Support for multiple T&L engines
890    */
891   /*@{*/
892
893   /**
894    * Bitmask of state changes that require the current T&L module to be
895    * validated, using ValidateTnlModule() below.
896    */
897   GLuint NeedValidate;
898
899   /**
900    * Validate the current T&L module.
901    *
902    * This is called directly after UpdateState() when a state change that has
903    * occurred matches the dd_function_table::NeedValidate bitmask above.  This
904    * ensures all computed values are up to date, thus allowing the driver to
905    * decide if the current T&L module needs to be swapped out.
906    *
907    * This must be non-NULL if a driver installs a custom T&L module and sets
908    * the dd_function_table::NeedValidate bitmask, but may be NULL otherwise.
909    */
910   void (*ValidateTnlModule)( GLcontext *ctx, GLuint new_state );
911
912
913#define PRIM_OUTSIDE_BEGIN_END   (GL_POLYGON+1)
914#define PRIM_INSIDE_UNKNOWN_PRIM (GL_POLYGON+2)
915#define PRIM_UNKNOWN             (GL_POLYGON+3)
916
917   /**
918    * Set by the driver-supplied T&L engine.
919    *
920    * Set to PRIM_OUTSIDE_BEGIN_END when outside glBegin()/glEnd().
921    */
922   GLuint CurrentExecPrimitive;
923
924   /**
925    * Current state of an in-progress compilation.
926    *
927    * May take on any of the additional values PRIM_OUTSIDE_BEGIN_END,
928    * PRIM_INSIDE_UNKNOWN_PRIM or PRIM_UNKNOWN defined above.
929    */
930   GLuint CurrentSavePrimitive;
931
932
933#define FLUSH_STORED_VERTICES 0x1
934#define FLUSH_UPDATE_CURRENT  0x2
935   /**
936    * Set by the driver-supplied T&L engine whenever vertices are buffered
937    * between glBegin()/glEnd() objects or __GLcontextRec::Current is not
938    * updated.
939    *
940    * The dd_function_table::FlushVertices call below may be used to resolve
941    * these conditions.
942    */
943   GLuint NeedFlush;
944   GLuint SaveNeedFlush;
945
946
947   /* Called prior to any of the GLvertexformat functions being
948    * called.  Paired with Driver.FlushVertices().
949    */
950   void (*BeginVertices)( GLcontext *ctx );
951
952   /**
953    * If inside glBegin()/glEnd(), it should ASSERT(0).  Otherwise, if
954    * FLUSH_STORED_VERTICES bit in \p flags is set flushes any buffered
955    * vertices, if FLUSH_UPDATE_CURRENT bit is set updates
956    * __GLcontextRec::Current and gl_light_attrib::Material
957    *
958    * Note that the default T&L engine never clears the
959    * FLUSH_UPDATE_CURRENT bit, even after performing the update.
960    */
961   void (*FlushVertices)( GLcontext *ctx, GLuint flags );
962   void (*SaveFlushVertices)( GLcontext *ctx );
963
964   /**
965    * Give the driver the opportunity to hook in its own vtxfmt for
966    * compiling optimized display lists.  This is called on each valid
967    * glBegin() during list compilation.
968    */
969   GLboolean (*NotifySaveBegin)( GLcontext *ctx, GLenum mode );
970
971   /**
972    * Notify driver that the special derived value _NeedEyeCoords has
973    * changed.
974    */
975   void (*LightingSpaceChange)( GLcontext *ctx );
976
977   /**
978    * Called by glNewList().
979    *
980    * Let the T&L component know what is going on with display lists
981    * in time to make changes to dispatch tables, etc.
982    */
983   void (*NewList)( GLcontext *ctx, GLuint list, GLenum mode );
984   /**
985    * Called by glEndList().
986    *
987    * \sa dd_function_table::NewList.
988    */
989   void (*EndList)( GLcontext *ctx );
990
991   /**
992    * Called by glCallList(s).
993    *
994    * Notify the T&L component before and after calling a display list.
995    */
996   void (*BeginCallList)( GLcontext *ctx,
997			  struct gl_display_list *dlist );
998   /**
999    * Called by glEndCallList().
1000    *
1001    * \sa dd_function_table::BeginCallList.
1002    */
1003   void (*EndCallList)( GLcontext *ctx );
1004
1005
1006#if FEATURE_ARB_sync
1007   /**
1008    * \name GL_ARB_sync interfaces
1009    */
1010   /*@{*/
1011   struct gl_sync_object * (*NewSyncObject)(GLcontext *, GLenum);
1012   void (*FenceSync)(GLcontext *, struct gl_sync_object *, GLenum, GLbitfield);
1013   void (*DeleteSyncObject)(GLcontext *, struct gl_sync_object *);
1014   void (*CheckSync)(GLcontext *, struct gl_sync_object *);
1015   void (*ClientWaitSync)(GLcontext *, struct gl_sync_object *,
1016			  GLbitfield, GLuint64);
1017   void (*ServerWaitSync)(GLcontext *, struct gl_sync_object *,
1018			  GLbitfield, GLuint64);
1019   /*@}*/
1020#endif
1021};
1022
1023
1024/**
1025 * Transform/Clip/Lighting interface
1026 *
1027 * Drivers present a reduced set of the functions possible in
1028 * glBegin()/glEnd() objects.  Core mesa provides translation stubs for the
1029 * remaining functions to map down to these entry points.
1030 *
1031 * These are the initial values to be installed into dispatch by
1032 * mesa.  If the T&L driver wants to modify the dispatch table
1033 * while installed, it must do so itself.  It would be possible for
1034 * the vertexformat to install it's own initial values for these
1035 * functions, but this way there is an obvious list of what is
1036 * expected of the driver.
1037 *
1038 * If the driver wants to hook in entry points other than those
1039 * listed, it must restore them to their original values in
1040 * the disable() callback, below.
1041 */
1042typedef struct {
1043   /**
1044    * \name Vertex
1045    */
1046   /*@{*/
1047   void (GLAPIENTRYP ArrayElement)( GLint ); /* NOTE */
1048   void (GLAPIENTRYP Color3f)( GLfloat, GLfloat, GLfloat );
1049   void (GLAPIENTRYP Color3fv)( const GLfloat * );
1050   void (GLAPIENTRYP Color4f)( GLfloat, GLfloat, GLfloat, GLfloat );
1051   void (GLAPIENTRYP Color4fv)( const GLfloat * );
1052   void (GLAPIENTRYP EdgeFlag)( GLboolean );
1053   void (GLAPIENTRYP EvalCoord1f)( GLfloat );          /* NOTE */
1054   void (GLAPIENTRYP EvalCoord1fv)( const GLfloat * ); /* NOTE */
1055   void (GLAPIENTRYP EvalCoord2f)( GLfloat, GLfloat ); /* NOTE */
1056   void (GLAPIENTRYP EvalCoord2fv)( const GLfloat * ); /* NOTE */
1057   void (GLAPIENTRYP EvalPoint1)( GLint );             /* NOTE */
1058   void (GLAPIENTRYP EvalPoint2)( GLint, GLint );      /* NOTE */
1059   void (GLAPIENTRYP FogCoordfEXT)( GLfloat );
1060   void (GLAPIENTRYP FogCoordfvEXT)( const GLfloat * );
1061   void (GLAPIENTRYP Indexf)( GLfloat );
1062   void (GLAPIENTRYP Indexfv)( const GLfloat * );
1063   void (GLAPIENTRYP Materialfv)( GLenum face, GLenum pname, const GLfloat * ); /* NOTE */
1064   void (GLAPIENTRYP MultiTexCoord1fARB)( GLenum, GLfloat );
1065   void (GLAPIENTRYP MultiTexCoord1fvARB)( GLenum, const GLfloat * );
1066   void (GLAPIENTRYP MultiTexCoord2fARB)( GLenum, GLfloat, GLfloat );
1067   void (GLAPIENTRYP MultiTexCoord2fvARB)( GLenum, const GLfloat * );
1068   void (GLAPIENTRYP MultiTexCoord3fARB)( GLenum, GLfloat, GLfloat, GLfloat );
1069   void (GLAPIENTRYP MultiTexCoord3fvARB)( GLenum, const GLfloat * );
1070   void (GLAPIENTRYP MultiTexCoord4fARB)( GLenum, GLfloat, GLfloat, GLfloat, GLfloat );
1071   void (GLAPIENTRYP MultiTexCoord4fvARB)( GLenum, const GLfloat * );
1072   void (GLAPIENTRYP Normal3f)( GLfloat, GLfloat, GLfloat );
1073   void (GLAPIENTRYP Normal3fv)( const GLfloat * );
1074   void (GLAPIENTRYP SecondaryColor3fEXT)( GLfloat, GLfloat, GLfloat );
1075   void (GLAPIENTRYP SecondaryColor3fvEXT)( const GLfloat * );
1076   void (GLAPIENTRYP TexCoord1f)( GLfloat );
1077   void (GLAPIENTRYP TexCoord1fv)( const GLfloat * );
1078   void (GLAPIENTRYP TexCoord2f)( GLfloat, GLfloat );
1079   void (GLAPIENTRYP TexCoord2fv)( const GLfloat * );
1080   void (GLAPIENTRYP TexCoord3f)( GLfloat, GLfloat, GLfloat );
1081   void (GLAPIENTRYP TexCoord3fv)( const GLfloat * );
1082   void (GLAPIENTRYP TexCoord4f)( GLfloat, GLfloat, GLfloat, GLfloat );
1083   void (GLAPIENTRYP TexCoord4fv)( const GLfloat * );
1084   void (GLAPIENTRYP Vertex2f)( GLfloat, GLfloat );
1085   void (GLAPIENTRYP Vertex2fv)( const GLfloat * );
1086   void (GLAPIENTRYP Vertex3f)( GLfloat, GLfloat, GLfloat );
1087   void (GLAPIENTRYP Vertex3fv)( const GLfloat * );
1088   void (GLAPIENTRYP Vertex4f)( GLfloat, GLfloat, GLfloat, GLfloat );
1089   void (GLAPIENTRYP Vertex4fv)( const GLfloat * );
1090   void (GLAPIENTRYP CallList)( GLuint );	/* NOTE */
1091   void (GLAPIENTRYP CallLists)( GLsizei, GLenum, const GLvoid * );	/* NOTE */
1092   void (GLAPIENTRYP Begin)( GLenum );
1093   void (GLAPIENTRYP End)( void );
1094   /* GL_NV_vertex_program */
1095   void (GLAPIENTRYP VertexAttrib1fNV)( GLuint index, GLfloat x );
1096   void (GLAPIENTRYP VertexAttrib1fvNV)( GLuint index, const GLfloat *v );
1097   void (GLAPIENTRYP VertexAttrib2fNV)( GLuint index, GLfloat x, GLfloat y );
1098   void (GLAPIENTRYP VertexAttrib2fvNV)( GLuint index, const GLfloat *v );
1099   void (GLAPIENTRYP VertexAttrib3fNV)( GLuint index, GLfloat x, GLfloat y, GLfloat z );
1100   void (GLAPIENTRYP VertexAttrib3fvNV)( GLuint index, const GLfloat *v );
1101   void (GLAPIENTRYP VertexAttrib4fNV)( GLuint index, GLfloat x, GLfloat y, GLfloat z, GLfloat w );
1102   void (GLAPIENTRYP VertexAttrib4fvNV)( GLuint index, const GLfloat *v );
1103#if FEATURE_ARB_vertex_program
1104   void (GLAPIENTRYP VertexAttrib1fARB)( GLuint index, GLfloat x );
1105   void (GLAPIENTRYP VertexAttrib1fvARB)( GLuint index, const GLfloat *v );
1106   void (GLAPIENTRYP VertexAttrib2fARB)( GLuint index, GLfloat x, GLfloat y );
1107   void (GLAPIENTRYP VertexAttrib2fvARB)( GLuint index, const GLfloat *v );
1108   void (GLAPIENTRYP VertexAttrib3fARB)( GLuint index, GLfloat x, GLfloat y, GLfloat z );
1109   void (GLAPIENTRYP VertexAttrib3fvARB)( GLuint index, const GLfloat *v );
1110   void (GLAPIENTRYP VertexAttrib4fARB)( GLuint index, GLfloat x, GLfloat y, GLfloat z, GLfloat w );
1111   void (GLAPIENTRYP VertexAttrib4fvARB)( GLuint index, const GLfloat *v );
1112#endif
1113   /*@}*/
1114
1115   /*
1116    */
1117   void (GLAPIENTRYP Rectf)( GLfloat, GLfloat, GLfloat, GLfloat );
1118
1119   /**
1120    * \name Array
1121    */
1122   /*@{*/
1123   void (GLAPIENTRYP DrawArrays)( GLenum mode, GLint start, GLsizei count );
1124   void (GLAPIENTRYP DrawElements)( GLenum mode, GLsizei count, GLenum type,
1125			 const GLvoid *indices );
1126   void (GLAPIENTRYP DrawRangeElements)( GLenum mode, GLuint start,
1127			      GLuint end, GLsizei count,
1128			      GLenum type, const GLvoid *indices );
1129   void (GLAPIENTRYP MultiDrawElementsEXT)( GLenum mode, const GLsizei *count,
1130					    GLenum type,
1131					    const GLvoid **indices,
1132					    GLsizei primcount);
1133   void (GLAPIENTRYP DrawElementsBaseVertex)( GLenum mode, GLsizei count,
1134					      GLenum type,
1135					      const GLvoid *indices,
1136					      GLint basevertex );
1137   void (GLAPIENTRYP DrawRangeElementsBaseVertex)( GLenum mode, GLuint start,
1138						   GLuint end, GLsizei count,
1139						   GLenum type,
1140						   const GLvoid *indices,
1141						   GLint basevertex);
1142   void (GLAPIENTRYP MultiDrawElementsBaseVertex)( GLenum mode,
1143						   const GLsizei *count,
1144						   GLenum type,
1145						   const GLvoid **indices,
1146						   GLsizei primcount,
1147						   const GLint *basevertex);
1148   /*@}*/
1149
1150   /**
1151    * \name Eval
1152    *
1153    * If you don't support eval, fallback to the default vertex format
1154    * on receiving an eval call and use the pipeline mechanism to
1155    * provide partial T&L acceleration.
1156    *
1157    * Mesa will provide a set of helper functions to do eval within
1158    * accelerated vertex formats, eventually...
1159    */
1160   /*@{*/
1161   void (GLAPIENTRYP EvalMesh1)( GLenum mode, GLint i1, GLint i2 );
1162   void (GLAPIENTRYP EvalMesh2)( GLenum mode, GLint i1, GLint i2, GLint j1, GLint j2 );
1163   /*@}*/
1164
1165} GLvertexformat;
1166
1167
1168#endif /* DD_INCLUDED */
1169