annotate examples/example-debug/example-debug.c @ 522:f45a023f6690

core: doxygenize game
author David Demelier <markand@malikania.fr>
date Sat, 04 Mar 2023 16:47:54 +0100
parents d49a05e7a5b5
children c7664b679a95
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-debug.c -- example on how to use debug interface
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: 433
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
431
8f59201dc76b core: cleanup hierarchy
David Demelier <markand@malikania.fr>
parents: 415
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>
431
8f59201dc76b core: cleanup hierarchy
David Demelier <markand@malikania.fr>
parents: 415
diff changeset
21 #include <mlk/core/event.h>
8f59201dc76b core: cleanup hierarchy
David Demelier <markand@malikania.fr>
parents: 415
diff changeset
22 #include <mlk/core/game.h>
8f59201dc76b core: cleanup hierarchy
David Demelier <markand@malikania.fr>
parents: 415
diff changeset
23 #include <mlk/core/window.h>
8f59201dc76b core: cleanup hierarchy
David Demelier <markand@malikania.fr>
parents: 415
diff changeset
24 #include <mlk/core/painter.h>
8f59201dc76b core: cleanup hierarchy
David Demelier <markand@malikania.fr>
parents: 415
diff changeset
25 #include <mlk/core/panic.h>
8f59201dc76b core: cleanup hierarchy
David Demelier <markand@malikania.fr>
parents: 415
diff changeset
26 #include <mlk/core/state.h>
8f59201dc76b core: cleanup hierarchy
David Demelier <markand@malikania.fr>
parents: 415
diff changeset
27 #include <mlk/core/util.h>
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
28
433
862b15c3a3ae ui: cleanup hierarchy
David Demelier <markand@malikania.fr>
parents: 431
diff changeset
29 #include <mlk/ui/debug.h>
862b15c3a3ae ui: cleanup hierarchy
David Demelier <markand@malikania.fr>
parents: 431
diff changeset
30 #include <mlk/ui/ui.h>
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
31
486
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
32 #include <mlk/example/example.h>
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
33
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
34 static int mouse_x;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
35 static int mouse_y;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
36
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
37 static void
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 init(void)
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
39 {
486
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
40 int err;
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
41
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
42 if ((err = mlk_example_init("example-debug")) < 0)
d6757c30658e core: rework errors
David Demelier <markand@malikania.fr>
parents: 485
diff changeset
43 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
44
490
d4e50da7e5c5 ui: debug -> mlk_debug
David Demelier <markand@malikania.fr>
parents: 486
diff changeset
45 mlk_debug_options.enable = 1;
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
46 }
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 static void
469
0d6206cee6b9 core: state -> mlk_state
David Demelier <markand@malikania.fr>
parents: 465
diff changeset
49 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
50 {
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 (void)st;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
52
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
53 switch (ev->type) {
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
54 case MLK_EVENT_MOUSE:
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
55 mouse_x = ev->mouse.x;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 mouse_y = ev->mouse.y;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 break;
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
58 case MLK_EVENT_QUIT:
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
59 mlk_game_quit();
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
60 break;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
61 default:
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 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
65
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
66 static void
469
0d6206cee6b9 core: state -> mlk_state
David Demelier <markand@malikania.fr>
parents: 465
diff changeset
67 draw(struct mlk_state *st)
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
68 {
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
69 (void)st;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
70
490
d4e50da7e5c5 ui: debug -> mlk_debug
David Demelier <markand@malikania.fr>
parents: 486
diff changeset
71 struct mlk_debug_report report = {0};
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
72
507
d49a05e7a5b5 ui: separate delegate/style
David Demelier <markand@malikania.fr>
parents: 498
diff changeset
73 mlk_painter_set_color(MLK_EXAMPLE_BG);
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
74 mlk_painter_clear();
490
d4e50da7e5c5 ui: debug -> mlk_debug
David Demelier <markand@malikania.fr>
parents: 486
diff changeset
75 mlk_debugf(&report, "Game running.");
d4e50da7e5c5 ui: debug -> mlk_debug
David Demelier <markand@malikania.fr>
parents: 486
diff changeset
76 mlk_debugf(&report, "mouse: %d, %d", mouse_x, mouse_y);
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
77 mlk_painter_present();
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
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
80 static void
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
81 run(void)
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
82 {
469
0d6206cee6b9 core: state -> mlk_state
David Demelier <markand@malikania.fr>
parents: 465
diff changeset
83 struct mlk_state state = {
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
84 .handle = handle,
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
85 .draw = draw
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
522
f45a023f6690 core: doxygenize game
David Demelier <markand@malikania.fr>
parents: 507
diff changeset
88 mlk_game_init();
459
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
89 mlk_game_push(&state);
541cb950997b examples: add libmlk-example library
David Demelier <markand@malikania.fr>
parents: 445
diff changeset
90 mlk_game_loop();
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
91 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
92
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
93 static void
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
94 quit(void)
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
95 {
498
41267f6e344d examples: use mlk_example_finish
David Demelier <markand@malikania.fr>
parents: 497
diff changeset
96 mlk_example_finish();
415
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
97 }
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
98
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
99 int
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
100 main(int argc, char **argv)
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
101 {
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
102 (void)argc;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
103 (void)argv;
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
104
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
105 init();
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
106 run();
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
107 quit();
a5b98db4fd87 misc: fix .hgignore too greedy
David Demelier <markand@malikania.fr>
parents:
diff changeset
108 }