/*
* This file is part of espanso.
*
* Copyright (C) 2019 Federico Terzi
*
* espanso is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* espanso 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 General Public License
* along with espanso. If not, see .
*/
#ifndef ESPANSO_BRIDGE_H
#define ESPANSO_BRIDGE_H
#include
extern "C" {
extern void * context_instance;
extern char * icon_path;
extern int32_t show_icon;
/*
* Initialize the AppDelegate and check for accessibility permissions
*/
int32_t initialize(void * context, const char * icon_path, int32_t show_icon);
/*
* Start the event loop indefinitely. Blocking call.
*/
int32_t eventloop();
/*
* Initialize the application and start the headless eventloop, used for the espanso detect command
*/
int32_t headless_eventloop();
/*
* Called when a new keypress is made, the first argument is an char array,
* while the second is the size of the array.
*/
typedef void (*KeypressCallback)(void * self, const char *buffer, int32_t len, int32_t event_type, int32_t key_code);
extern KeypressCallback keypress_callback;
/*
* Register the callback that will be called when a keypress was made
*/
void register_keypress_callback(KeypressCallback callback);
/*
* Type the given string by using the CGEventKeyboardSetUnicodeString call
*/
void send_string(const char * string);
/*
* Send the Virtual Key press
*/
void send_vkey(int32_t vk);
/*
* Send the Virtual Key press multiple times
*/
void send_multi_vkey(int32_t vk, int32_t count);
/*
* Send the backspace keypress, *count* times.
*/
void delete_string(int32_t count);
/*
* Trigger normal paste ( Pressing CMD+V )
*/
void trigger_paste();
/*
* Trigger normal copy ( Pressing CMD+C )
*/
void trigger_copy();
// UI
/*
* Called when the tray icon is clicked
*/
typedef void (*IconClickCallback)(void * self);
extern IconClickCallback icon_click_callback;
void register_icon_click_callback(IconClickCallback callback);
// CONTEXT MENU
typedef struct {
int32_t id;
int32_t type;
char name[100];
} MenuItem;
int32_t show_context_menu(MenuItem * items, int32_t count);
/*
* Called when the context menu is clicked
*/
typedef void (*ContextMenuClickCallback)(void * self, int32_t id);
extern ContextMenuClickCallback context_menu_click_callback;
extern "C" void register_context_menu_click_callback(ContextMenuClickCallback callback);
// SYSTEM
/*
* Check if espanso is authorized to control accessibility features, needed to detect key presses.
* @return
*/
int32_t check_accessibility();
/*
* Prompt to authorize the accessibility features.
* @return
*/
int32_t prompt_accessibility();
/*
* Open Security & Privacy settings panel
* @return
*/
void open_settings_panel();
/*
* Return the active NSRunningApplication path
*/
int32_t get_active_app_bundle(char * buffer, int32_t size);
/*
* Return the active NSRunningApplication bundle identifier
*/
int32_t get_active_app_identifier(char * buffer, int32_t size);
// CLIPBOARD
/*
* Return the clipboard text
*/
int32_t get_clipboard(char * buffer, int32_t size);
/*
* Set the clipboard text
*/
int32_t set_clipboard(char * text);
/*
* Set the clipboard image to the given file
*/
int32_t set_clipboard_image(char * path);
/*
* If a process is currently holding SecureInput, then return 1 and set the pid pointer to the corresponding PID.
*/
int32_t get_secure_input_process(int64_t *pid);
/*
* Find the executable path corresponding to the given PID, return 0 if no process was found.
*/
int32_t get_path_from_pid(int64_t pid, char *buff, int buff_size);
};
#endif //ESPANSO_BRIDGE_H