xref: /aosp_15_r20/external/mesa3d/src/mesa/main/dlist.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
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 struct gl_display_list *
73 _mesa_lookup_list(struct gl_context *ctx, GLuint list, bool locked);
74 
75 void
76 _mesa_compile_error(struct gl_context *ctx, GLenum error, const char *s);
77 
78 void *
79 _mesa_dlist_alloc_vertex_list(struct gl_context *ctx,
80                               bool copy_to_current);
81 
82 void
83 _mesa_delete_list(struct gl_context *ctx, struct gl_display_list *dlist);
84 
85 void
86 _mesa_init_dispatch_save(const struct gl_context *);
87 
88 void
89 _mesa_init_display_list(struct gl_context * ctx);
90 
91 void
92 _mesa_init_dispatch_save_begin_end(struct gl_context *ctx);
93 
94 bool
95 _mesa_get_list(struct gl_context *ctx, GLuint list,
96                struct gl_display_list **dlist,
97                bool locked);
98 
99 #endif /* DLIST_H */
100