1 /**
2  * \file dlist.h
3  * Display lists management.
4  */
5 
6 /*
7  * Mesa 3-D graphics library
8  *
9  * Copyright (C) 1999-2006  Brian Paul   All Rights Reserved.
10  *
11  * Permission is hereby granted, free of charge, to any person obtaining a
12  * copy of this software and associated documentation files (the "Software"),
13  * to deal in the Software without restriction, including without limitation
14  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
15  * and/or sell copies of the Software, and to permit persons to whom the
16  * Software is furnished to do so, subject to the following conditions:
17  *
18  * The above copyright notice and this permission notice shall be included
19  * in all copies or substantial portions of the Software.
20  *
21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
22  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
24  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
25  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
26  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
27  * OTHER DEALINGS IN THE SOFTWARE.
28  */
29 
30 
31 
32 #ifndef DLIST_H
33 #define DLIST_H
34 
35 #include <stdio.h>
36 
37 struct gl_context;
38 
39 /**
40  * Describes the location and size of a glBitmap image in a texture atlas.
41  */
42 struct gl_bitmap_glyph
43 {
44    unsigned short x, y, w, h;  /**< position and size in the texture */
45    float xorig, yorig;         /**< bitmap origin */
46    float xmove, ymove;         /**< rasterpos move */
47 };
48 
49 
50 /**
51  * Describes a set of glBitmap display lists which live in a texture atlas.
52  * The idea is when we see a code sequence of glListBase(b), glCallLists(n)
53  * we're probably drawing bitmap font glyphs.  We try to put all the bitmap
54  * glyphs into one texture map then render the glCallLists as a textured
55  * quadstrip.
56  */
57 struct gl_bitmap_atlas
58 {
59    GLint Id;
60    bool complete;     /**< Is the atlas ready to use? */
61    bool incomplete;   /**< Did we fail to construct this atlas? */
62 
63    unsigned numBitmaps;
64    unsigned texWidth, texHeight;
65    struct gl_texture_object *texObj;
66    struct gl_texture_image *texImage;
67 
68    unsigned glyphHeight;
69 
70    struct gl_bitmap_glyph *glyphs;
71 };
72 
73 void
74 _mesa_delete_bitmap_atlas(struct gl_context *ctx,
75                           struct gl_bitmap_atlas *atlas);
76 
77 
78 GLboolean GLAPIENTRY
79 _mesa_IsList(GLuint list);
80 
81 void GLAPIENTRY
82 _mesa_DeleteLists(GLuint list, GLsizei range);
83 
84 GLuint GLAPIENTRY
85 _mesa_GenLists(GLsizei range);
86 
87 void GLAPIENTRY
88 _mesa_NewList(GLuint name, GLenum mode);
89 
90 void GLAPIENTRY
91 _mesa_EndList(void);
92 
93 void GLAPIENTRY
94 _mesa_CallList(GLuint list);
95 
96 void GLAPIENTRY
97 _mesa_CallLists(GLsizei n, GLenum type, const GLvoid *lists);
98 
99 void GLAPIENTRY
100 _mesa_ListBase(GLuint base);
101 
102 struct gl_display_list *
103 _mesa_lookup_list(struct gl_context *ctx, GLuint list, bool locked);
104 
105 void
106 _mesa_compile_error(struct gl_context *ctx, GLenum error, const char *s);
107 
108 void *
109 _mesa_dlist_alloc_vertex_list(struct gl_context *ctx,
110                               bool copy_to_current);
111 
112 void
113 _mesa_delete_list(struct gl_context *ctx, struct gl_display_list *dlist);
114 
115 void
116 _mesa_initialize_save_table(const struct gl_context *);
117 
118 void
119 _mesa_install_dlist_vtxfmt(struct _glapi_table *disp,
120                            const GLvertexformat *vfmt);
121 
122 void
123 _mesa_init_display_list(struct gl_context * ctx);
124 
125 bool
126 _mesa_get_list(struct gl_context *ctx, GLuint list,
127                struct gl_display_list **dlist,
128                bool locked);
129 
130 #endif /* DLIST_H */
131