@mukea/uiohook-napi 1.5.4

package/libuiohook/src/x11/input_helper.h

@@ -0,0 +1,108 @@
+/* libUIOHook: Cross-platform keyboard and mouse hooking from userland.
+ * Copyright (C) 2006-2023 Alexander Barker.  All Rights Reserved.
+ * https://github.com/kwhat/libuiohook/
+ *
+ * libUIOHook is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * libUIOHook is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef _included_input_helper
+#define _included_input_helper
+
+#include <stdint.h>
+#include <X11/Xlib.h>
+
+#ifdef USE_XKB_COMMON
+#include <X11/Xlib-xcb.h>
+#include <xkbcommon/xkbcommon.h>
+#include <xkbcommon/xkbcommon-x11.h>
+#endif
+
+
+// Virtual button codes that are not defined by X11.
+#define Button1     1
+#define Button2     2
+#define Button3     3
+#define WheelUp     4
+#define WheelDown   5
+#define WheelLeft   6
+#define WheelRight  7
+#define XButton1    8
+#define XButton2    9
+
+// Helper display used by input helper, properties and post event.
+extern Display *helper_disp;
+
+/* Converts a X11 key symbol to a single Unicode character.  No direct X11
+ * functionality exists to provide this information.
+ */
+extern size_t keysym_to_unicode(KeySym keysym, uint16_t *buffer, size_t size);
+
+/* Convert a single Unicode character to a X11 key symbol.  This function
+ * provides a better translation than XStringToKeysym() for Unicode characters.
+ */
+extern KeySym unicode_to_keysym(uint16_t unicode);
+
+/* Converts a X11 key code to the appropriate keyboard scan code.
+ */
+extern uint16_t keycode_to_scancode(KeyCode keycode);
+
+/* Converts a keyboard scan code to the appropriate X11 key code.
+ */
+extern KeyCode scancode_to_keycode(uint16_t scancode);
+
+
+#ifdef USE_XKB_COMMON
+
+/* Converts a X11 key code to a Unicode character sequence.  libXKBCommon support
+ * is required for this method.
+ */
+extern size_t keycode_to_unicode(struct xkb_state* state, KeyCode keycode, uint16_t *buffer, size_t size);
+
+/* Create a xkb_state structure and return a pointer to it.
+ */
+extern struct xkb_state * create_xkb_state(struct xkb_context *context, xcb_connection_t *connection);
+
+/* Release xkb_state structure created by create_xkb_state().
+ */
+extern void destroy_xkb_state(struct xkb_state* state);
+
+#else
+
+/* Converts a X11 key code and event mask to the appropriate X11 key symbol.
+ * This functions in much the same way as XKeycodeToKeysym() but allows for a
+ * faster and more flexible lookup.
+ */
+extern KeySym keycode_to_keysym(KeyCode keycode, unsigned int modifier_mask);
+
+#endif
+
+/* Lookup a X11 buttons possible remapping and return that value.
+ */
+extern unsigned int button_map_lookup(unsigned int button);
+
+/* Initialize items required for KeyCodeToKeySym() and KeySymToUnicode()
+ * functionality.  This method is called by OnLibraryLoad() and may need to be
+ * called in combination with UnloadInputHelper() if the native keyboard layout
+ * is changed.
+ */
+extern void load_input_helper();
+
+/* De-initialize items required for KeyCodeToKeySym() and KeySymToUnicode()
+ * functionality.  This method is called by OnLibraryUnload() and may need to be
+ * called in combination with LoadInputHelper() if the native keyboard layout
+ * is changed.
+ */
+extern void unload_input_helper();
+
+#endif