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 * Display list node. 41 * 42 * Display list instructions are stored as sequences of "nodes". Nodes 43 * are allocated in blocks. Each block has BLOCK_SIZE nodes. Blocks 44 * are linked together with a pointer. 45 * 46 * Each instruction in the display list is stored as a sequence of 47 * contiguous nodes in memory. 48 * Each node is the union of a variety of data types. 49 * 50 * Note, all of these members should be 4 bytes in size or less for the 51 * sake of compact display lists. We store 8-byte pointers in a pair of 52 * these nodes using the save/get_pointer() functions below. 53 */ 54 union gl_dlist_node 55 { 56 struct { 57 uint16_t opcode; /* dlist.c : enum Opcode */ 58 uint16_t InstSize; 59 }; 60 GLboolean b; 61 GLbitfield bf; 62 GLubyte ub; 63 GLshort s; 64 GLushort us; 65 GLint i; 66 GLuint ui; 67 GLenum e; 68 GLfloat f; 69 GLsizei si; 70 }; 71 72 /** 73 * Describes the location and size of a glBitmap image in a texture atlas. 74 */ 75 struct gl_bitmap_glyph 76 { 77 unsigned short x, y, w, h; /**< position and size in the texture */ 78 float xorig, yorig; /**< bitmap origin */ 79 float xmove, ymove; /**< rasterpos move */ 80 }; 81 82 83 /** 84 * Describes a set of glBitmap display lists which live in a texture atlas. 85 * The idea is when we see a code sequence of glListBase(b), glCallLists(n) 86 * we're probably drawing bitmap font glyphs. We try to put all the bitmap 87 * glyphs into one texture map then render the glCallLists as a textured 88 * quadstrip. 89 */ 90 struct gl_bitmap_atlas 91 { 92 GLint Id; 93 bool complete; /**< Is the atlas ready to use? */ 94 bool incomplete; /**< Did we fail to construct this atlas? */ 95 96 unsigned numBitmaps; 97 unsigned texWidth, texHeight; 98 struct gl_texture_object *texObj; 99 struct gl_texture_image *texImage; 100 101 unsigned glyphHeight; 102 103 struct gl_bitmap_glyph *glyphs; 104 }; 105 106 void 107 _mesa_delete_bitmap_atlas(struct gl_context *ctx, 108 struct gl_bitmap_atlas *atlas); 109 110 struct gl_display_list * 111 _mesa_lookup_list(struct gl_context *ctx, GLuint list, bool locked); 112 113 void 114 _mesa_compile_error(struct gl_context *ctx, GLenum error, const char *s); 115 116 void * 117 _mesa_dlist_alloc_vertex_list(struct gl_context *ctx, 118 bool copy_to_current); 119 120 void 121 _mesa_delete_list(struct gl_context *ctx, struct gl_display_list *dlist); 122 123 void 124 _mesa_initialize_save_table(const struct gl_context *); 125 126 void 127 _mesa_init_display_list(struct gl_context * ctx); 128 129 void 130 _mesa_install_save_vtxfmt(struct gl_context *ctx); 131 132 bool 133 _mesa_get_list(struct gl_context *ctx, GLuint list, 134 struct gl_display_list **dlist, 135 bool locked); 136 137 #endif /* DLIST_H */ 138