annotate src/libmlk-core/core/drawable-stack.c @ 419:1b4e61bdb9ab

core: introduce err.h
author David Demelier <markand@malikania.fr>
date Wed, 12 Oct 2022 15:06:18 +0200
parents b172b10bbe1c
children b0579ae033ed
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
368
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 /*
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 * drawable-stack.c -- convenient stack of drawables
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 *
378
460c78706989 misc: update copyright years
David Demelier <markand@malikania.fr>
parents: 368
diff changeset
4 * Copyright (c) 2020-2022 David Demelier <markand@malikania.fr>
368
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 *
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 * Permission to use, copy, modify, and/or distribute this software for any
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 * purpose with or without fee is hereby granted, provided that the above
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 * copyright notice and this permission notice appear in all copies.
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 *
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 */
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
18
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 #include <assert.h>
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
20 #include <string.h>
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
21
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
22 #include "drawable.h"
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
23 #include "drawable-stack.h"
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
24
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
25 #define DRAWABLE_FOREACH(st, iter) \
393
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
26 for (size_t i = 0; i < (st)->objectsz && ((iter) = (st)->objects[i], 1); ++i)
368
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
27
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
28 void
393
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
29 drawable_stack_init(struct drawable_stack *st, struct drawable **objects, size_t objectsz)
368
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 {
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
31 assert(st);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
32
393
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
33 st->objects = objects;
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
34 st->objectsz = objectsz;
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
35
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
36 for (size_t i = 0; i < st->objectsz; ++i)
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
37 st->objects[i] = NULL;
368
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
39
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 int
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
41 drawable_stack_add(struct drawable_stack *st, struct drawable *dw)
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
42 {
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
43 assert(st);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
44 assert(dw);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
45
393
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
46 for (size_t i = 0; i < st->objectsz; ++i) {
368
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
47 if (!st->objects[i]) {
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
48 st->objects[i] = dw;
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
49 return 0;
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
50 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
52
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
53 return -1;
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
54 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
55
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 int
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 drawable_stack_update(struct drawable_stack *st, unsigned int ticks)
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 {
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
59 assert(st);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
60
393
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
61 struct drawable *dw;
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
62
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
63 for (size_t i = 0; i < st->objectsz; ++i) {
b172b10bbe1c core: do the same for drawables
David Demelier <markand@malikania.fr>
parents: 378
diff changeset
64 dw = st->objects[i];
368
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
65
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
66 if (dw && drawable_update(dw, ticks)) {
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
67 drawable_end(dw);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
68 drawable_finish(dw);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
69 st->objects[i] = NULL;
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
70 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
71 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
72
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
73 /*
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
74 * We process the array again in case a drawable added a new drawable
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
75 * within the update function.
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
76 */
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
77 return drawable_stack_completed(st);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
78 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
79
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
80 void
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
81 drawable_stack_draw(struct drawable_stack *st)
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
82 {
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
83 assert(st);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
84
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
85 struct drawable *dw;
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
86
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
87 DRAWABLE_FOREACH(st, dw)
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
88 if (dw)
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
89 drawable_draw(dw);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
90 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
91
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
92 int
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
93 drawable_stack_completed(const struct drawable_stack *st)
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
94 {
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
95 assert(st);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
96
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
97 struct drawable *dw;
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
98
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
99 DRAWABLE_FOREACH(st, dw)
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
100 if (dw)
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
101 return 0;
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
102
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
103 return 1;
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
104 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
105
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
106 void
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
107 drawable_stack_finish(struct drawable_stack *st)
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
108 {
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
109 assert(st);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
110
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
111 struct drawable *dw;
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
112
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
113 DRAWABLE_FOREACH(st, dw) {
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
114 if (dw) {
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
115 drawable_end(dw);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
116 drawable_finish(dw);
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
117 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
118 }
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
119
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
120 memset(st, 0, sizeof (*st));
15bdac29ba4b core: split drawable and drawable_stack
David Demelier <markand@malikania.fr>
parents:
diff changeset
121 }