mesa: add support for memory object creation/import/delete
[mesa.git] / src / mesa / main / dlist.h
index 6671620d4709889c6aef8d0cbdf15992c530f8c9..22b696f50c18c2658923e681e7f1882d44dc80d9 100644 (file)
@@ -1,10 +1,12 @@
-/* $Id: dlist.h,v 1.17 2001/12/14 02:50:01 brianp Exp $ */
+/**
+ * \file dlist.h
+ * Display lists management.
+ */
 
 /*
  * Mesa 3-D graphics library
- * Version:  4.1
  *
- * Copyright (C) 1999-2001  Brian Paul   All Rights Reserved.
+ * Copyright (C) 1999-2006  Brian Paul   All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a
  * copy of this software and associated documentation files (the "Software"),
  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
- * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
- * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
- * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+ * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
  */
 
 
+
 #ifndef DLIST_H
 #define DLIST_H
 
+#include <stdio.h>
+#include "main/mtypes.h"
 
-#include "mtypes.h"
 
+/**
+ * Describes the location and size of a glBitmap image in a texture atlas.
+ */
+struct gl_bitmap_glyph
+{
+   unsigned short x, y, w, h;  /**< position and size in the texture */
+   float xorig, yorig;         /**< bitmap origin */
+   float xmove, ymove;         /**< rasterpos move */
+};
+
+
+/**
+ * Describes a set of glBitmap display lists which live in a texture atlas.
+ * The idea is when we see a code sequence of glListBase(b), glCallLists(n)
+ * we're probably drawing bitmap font glyphs.  We try to put all the bitmap
+ * glyphs into one texture map then render the glCallLists as a textured
+ * quadstrip.
+ */
+struct gl_bitmap_atlas
+{
+   bool complete;     /**< Is the atlas ready to use? */
+   bool incomplete;   /**< Did we fail to construct this atlas? */
 
-#define ASSERT_OUTSIDE_SAVE_BEGIN_END_WITH_RETVAL(ctx, retval)         \
-do {                                                                   \
-   if (ctx->Driver.CurrentSavePrimitive <= GL_POLYGON ||               \
-       ctx->Driver.CurrentSavePrimitive == PRIM_INSIDE_UNKNOWN_PRIM) { \
-      _mesa_compile_error( ctx, GL_INVALID_OPERATION, "begin/end" );   \
-      return retval;                                                   \
-   }                                                                   \
-} while (0)
+   unsigned numBitmaps;
+   unsigned texWidth, texHeight;
+   struct gl_texture_object *texObj;
+   struct gl_texture_image *texImage;
 
-#define ASSERT_OUTSIDE_SAVE_BEGIN_END(ctx)                             \
-do {                                                                   \
-   if (ctx->Driver.CurrentSavePrimitive <= GL_POLYGON ||               \
-       ctx->Driver.CurrentSavePrimitive == PRIM_INSIDE_UNKNOWN_PRIM) { \
-      _mesa_compile_error( ctx, GL_INVALID_OPERATION, "begin/end" );   \
-      return;                                                          \
-   }                                                                   \
-} while (0)
+   unsigned glyphHeight;
 
-#define ASSERT_OUTSIDE_SAVE_BEGIN_END_AND_FLUSH(ctx)                   \
-do {                                                                   \
-   ASSERT_OUTSIDE_SAVE_BEGIN_END(ctx);                                 \
-   FLUSH_VERTICES(ctx, 0);                                             \
-} while (0)
+   struct gl_bitmap_glyph *glyphs;
+};
 
-#define ASSERT_OUTSIDE_SAVE_BEGIN_END_AND_FLUSH_WITH_RETVAL(ctx, retval)\
-do {                                                                   \
-   ASSERT_OUTSIDE_SAVE_BEGIN_END_WITH_RETVAL(ctx, retval);             \
-   FLUSH_VERTICES(ctx, 0);                                             \
-} while (0)
+void
+_mesa_delete_bitmap_atlas(struct gl_context *ctx,
+                          struct gl_bitmap_atlas *atlas);
 
 
-extern void _mesa_init_lists( void );
+GLboolean GLAPIENTRY
+_mesa_IsList(GLuint list);
 
-extern void _mesa_destroy_list( GLcontext *ctx, GLuint list );
+void GLAPIENTRY
+_mesa_DeleteLists(GLuint list, GLsizei range);
 
-extern void _mesa_CallList( GLuint list );
+GLuint GLAPIENTRY
+_mesa_GenLists(GLsizei range);
 
-extern void _mesa_CallLists( GLsizei n, GLenum type, const GLvoid *lists );
+void GLAPIENTRY
+_mesa_NewList(GLuint name, GLenum mode);
 
-extern void _mesa_DeleteLists( GLuint list, GLsizei range );
+void GLAPIENTRY
+_mesa_EndList(void);
 
-extern void _mesa_EndList( void );
+void GLAPIENTRY
+_mesa_CallList(GLuint list);
 
-extern GLuint _mesa_GenLists( GLsizei range );
+void GLAPIENTRY
+_mesa_CallLists(GLsizei n, GLenum type, const GLvoid *lists);
 
-extern GLboolean _mesa_IsList( GLuint list );
+void GLAPIENTRY
+_mesa_ListBase(GLuint base);
 
-extern void _mesa_ListBase( GLuint base );
+struct gl_display_list *
+_mesa_lookup_list(struct gl_context *ctx, GLuint list);
 
-extern void _mesa_NewList( GLuint list, GLenum mode );
+void
+_mesa_compile_error(struct gl_context *ctx, GLenum error, const char *s);
 
-extern void _mesa_init_dlist_table( struct _glapi_table *table,
-                                    GLuint tableSize );
+void *
+_mesa_dlist_alloc(struct gl_context *ctx, GLuint opcode, GLuint sz);
 
-extern void _mesa_save_error( GLcontext *ctx, GLenum error, const char *s );
+void *
+_mesa_dlist_alloc_aligned(struct gl_context *ctx, GLuint opcode, GLuint bytes);
 
-extern void _mesa_compile_error( GLcontext *ctx, GLenum error, const char *s );
+GLint
+_mesa_dlist_alloc_opcode(struct gl_context *ctx, GLuint sz,
+                         void (*execute)(struct gl_context *, void *),
+                         void (*destroy)(struct gl_context *, void *),
+                         void (*print)(struct gl_context *, void *, FILE *));
 
+void
+_mesa_delete_list(struct gl_context *ctx, struct gl_display_list *dlist);
 
-extern void *_mesa_alloc_instruction( GLcontext *ctx, int opcode, GLint sz );
+void
+_mesa_initialize_save_table(const struct gl_context *);
 
-extern int _mesa_alloc_opcode( GLcontext *ctx, GLuint sz,
-                               void (*execute)( GLcontext *, void * ),
-                               void (*destroy)( GLcontext *, void * ),
-                               void (*print)( GLcontext *, void * ) );
+void
+_mesa_install_dlist_vtxfmt(struct _glapi_table *disp,
+                           const GLvertexformat *vfmt);
 
-extern void _mesa_save_EvalMesh2(GLenum mode, GLint i1, GLint i2,
-                                GLint j1, GLint j2 );
-extern void _mesa_save_EvalMesh1( GLenum mode, GLint i1, GLint i2 );
-extern void _mesa_save_CallLists( GLsizei n, GLenum type, const GLvoid *lists );
-extern void _mesa_save_CallList( GLuint list );
+void
+_mesa_init_display_list(struct gl_context * ctx);
 
+void
+_mesa_free_display_list_data(struct gl_context *ctx);
 
 
-#endif
+#endif /* DLIST_H */