annotate examples/example-trace/example-trace.c @ 510:21d2c66f3521

core: doxygenize alloc
author David Demelier <markand@malikania.fr>
date Sat, 04 Mar 2023 10:06:07 +0100
parents 7f7602bae0bd
children f45a023f6690
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 /*
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 * example-trace.c -- example on how to use custom trace handlers
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 *
445
773a082f0b91 misc: update copyright years
David Demelier <markand@malikania.fr>
parents: 415
diff changeset
4 * Copyright (c) 2020-2023 David Demelier <markand@malikania.fr>
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 *
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 * Permission to use, copy, modify, and/or distribute this software for any
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 * purpose with or without fee is hereby granted, provided that the above
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 * copyright notice and this permission notice appear in all copies.
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 *
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 */
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
18
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
19 #include <mlk/core/core.h>
486
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
20 #include <mlk/core/err.h>
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
21 #include <mlk/core/event.h>
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
22 #include <mlk/core/game.h>
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
23 #include <mlk/core/sys.h>
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
24 #include <mlk/core/window.h>
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
25 #include <mlk/core/painter.h>
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
26 #include <mlk/core/panic.h>
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
27 #include <mlk/core/state.h>
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
28 #include <mlk/core/trace.h>
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
29 #include <mlk/core/util.h>
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
30
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
31 #include <mlk/ui/ui.h>
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
32
486
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
33 #include <mlk/example/example.h>
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
34 #include <mlk/example/trace-hud.h>
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
35
469
0d6206cee6b9 core: state -> mlk_state
David Demelier <markand@malikania.fr>
parents: 465
diff changeset
36 static struct mlk_state *states[1];
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
37
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 static void
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
39 init(void)
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 {
486
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
41 int err;
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
42
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
43 if ((err = mlk_example_init("example-trace")) < 0)
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
44 mlk_panicf("mlk_example_init: %s", mlk_err_string(err));
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
45
500
d7855791a2b8 examples: prefix mlk
David Demelier <markand@malikania.fr>
parents: 498
diff changeset
46 mlk_trace_handler = mlk_trace_hud_handler;
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
47 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
48
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
49 static void
469
0d6206cee6b9 core: state -> mlk_state
David Demelier <markand@malikania.fr>
parents: 465
diff changeset
50 handle(struct mlk_state *st, const union mlk_event *ev)
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 {
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
52 (void)st;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
53
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
54 switch (ev->type) {
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
55 case MLK_EVENT_KEYDOWN:
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 switch (ev->key.key) {
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
57 case MLK_KEY_ESCAPE:
500
d7855791a2b8 examples: prefix mlk
David Demelier <markand@malikania.fr>
parents: 498
diff changeset
58 mlk_trace_hud_clear();
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
59 break;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
60 default:
473
02b16dd49b54 core: trace -> mlk_trace
David Demelier <markand@malikania.fr>
parents: 469
diff changeset
61 mlk_tracef("keydown pressed: %d", ev->key.key);
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
62 break;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
63 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
64 break;
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
65 case MLK_EVENT_CLICKDOWN:
473
02b16dd49b54 core: trace -> mlk_trace
David Demelier <markand@malikania.fr>
parents: 469
diff changeset
66 mlk_tracef("click at %d,%d", ev->click.x, ev->click.y);
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
67 break;
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
68 case MLK_EVENT_QUIT:
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
69 mlk_game_quit();
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
70 break;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
71 default:
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
72 break;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
73 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
74 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
75
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
76 static void
469
0d6206cee6b9 core: state -> mlk_state
David Demelier <markand@malikania.fr>
parents: 465
diff changeset
77 update(struct mlk_state *st, unsigned int ticks)
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
78 {
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
79 (void)st;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
80
500
d7855791a2b8 examples: prefix mlk
David Demelier <markand@malikania.fr>
parents: 498
diff changeset
81 mlk_trace_hud_update(ticks);
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
82 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
83
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
84 static void
469
0d6206cee6b9 core: state -> mlk_state
David Demelier <markand@malikania.fr>
parents: 465
diff changeset
85 draw(struct mlk_state *st)
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
86 {
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
87 (void)st;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
88
508
7f7602bae0bd examples: minor touches
David Demelier <markand@malikania.fr>
parents: 500
diff changeset
89 mlk_painter_set_color(MLK_EXAMPLE_BG);
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
90 mlk_painter_clear();
500
d7855791a2b8 examples: prefix mlk
David Demelier <markand@malikania.fr>
parents: 498
diff changeset
91 mlk_trace_hud_draw();
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
92 mlk_painter_present();
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
93 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
94
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
95 static void
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
96 run(void)
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
97 {
469
0d6206cee6b9 core: state -> mlk_state
David Demelier <markand@malikania.fr>
parents: 465
diff changeset
98 struct mlk_state state = {
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
99 .handle = handle,
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
100 .update = update,
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
101 .draw = draw
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
102 };
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
103
474
ca30ff96bbe0 core: util -> mlk_util
David Demelier <markand@malikania.fr>
parents: 473
diff changeset
104 mlk_game_init(states, MLK_UTIL_SIZE(states));
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
105 mlk_game_push(&state);
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
106 mlk_game_loop();
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
107 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
108
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
109 static void
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
110 quit(void)
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
111 {
498
41267f6e344d examples: use mlk_example_finish
David Demelier <markand@malikania.fr>
parents: 497
diff changeset
112 mlk_example_finish();
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
113 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
114
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
115 int
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
116 main(int argc, char **argv)
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
117 {
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
118 (void)argc;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
119 (void)argv;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
120
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
121 init();
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
122 run();
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
123 quit();
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
124 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
125