annotate libmlk-core/mlk/core/gamepad.h @ 443:dfc65293d984

core: initial gamepad support
author David Demelier <markand@malikania.fr>
date Sat, 21 Jan 2023 20:20:34 +0100
parents
children 773a082f0b91
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
443
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 /*
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 * gamepad.h -- game controller support
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 *
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
4 * Copyright (c) 2020-2022 David Demelier <markand@malikania.fr>
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 *
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 * Permission to use, copy, modify, and/or distribute this software for any
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 * purpose with or without fee is hereby granted, provided that the above
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 * copyright notice and this permission notice appear in all copies.
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 *
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 */
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
18
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 #ifndef MLK_CORE_GAMEPAD_H
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
20 #define MLK_CORE_GAMEPAD_H
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
21
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
22 #include "core.h"
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
23
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
24 CORE_BEGIN_DECLS
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
25
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
26 enum mlk_gamepad_button {
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
27 MLK_GAMEPAD_BUTTON_UNKNOWN,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
28 MLK_GAMEPAD_BUTTON_A,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
29 MLK_GAMEPAD_BUTTON_B,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 MLK_GAMEPAD_BUTTON_X,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
31 MLK_GAMEPAD_BUTTON_Y,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
32 MLK_GAMEPAD_BUTTON_BACK,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
33 MLK_GAMEPAD_BUTTON_LOGO,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
34 MLK_GAMEPAD_BUTTON_START,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
35 MLK_GAMEPAD_BUTTON_LTHUMB,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
36 MLK_GAMEPAD_BUTTON_RTHUMB,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
37 MLK_GAMEPAD_BUTTON_LSHOULDER,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 MLK_GAMEPAD_BUTTON_RSHOULDER,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
39 MLK_GAMEPAD_BUTTON_UP,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 MLK_GAMEPAD_BUTTON_DOWN,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
41 MLK_GAMEPAD_BUTTON_LEFT,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
42 MLK_GAMEPAD_BUTTON_RIGHT
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
43 };
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
44
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
45 enum mlk_gamepad_axis {
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
46 MLK_GAMEPAD_AXIS_UNKNOWN,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
47 MLK_GAMEPAD_AXIS_LX,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
48 MLK_GAMEPAD_AXIS_LY,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
49 MLK_GAMEPAD_AXIS_RX,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
50 MLK_GAMEPAD_AXIS_RY,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 MLK_GAMEPAD_AXIS_LTRIGGER,
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
52 MLK_GAMEPAD_AXIS_RTRIGGER
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
53 };
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
54
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
55 struct mlk_gamepad {
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 const char *name;
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 void *handle;
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 };
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
59
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
60 struct mlk_gamepad_iter {
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
61 const char *name;
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
62 int idx;
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
63 int end;
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
64 };
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
65
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
66 int
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
67 mlk_gamepad_open(struct mlk_gamepad *pad, int idx);
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
68
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
69 void
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
70 mlk_gamepad_finish(struct mlk_gamepad *pad);
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
71
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
72 int
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
73 mlk_gamepad_iter_begin(struct mlk_gamepad_iter *);
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
74
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
75 int
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
76 mlk_gamepad_iter_next(struct mlk_gamepad_iter *);
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
77
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
78 CORE_END_DECLS
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
79
dfc65293d984 core: initial gamepad support
David Demelier <markand@malikania.fr>
parents:
diff changeset
80 #endif /* !MLK_CORE_GAMEPAD_H */