#ifndef _ELPUT_H # define _ELPUT_H # ifdef EAPI # undef EAPI # endif # ifdef _WIN32 # ifdef EFL_ELPUT_BUILD # ifdef DLL_EXPORT # define EAPI __declspec(dllexport) # else # define EAPI # endif /* ! DLL_EXPORT */ # else # define EAPI __declspec(dllimport) # endif /* ! EFL_ELPUT_BUILD */ # else # ifdef __GNUC__ # if __GNUC__ >= 4 # define EAPI __attribute__ ((visibility("default"))) # else # define EAPI # endif # else # define EAPI # endif # endif /* ! _WIN32 */ # ifdef EFL_BETA_API_SUPPORT /* opaque structure to represent an input manager */ typedef struct _Elput_Manager Elput_Manager; /* opaque structure to represent an input seat */ typedef struct _Elput_Seat Elput_Seat; /* opaque structure to represent an input device */ typedef struct _Elput_Device Elput_Device; /* opaque structure to represent a keyboard */ typedef struct _Elput_Keyboard Elput_Keyboard; /* opaque structure to represent a mouse */ typedef struct _Elput_Pointer Elput_Pointer; /* opaque structure to represent a touch device */ typedef struct _Elput_Touch Elput_Touch; /* structure to represent event for seat capability changes */ typedef struct _Elput_Event_Seat_Caps { int pointer_count; int keyboard_count; int touch_count; Elput_Seat *seat; } Elput_Event_Seat_Caps; /* structure to represent event for seat frame */ typedef struct _Elput_Event_Seat_Frame { Elput_Seat *seat; } Elput_Event_Seat_Frame; /* structure to represent event for seat keymap changes */ typedef struct _Elput_Event_Keymap_Send { int fd, format; size_t size; } Elput_Event_Keymap_Send; /* structure to represent event for seat modifiers changes */ typedef struct _Elput_Event_Modifiers_Send { unsigned int depressed; unsigned int latched; unsigned int locked; unsigned int group; } Elput_Event_Modifiers_Send; typedef enum _Elput_Device_Change_Type { ELPUT_DEVICE_ADDED, ELPUT_DEVICE_REMOVED, } Elput_Device_Change_Type; /* structure to represent event for device being added or removed */ typedef struct _Elput_Event_Device_Change { Elput_Device *device; Elput_Device_Change_Type type; } Elput_Event_Device_Change; /* structure to represent session active changes */ typedef struct _Elput_Event_Session_Active { const char *session; Eina_Bool active : 1; } Elput_Event_Session_Active; EAPI extern int ELPUT_EVENT_SEAT_CAPS; EAPI extern int ELPUT_EVENT_SEAT_FRAME; EAPI extern int ELPUT_EVENT_KEYMAP_SEND; EAPI extern int ELPUT_EVENT_MODIFIERS_SEND; EAPI extern int ELPUT_EVENT_DEVICE_CHANGE; EAPI extern int ELPUT_EVENT_SESSION_ACTIVE; /** * @file * @brief Ecore functions for dealing with libinput * * @defgroup Elput_Group Elput - libinput integration * @ingrup Ecore * * Elput provides a wrapper and functions for using libinput * * @li @ref Elput_Init_Group * @li @ref Elput_Manager_Group * @li @ref Elput_Input_Group * */ /** * @defgroup Elput_Init_Group Library Init and Shutdown functions * * Functions that start and shutdown the Elput library */ /** * Initialize the Elput library * * @return The number of times the library has been initialized without being * shutdown. 0 is returned if an error occurs. * * @ingroup Elput_Init_Group * @since 1.18 */ EAPI int elput_init(void); /** * Shutdown the Elput library * * @return The number of times the library has been initialized without being * shutdown. 0 is returned if an error occurs. * * @ingroup Elput_Init_Group * @since 1.18 */ EAPI int elput_shutdown(void); /** * @defgroup Elput_Manager_Group * * Functions that deal with connecting, disconnecting, opening, closing * of input devices. */ /** * Create an input manager on the specified seat * * @param seat * @param tty * @param sync * * @return A Elput_Manager on success, NULL on failure * * @ingroup Elput_Manager_Group * @since 1.18 */ EAPI Elput_Manager *elput_manager_connect(const char *seat, unsigned int tty); /** * Disconnect an input manager * * @param manager * * @ingroup Elput_Manager_Group * @since 1.18 */ EAPI void elput_manager_disconnect(Elput_Manager *manager); /** * Request input manager to open a file * * @param manager * @param path * @param flags * * @return Filedescriptor of opened file or -1 on failure * * @ingroup Elput_Manager_Group * @since 1.18 */ EAPI int elput_manager_open(Elput_Manager *manager, const char *path, int flags); /** * Request input manager to close a file * * @param manager * @param fd * * @ingroup Elput_Manager_Group * @since 1.18 */ EAPI void elput_manager_close(Elput_Manager *manager, int fd); /** * Request to switch to a given vt * * @param manager * @param vt * * @return EINA_TRUE on success, EINA_FALSE otherwise * * @ingroup Elput_Manager_Group * @since 1.18 */ EAPI Eina_Bool elput_manager_vt_set(Elput_Manager *manager, int vt); /** * Get the list of seats from a manager * * @param manager * * @return An Eina_List of existing Elput_Seats or NULL on failure * * @ingroup Elput_Manager_Group * @since 1.18 */ EAPI const Eina_List *elput_manager_seats_get(Elput_Manager *manager); /** * Set which window to use for this input manager * * @brief This function should be used to specify which window to set on the * input manager. Setting a window on the input manager is done so that * when we raise events (mouse movement, keyboard key, etc) then * this window is passed to the event structure as the window which * the event occured on. * * @param manager * @param window * * @ingroup Elput_Manager_Group * @since 1.18 */ EAPI void elput_manager_window_set(Elput_Manager *manager, unsigned int window); /** * @defgroup Elput_Input_Group Elput input functions * * Functions that deal with setup of inputs */ /** * Initialize input * * @param manager * * @return EINA_TRUE on success, EINA_FALSE on failure * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI Eina_Bool elput_input_init(Elput_Manager *manager); /** * Shutdown input * * @param manager * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI void elput_input_shutdown(Elput_Manager *manager); /** * Get the pointer position on a given seat * * @param manager * @param seat * @param x * @param y * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI void elput_input_pointer_xy_get(Elput_Manager *manager, const char *seat, int *x, int *y); /** * Set the pointer position on a given seat * * @param manager * @param seat * @param x * @param y * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI void elput_input_pointer_xy_set(Elput_Manager *manager, const char *seat, int x, int y); /** * Set the pointer left-handed mode * * @param manager * @param seat * @param left * * @return EINA_TRUE on success, EINA_FALSE otherwise * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI Eina_Bool elput_input_pointer_left_handed_set(Elput_Manager *manager, const char *seat, Eina_Bool left); /** * Get the list of devices on a given seat * * @param seat * * @return An Eina_List of existing Elput_Devices on a given seat or NULL on failure * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI const Eina_List *elput_input_devices_get(Elput_Seat *seat); /** * Set the maximum position of any existing mouse pointers * * @param manager * @param maxw * @param maxh * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI void elput_input_pointer_max_set(Elput_Manager *manager, int maxw, int maxh); /** * Calibrate input devices for given screen size * * @param manager * @param w * @param h * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI void elput_input_devices_calibrate(Elput_Manager *manager, int w, int h); /** * Enable key remap functionality * * @param manager * @param enable * * @return EINA_TRUE on success, EINA_FALSE otherwise * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI Eina_Bool elput_input_key_remap_enable(Elput_Manager *manager, Eina_Bool enable); /** * Set a given set of keys as remapped keys * * @param manager * @param from_keys * @param to_keys * @param num * * @return EINA_TRUE on success, EINA_FALSE otherwise * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI Eina_Bool elput_input_key_remap_set(Elput_Manager *manager, int *from_keys, int *to_keys, int num); /** * Set a cached context to be used for keyboards * * @param manager * @param context * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI void elput_input_keyboard_cached_context_set(Elput_Manager *manager, void *context); /** * Set a cached keymap to be used for keyboards * * @param manager * @param keymap * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI void elput_input_keyboard_cached_keymap_set(Elput_Manager *manager, void *keymap); /** * Return the output name associated with a given device * * @param device * * @return An Eina_Stringshare of the output name for this device, or NULL on error * * @ingroup Elput_Input_Group * @since 1.18 */ EAPI Eina_Stringshare *elput_input_device_output_name_get(Elput_Device *device); # endif # undef EAPI # define EAPI #endif