libeis.h

Go to the documentation of this file.

/*
 * Copyright © 2020 Red Hat, Inc.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the next
 * paragraph) shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 * DEALINGS IN THE SOFTWARE.
 */
 
 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stddef.h>
#include <stdbool.h>
#include <stdint.h>
 
struct eis;
struct eis_client;
struct eis_device;
struct eis_seat;
struct eis_event;
struct eis_keymap;
 
enum eis_device_capability {
        EIS_DEVICE_CAP_POINTER = 1,
        EIS_DEVICE_CAP_POINTER_ABSOLUTE,
        EIS_DEVICE_CAP_KEYBOARD,
        EIS_DEVICE_CAP_TOUCH,
};
 
enum eis_keymap_type {
        EIS_KEYMAP_TYPE_XKB = 1,
};
 
enum eis_event_type {
        EIS_EVENT_CLIENT_CONNECT = 1,
        EIS_EVENT_CLIENT_DISCONNECT,
 
        EIS_EVENT_DEVICE_ADDED,
        EIS_EVENT_DEVICE_REMOVED,
 
        EIS_EVENT_POINTER_MOTION = 300,
        EIS_EVENT_POINTER_MOTION_ABSOLUTE,
        EIS_EVENT_POINTER_BUTTON,
        EIS_EVENT_POINTER_SCROLL,
        EIS_EVENT_POINTER_SCROLL_DISCRETE,
 
        EIS_EVENT_KEYBOARD_KEY = 400,
 
        EIS_EVENT_TOUCH_DOWN = 500,
        EIS_EVENT_TOUCH_UP,
        EIS_EVENT_TOUCH_MOTION,
};
 
struct eis *
eis_new(void *user_data);
 
enum eis_log_priority {
        EIS_LOG_PRIORITY_DEBUG = 10,
        EIS_LOG_PRIORITY_INFO = 20,
        EIS_LOG_PRIORITY_WARNING = 30,
        EIS_LOG_PRIORITY_ERROR = 40,
};
 
typedef void (*eis_log_handler)(struct eis *eis,
                                enum eis_log_priority priority,
                                const char *message,
                                bool is_continuation);
void
eis_log_set_handler(struct eis *eis, eis_log_handler log_handler);
 
void
eis_log_set_priority(struct eis *eis, enum eis_log_priority priority);
 
enum eis_log_priority
eis_log_get_priority(const struct eis *eis);
 
struct eis *
eis_ref(struct eis *eis);
 
struct eis *
eis_unref(struct eis *eis);
 
void *
eis_get_user_data(struct eis *eis);
 
void
eis_set_user_data(struct eis *eis, void *user_data);
 
int
eis_setup_backend_socket(struct eis *ctx, const char *path);
 
int
eis_setup_backend_fd(struct eis *ctx);
 
int
eis_backend_fd_add_fd(struct eis *ctx, int fd);
 
int
eis_get_fd(struct eis *eis);
 
void
eis_dispatch(struct eis *eis);
 
struct eis_event *
eis_get_event(struct eis *eis);
 
struct eis_event *
eis_peek_event(struct eis *eis);
 
struct eis_event *
eis_event_unref(struct eis_event *event);
 
struct eis_client *
eis_client_ref(struct eis_client *client);
 
struct eis_client *
eis_client_unref(struct eis_client *client);
 
void *
eis_client_get_user_data(struct eis_client *eis_client);
 
void
eis_client_set_user_data(struct eis_client *eis_client, void *user_data);
 
const char *
eis_client_get_name(struct eis_client *client);
 
void
eis_client_connect(struct eis_client *client);
 
void
eis_client_disconnect(struct eis_client *client);
 
struct eis_seat *
eis_client_new_seat(struct eis_client *client, const char *name);
 
struct eis_seat *
eis_seat_ref(struct eis_seat *seat);
 
struct eis_seat *
eis_seat_unref(struct eis_seat *seat);
 
struct eis_client *
eis_seat_get_client(struct eis_seat *eis_seat);
 
const char *
eis_seat_get_name(struct eis_seat *eis_seat);
 
void *
eis_seat_get_user_data(struct eis_seat *eis_seat);
 
void
eis_seat_set_user_data(struct eis_seat *eis_seat, void *user_data);
 
void
eis_seat_allow_capability(struct eis_seat *seat,
                          enum eis_device_capability cap);
 
void
eis_seat_add(struct eis_seat *seat);
 
void
eis_seat_remove(struct eis_seat *seat);
 
enum eis_event_type
eis_event_get_type(struct eis_event *event);
 
struct eis_client *
eis_event_get_client(struct eis_event *event);
 
struct eis_client *
eis_device_get_client(struct eis_device *device);
 
struct eis_seat *
eis_device_get_seat(struct eis_device *device);
 
struct eis_device *
eis_device_ref(struct eis_device *device);
 
struct eis_device *
eis_device_unref(struct eis_device *device);
 
void *
eis_device_get_user_data(struct eis_device *eis_device);
 
void
eis_device_set_user_data(struct eis_device *eis_device, void *user_data);
 
const char *
eis_device_get_name(struct eis_device *device);
 
void
eis_device_set_name(struct eis_device *device, const char *name);
 
bool
eis_device_has_capability(struct eis_device *device,
                          enum eis_device_capability cap);
 
void
eis_device_allow_capability(struct eis_device *device,
                            enum eis_device_capability cap);
 
void
eis_device_connect(struct eis_device *device);
 
void
eis_device_disconnect(struct eis_device *device);
 
void
eis_device_suspend(struct eis_device *device);
 
void
eis_device_resume(struct eis_device *device);
 
uint32_t
eis_device_pointer_get_width(struct eis_device *device);
 
uint32_t
eis_device_pointer_get_height(struct eis_device *device);
 
uint32_t
eis_device_touch_get_width(struct eis_device *device);
 
uint32_t
eis_device_touch_get_height(struct eis_device *device);
 
struct eis_keymap *
eis_keymap_new(enum eis_keymap_type type, int fd, size_t size);
 
size_t
eis_keymap_get_size(struct eis_keymap *keymap);
 
enum eis_keymap_type
eis_keymap_get_type(struct eis_keymap *keymap);
 
int
eis_keymap_get_fd(struct eis_keymap *keymap);
 
struct eis_keymap *
eis_keymap_ref(struct eis_keymap *keymap);
 
struct eis_keymap *
eis_keymap_unref(struct eis_keymap *keymap);
 
struct eis_device *
eis_keymap_get_device(struct eis_keymap *keymap);
 
struct eis_keymap *
eis_device_keyboard_get_keymap(struct eis_device *device);
 
void
eis_device_keyboard_set_keymap(struct eis_device *device,
                               struct eis_keymap *keymap);
 
struct eis_device *
eis_event_get_device(struct eis_event *event);
 
double
eis_event_pointer_get_dx(struct eis_event *event);
 
double
eis_event_pointer_get_dy(struct eis_event *event);
 
double
eis_event_pointer_get_absolute_x(struct eis_event *event);
 
double
eis_event_pointer_get_absolute_y(struct eis_event *event);
 
uint32_t
eis_event_pointer_get_button(struct eis_event *event);
 
bool
eis_event_pointer_get_button_is_press(struct eis_event *event);
 
double
eis_event_pointer_get_scroll_x(struct eis_event *event);
 
double
eis_event_pointer_get_scroll_y(struct eis_event *event);
 
int32_t
eis_event_pointer_get_scroll_discrete_x(struct eis_event *event);
 
int32_t
eis_event_pointer_get_scroll_discrete_y(struct eis_event *event);
 
uint32_t
eis_event_keyboard_get_key(struct eis_event *event);
 
bool
eis_event_keyboard_get_key_is_press(struct eis_event *event);
 
uint32_t
eis_event_touch_get_id(struct eis_event *event);
 
double
eis_event_touch_get_x(struct eis_event *event);
 
double
eis_event_touch_get_y(struct eis_event *event);
 
#ifdef __cplusplus
}
#endif