#include "flutter/shell/platform/linux/fl_key_embedder_responder.h"
#include <gtk/gtk.h>
#include <cinttypes>
#include "flutter/shell/platform/embedder/embedder.h"
#include "flutter/shell/platform/linux/fl_key_embedder_responder_private.h"
#include "flutter/shell/platform/linux/key_mapping.h"

Classes
struct	_FlKeyEmbedderUserData

struct	_FlKeyEmbedderResponder

Macros
#define	FL_TYPE_EMBEDDER_USER_DATA fl_key_embedder_user_data_get_type()

#define	FL_TYPE_EMBEDDER_RESPONDER_USER_DATA fl_key_embedder_responder_get_type()

Functions
static uint64_t	lookup_hash_table (GHashTable *table, uint64_t key)

static gboolean	hash_table_find_equal_value (gpointer key, gpointer value, gpointer user_data)

static uint64_t	reverse_lookup_hash_table (GHashTable *table, uint64_t value)

static uint64_t	to_lower (uint64_t n)

	G_DECLARE_FINAL_TYPE (FlKeyEmbedderUserData, fl_key_embedder_user_data, FL, KEY_EMBEDDER_USER_DATA, GObject)

static void	fl_key_embedder_user_data_dispose (GObject *object)

static void	fl_key_embedder_user_data_class_init (FlKeyEmbedderUserDataClass *klass)

static void	fl_key_embedder_user_data_init (FlKeyEmbedderUserData *self)

static FlKeyEmbedderUserData *	fl_key_embedder_user_data_new (FlKeyResponderAsyncCallback callback, gpointer user_data)

static void	fl_key_embedder_responder_iface_init (FlKeyResponderInterface *iface)

static void	fl_key_embedder_responder_dispose (GObject *object)

	G_DEFINE_TYPE_WITH_CODE (FlKeyEmbedderResponder, fl_key_embedder_responder, G_TYPE_OBJECT, G_IMPLEMENT_INTERFACE(FL_TYPE_KEY_RESPONDER, fl_key_embedder_responder_iface_init)) static void fl_key_embedder_responder_handle_event(FlKeyResponder *responder

static void	fl_key_embedder_responder_class_init (FlKeyEmbedderResponderClass *klass)

static void	fl_key_embedder_responder_init (FlKeyEmbedderResponder *self)

static void	initialize_logical_key_to_lock_bit_loop_body (gpointer lock_bit, gpointer value, gpointer user_data)

FlKeyEmbedderResponder *	fl_key_embedder_responder_new (EmbedderSendKeyEvent send_key_event, void *send_key_event_user_data)

static uint64_t	apply_id_plane (uint64_t logical_id, uint64_t plane)

static uint64_t	event_to_physical_key (const FlKeyEvent *event)

static uint64_t	event_to_logical_key (const FlKeyEvent *event)

static uint64_t	event_to_timestamp (const FlKeyEvent *event)

static char *	event_to_character (const FlKeyEvent *event)

static void	handle_response (bool handled, gpointer user_data)

static void	synthesize_simple_event (FlKeyEmbedderResponder *self, FlutterKeyEventType type, uint64_t physical, uint64_t logical, double timestamp)

static void	update_pressing_state (FlKeyEmbedderResponder *self, uint64_t physical_key, uint64_t logical_key)

static void	possibly_update_lock_bit (FlKeyEmbedderResponder *self, uint64_t logical_key, bool is_down)

static void	update_mapping_record (FlKeyEmbedderResponder *self, uint64_t physical_key, uint64_t logical_key)

static void	synchronize_pressed_states_loop_body (gpointer key, gpointer value, gpointer user_data)

static int	find_stage_by_record (bool is_down, bool is_enabled)

static int	find_stage_by_self_event (int stage_by_record, bool is_down_event, bool is_state_on, bool reverse_state_logic)

static int	find_stage_by_others_event (int stage_by_record, bool is_state_on)

static void	update_caps_lock_state_logic_inferrence (FlKeyEmbedderResponder *self, bool is_down_event, bool enabled_by_state, int stage_by_record)

static void	synchronize_lock_states_loop_body (gpointer key, gpointer value, gpointer user_data)

static void	is_known_modifier_physical_key_loop_body (gpointer key, gpointer value, gpointer user_data)

static void	find_physical_from_logical_loop_body (gpointer key, gpointer value, gpointer user_data)

static uint64_t	corrected_modifier_physical_key (GHashTable *modifier_bit_to_checked_keys, uint64_t physical_key_from_event, uint64_t logical_key)

static void	fl_key_embedder_responder_handle_event_impl (FlKeyResponder responder, FlKeyEvent event, uint64_t specified_logical_key, FlKeyResponderAsyncCallback callback, gpointer user_data)

static void	fl_key_embedder_responder_handle_event (FlKeyResponder responder, FlKeyEvent event, uint64_t specified_logical_key, FlKeyResponderAsyncCallback callback, gpointer user_data)

void	fl_key_embedder_responder_sync_modifiers_if_needed (FlKeyEmbedderResponder *responder, guint state, double event_time)

GHashTable *	fl_key_embedder_responder_get_pressed_state (FlKeyEmbedderResponder *self)

Variables
constexpr uint64_t	kMicrosecondsPerMillisecond = 1000

static const FlutterKeyEvent	kEmptyEvent

FlKeyEvent *	event

FlKeyEvent uint64_t	specified_logical_key

FlKeyEvent uint64_t FlKeyResponderAsyncCallback	callback

FlKeyEvent uint64_t FlKeyResponderAsyncCallback gpointer	user_data

Macro Definition Documentation

◆ FL_TYPE_EMBEDDER_RESPONDER_USER_DATA

#define FL_TYPE_EMBEDDER_RESPONDER_USER_DATA fl_key_embedder_responder_get_type()

Definition at line 204 of file fl_key_embedder_responder.cc.

◆ FL_TYPE_EMBEDDER_USER_DATA

#define FL_TYPE_EMBEDDER_USER_DATA fl_key_embedder_user_data_get_type()

FlKeyEmbedderUserData: The user_data used when #FlKeyEmbedderResponder sends message through the embedder.SendKeyEvent API.

Definition at line 83 of file fl_key_embedder_responder.cc.

Function Documentation

◆ apply_id_plane()

static uint64_t apply_id_plane	(	uint64_t	logical_id,
		uint64_t	plane
	)

static

Definition at line 296 of file fl_key_embedder_responder.cc.

                                                                     {
   return (logical_id & kValueMask) | plane;
 }

References kValueMask.

Referenced by event_to_logical_key(), and event_to_physical_key().

◆ corrected_modifier_physical_key()

static uint64_t corrected_modifier_physical_key	(	GHashTable *	modifier_bit_to_checked_keys,
		uint64_t	physical_key_from_event,
		uint64_t	logical_key
	)

static

Definition at line 747 of file fl_key_embedder_responder.cc.

                           {
   ModifierLogicalToPhysicalContext logical_to_physical_context;
   logical_to_physical_context.known_modifier_physical_key = false;
   logical_to_physical_context.physical_key_from_event = physical_key_from_event;
   logical_to_physical_context.logical_key = logical_key;
   // If no match is found, defaults to the physical key retrieved from the
   // event.
   logical_to_physical_context.corrected_physical_key = physical_key_from_event;
  
   // Check if the physical key is one of the known modifier physical key.
   g_hash_table_foreach(modifier_bit_to_checked_keys,
                        is_known_modifier_physical_key_loop_body,
                        &logical_to_physical_context);
  
   // If the physical key matches a known modifier key, find the modifier
   // physical key from the logical key.
   if (logical_to_physical_context.known_modifier_physical_key) {
     g_hash_table_foreach(modifier_bit_to_checked_keys,
                          find_physical_from_logical_loop_body,
                          &logical_to_physical_context);
   }
  
   return logical_to_physical_context.corrected_physical_key;
 }

References find_physical_from_logical_loop_body(), and is_known_modifier_physical_key_loop_body().

Referenced by fl_key_embedder_responder_handle_event_impl().

◆ event_to_character()

static char* event_to_character ( const FlKeyEvent * event )

static

Definition at line 328 of file fl_key_embedder_responder.cc.

                                                          {
   gunichar unicodeChar = gdk_keyval_to_unicode(event->keyval);
   glong items_written;
   gchar* result = g_ucs4_to_utf8(&unicodeChar, 1, NULL, &items_written, NULL);
   if (items_written == 0) {
     if (result != NULL) {
       g_free(result);
     }
     return nullptr;
   }
   return result;
 }

References event, _FlKeyEvent::keyval, and result.

Referenced by fl_key_embedder_responder_handle_event_impl().

◆ event_to_logical_key()

static uint64_t event_to_logical_key ( const FlKeyEvent * event )

static

Definition at line 308 of file fl_key_embedder_responder.cc.

                                                               {
   guint keyval = event->keyval;
   auto found = gtk_keyval_to_logical_key_map.find(keyval);
   if (found != gtk_keyval_to_logical_key_map.end()) {
     return found->second;
   }
   // EASCII range
   if (keyval < 256) {
     return apply_id_plane(to_lower(keyval), kUnicodePlane);
   }
   // Auto-generate key
   return apply_id_plane(keyval, kGtkPlane);
 }

References apply_id_plane(), gtk_keyval_to_logical_key_map, kGtkPlane, kUnicodePlane, and to_lower().

Referenced by fl_key_embedder_responder_handle_event_impl().

◆ event_to_physical_key()

static uint64_t event_to_physical_key ( const FlKeyEvent * event )

static

Definition at line 300 of file fl_key_embedder_responder.cc.

                                                                {
   auto found = xkb_to_physical_key_map.find(event->keycode);
   if (found != xkb_to_physical_key_map.end()) {
     return found->second;
   }
   return apply_id_plane(event->keycode, kGtkPlane);
 }

References apply_id_plane(), event, _FlKeyEvent::keycode, kGtkPlane, and xkb_to_physical_key_map.

Referenced by fl_key_embedder_responder_handle_event_impl().

◆ event_to_timestamp()

static uint64_t event_to_timestamp ( const FlKeyEvent * event )

static

Definition at line 322 of file fl_key_embedder_responder.cc.

                                                             {
   return kMicrosecondsPerMillisecond * static_cast<double>(event->time);
 }

References kMicrosecondsPerMillisecond.

Referenced by fl_key_embedder_responder_handle_event_impl().

◆ find_physical_from_logical_loop_body()

static void find_physical_from_logical_loop_body	(	gpointer	key,
		gpointer	value,
		gpointer	user_data
	)

static

Definition at line 733 of file fl_key_embedder_responder.cc.

                                                                      {
   ModifierLogicalToPhysicalContext* context =
       reinterpret_cast<ModifierLogicalToPhysicalContext*>(user_data);
   FlKeyEmbedderCheckedKey* checked_key =
       reinterpret_cast<FlKeyEmbedderCheckedKey*>(value);
  
   if (checked_key->primary_logical_key == context->logical_key ||
       checked_key->secondary_logical_key == context->logical_key) {
     context->corrected_physical_key = checked_key->primary_physical_key;
   }
 }

References FlKeyEmbedderCheckedKey::primary_logical_key, FlKeyEmbedderCheckedKey::primary_physical_key, FlKeyEmbedderCheckedKey::secondary_logical_key, user_data, and value.

Referenced by corrected_modifier_physical_key().

◆ find_stage_by_others_event()

static int find_stage_by_others_event	(	int	stage_by_record,
		bool	is_state_on
	)

static

Definition at line 555 of file fl_key_embedder_responder.cc.

                                                                              {
   g_return_val_if_fail(stage_by_record >= 0 && stage_by_record < 4,
                        stage_by_record);
   if (!is_state_on) {
     return 0;
   }
   if (stage_by_record == 0) {
     return 1;
   }
   return stage_by_record;
 }

Referenced by synchronize_lock_states_loop_body().

◆ find_stage_by_record()

static int find_stage_by_record	(	bool	is_down,
		bool	is_enabled
	)

static

Definition at line 528 of file fl_key_embedder_responder.cc.

                                                                {
   constexpr int stage_by_record_index[] = {
       0,  // is_down: 0,  is_enabled: 0
       2,  //          0               1
       3,  //          1               0
       1   //          1               1
   };
   return stage_by_record_index[(is_down << 1) + is_enabled];
 }

Referenced by synchronize_lock_states_loop_body().

◆ find_stage_by_self_event()

static int find_stage_by_self_event	(	int	stage_by_record,
		bool	is_down_event,
		bool	is_state_on,
		bool	reverse_state_logic
	)

static

Definition at line 540 of file fl_key_embedder_responder.cc.

                                                               {
   if (!is_state_on) {
     return reverse_state_logic ? 2 : 0;
   }
   if (is_down_event) {
     return reverse_state_logic ? 0 : 2;
   }
   return stage_by_record;
 }

Referenced by synchronize_lock_states_loop_body(), and update_caps_lock_state_logic_inferrence().

◆ fl_key_embedder_responder_class_init()

static void fl_key_embedder_responder_class_init ( FlKeyEmbedderResponderClass * klass )

static

Definition at line 226 of file fl_key_embedder_responder.cc.

                                         {
   G_OBJECT_CLASS(klass)->dispose = fl_key_embedder_responder_dispose;
 }

References fl_key_embedder_responder_dispose().

◆ fl_key_embedder_responder_dispose()

static void fl_key_embedder_responder_dispose ( GObject * object )

static

Definition at line 235 of file fl_key_embedder_responder.cc.

                                                                {
   FlKeyEmbedderResponder* self = FL_KEY_EMBEDDER_RESPONDER(object);
  
   g_clear_pointer(&self->pressing_records, g_hash_table_unref);
   g_clear_pointer(&self->mapping_records, g_hash_table_unref);
   g_clear_pointer(&self->modifier_bit_to_checked_keys, g_hash_table_unref);
   g_clear_pointer(&self->lock_bit_to_checked_keys, g_hash_table_unref);
   g_clear_pointer(&self->logical_key_to_lock_bit, g_hash_table_unref);
  
   G_OBJECT_CLASS(fl_key_embedder_responder_parent_class)->dispose(object);
 }

Referenced by fl_key_embedder_responder_class_init().

◆ fl_key_embedder_responder_get_pressed_state()

GHashTable* fl_key_embedder_responder_get_pressed_state ( FlKeyEmbedderResponder * responder )

fl_key_embedder_responder_get_pressed_state: @responder: the #FlKeyEmbedderResponder self.

Returns the keyboard pressed state. The hash table contains one entry per pressed keys, mapping from the logical key to the physical key.

Definition at line 895 of file fl_key_embedder_responder.cc.

                                   {
   return self->pressing_records;
 }

Referenced by fl_keyboard_manager_get_pressed_state().

◆ fl_key_embedder_responder_handle_event()

static void fl_key_embedder_responder_handle_event	(	FlKeyResponder *	responder,
		FlKeyEvent *	event,
		uint64_t	specified_logical_key,
		FlKeyResponderAsyncCallback	callback,
		gpointer	user_data
	)

static

Definition at line 862 of file fl_key_embedder_responder.cc.

                         {
   FlKeyEmbedderResponder* self = FL_KEY_EMBEDDER_RESPONDER(responder);
   self->sent_any_events = false;
   fl_key_embedder_responder_handle_event_impl(
       responder, event, specified_logical_key, callback, user_data);
   if (!self->sent_any_events) {
     self->send_key_event(&kEmptyEvent, nullptr, nullptr,
                          self->send_key_event_user_data);
   }
 }

References callback, event, fl_key_embedder_responder_handle_event_impl(), kEmptyEvent, specified_logical_key, and user_data.

Referenced by fl_key_embedder_responder_iface_init().

◆ fl_key_embedder_responder_handle_event_impl()

static void fl_key_embedder_responder_handle_event_impl	(	FlKeyResponder *	responder,
		FlKeyEvent *	event,
		uint64_t	specified_logical_key,
		FlKeyResponderAsyncCallback	callback,
		gpointer	user_data
	)

static

Definition at line 775 of file fl_key_embedder_responder.cc.

                         {
   FlKeyEmbedderResponder* self = FL_KEY_EMBEDDER_RESPONDER(responder);
  
   g_return_if_fail(event != nullptr);
   g_return_if_fail(callback != nullptr);
  
   const uint64_t logical_key = specified_logical_key != 0
                                    ? specified_logical_key
                                    : event_to_logical_key(event);
   const uint64_t physical_key_from_event = event_to_physical_key(event);
   const uint64_t physical_key = corrected_modifier_physical_key(
       self->modifier_bit_to_checked_keys, physical_key_from_event, logical_key);
   const double timestamp = event_to_timestamp(event);
   const bool is_down_event = event->is_press;
  
   SyncStateLoopContext sync_state_context;
   sync_state_context.self = self;
   sync_state_context.state = event->state;
   sync_state_context.timestamp = timestamp;
   sync_state_context.is_down = is_down_event;
   sync_state_context.event_logical_key = logical_key;
  
   // Update lock mode states
   g_hash_table_foreach(self->lock_bit_to_checked_keys,
                        synchronize_lock_states_loop_body, &sync_state_context);
  
   // Update pressing states
   g_hash_table_foreach(self->modifier_bit_to_checked_keys,
                        synchronize_pressed_states_loop_body,
                        &sync_state_context);
  
   // Construct the real event
   const uint64_t last_logical_record =
       lookup_hash_table(self->pressing_records, physical_key);
  
   FlutterKeyEvent out_event;
   out_event.struct_size = sizeof(out_event);
   out_event.timestamp = timestamp;
   out_event.physical = physical_key;
   out_event.logical =
       last_logical_record != 0 ? last_logical_record : logical_key;
   out_event.character = nullptr;
   out_event.synthesized = false;
  
   g_autofree char* character_to_free = nullptr;
   if (is_down_event) {
     if (last_logical_record) {
       // A key has been pressed that has the exact physical key as a currently
       // pressed one. This can happen during repeated events.
       out_event.type = kFlutterKeyEventTypeRepeat;
     } else {
       out_event.type = kFlutterKeyEventTypeDown;
     }
     character_to_free = event_to_character(event);  // Might be null
     out_event.character = character_to_free;
   } else {  // is_down_event false
     if (!last_logical_record) {
       // The physical key has been released before. It might indicate a missed
       // event due to loss of focus, or multiple keyboards pressed keys with the
       // same physical key. Ignore the up event.
       callback(true, user_data);
       return;
     } else {
       out_event.type = kFlutterKeyEventTypeUp;
     }
   }
  
   if (out_event.type != kFlutterKeyEventTypeRepeat) {
     update_pressing_state(self, physical_key, is_down_event ? logical_key : 0);
   }
   possibly_update_lock_bit(self, logical_key, is_down_event);
   if (is_down_event) {
     update_mapping_record(self, physical_key, logical_key);
   }
   FlKeyEmbedderUserData* response_data =
       fl_key_embedder_user_data_new(callback, user_data);
   self->sent_any_events = true;
   self->send_key_event(&out_event, handle_response, response_data,
                        self->send_key_event_user_data);
 }

References callback, corrected_modifier_physical_key(), event, event_to_character(), event_to_logical_key(), event_to_physical_key(), event_to_timestamp(), fl_key_embedder_user_data_new(), handle_response(), lookup_hash_table(), possibly_update_lock_bit(), specified_logical_key, synchronize_lock_states_loop_body(), synchronize_pressed_states_loop_body(), update_mapping_record(), update_pressing_state(), and user_data.

Referenced by fl_key_embedder_responder_handle_event().

◆ fl_key_embedder_responder_iface_init()

static void fl_key_embedder_responder_iface_init ( FlKeyResponderInterface * iface )

static

Definition at line 220 of file fl_key_embedder_responder.cc.

                                     {
   iface->handle_event = fl_key_embedder_responder_handle_event;
 }

References fl_key_embedder_responder_handle_event().

◆ fl_key_embedder_responder_init()

static void fl_key_embedder_responder_init ( FlKeyEmbedderResponder * self )

static

Definition at line 232 of file fl_key_embedder_responder.cc.

232 {}

◆ fl_key_embedder_responder_new()

FlKeyEmbedderResponder* fl_key_embedder_responder_new	(	EmbedderSendKeyEvent	send_key_event,
		void *	send_key_event_user_data
	)

FlKeyEmbedderResponder:

A #FlKeyResponder that handles events by sending the converted events through the embedder API.

This class communicates with the HardwareKeyboard API in the framework. fl_key_embedder_responder_new: @engine: The #FlEngine, whose the embedder API will be used to send the event.

Creates a new #FlKeyEmbedderResponder. @send_key_event: a function that is called on every key event. @send_key_event_user_data: an opaque pointer that will be sent back as the last argument of send_key_event, created and managed by the object that holds FlKeyEmbedderResponder.

Returns: a new #FlKeyEmbedderResponder.

Definition at line 263 of file fl_key_embedder_responder.cc.

                                     {
   FlKeyEmbedderResponder* self = FL_KEY_EMBEDDER_RESPONDER(
       g_object_new(FL_TYPE_EMBEDDER_RESPONDER_USER_DATA, nullptr));
  
   self->send_key_event = send_key_event;
   self->send_key_event_user_data = send_key_event_user_data;
  
   self->pressing_records = g_hash_table_new(g_direct_hash, g_direct_equal);
   self->mapping_records = g_hash_table_new(g_direct_hash, g_direct_equal);
   self->lock_records = 0;
   self->caps_lock_state_logic_inferrence = kStateLogicUndecided;
  
   self->modifier_bit_to_checked_keys =
       g_hash_table_new_full(g_direct_hash, g_direct_equal, NULL, g_free);
   initialize_modifier_bit_to_checked_keys(self->modifier_bit_to_checked_keys);
  
   self->lock_bit_to_checked_keys =
       g_hash_table_new_full(g_direct_hash, g_direct_equal, NULL, g_free);
   initialize_lock_bit_to_checked_keys(self->lock_bit_to_checked_keys);
  
   self->logical_key_to_lock_bit =
       g_hash_table_new(g_direct_hash, g_direct_equal);
   g_hash_table_foreach(self->lock_bit_to_checked_keys,
                        initialize_logical_key_to_lock_bit_loop_body,
                        self->logical_key_to_lock_bit);
  
   return self;
 }

References FL_TYPE_EMBEDDER_RESPONDER_USER_DATA, initialize_lock_bit_to_checked_keys(), initialize_logical_key_to_lock_bit_loop_body(), initialize_modifier_bit_to_checked_keys(), and send_key_event().

Referenced by fl_keyboard_manager_new(), and TEST().

◆ fl_key_embedder_responder_sync_modifiers_if_needed()

void fl_key_embedder_responder_sync_modifiers_if_needed	(	FlKeyEmbedderResponder *	responder,
		guint	state,
		double	event_time
	)

fl_key_embedder_responder_sync_modifiers_if_needed: @responder: the #FlKeyEmbedderResponder self. @state: the state of the modifiers mask. @event_time: the time attribute of the incoming GDK event.

If needed, synthesize modifier keys up and down event by comparing their current pressing states with the given modifiers mask.

Definition at line 878 of file fl_key_embedder_responder.cc.

                        {
   const double timestamp = event_time * kMicrosecondsPerMillisecond;
  
   SyncStateLoopContext sync_state_context;
   sync_state_context.self = responder;
   sync_state_context.state = state;
   sync_state_context.timestamp = timestamp;
  
   // Update pressing states.
   g_hash_table_foreach(responder->modifier_bit_to_checked_keys,
                        synchronize_pressed_states_loop_body,
                        &sync_state_context);
 }

References kMicrosecondsPerMillisecond, state, and synchronize_pressed_states_loop_body().

Referenced by fl_keyboard_manager_sync_modifier_if_needed().

◆ fl_key_embedder_user_data_class_init()

static void fl_key_embedder_user_data_class_init ( FlKeyEmbedderUserDataClass * klass )

static

Definition at line 101 of file fl_key_embedder_responder.cc.

                                        {
   G_OBJECT_CLASS(klass)->dispose = fl_key_embedder_user_data_dispose;
 }

References fl_key_embedder_user_data_dispose().

◆ fl_key_embedder_user_data_dispose()

static void fl_key_embedder_user_data_dispose ( GObject * object )

static

Definition at line 108 of file fl_key_embedder_responder.cc.

                                                                {
   // The following line suppresses a warning for unused function
   // FL_IS_KEY_EMBEDDER_USER_DATA.
   g_return_if_fail(FL_IS_KEY_EMBEDDER_USER_DATA(object));
 }

Referenced by fl_key_embedder_user_data_class_init().

◆ fl_key_embedder_user_data_init()

static void fl_key_embedder_user_data_init ( FlKeyEmbedderUserData * self )

static

Definition at line 106 of file fl_key_embedder_responder.cc.

106 {}

◆ fl_key_embedder_user_data_new()

static FlKeyEmbedderUserData* fl_key_embedder_user_data_new	(	FlKeyResponderAsyncCallback	callback,
		gpointer	user_data
	)

static

Definition at line 117 of file fl_key_embedder_responder.cc.

                         {
   FlKeyEmbedderUserData* self = FL_KEY_EMBEDDER_USER_DATA(
       g_object_new(FL_TYPE_EMBEDDER_USER_DATA, nullptr));
  
   self->callback = callback;
   self->user_data = user_data;
   return self;
 }

References callback, FL_TYPE_EMBEDDER_USER_DATA, and user_data.

Referenced by fl_key_embedder_responder_handle_event_impl().

◆ G_DECLARE_FINAL_TYPE()

G_DECLARE_FINAL_TYPE	(	FlKeyEmbedderUserData	,
		fl_key_embedder_user_data	,
		FL	,
		KEY_EMBEDDER_USER_DATA	,
		GObject
	)

◆ G_DEFINE_TYPE_WITH_CODE()

G_DEFINE_TYPE_WITH_CODE	(	FlKeyEmbedderResponder	,
		fl_key_embedder_responder	,
		G_TYPE_OBJECT	,
		G_IMPLEMENT_INTERFACE(FL_TYPE_KEY_RESPONDER, fl_key_embedder_responder_iface_init)
	)

◆ handle_response()

static void handle_response	(	bool	handled,
		gpointer	user_data
	)

static

Definition at line 343 of file fl_key_embedder_responder.cc.

                                                               {
   g_autoptr(FlKeyEmbedderUserData) data = FL_KEY_EMBEDDER_USER_DATA(user_data);
  
   g_return_if_fail(data->callback != nullptr);
  
   data->callback(handled, data->user_data);
 }

References user_data.

Referenced by fl_key_embedder_responder_handle_event_impl().

◆ hash_table_find_equal_value()

static gboolean hash_table_find_equal_value	(	gpointer	key,
		gpointer	value,
		gpointer	user_data
	)

static

Definition at line 36 of file fl_key_embedder_responder.cc.

                                                                 {
   return gpointer_to_uint64(value) == gpointer_to_uint64(user_data);
 }

References gpointer_to_uint64(), user_data, and value.

Referenced by reverse_lookup_hash_table().

◆ initialize_logical_key_to_lock_bit_loop_body()

static void initialize_logical_key_to_lock_bit_loop_body	(	gpointer	lock_bit,
		gpointer	value,
		gpointer	user_data
	)

static

Definition at line 251 of file fl_key_embedder_responder.cc.

                                                                              {
   FlKeyEmbedderCheckedKey* checked_key =
       reinterpret_cast<FlKeyEmbedderCheckedKey*>(value);
   GHashTable* table = reinterpret_cast<GHashTable*>(user_data);
   g_hash_table_insert(table,
                       uint64_to_gpointer(checked_key->primary_logical_key),
                       GUINT_TO_POINTER(lock_bit));
 }

References FlKeyEmbedderCheckedKey::primary_logical_key, uint64_to_gpointer(), user_data, and value.

Referenced by fl_key_embedder_responder_new().

◆ is_known_modifier_physical_key_loop_body()

static void is_known_modifier_physical_key_loop_body	(	gpointer	key,
		gpointer	value,
		gpointer	user_data
	)

static

Definition at line 716 of file fl_key_embedder_responder.cc.

                                                                          {
   ModifierLogicalToPhysicalContext* context =
       reinterpret_cast<ModifierLogicalToPhysicalContext*>(user_data);
   FlKeyEmbedderCheckedKey* checked_key =
       reinterpret_cast<FlKeyEmbedderCheckedKey*>(value);
  
   if (checked_key->primary_physical_key == context->physical_key_from_event) {
     context->known_modifier_physical_key = true;
   }
 }

References FlKeyEmbedderCheckedKey::primary_physical_key, user_data, and value.

Referenced by corrected_modifier_physical_key().

◆ lookup_hash_table()

static uint64_t lookup_hash_table	(	GHashTable *	table,
		uint64_t	key
	)

static

Definition at line 31 of file fl_key_embedder_responder.cc.

                                                                    {
   return gpointer_to_uint64(
       g_hash_table_lookup(table, uint64_to_gpointer(key)));
 }

References gpointer_to_uint64(), and uint64_to_gpointer().

Referenced by fl_key_embedder_responder_handle_event_impl(), synchronize_lock_states_loop_body(), synchronize_pressed_states_loop_body(), and update_pressing_state().

◆ possibly_update_lock_bit()

static void possibly_update_lock_bit	(	FlKeyEmbedderResponder *	self,
		uint64_t	logical_key,
		bool	is_down
	)

static

Definition at line 419 of file fl_key_embedder_responder.cc.

                                                    {
   if (!is_down) {
     return;
   }
   const guint mode_bit = GPOINTER_TO_UINT(g_hash_table_lookup(
       self->logical_key_to_lock_bit, uint64_to_gpointer(logical_key)));
   if (mode_bit != 0) {
     self->lock_records ^= mode_bit;
   }
 }

References uint64_to_gpointer().

Referenced by fl_key_embedder_responder_handle_event_impl(), and synchronize_lock_states_loop_body().

◆ reverse_lookup_hash_table()

static uint64_t reverse_lookup_hash_table	(	GHashTable *	table,
		uint64_t	value
	)

static

Definition at line 48 of file fl_key_embedder_responder.cc.

                                                                              {
   return gpointer_to_uint64(g_hash_table_find(
       table, hash_table_find_equal_value, uint64_to_gpointer(value)));
 }

References gpointer_to_uint64(), hash_table_find_equal_value(), uint64_to_gpointer(), and value.

Referenced by synchronize_pressed_states_loop_body().

◆ synchronize_lock_states_loop_body()

static void synchronize_lock_states_loop_body	(	gpointer	key,
		gpointer	value,
		gpointer	user_data
	)

static

Definition at line 609 of file fl_key_embedder_responder.cc.

                                                                   {
   SyncStateLoopContext* context =
       reinterpret_cast<SyncStateLoopContext*>(user_data);
   FlKeyEmbedderCheckedKey* checked_key =
       reinterpret_cast<FlKeyEmbedderCheckedKey*>(value);
  
   guint modifier_bit = GPOINTER_TO_INT(key);
   FlKeyEmbedderResponder* self = context->self;
  
   const uint64_t logical_key = checked_key->primary_logical_key;
   const uint64_t recorded_physical_key =
       lookup_hash_table(self->mapping_records, logical_key);
   // The physical key is derived from past mapping record if possible.
   //
   // If the event to be synthesized is a key up event, then there must have
   // been a key down event before, which has updated the mapping record.
   // If the event to be synthesized is a key down event, then there might
   // not have been a mapping record, in which case the hard-coded
   // #primary_physical_key is used.
   const uint64_t physical_key = recorded_physical_key != 0
                                     ? recorded_physical_key
                                     : checked_key->primary_physical_key;
  
   // A lock mode key can be at any of a 4-stage cycle, depending on whether it's
   // pressed and enabled. The following table lists the definition of each
   // stage (TruePressed and TrueEnabled), the event of the lock key between
   // every 2 stages (SelfType and SelfState), and the event of other keys at
   // each stage (OthersState). On certain platforms SelfState uses a reversed
   // rule for certain keys (SelfState(rvsd), as documented in
   // #update_caps_lock_state_logic_inferrence).
   //
   //               #    [0]         [1]          [2]           [3]
   //     TruePressed: Released    Pressed      Released      Pressed
   //     TrueEnabled: Disabled    Enabled      Enabled       Disabled
   //        SelfType:         Down         Up           Down            Up
   //       SelfState:          0           1             1              1
   // SelfState(rvsd):          1           1             0              1
   //     OthersState:    0           1            1              1
   //
   // When the exact stage can't be derived, choose the stage that requires the
   // minimal synthesization.
  
   const uint64_t pressed_logical_key =
       recorded_physical_key == 0
           ? 0
           : lookup_hash_table(self->pressing_records, recorded_physical_key);
  
   g_return_if_fail(pressed_logical_key == 0 ||
                    pressed_logical_key == logical_key);
   const int stage_by_record = find_stage_by_record(
       pressed_logical_key != 0, (self->lock_records & modifier_bit) != 0);
  
   const bool enabled_by_state = (context->state & modifier_bit) != 0;
   const bool this_key_is_event_key = logical_key == context->event_logical_key;
   if (this_key_is_event_key && checked_key->is_caps_lock) {
     update_caps_lock_state_logic_inferrence(self, context->is_down,
                                             enabled_by_state, stage_by_record);
     g_return_if_fail(self->caps_lock_state_logic_inferrence !=
                      kStateLogicUndecided);
   }
   const bool reverse_state_logic =
       checked_key->is_caps_lock &&
       self->caps_lock_state_logic_inferrence == kStateLogicReversed;
   const int stage_by_event =
       this_key_is_event_key
           ? find_stage_by_self_event(stage_by_record, context->is_down,
                                      enabled_by_state, reverse_state_logic)
           : find_stage_by_others_event(stage_by_record, enabled_by_state);
  
   // The destination stage is equal to stage_by_event but shifted cyclically to
   // be no less than stage_by_record.
   constexpr int kNumStages = 4;
   const int destination_stage = stage_by_event >= stage_by_record
                                     ? stage_by_event
                                     : stage_by_event + kNumStages;
  
   g_return_if_fail(stage_by_record <= destination_stage);
   if (stage_by_record == destination_stage) {
     return;
   }
   for (int current_stage = stage_by_record; current_stage < destination_stage;
        current_stage += 1) {
     if (current_stage == 9) {
       return;
     }
  
     const int standard_current_stage = current_stage % kNumStages;
     const bool is_down_event =
         standard_current_stage == 0 || standard_current_stage == 2;
     if (is_down_event && recorded_physical_key == 0) {
       update_mapping_record(self, physical_key, logical_key);
     }
     FlutterKeyEventType type =
         is_down_event ? kFlutterKeyEventTypeDown : kFlutterKeyEventTypeUp;
     update_pressing_state(self, physical_key, is_down_event ? logical_key : 0);
     possibly_update_lock_bit(self, logical_key, is_down_event);
     synthesize_simple_event(self, type, physical_key, logical_key,
                             context->timestamp);
   }
 }

References find_stage_by_others_event(), find_stage_by_record(), find_stage_by_self_event(), FlKeyEmbedderCheckedKey::is_caps_lock, lookup_hash_table(), possibly_update_lock_bit(), FlKeyEmbedderCheckedKey::primary_logical_key, FlKeyEmbedderCheckedKey::primary_physical_key, synthesize_simple_event(), type, update_caps_lock_state_logic_inferrence(), update_mapping_record(), update_pressing_state(), user_data, and value.

Referenced by fl_key_embedder_responder_handle_event_impl().

◆ synchronize_pressed_states_loop_body()

static void synchronize_pressed_states_loop_body	(	gpointer	key,
		gpointer	value,
		gpointer	user_data
	)

static

Definition at line 443 of file fl_key_embedder_responder.cc.

                                                                      {
   SyncStateLoopContext* context =
       reinterpret_cast<SyncStateLoopContext*>(user_data);
   FlKeyEmbedderCheckedKey* checked_key =
       reinterpret_cast<FlKeyEmbedderCheckedKey*>(value);
  
   const guint modifier_bit = GPOINTER_TO_INT(key);
   FlKeyEmbedderResponder* self = context->self;
   // Each TestKey contains up to two logical keys, typically the left modifier
   // and the right modifier, that correspond to the same modifier_bit. We'd
   // like to infer whether to synthesize a down or up event for each key.
   //
   // The hard part is that, if we want to synthesize a down event, we don't know
   // which physical key to use. Here we assume the keyboard layout do not change
   // frequently and use the last physical-logical relationship, recorded in
   // #mapping_records.
   const uint64_t logical_keys[] = {
       checked_key->primary_logical_key,
       checked_key->secondary_logical_key,
   };
   const guint length = checked_key->secondary_logical_key == 0 ? 1 : 2;
  
   const bool any_pressed_by_state = (context->state & modifier_bit) != 0;
  
   bool any_pressed_by_record = false;
  
   // Traverse each logical key of this modifier bit for 2 purposes:
   //
   //  1. Perform the synthesization of release events: If the modifier bit is 0
   //     and the key is pressed, synthesize a release event.
   //  2. Prepare for the synthesization of press events: If the modifier bit is
   //     1, and no keys are pressed (discovered here), synthesize a press event
   //     later.
   for (guint logical_key_idx = 0; logical_key_idx < length; logical_key_idx++) {
     const uint64_t logical_key = logical_keys[logical_key_idx];
     g_return_if_fail(logical_key != 0);
     const uint64_t pressing_physical_key =
         reverse_lookup_hash_table(self->pressing_records, logical_key);
     const bool this_key_pressed_before_event = pressing_physical_key != 0;
  
     any_pressed_by_record =
         any_pressed_by_record || this_key_pressed_before_event;
  
     if (this_key_pressed_before_event && !any_pressed_by_state) {
       const uint64_t recorded_physical_key =
           lookup_hash_table(self->mapping_records, logical_key);
       // Since this key has been pressed before, there must have been a recorded
       // physical key.
       g_return_if_fail(recorded_physical_key != 0);
       // In rare cases #recorded_logical_key is different from #logical_key.
       const uint64_t recorded_logical_key =
           lookup_hash_table(self->pressing_records, recorded_physical_key);
       synthesize_simple_event(self, kFlutterKeyEventTypeUp,
                               recorded_physical_key, recorded_logical_key,
                               context->timestamp);
       update_pressing_state(self, recorded_physical_key, 0);
     }
   }
   // If the modifier should be pressed, synthesize a down event for its primary
   // key.
   if (any_pressed_by_state && !any_pressed_by_record) {
     const uint64_t logical_key = checked_key->primary_logical_key;
     const uint64_t recorded_physical_key =
         lookup_hash_table(self->mapping_records, logical_key);
     // The physical key is derived from past mapping record if possible.
     //
     // The event to be synthesized is a key down event. There might not have
     // been a mapping record, in which case the hard-coded #primary_physical_key
     // is used.
     const uint64_t physical_key = recorded_physical_key != 0
                                       ? recorded_physical_key
                                       : checked_key->primary_physical_key;
     if (recorded_physical_key == 0) {
       update_mapping_record(self, physical_key, logical_key);
     }
     synthesize_simple_event(self, kFlutterKeyEventTypeDown, physical_key,
                             logical_key, context->timestamp);
     update_pressing_state(self, physical_key, logical_key);
   }
 }

References length, lookup_hash_table(), FlKeyEmbedderCheckedKey::primary_logical_key, FlKeyEmbedderCheckedKey::primary_physical_key, reverse_lookup_hash_table(), FlKeyEmbedderCheckedKey::secondary_logical_key, synthesize_simple_event(), update_mapping_record(), update_pressing_state(), user_data, and value.

Referenced by fl_key_embedder_responder_handle_event_impl(), and fl_key_embedder_responder_sync_modifiers_if_needed().

◆ synthesize_simple_event()

static void synthesize_simple_event	(	FlKeyEmbedderResponder *	self,
		FlutterKeyEventType	type,
		uint64_t	physical,
		uint64_t	logical,
		double	timestamp
	)

static

Definition at line 352 of file fl_key_embedder_responder.cc.

                                                       {
   FlutterKeyEvent out_event;
   out_event.struct_size = sizeof(out_event);
   out_event.timestamp = timestamp;
   out_event.type = type;
   out_event.physical = physical;
   out_event.logical = logical;
   out_event.character = nullptr;
   out_event.synthesized = true;
   self->sent_any_events = true;
   self->send_key_event(&out_event, nullptr, nullptr,
                        self->send_key_event_user_data);
 }

References type.

Referenced by synchronize_lock_states_loop_body(), and synchronize_pressed_states_loop_body().

◆ to_lower()

static uint64_t to_lower ( uint64_t n )

static

Definition at line 53 of file fl_key_embedder_responder.cc.

                                      {
   constexpr uint64_t lower_a = 0x61;
   constexpr uint64_t upper_a = 0x41;
   constexpr uint64_t upper_z = 0x5a;
  
   constexpr uint64_t lower_a_grave = 0xe0;
   constexpr uint64_t upper_a_grave = 0xc0;
   constexpr uint64_t upper_thorn = 0xde;
   constexpr uint64_t division = 0xf7;
  
   // ASCII range.
   if (n >= upper_a && n <= upper_z) {
     return n - upper_a + lower_a;
   }
  
   // EASCII range.
   if (n >= upper_a_grave && n <= upper_thorn && n != division) {
     return n - upper_a_grave + lower_a_grave;
   }
  
   return n;
 }

Referenced by event_to_logical_key().

◆ update_caps_lock_state_logic_inferrence()

static void update_caps_lock_state_logic_inferrence	(	FlKeyEmbedderResponder *	self,
		bool	is_down_event,
		bool	enabled_by_state,
		int	stage_by_record
	)

static

Definition at line 582 of file fl_key_embedder_responder.cc.

                          {
   if (self->caps_lock_state_logic_inferrence != kStateLogicUndecided) {
     return;
   }
   if (!is_down_event) {
     return;
   }
   const int stage_by_event = find_stage_by_self_event(
       stage_by_record, is_down_event, enabled_by_state, false);
   if ((stage_by_event == 0 && stage_by_record == 2) ||
       (stage_by_event == 2 && stage_by_record == 0)) {
     self->caps_lock_state_logic_inferrence = kStateLogicReversed;
   } else {
     self->caps_lock_state_logic_inferrence = kStateLogicNormal;
   }
 }

References find_stage_by_self_event().

Referenced by synchronize_lock_states_loop_body().

◆ update_mapping_record()

static void update_mapping_record	(	FlKeyEmbedderResponder *	self,
		uint64_t	physical_key,
		uint64_t	logical_key
	)

static

Definition at line 432 of file fl_key_embedder_responder.cc.

                                                         {
   g_hash_table_insert(self->mapping_records, uint64_to_gpointer(logical_key),
                       uint64_to_gpointer(physical_key));
 }

References uint64_to_gpointer().

Referenced by fl_key_embedder_responder_handle_event_impl(), synchronize_lock_states_loop_body(), and synchronize_pressed_states_loop_body().

◆ update_pressing_state()

static void update_pressing_state	(	FlKeyEmbedderResponder *	self,
		uint64_t	physical_key,
		uint64_t	logical_key
	)

static

Definition at line 398 of file fl_key_embedder_responder.cc.

                                                         {
   if (logical_key != 0) {
     g_return_if_fail(lookup_hash_table(self->pressing_records, physical_key) ==
                      0);
     g_hash_table_insert(self->pressing_records,
                         uint64_to_gpointer(physical_key),
                         uint64_to_gpointer(logical_key));
   } else {
     g_return_if_fail(lookup_hash_table(self->pressing_records, physical_key) !=
                      0);
     g_hash_table_remove(self->pressing_records,
                         uint64_to_gpointer(physical_key));
   }
 }

References lookup_hash_table(), and uint64_to_gpointer().

Referenced by fl_key_embedder_responder_handle_event_impl(), synchronize_lock_states_loop_body(), and synchronize_pressed_states_loop_body().

Variable Documentation

◆ callback

FlKeyEvent uint64_t FlKeyResponderAsyncCallback callback

Definition at line 217 of file fl_key_embedder_responder.cc.

Referenced by fl_key_embedder_responder_handle_event(), fl_key_embedder_responder_handle_event_impl(), and fl_key_embedder_user_data_new().

◆ event

FlKeyEvent* event

Definition at line 215 of file fl_key_embedder_responder.cc.

Referenced by event_to_character(), event_to_physical_key(), fl_key_embedder_responder_handle_event(), and fl_key_embedder_responder_handle_event_impl().

◆ kEmptyEvent

const FlutterKeyEvent kEmptyEvent

static

Initial value:

{
    .struct_size = sizeof(FlutterKeyEvent),
    .timestamp = 0,
    .type = kFlutterKeyEventTypeDown,
    .physical = 0,
    .logical = 0,
    .character = nullptr,
    .synthesized = false,
}

Definition at line 16 of file fl_key_embedder_responder.cc.

Referenced by fl_key_embedder_responder_handle_event().

◆ kMicrosecondsPerMillisecond

constexpr uint64_t kMicrosecondsPerMillisecond = 1000

constexpr

Definition at line 14 of file fl_key_embedder_responder.cc.

Referenced by event_to_timestamp(), and fl_key_embedder_responder_sync_modifiers_if_needed().

◆ specified_logical_key

FlKeyEvent uint64_t specified_logical_key

Definition at line 216 of file fl_key_embedder_responder.cc.

Referenced by fl_key_embedder_responder_handle_event(), and fl_key_embedder_responder_handle_event_impl().

◆ user_data

FlKeyEvent uint64_t FlKeyResponderAsyncCallback gpointer user_data

Definition at line 218 of file fl_key_embedder_responder.cc.

Referenced by find_physical_from_logical_loop_body(), fl_key_embedder_responder_handle_event(), fl_key_embedder_responder_handle_event_impl(), fl_key_embedder_user_data_new(), handle_response(), hash_table_find_equal_value(), initialize_logical_key_to_lock_bit_loop_body(), is_known_modifier_physical_key_loop_body(), synchronize_lock_states_loop_body(), and synchronize_pressed_states_loop_body().

Classes

Macros

Functions

Variables

Macro Definition Documentation

◆ FL_TYPE_EMBEDDER_RESPONDER_USER_DATA

◆ FL_TYPE_EMBEDDER_USER_DATA

Function Documentation

◆ apply_id_plane()

◆ corrected_modifier_physical_key()

◆ event_to_character()

◆ event_to_logical_key()

◆ event_to_physical_key()

◆ event_to_timestamp()

◆ find_physical_from_logical_loop_body()

◆ find_stage_by_others_event()

◆ find_stage_by_record()

◆ find_stage_by_self_event()

◆ fl_key_embedder_responder_class_init()

◆ fl_key_embedder_responder_dispose()

◆ fl_key_embedder_responder_get_pressed_state()

◆ fl_key_embedder_responder_handle_event()

◆ fl_key_embedder_responder_handle_event_impl()

◆ fl_key_embedder_responder_iface_init()

◆ fl_key_embedder_responder_init()

◆ fl_key_embedder_responder_new()

◆ fl_key_embedder_responder_sync_modifiers_if_needed()

◆ fl_key_embedder_user_data_class_init()

◆ fl_key_embedder_user_data_dispose()

◆ fl_key_embedder_user_data_init()

◆ fl_key_embedder_user_data_new()

◆ G_DECLARE_FINAL_TYPE()

◆ G_DEFINE_TYPE_WITH_CODE()

◆ handle_response()

◆ hash_table_find_equal_value()

◆ initialize_logical_key_to_lock_bit_loop_body()

◆ is_known_modifier_physical_key_loop_body()

◆ lookup_hash_table()

◆ possibly_update_lock_bit()

◆ reverse_lookup_hash_table()

◆ synchronize_lock_states_loop_body()

◆ synchronize_pressed_states_loop_body()

◆ synthesize_simple_event()

◆ to_lower()

◆ update_caps_lock_state_logic_inferrence()

◆ update_mapping_record()

◆ update_pressing_state()

Variable Documentation

◆ callback

◆ event

◆ kEmptyEvent

◆ kMicrosecondsPerMillisecond

◆ specified_logical_key

◆ user_data