| Flutter Linux Embedder |

Typedefs | Enumerations | Functions
fl_engine_private.h File Reference
`#include <glib-object.h>`
`#include "flutter/shell/platform/embedder/embedder.h"`
`#include "flutter/shell/platform/linux/fl_display_monitor.h"`
`#include "flutter/shell/platform/linux/fl_keyboard_manager.h"`
`#include "flutter/shell/platform/linux/fl_mouse_cursor_handler.h"`
`#include "flutter/shell/platform/linux/fl_opengl_manager.h"`
`#include "flutter/shell/platform/linux/fl_renderable.h"`
`#include "flutter/shell/platform/linux/fl_task_runner.h"`
`#include "flutter/shell/platform/linux/fl_text_input_handler.h"`
`#include "flutter/shell/platform/linux/fl_windowing_handler.h"`
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_dart_project.h"`
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_engine.h"`

Go to the source code of this file.

## Typedefs
typedef gboolean(* | FlEnginePlatformMessageHandler) (FlEngine *engine, const gchar *channel, GBytes *message, const FlutterPlatformMessageResponseHandle *response_handle, gpointer user_data)

## Enumerations
enum | FlEngineError { FL_ENGINE_ERROR_FAILED }

## Functions
GQuark | fl_engine_error_quark (void) G_GNUC_CONST
FlEngine * | fl_engine_new_with_binary_messenger (FlBinaryMessenger *binary_messenger)
FlutterRendererType | fl_engine_get_renderer_type (FlEngine *engine)
FlOpenGLManager * | fl_engine_get_opengl_manager (FlEngine *engine)
FlDisplayMonitor * | fl_engine_get_display_monitor (FlEngine *engine)
gboolean | fl_engine_start (FlEngine *engine, GError **error)
FlutterEngineProcTable * | fl_engine_get_embedder_api (FlEngine *engine)
void | fl_engine_notify_display_update (FlEngine *engine, const FlutterEngineDisplay *displays, size_t displays_length)
void | fl_engine_set_implicit_view (FlEngine *engine, FlRenderable *renderable)
FlutterViewId | fl_engine_add_view (FlEngine *engine, FlRenderable *renderable, size_t width, size_t height, double pixel_ratio, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
gboolean | fl_engine_add_view_finish (FlEngine *engine, GAsyncResult *result, GError **error)
FlRenderable * | fl_engine_get_renderable (FlEngine *engine, FlutterViewId view_id)
void | fl_engine_remove_view (FlEngine *engine, FlutterViewId view_id, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
gboolean | fl_engine_remove_view_finish (FlEngine *engine, GAsyncResult *result, GError **error)
void | fl_engine_set_platform_message_handler (FlEngine *engine, FlEnginePlatformMessageHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
void | fl_engine_send_window_metrics_event (FlEngine *engine, FlutterEngineDisplayId display_id, FlutterViewId view_id, size_t width, size_t height, double pixel_ratio)
void | fl_engine_send_mouse_pointer_event (FlEngine *engine, FlutterViewId view_id, FlutterPointerPhase phase, size_t timestamp, double x, double y, FlutterPointerDeviceKind device_kind, double scroll_delta_x, double scroll_delta_y, int64_t buttons)
void | fl_engine_send_touch_up_event (FlEngine *engine, FlutterViewId view_id, size_t timestamp, double x, double y, int32_t device)
void | fl_engine_send_touch_down_event (FlEngine *engine, FlutterViewId view_id, size_t timestamp, double x, double y, int32_t device)
void | fl_engine_send_touch_move_event (FlEngine *engine, FlutterViewId view_id, size_t timestamp, double x, double y, int32_t device)
void | fl_engine_send_touch_add_event (FlEngine *engine, FlutterViewId view_id, size_t timestamp, double x, double y, int32_t device)
void | fl_engine_send_touch_remove_event (FlEngine *engine, FlutterViewId view_id, size_t timestamp, double x, double y, int32_t device)
void | fl_engine_send_pointer_pan_zoom_event (FlEngine *engine, FlutterViewId view_id, size_t timestamp, double x, double y, FlutterPointerPhase phase, double pan_x, double pan_y, double scale, double rotation)
void | fl_engine_send_key_event (FlEngine *engine, const FlutterKeyEvent *event, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
gboolean | fl_engine_send_key_event_finish (FlEngine *engine, GAsyncResult *result, gboolean *handled, GError **error)
void | fl_engine_dispatch_semantics_action (FlEngine *engine, FlutterViewId view_id, uint64_t node_id, FlutterSemanticsAction action, GBytes *data)
gboolean | fl_engine_send_platform_message_response (FlEngine *engine, const FlutterPlatformMessageResponseHandle *handle, GBytes *response, GError **error)
void | fl_engine_send_platform_message (FlEngine *engine, const gchar *channel, GBytes *message, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
GBytes * | fl_engine_send_platform_message_finish (FlEngine *engine, GAsyncResult *result, GError **error)
FlTaskRunner * | fl_engine_get_task_runner (FlEngine *engine)
void | fl_engine_execute_task (FlEngine *engine, FlutterTask *task)
gboolean | fl_engine_mark_texture_frame_available (FlEngine *engine, int64_t texture_id)
gboolean | fl_engine_register_external_texture (FlEngine *engine, int64_t texture_id)
gboolean | fl_engine_unregister_external_texture (FlEngine *engine, int64_t texture_id)
void | fl_engine_update_accessibility_features (FlEngine *engine, int32_t flags)
void | fl_engine_request_app_exit (FlEngine *engine)
FlWindowingHandler * | fl_engine_get_windowing_handler (FlEngine *engine)
FlKeyboardManager * | fl_engine_get_keyboard_manager (FlEngine *engine)
FlTextInputHandler * | fl_engine_get_text_input_handler (FlEngine *engine)
FlMouseCursorHandler * | fl_engine_get_mouse_cursor_handler (FlEngine *engine)
FlEngine * | fl_engine_for_id (int64_t handle)

## Typedef Documentation

## ◆ FlEnginePlatformMessageHandler

typedef gboolean(* FlEnginePlatformMessageHandler) (FlEngine *engine, const gchar *channel, GBytes *message, const FlutterPlatformMessageResponseHandle *response_handle, gpointer user_data)

FlEnginePlatformMessageHandler: @engine: an #FlEngine. @channel: channel message received on. @message: message content received from Dart. @response_handle: a handle to respond to the message with. @user_data: (closure): data provided when registering this handler.

Function called when platform messages are received.

Returns: TRUE if message has been accepted.

Definition at line 47 of file fl_engine_private.h.

## Enumeration Type Documentation

## ◆ FlEngineError

enum FlEngineError

FlEngineError: Errors for #FlEngine objects to set on failures.

Enumerator
FL_ENGINE_ERROR_FAILED |

Definition at line 29 of file fl_engine_private.h.

29 {
30 FL_ENGINE_ERROR_FAILED,
31 } FlEngineError;
FlEngineError
FlEngineError
Definition: fl_engine_private.h:29
FL_ENGINE_ERROR_FAILED
@ FL_ENGINE_ERROR_FAILED
Definition: fl_engine_private.h:30

## Function Documentation

## ◆ fl_engine_add_view()

FlutterViewId fl_engine_add_view | ( | FlEngine * | engine,
|  | FlRenderable * | renderable,
|  | size_t | width,
|  | size_t | height,
|  | double | pixel_ratio,
|  | GCancellable * | cancellable,
|  | GAsyncReadyCallback | callback,
|  | gpointer | user_data
| ) |  |

fl_engine_add_view: @engine: an #FlEngine. @renderable: the object that will render this view. @width: width of view in pixels. @height: height of view in pixels. @pixel_ratio: scale factor for view. @cancellable: (allow-none): a #GCancellable or NULL. @callback: (scope async): a #GAsyncReadyCallback to call when the view is added. @user_data: (closure): user data to pass to @callback.

Asynchronously add a new view. The returned view ID should not be used until this function completes.

Returns: the ID for the view.

Definition at line 888 of file fl_engine.cc.

895 {
896 g_return_val_if_fail(FL_IS_ENGINE(self), -1);
897
898 g_autoptr(GTask) task = g_task_new(self, cancellable, callback, user_data);
899
900 FlutterViewId view_id = self->next_view_id;
901 self->next_view_id++;
902
903 GWeakRef* ref = g_new(GWeakRef, 1);
904 g_weak_ref_init(ref, G_OBJECT(renderable));
905 g_hash_table_insert(self->renderables_by_view_id, GINT_TO_POINTER(view_id),
906 ref);
907
908 // We don't know which display this view will open on, so set to zero and this
909 // will be updated in a following FlutterWindowMetricsEvent
910 FlutterEngineDisplayId display_id = 0;
911
912 FlutterWindowMetricsEvent metrics = {};
913 metrics.struct_size = sizeof(FlutterWindowMetricsEvent);
914 metrics.width = width;
915 metrics.height = height;
916 metrics.pixel_ratio = pixel_ratio;
917 metrics.display_id = display_id;
918 metrics.view_id = view_id;
919 FlutterAddViewInfo info;
920 info.struct_size = sizeof(FlutterAddViewInfo);
921 info.view_id = view_id;
922 info.view_metrics = &metrics;
923 info.user_data = g_object_ref(task);
924 info.add_view_callback = view_added_cb;
925 FlutterEngineResult result = self->embedder_api.AddView(self->engine, &info);
926 if (result != kSuccess) {
927 g_task_return_new_error(task, fl_engine_error_quark(),
928 FL_ENGINE_ERROR_FAILED, "AddView returned %d",
929 result);
930 // This would have been done in the callback, but that won't occur now.
931 g_object_unref(task);
932 }
933
934 return view_id;
935 }
height
self height
Definition: fl_compositor_software.cc:43
g_autoptr
g_autoptr(GMutexLocker) locker
width
self width
Definition: fl_compositor_software.cc:42
view_added_cb
static void view_added_cb(const FlutterAddViewResult *result)
Definition: fl_engine.cc:171
fl_engine_error_quark
GQuark fl_engine_error_quark(void) G_GNUC_CONST
user_data
G_BEGIN_DECLS G_MODULE_EXPORT FlValue gpointer user_data
Definition: fl_event_channel.h:90
view_id
G_BEGIN_DECLS FlutterViewId view_id
Definition: fl_view_accessible.h:49

References FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), g_autoptr(), height, user_data, view_added_cb(), view_id, and width.

Referenced by fl_view_new_for_engine(), and TEST().

## ◆ fl_engine_add_view_finish()

gboolean fl_engine_add_view_finish | ( | FlEngine * | engine,
|  | GAsyncResult * | result,
|  | GError ** | error
| ) |  |

fl_engine_add_view_finish: @engine: an #FlEngine.

Returns
  : a #GAsyncResult. @error: (allow-none): #GError location to store the error occurring, or NULL to ignore.

Completes request started with fl_engine_add_view().

Returns: TRUE on success.

Definition at line 937 of file fl_engine.cc.

939 {
940 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
941 return g_task_propagate_boolean(G_TASK(result), error);
942 }
error
const uint8_t uint32_t uint32_t GError ** error
Definition: fl_pixel_buffer_texture_test.cc:40

References error.

Referenced by add_view_cb(), add_view_engine_error_cb(), add_view_error_cb(), and view_added_cb().

## ◆ fl_engine_dispatch_semantics_action()

void fl_engine_dispatch_semantics_action | ( | FlEngine * | engine,
|  | FlutterViewId | view_id,
|  | uint64_t | node_id,
|  | FlutterSemanticsAction | action,
|  | GBytes * | data
| ) |  |

fl_engine_dispatch_semantics_action: @engine: an #FlEngine. @view_id: the view that the event occured on. @node_id: the semantics action identifier. @action: the action being dispatched. @data: (allow-none): data associated with the action.

Definition at line 1396 of file fl_engine.cc.

1400 {
1401 g_return_if_fail(FL_IS_ENGINE(self));
1402
1403 if (self->engine == nullptr) {
1404 return;
1405 }
1406
1407 const uint8_t* action_data = nullptr;
1408 size_t action_data_length = 0;
1409 if (data != nullptr) {
1410 action_data = static_cast<const uint8_t*>(
1411 g_bytes_get_data(data, &action_data_length));
1412 }
1413
1414 FlutterSendSemanticsActionInfo info;
1415 info.struct_size = sizeof(FlutterSendSemanticsActionInfo);
1416 info.view_id = view_id;
1417 info.node_id = node_id;
1418 info.action = action;
1419 info.data = action_data;
1420 info.data_length = action_data_length;
1421 if (self->embedder_api.SendSemanticsAction(self->engine, &info) != kSuccess) {
1422 g_warning("Failed to send semantics action");
1423 }
1424 }

References view_id.

Referenced by fl_accessible_node_perform_action_impl(), and TEST().

## ◆ fl_engine_error_quark()

GQuark fl_engine_error_quark | ( | void |  | ) |

Referenced by fl_engine_add_view(), fl_engine_remove_view(), fl_engine_send_key_event(), fl_engine_send_platform_message(), fl_engine_send_platform_message_response(), fl_engine_start(), view_added_cb(), and view_removed_cb().

## ◆ fl_engine_execute_task()

void fl_engine_execute_task | ( | FlEngine * | engine,
|  | FlutterTask * | task
| ) |  |

fl_engine_execute_task: @engine: an #FlEngine. @task: a #FlutterTask to execute.

Executes given Flutter task.

Definition at line 1458 of file fl_engine.cc.

1458 {
1459 g_return_if_fail(FL_IS_ENGINE(self));
1460 if (self->embedder_api.RunTask(self->engine, task) != kSuccess) {
1461 g_warning("Failed to run task");
1462 }
1463 }

Referenced by fl_task_runner_process_expired_tasks_locked().

## ◆ fl_engine_for_id()

FlEngine* fl_engine_for_id | ( | int64_t | handle | ) |

fl_engine_for_id: @handle: an engine identifier obtained through PlatformDispatcher.instance.engineId.

Returns Flutter engine associated with the identifier. The identifier must be valid and for a running engine otherwise the behavior is undefined. Must be called from the main thread.

Returns: a #FlEngine or NULL.

Definition at line 691 of file fl_engine.cc.

691 {
692 void* engine = reinterpret_cast<void*>(id);
693 g_return_val_if_fail(FL_IS_ENGINE(engine), nullptr);
694 return FL_ENGINE(engine);
695 }
id
int64_t id
Definition: fl_pixel_buffer_texture.cc:28

References id.

Referenced by TEST().

## ◆ fl_engine_get_display_monitor()

FlDisplayMonitor* fl_engine_get_display_monitor | ( | FlEngine * | engine | ) |

fl_engine_get_display_monitor: @engine: an #FlEngine.

Gets the display monitor used by this engine.

Returns: an #FlDisplayMonitor.

Definition at line 721 of file fl_engine.cc.

721 {
722 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
723 return self->display_monitor;
724 }

Referenced by handle_geometry_changed(), and TEST().

## ◆ fl_engine_get_embedder_api()

FlutterEngineProcTable* fl_engine_get_embedder_api | ( | FlEngine * | engine | ) |

fl_engine_get_embedder_api: @engine: an #FlEngine.

Gets the embedder API proc table, allowing modificiations for unit testing.

Returns: a mutable pointer to the embedder API proc table.

Definition at line 864 of file fl_engine.cc.

864 {
865 return &(self->embedder_api);
866 }

Referenced by TEST().

## ◆ fl_engine_get_keyboard_manager()

FlKeyboardManager* fl_engine_get_keyboard_manager | ( | FlEngine * | engine | ) |

fl_engine_get_keyboard_manager: @engine: an #FlEngine.

Gets the keyboard manager used by this engine.

Returns: an #FlKeyboardManager.

Definition at line 1495 of file fl_engine.cc.

1495 {
1496 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1497 return self->keyboard_manager;
1498 }

Referenced by handle_key_event(), sync_modifier_if_needed(), and TEST().

## ◆ fl_engine_get_mouse_cursor_handler()

FlMouseCursorHandler* fl_engine_get_mouse_cursor_handler | ( | FlEngine * | engine | ) |

fl_engine_get_mouse_cursor_handler: @engine: an #FlEngine.

Gets the mouse cursor handler used by this engine.

Returns: an #FlMouseCursorHandler.

Definition at line 1505 of file fl_engine.cc.

1505 {
1506 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1507 return self->mouse_cursor_handler;
1508 }

Referenced by cursor_changed_cb(), fl_view_dispose(), setup_cursor(), and TEST().

## ◆ fl_engine_get_opengl_manager()

FlOpenGLManager* fl_engine_get_opengl_manager | ( | FlEngine * | engine | ) |

fl_engine_get_opengl_manager: @engine: an #FlEngine.

Gets the OpenGL manager used by this engine.

Returns: an #FlOpenGLManager.

Definition at line 716 of file fl_engine.cc.

716 {
717 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
718 return self->opengl_manager;
719 }

Referenced by realize_cb(), and setup_opengl().

## ◆ fl_engine_get_renderable()

FlRenderable* fl_engine_get_renderable | ( | FlEngine * | engine,
|  | FlutterViewId | view_id
| ) |  |

fl_engine_get_renderable: @engine: an #FlEngine. @view_id: ID to check.

Gets the renderable associated with the give view ID.

Returns: (transfer full): a reference to an #FlRenderable or NULL if none for this ID.

Definition at line 944 of file fl_engine.cc.

944 {
945 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
946
947 GWeakRef* ref = static_cast<GWeakRef*>(g_hash_table_lookup(
948 self->renderables_by_view_id, GINT_TO_POINTER(view_id)));
949 return FL_RENDERABLE(g_weak_ref_get(ref));
950 }

References view_id.

## ◆ fl_engine_get_renderer_type()

FlutterRendererType fl_engine_get_renderer_type | ( | FlEngine * | engine | ) |

fl_engine_get_renderer_type: @engine: an #FlEngine.

Gets the rendering type used by this engine.

Returns: type of rendering used.

Definition at line 711 of file fl_engine.cc.

711 {
712 g_return_val_if_fail(FL_IS_ENGINE(self), static_cast<FlutterRendererType>(0));
713 return self->renderer_type;
714 }

Referenced by realize_cb().

## ◆ fl_engine_get_task_runner()

FlTaskRunner* fl_engine_get_task_runner | ( | FlEngine * | engine | ) |

fl_engine_get_task_runner: @engine: an #FlEngine.

Returns
  : a #FlTaskRunner.

Returns: task runner responsible for scheduling Flutter tasks.

Definition at line 1453 of file fl_engine.cc.

1453 {
1454 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1455 return self->task_runner;
1456 }

Referenced by setup_opengl(), setup_software(), and TEST().

## ◆ fl_engine_get_text_input_handler()

FlTextInputHandler* fl_engine_get_text_input_handler | ( | FlEngine * | engine | ) |

fl_engine_get_text_input_handler: @engine: an #FlEngine.

Gets the text input handler used by this engine.

Returns: an #FlTextInputHandler.

Definition at line 1500 of file fl_engine.cc.

1500 {
1501 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1502 return self->text_input_handler;
1503 }

Referenced by fl_view_focus_in_event(), and handle_key_event().

## ◆ fl_engine_get_windowing_handler()

FlWindowingHandler* fl_engine_get_windowing_handler | ( | FlEngine * | engine | ) |

fl_engine_get_windowing_handler: @engine: an #FlEngine.

Gets the windowing handler used by this engine.

Returns: an #FlWindowingHandler.

Definition at line 1490 of file fl_engine.cc.

1490 {
1491 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1492 return self->windowing_handler;
1493 }

Referenced by fl_application_activate(), and TEST().

## ◆ fl_engine_mark_texture_frame_available()

gboolean fl_engine_mark_texture_frame_available | ( | FlEngine * | engine,
|  | int64_t | texture_id
| ) |  |

fl_engine_mark_texture_frame_available: @engine: an #FlEngine. @texture_id: the identifier of the texture whose frame has been updated.

Tells the Flutter engine that a new texture frame is available for the given texture.

Returns: TRUE on success.

Definition at line 1426 of file fl_engine.cc.

1427 {
1428 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1429 return self->embedder_api.MarkExternalTextureFrameAvailable(
1430 self->engine, texture_id) == kSuccess;
1431 }
texture_id
int64_t texture_id
Definition: texture_registrar_unittests.cc:24

References texture_id.

Referenced by mark_texture_frame_available().

## ◆ fl_engine_new_with_binary_messenger()

FlEngine* fl_engine_new_with_binary_messenger | ( | FlBinaryMessenger * | binary_messenger | ) |

fl_engine_new_with_binary_messenger: @binary_messenger: an #FlBinaryMessenger.

Creates a new engine with a custom binary messenger. Used for testing.

Returns: a new #FlEngine.

Definition at line 701 of file fl_engine.cc.

702 {
703 g_autoptr(FlDartProject) project = fl_dart_project_new();
704 return fl_engine_new_full(project, binary_messenger);
705 }
fl_dart_project_new
G_MODULE_EXPORT FlDartProject * fl_dart_project_new()
Definition: fl_dart_project.cc:52
fl_engine_new_full
static FlEngine * fl_engine_new_full(FlDartProject *project, FlBinaryMessenger *binary_messenger)
Definition: fl_engine.cc:654

References fl_dart_project_new(), fl_engine_new_full(), and g_autoptr().

Referenced by TEST().

## ◆ fl_engine_notify_display_update()

void fl_engine_notify_display_update | ( | FlEngine * | engine,
|  | const FlutterEngineDisplay * | displays,
|  | size_t | displays_length
| ) |  |

fl_engine_notify_display_update: @engine: an #FlEngine. @displays: displays present on the system. @displays_length: length of @displays.

Notify the current displays that are in the system.

Definition at line 868 of file fl_engine.cc.

870 {
871 g_return_if_fail(FL_IS_ENGINE(self));
872
873 FlutterEngineResult result = self->embedder_api.NotifyDisplayUpdate(
874 self->engine, kFlutterEngineDisplaysUpdateTypeStartup, displays,
875 displays_length);
876 if (result != kSuccess) {
877 g_warning("Failed to notify display update to Flutter engine: %d", result);
878 }
879 }

Referenced by notify_display_update(), and TEST().

## ◆ fl_engine_register_external_texture()

gboolean fl_engine_register_external_texture | ( | FlEngine * | engine,
|  | int64_t | texture_id
| ) |  |

fl_engine_register_external_texture: @engine: an #FlEngine. @texture_id: the identifier of the texture that is available.

Tells the Flutter engine that a new external texture is available.

Returns: TRUE on success.

Definition at line 1433 of file fl_engine.cc.

1434 {
1435 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1436 return self->embedder_api.RegisterExternalTexture(self->engine, texture_id) ==
1437 kSuccess;
1438 }

References texture_id.

Referenced by register_texture().

## ◆ fl_engine_remove_view()

void fl_engine_remove_view | ( | FlEngine * | engine,
|  | FlutterViewId | view_id,
|  | GCancellable * | cancellable,
|  | GAsyncReadyCallback | callback,
|  | gpointer | user_data
| ) |  |

fl_engine_remove_view: @engine: an #FlEngine. @view_id: ID to remove. @cancellable: (allow-none): a #GCancellable or NULL. @callback: (scope async): a #GAsyncReadyCallback to call when the view is added. @user_data: (closure): user data to pass to @callback.

Removes a view previously added with fl_engine_add_view().

Definition at line 952 of file fl_engine.cc.

956 {
957 g_return_if_fail(FL_IS_ENGINE(self));
958
959 g_hash_table_remove(self->renderables_by_view_id, GINT_TO_POINTER(view_id));
960
961 g_autoptr(GTask) task = g_task_new(self, cancellable, callback, user_data);
962
963 FlutterRemoveViewInfo info;
964 info.struct_size = sizeof(FlutterRemoveViewInfo);
965 info.view_id = view_id;
966 info.user_data = g_object_ref(task);
967 info.remove_view_callback = view_removed_cb;
968 FlutterEngineResult result =
969 self->embedder_api.RemoveView(self->engine, &info);
970 if (result != kSuccess) {
971 g_task_return_new_error(task, fl_engine_error_quark(),
972 FL_ENGINE_ERROR_FAILED, "RemoveView returned %d",
973 result);
974 // This would have been done in the callback, but that won't occur now.
975 g_object_unref(task);
976 }
977 }
view_removed_cb
static void view_removed_cb(const FlutterRemoveViewResult *result)
Definition: fl_engine.cc:182

References FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), g_autoptr(), user_data, view_id, and view_removed_cb().

Referenced by fl_view_dispose(), and TEST().

## ◆ fl_engine_remove_view_finish()

gboolean fl_engine_remove_view_finish | ( | FlEngine * | engine,
|  | GAsyncResult * | result,
|  | GError ** | error
| ) |  |

fl_engine_remove_view_finish: @engine: an #FlEngine.

Returns
  : a #GAsyncResult. @error: (allow-none): #GError location to store the error occurring, or NULL to ignore.

Completes request started with fl_engine_remove_view().

Returns: TRUE on succcess.

Definition at line 979 of file fl_engine.cc.

981 {
982 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
983 return g_task_propagate_boolean(G_TASK(result), error);
984 }

References error.

Referenced by remove_view_cb(), remove_view_engine_error_cb(), and remove_view_error_cb().

## ◆ fl_engine_request_app_exit()

void fl_engine_request_app_exit | ( | FlEngine * | engine | ) |

fl_engine_request_app_exit: @engine: an #FlEngine.

Request the application exits.

Definition at line 1485 of file fl_engine.cc.

1485 {
1486 g_return_if_fail(FL_IS_ENGINE(self));
1487 fl_platform_handler_request_app_exit(self->platform_handler);
1488 }
fl_platform_handler_request_app_exit
void fl_platform_handler_request_app_exit(FlPlatformHandler *self)
Definition: fl_platform_handler.cc:267

References fl_platform_handler_request_app_exit().

Referenced by window_delete_event_cb().

## ◆ fl_engine_send_key_event()

void fl_engine_send_key_event | ( | FlEngine * | engine,
|  | const FlutterKeyEvent * | event,
|  | GCancellable * | cancellable,
|  | GAsyncReadyCallback | callback,
|  | gpointer | user_data
| ) |  |

fl_engine_send_key_event: @engine: an #FlEngine. @event: key event to send. @cancellable: (allow-none): a #GCancellable or NULL. @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied. @user_data: (closure): user data to pass to @callback.

Send a key event to the engine.

Definition at line 1356 of file fl_engine.cc.

1360 {
1361 g_return_if_fail(FL_IS_ENGINE(self));
1362
1363 g_autoptr(GTask) task = g_task_new(self, cancellable, callback, user_data);
1364
1365 if (self->engine == nullptr) {
1366 g_task_return_new_error(task, fl_engine_error_quark(),
1367 FL_ENGINE_ERROR_FAILED, "No engine");
1368 return;
1369 }
1370
1371 if (self->embedder_api.SendKeyEvent(self->engine, event, send_key_event_cb,
1372 g_object_ref(task)) != kSuccess) {
1373 g_task_return_new_error(task, fl_engine_error_quark(),
1374 FL_ENGINE_ERROR_FAILED, "Failed to send key event");
1375 g_object_unref(task);
1376 }
1377 }
send_key_event_cb
static void send_key_event_cb(bool handled, void *user_data)
Definition: fl_engine.cc:1349

References FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), g_autoptr(), send_key_event_cb(), and user_data.

Referenced by fl_key_embedder_responder_handle_event(), fl_key_embedder_responder_handle_event_impl(), synthesize_simple_event(), and TEST().

## ◆ fl_engine_send_key_event_finish()

gboolean fl_engine_send_key_event_finish | ( | FlEngine * | engine,
|  | GAsyncResult * | result,
|  | gboolean * | handled,
|  | GError ** | error
| ) |  |

fl_engine_send_key_event_finish: @engine: an #FlEngine.

Returns
  : a #GAsyncResult. @handled: location to write if this event was handled by the engine. @error: (allow-none): #GError location to store the error occurring, or NULL to ignore.

Completes request started with fl_engine_send_key_event().

Returns: TRUE on success.

Definition at line 1379 of file fl_engine.cc.

1382 {
1383 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1384 g_return_val_if_fail(g_task_is_valid(result, self), FALSE);
1385
1386 g_autofree gboolean* return_value =
1387 static_cast<gboolean*>(g_task_propagate_pointer(G_TASK(result), error));
1388 if (return_value == nullptr) {
1389 return FALSE;
1390 }
1391
1392 *handled = *return_value;
1393 return TRUE;
1394 }
TRUE
return TRUE
Definition: fl_compositor_software.cc:68

References error, and TRUE.

Referenced by TEST().

## ◆ fl_engine_send_mouse_pointer_event()

void fl_engine_send_mouse_pointer_event | ( | FlEngine * | engine,
|  | FlutterViewId | view_id,
|  | FlutterPointerPhase | phase,
|  | size_t | timestamp,
|  | double | x,
|  | double | y,
|  | FlutterPointerDeviceKind | device_kind,
|  | double | scroll_delta_x,
|  | double | scroll_delta_y,
|  | int64_t | buttons
| ) |  |

fl_engine_send_mouse_pointer_event: @engine: an #FlEngine. @view_id: the view that the event occured on. @phase: mouse phase. @timestamp: time when event occurred in microseconds. @x: x location of mouse cursor. @y: y location of mouse cursor. @device_kind: kind of pointing device. @scroll_delta_x: x offset of scroll. @scroll_delta_y: y offset of scroll. @buttons: buttons that are pressed.

Sends a mouse pointer event to the engine.

Definition at line 1132 of file fl_engine.cc.

1141 {
1142 g_return_if_fail(FL_IS_ENGINE(self));
1143
1144 if (self->engine == nullptr) {
1145 return;
1146 }
1147
1148 FlutterPointerEvent fl_event = {};
1149 fl_event.struct_size = sizeof(fl_event);
1150 fl_event.phase = phase;
1151 fl_event.timestamp = timestamp;
1152 fl_event.x = x;
1153 fl_event.y = y;
1154 if (scroll_delta_x != 0 || scroll_delta_y != 0) {
1155 fl_event.signal_kind = kFlutterPointerSignalKindScroll;
1156 }
1157 fl_event.scroll_delta_x = scroll_delta_x;
1158 fl_event.scroll_delta_y = scroll_delta_y;
1159 fl_event.device_kind = device_kind;
1160 fl_event.buttons = buttons;
1161 fl_event.device = kMousePointerDeviceId;
1162 fl_event.view_id = view_id;
1163 if (self->embedder_api.SendPointerEvent(self->engine, &fl_event, 1) !=
1164 kSuccess) {
1165 g_warning("Failed to send pointer event");
1166 }
1167 }
kMousePointerDeviceId
static constexpr int32_t kMousePointerDeviceId
Definition: fl_engine.cc:36

References kMousePointerDeviceId, and view_id.

Referenced by ensure_pointer_added(), fl_pointer_manager_handle_button_press(), fl_pointer_manager_handle_button_release(), fl_pointer_manager_handle_leave(), fl_pointer_manager_handle_motion(), fl_scrolling_manager_handle_scroll_event(), and TEST().

## ◆ fl_engine_send_platform_message()

void fl_engine_send_platform_message | ( | FlEngine * | engine,
|  | const gchar * | channel,
|  | GBytes * | message,
|  | GCancellable * | cancellable,
|  | GAsyncReadyCallback | callback,
|  | gpointer | user_data
| ) |  |

fl_engine_send_platform_message: @engine: an #FlEngine. @channel: channel to send to. @message: (allow-none): message buffer to send or NULL for an empty message @cancellable: (allow-none): a #GCancellable or NULL. @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied. @user_data: (closure): user data to pass to @callback.

Asynchronously sends a platform message.

Definition at line 1037 of file fl_engine.cc.

1042 {
1043 g_return_if_fail(FL_IS_ENGINE(self));
1044
1045 GTask* task = nullptr;
1046 FlutterPlatformMessageResponseHandle* response_handle = nullptr;
1047 if (callback != nullptr) {
1048 task = g_task_new(self, cancellable, callback, user_data);
1049
1050 if (self->engine == nullptr) {
1051 g_task_return_new_error(task, fl_engine_error_quark(),
1052 FL_ENGINE_ERROR_FAILED, "No engine to send to");
1053 return;
1054 }
1055
1056 FlutterEngineResult result =
1057 self->embedder_api.PlatformMessageCreateResponseHandle(
1058 self->engine, fl_engine_platform_message_response_cb, task,
1059 &response_handle);
1060 if (result != kSuccess) {
1061 g_task_return_new_error(task, fl_engine_error_quark(),
1062 FL_ENGINE_ERROR_FAILED,
1063 "Failed to create response handle");
1064 g_object_unref(task);
1065 return;
1066 }
1067 } else if (self->engine == nullptr) {
1068 return;
1069 }
1070
1071 FlutterPlatformMessage fl_message = {};
1072 fl_message.struct_size = sizeof(fl_message);
1073 fl_message.channel = channel;
1074 fl_message.message =
1075 message != nullptr
1076 ? static_cast<const uint8_t*>(g_bytes_get_data(message, nullptr))
1077 : nullptr;
1078 fl_message.message_size = message != nullptr ? g_bytes_get_size(message) : 0;
1079 fl_message.response_handle = response_handle;
1080 FlutterEngineResult result =
1081 self->embedder_api.SendPlatformMessage(self->engine, &fl_message);
1082
1083 if (result != kSuccess && task != nullptr) {
1084 g_task_return_new_error(task, fl_engine_error_quark(),
1085 FL_ENGINE_ERROR_FAILED,
1086 "Failed to send platform messages");
1087 g_object_unref(task);
1088 }
1089
1090 if (response_handle != nullptr) {
1091 if (self->embedder_api.PlatformMessageReleaseResponseHandle(
1092 self->engine, response_handle) != kSuccess) {
1093 g_warning("Failed to release response handle");
1094 }
1095 }
1096 }
fl_engine_platform_message_response_cb
static void fl_engine_platform_message_response_cb(const uint8_t *data, size_t data_length, void *user_data)
Definition: fl_engine.cc:524

References FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), fl_engine_platform_message_response_cb(), and user_data.

Referenced by send_on_channel(), and TEST().

## ◆ fl_engine_send_platform_message_finish()

GBytes* fl_engine_send_platform_message_finish | ( | FlEngine * | engine,
|  | GAsyncResult * | result,
|  | GError ** | error
| ) |  |

fl_engine_send_platform_message_finish: @engine: an #FlEngine.

Returns
  : a #GAsyncResult. @error: (allow-none): #GError location to store the error occurring, or NULL to ignore.

Completes request started with fl_engine_send_platform_message().

Returns: message response on success or NULL on error.

Definition at line 1098 of file fl_engine.cc.

1100 {
1101 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1102 g_return_val_if_fail(g_task_is_valid(result, self), FALSE);
1103
1104 return static_cast<GBytes*>(g_task_propagate_pointer(G_TASK(result), error));
1105 }

References error.

Referenced by send_on_channel_finish().

## ◆ fl_engine_send_platform_message_response()

gboolean fl_engine_send_platform_message_response | ( | FlEngine * | engine,
|  | const FlutterPlatformMessageResponseHandle * | handle,
|  | GBytes * | response,
|  | GError ** | error
| ) |  |

fl_engine_send_platform_message_response: @engine: an #FlEngine. @handle: handle that was provided in FlEnginePlatformMessageHandler. @response: (allow-none): response to send or NULL for an empty response. @error: (allow-none): #GError location to store the error occurring, or NULL to ignore.

Responds to a platform message.

Returns: TRUE on success.

Definition at line 1005 of file fl_engine.cc.

1009 {
1010 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1011 g_return_val_if_fail(handle != nullptr, FALSE);
1012
1013 if (self->engine == nullptr) {
1014 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
1015 "No engine to send response to");
1016 return FALSE;
1017 }
1018
1019 gsize data_length = 0;
1020 const uint8_t* data = nullptr;
1021 if (response != nullptr) {
1022 data =
1023 static_cast<const uint8_t*>(g_bytes_get_data(response, &data_length));
1024 }
1025 FlutterEngineResult result = self->embedder_api.SendPlatformMessageResponse(
1026 self->engine, handle, data, data_length);
1027
1028 if (result != kSuccess) {
1029 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
1030 "Failed to send platform message response");
1031 return FALSE;
1032 }
1033
1034 return TRUE;
1035 }

References error, FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), and TRUE.

Referenced by fl_engine_platform_message_cb(), send_response(), and TEST().

## ◆ fl_engine_send_pointer_pan_zoom_event()

void fl_engine_send_pointer_pan_zoom_event | ( | FlEngine * | engine,
|  | FlutterViewId | view_id,
|  | size_t | timestamp,
|  | double | x,
|  | double | y,
|  | FlutterPointerPhase | phase,
|  | double | pan_x,
|  | double | pan_y,
|  | double | scale,
|  | double | rotation
| ) |  |

fl_engine_send_pointer_pan_zoom_event: @engine: an #FlEngine. @view_id: the view that the event occured on. @timestamp: time when event occurred in microseconds. @x: x location of mouse cursor. @y: y location of mouse cursor. @phase: mouse phase. @pan_x: x offset of the pan/zoom in pixels. @pan_y: y offset of the pan/zoom in pixels. @scale: scale of the pan/zoom. @rotation: rotation of the pan/zoom in radians.

Sends a pan/zoom pointer event to the engine.

Definition at line 1314 of file fl_engine.cc.

1323 {
1324 g_return_if_fail(FL_IS_ENGINE(self));
1325
1326 if (self->engine == nullptr) {
1327 return;
1328 }
1329
1330 FlutterPointerEvent fl_event = {};
1331 fl_event.struct_size = sizeof(fl_event);
1332 fl_event.timestamp = timestamp;
1333 fl_event.x = x;
1334 fl_event.y = y;
1335 fl_event.phase = phase;
1336 fl_event.pan_x = pan_x;
1337 fl_event.pan_y = pan_y;
1338 fl_event.scale = scale;
1339 fl_event.rotation = rotation;
1340 fl_event.device = kPointerPanZoomDeviceId;
1341 fl_event.device_kind = kFlutterPointerDeviceKindTrackpad;
1342 fl_event.view_id = view_id;
1343 if (self->embedder_api.SendPointerEvent(self->engine, &fl_event, 1) !=
1344 kSuccess) {
1345 g_warning("Failed to send pointer event");
1346 }
1347 }
kPointerPanZoomDeviceId
static constexpr int32_t kPointerPanZoomDeviceId
Definition: fl_engine.cc:37

References kPointerPanZoomDeviceId, and view_id.

Referenced by fl_scrolling_manager_handle_rotation_begin(), fl_scrolling_manager_handle_rotation_end(), fl_scrolling_manager_handle_rotation_update(), fl_scrolling_manager_handle_scroll_event(), fl_scrolling_manager_handle_zoom_begin(), fl_scrolling_manager_handle_zoom_end(), fl_scrolling_manager_handle_zoom_update(), and TEST().

## ◆ fl_engine_send_touch_add_event()

void fl_engine_send_touch_add_event | ( | FlEngine * | engine,
|  | FlutterViewId | view_id,
|  | size_t | timestamp,
|  | double | x,
|  | double | y,
|  | int32_t | device
| ) |  |

fl_engine_send_touch_add_event: @engine: an #FlEngine. @view_id: the view that the event occured on. @timestamp: time when event occurred in microseconds. @x: x location of mouse cursor. @y: y location of mouse cursor. @device: device id.

Sends a touch add event to the engine.

Definition at line 1256 of file fl_engine.cc.

1261 {
1262 g_return_if_fail(FL_IS_ENGINE(self));
1263
1264 if (self->engine == nullptr) {
1265 return;
1266 }
1267
1268 FlutterPointerEvent event;
1269 event.timestamp = timestamp;
1270 event.x = x;
1271 event.y = y;
1272 event.device_kind = kFlutterPointerDeviceKindTouch;
1273 event.device = device;
1274 event.buttons = 0;
1275 event.view_id = view_id;
1276 event.phase = FlutterPointerPhase::kAdd;
1277 event.struct_size = sizeof(event);
1278
1279 if (self->embedder_api.SendPointerEvent(self->engine, &event, 1) !=
1280 kSuccess) {
1281 g_warning("Failed to send pointer event");
1282 }
1283 }

References view_id.

Referenced by ensure_touch_added().

## ◆ fl_engine_send_touch_down_event()

void fl_engine_send_touch_down_event | ( | FlEngine * | engine,
|  | FlutterViewId | view_id,
|  | size_t | timestamp,
|  | double | x,
|  | double | y,
|  | int32_t | device
| ) |  |

fl_engine_send_touch_down_event: @engine: an #FlEngine. @view_id: the view that the event occured on. @timestamp: time when event occurred in microseconds. @x: x location of mouse cursor. @y: y location of mouse cursor. @device: device id.

Sends a touch down event to the engine.

Definition at line 1198 of file fl_engine.cc.

1203 {
1204 g_return_if_fail(FL_IS_ENGINE(self));
1205
1206 if (self->engine == nullptr) {
1207 return;
1208 }
1209
1210 FlutterPointerEvent event;
1211 event.timestamp = timestamp;
1212 event.x = x;
1213 event.y = y;
1214 event.device_kind = kFlutterPointerDeviceKindTouch;
1215 event.device = device;
1216 event.buttons = FlutterPointerMouseButtons::kFlutterPointerButtonMousePrimary;
1217 event.view_id = view_id;
1218 event.phase = FlutterPointerPhase::kDown;
1219 event.struct_size = sizeof(event);
1220
1221 if (self->embedder_api.SendPointerEvent(self->engine, &event, 1) !=
1222 kSuccess) {
1223 g_warning("Failed to send pointer event");
1224 }
1225 }

References view_id.

Referenced by fl_touch_manager_handle_touch_event().

## ◆ fl_engine_send_touch_move_event()

void fl_engine_send_touch_move_event | ( | FlEngine * | engine,
|  | FlutterViewId | view_id,
|  | size_t | timestamp,
|  | double | x,
|  | double | y,
|  | int32_t | device
| ) |  |

fl_engine_send_touch_move_event: @engine: an #FlEngine. @view_id: the view that the event occured on. @timestamp: time when event occurred in microseconds. @x: x location of mouse cursor. @y: y location of mouse cursor. @device: device id.

Sends a touch move event to the engine.

Definition at line 1227 of file fl_engine.cc.

1232 {
1233 g_return_if_fail(FL_IS_ENGINE(self));
1234
1235 if (self->engine == nullptr) {
1236 return;
1237 }
1238
1239 FlutterPointerEvent event;
1240 event.timestamp = timestamp;
1241 event.x = x;
1242 event.y = y;
1243 event.device_kind = kFlutterPointerDeviceKindTouch;
1244 event.device = device;
1245 event.buttons = FlutterPointerMouseButtons::kFlutterPointerButtonMousePrimary;
1246 event.view_id = view_id;
1247 event.phase = FlutterPointerPhase::kMove;
1248 event.struct_size = sizeof(event);
1249
1250 if (self->embedder_api.SendPointerEvent(self->engine, &event, 1) !=
1251 kSuccess) {
1252 g_warning("Failed to send pointer event");
1253 }
1254 }

References view_id.

Referenced by fl_touch_manager_handle_touch_event().

## ◆ fl_engine_send_touch_remove_event()

void fl_engine_send_touch_remove_event | ( | FlEngine * | engine,
|  | FlutterViewId | view_id,
|  | size_t | timestamp,
|  | double | x,
|  | double | y,
|  | int32_t | device
| ) |  |

fl_engine_send_touch_remove_event: @engine: an #FlEngine. @view_id: the view that the event occured on. @timestamp: time when event occurred in microseconds. @x: x location of mouse cursor. @y: y location of mouse cursor. @device: device id.

Sends a touch remove event to the engine.

Definition at line 1285 of file fl_engine.cc.

1290 {
1291 g_return_if_fail(FL_IS_ENGINE(self));
1292
1293 if (self->engine == nullptr) {
1294 return;
1295 }
1296
1297 FlutterPointerEvent event;
1298 event.timestamp = timestamp;
1299 event.x = x;
1300 event.y = y;
1301 event.device_kind = kFlutterPointerDeviceKindTouch;
1302 event.device = device;
1303 event.buttons = 0;
1304 event.view_id = view_id;
1305 event.phase = FlutterPointerPhase::kRemove;
1306 event.struct_size = sizeof(event);
1307
1308 if (self->embedder_api.SendPointerEvent(self->engine, &event, 1) !=
1309 kSuccess) {
1310 g_warning("Failed to send pointer event");
1311 }
1312 }

References view_id.

Referenced by fl_touch_manager_handle_touch_event().

## ◆ fl_engine_send_touch_up_event()

void fl_engine_send_touch_up_event | ( | FlEngine * | engine,
|  | FlutterViewId | view_id,
|  | size_t | timestamp,
|  | double | x,
|  | double | y,
|  | int32_t | device
| ) |  |

fl_engine_send_touch_up_event: @engine: an #FlEngine. @view_id: the view that the event occured on. @timestamp: time when event occurred in microseconds. @x: x location of mouse cursor. @y: y location of mouse cursor. @device: device id.

Sends a touch up event to the engine.

Definition at line 1169 of file fl_engine.cc.

1174 {
1175 g_return_if_fail(FL_IS_ENGINE(self));
1176
1177 if (self->engine == nullptr) {
1178 return;
1179 }
1180
1181 FlutterPointerEvent event;
1182 event.timestamp = timestamp;
1183 event.x = x;
1184 event.y = y;
1185 event.device_kind = kFlutterPointerDeviceKindTouch;
1186 event.device = device;
1187 event.buttons = 0;
1188 event.view_id = view_id;
1189 event.phase = FlutterPointerPhase::kUp;
1190 event.struct_size = sizeof(event);
1191
1192 if (self->embedder_api.SendPointerEvent(self->engine, &event, 1) !=
1193 kSuccess) {
1194 g_warning("Failed to send pointer event");
1195 }
1196 }

References view_id.

Referenced by fl_touch_manager_handle_touch_event().

## ◆ fl_engine_send_window_metrics_event()

void fl_engine_send_window_metrics_event | ( | FlEngine * | engine,
|  | FlutterEngineDisplayId | display_id,
|  | FlutterViewId | view_id,
|  | size_t | width,
|  | size_t | height,
|  | double | pixel_ratio
| ) |  |

fl_engine_send_window_metrics_event: @engine: an #FlEngine. @display_id: the display this view is rendering on. @view_id: the view that the event occured on. @width: width of the window in pixels. @height: height of the window in pixels. @pixel_ratio: scale factor for window.

Sends a window metrics event to the engine.

Definition at line 1107 of file fl_engine.cc.

1112 {
1113 g_return_if_fail(FL_IS_ENGINE(self));
1114
1115 if (self->engine == nullptr) {
1116 return;
1117 }
1118
1119 FlutterWindowMetricsEvent event = {};
1120 event.struct_size = sizeof(FlutterWindowMetricsEvent);
1121 event.width = width;
1122 event.height = height;
1123 event.pixel_ratio = pixel_ratio;
1124 event.display_id = display_id;
1125 event.view_id = view_id;
1126 if (self->embedder_api.SendWindowMetricsEvent(self->engine, &event) !=
1127 kSuccess) {
1128 g_warning("Failed to send window metrics");
1129 }
1130 }

References height, view_id, and width.

Referenced by handle_geometry_changed(), and TEST().

## ◆ fl_engine_set_implicit_view()

void fl_engine_set_implicit_view | ( | FlEngine * | engine,
|  | FlRenderable * | renderable
| ) |  |

fl_engine_set_implicit_view: @engine: an #FlEngine. @renderable: the object that will render the implicit view.

Sets the object to render the implicit view.

Definition at line 881 of file fl_engine.cc.

881 {
882 GWeakRef* ref = g_new(GWeakRef, 1);
883 g_weak_ref_init(ref, G_OBJECT(renderable));
884 g_hash_table_insert(self->renderables_by_view_id,
885 GINT_TO_POINTER(flutter::kFlutterImplicitViewId), ref);
886 }

Referenced by fl_view_new(), and TEST().

## ◆ fl_engine_set_platform_message_handler()

void fl_engine_set_platform_message_handler | ( | FlEngine * | engine,
|  | FlEnginePlatformMessageHandler | handler,
|  | gpointer | user_data,
|  | GDestroyNotify | destroy_notify
| ) |  |

fl_engine_set_platform_message_handler: @engine: an #FlEngine. @handler: function to call when a platform message is received. @user_data: (closure): user data to pass to @handler. @destroy_notify: (allow-none): a function which gets called to free @user_data, or NULL.

Registers the function called when a platform message is received. Call fl_engine_send_platform_message_response() with the response to this message. Ownership of #FlutterPlatformMessageResponseHandle is transferred to the caller, and the message must be responded to avoid memory leaks.

Definition at line 986 of file fl_engine.cc.

990 {
991 g_return_if_fail(FL_IS_ENGINE(self));
992 g_return_if_fail(handler != nullptr);
993
994 if (self->platform_message_handler_destroy_notify) {
995 self->platform_message_handler_destroy_notify(
996 self->platform_message_handler_data);
997 }
998
999 self->platform_message_handler = handler;
1000 self->platform_message_handler_data = user_data;
1001 self->platform_message_handler_destroy_notify = destroy_notify;
1002 }

References user_data.

Referenced by fl_binary_messenger_new().

## ◆ fl_engine_start()

gboolean fl_engine_start | ( | FlEngine * | engine,
|  | GError ** | error
| ) |  |

fl_engine_start: @engine: an #FlEngine. @error: (allow-none): #GError location to store the error occurring, or NULL to ignore.

Starts the Flutter engine.

Returns: TRUE on success.

Definition at line 726 of file fl_engine.cc.

726 {
727 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
728
729 FlutterRendererConfig config = {};
730 config.type = self->renderer_type;
731 switch (config.type) {
732 case kSoftware:
733 config.software.struct_size = sizeof(FlutterSoftwareRendererConfig);
734 // No action required, as this is handled in
735 // compositor_present_view_callback.
736 config.software.surface_present_callback =
737 [](void* user_data, const void* allocation, size_t row_bytes,
738 size_t height) { return true; };
739 break;
740 case kOpenGL:
741 config.open_gl.struct_size = sizeof(FlutterOpenGLRendererConfig);
742 config.open_gl.gl_proc_resolver = fl_engine_gl_proc_resolver;
743 config.open_gl.make_current = fl_engine_gl_make_current;
744 config.open_gl.clear_current = fl_engine_gl_clear_current;
745 config.open_gl.fbo_callback = fl_engine_gl_get_fbo;
746 // No action required, as this is handled in
747 // compositor_present_view_callback.
748 config.open_gl.present = [](void* user_data) { return true; };
749 config.open_gl.make_resource_current = fl_engine_gl_make_resource_current;
750 config.open_gl.gl_external_texture_frame_callback =
751 fl_engine_gl_external_texture_frame_callback;
752 break;
753 case kMetal:
754 case kVulkan:
755 default:
756 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
757 "Unsupported renderer type");
758 return FALSE;
759 }
760
761 FlutterTaskRunnerDescription platform_task_runner = {};
762 platform_task_runner.struct_size = sizeof(FlutterTaskRunnerDescription);
763 platform_task_runner.user_data = self;
764 platform_task_runner.runs_task_on_current_thread_callback =
765 fl_engine_runs_task_on_current_thread;
766 platform_task_runner.post_task_callback = fl_engine_post_task;
767 platform_task_runner.identifier = kPlatformTaskRunnerIdentifier;
768
769 FlutterCustomTaskRunners custom_task_runners = {};
770 custom_task_runners.struct_size = sizeof(FlutterCustomTaskRunners);
771 custom_task_runners.platform_task_runner = &platform_task_runner;
772
773 if (fl_dart_project_get_ui_thread_policy(self->project) ==
774 FL_UI_THREAD_POLICY_RUN_ON_PLATFORM_THREAD) {
775 custom_task_runners.ui_task_runner = &platform_task_runner;
776 }
777
778 g_autoptr(GPtrArray) command_line_args =
779 g_ptr_array_new_with_free_func(g_free);
780 g_ptr_array_insert(command_line_args, 0, g_strdup("flutter"));
781 for (const auto& env_switch : flutter::GetSwitchesFromEnvironment()) {
782 g_ptr_array_add(command_line_args, g_strdup(env_switch.c_str()));
783 }
784
785 gchar** dart_entrypoint_args =
786 fl_dart_project_get_dart_entrypoint_arguments(self->project);
787
788 FlutterProjectArgs args = {};
789 args.struct_size = sizeof(FlutterProjectArgs);
790 args.assets_path = fl_dart_project_get_assets_path(self->project);
791 args.icu_data_path = fl_dart_project_get_icu_data_path(self->project);
792 args.command_line_argc = command_line_args->len;
793 args.command_line_argv =
794 reinterpret_cast<const char* const*>(command_line_args->pdata);
795 args.platform_message_callback = fl_engine_platform_message_cb;
796 args.update_semantics_callback2 = fl_engine_update_semantics_cb;
797 args.custom_task_runners = &custom_task_runners;
798 args.shutdown_dart_vm_when_done = true;
799 args.on_pre_engine_restart_callback = fl_engine_on_pre_engine_restart_cb;
800 args.dart_entrypoint_argc =
801 dart_entrypoint_args != nullptr ? g_strv_length(dart_entrypoint_args) : 0;
802 args.dart_entrypoint_argv =
803 reinterpret_cast<const char* const*>(dart_entrypoint_args);
804 args.engine_id = reinterpret_cast<int64_t>(self);
805
806 FlutterCompositor compositor = {};
807 compositor.struct_size = sizeof(FlutterCompositor);
808 compositor.user_data = self;
809 compositor.create_backing_store_callback =
810 compositor_create_backing_store_callback;
811 compositor.collect_backing_store_callback =
812 compositor_collect_backing_store_callback;
813 compositor.present_view_callback = compositor_present_view_callback;
814 args.compositor = &compositor;
815
816 if (self->embedder_api.RunsAOTCompiledDartCode()) {
817 FlutterEngineAOTDataSource source = {};
818 source.type = kFlutterEngineAOTDataSourceTypeElfPath;
819 source.elf_path = fl_dart_project_get_aot_library_path(self->project);
820 if (self->embedder_api.CreateAOTData(&source, &self->aot_data) !=
821 kSuccess) {
822 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
823 "Failed to create AOT data");
824 return FALSE;
825 }
826 args.aot_data = self->aot_data;
827 }
828
829 FlutterEngineResult result = self->embedder_api.Initialize(
830 FLUTTER_ENGINE_VERSION, &config, &args, self, &self->engine);
831 if (result != kSuccess) {
832 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
833 "Failed to initialize Flutter engine");
834 return FALSE;
835 }
836
837 result = self->embedder_api.RunInitialized(self->engine);
838 if (result != kSuccess) {
839 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
840 "Failed to run Flutter engine");
841 return FALSE;
842 }
843
844 setup_locales(self);
845
846 g_autoptr(FlSettings) settings = fl_settings_new();
847 self->settings_handler = fl_settings_handler_new(self);
848 fl_settings_handler_start(self->settings_handler, settings);
849
850 self->platform_handler = fl_platform_handler_new(self->binary_messenger);
851
852 setup_keyboard(self);
853
854 result = self->embedder_api.UpdateSemanticsEnabled(self->engine, TRUE);
855 if (result != kSuccess) {
856 g_warning("Failed to enable accessibility features on Flutter engine");
857 }
858
859 fl_display_monitor_start(self->display_monitor);
860
861 return TRUE;
862 }
fl_dart_project_get_aot_library_path
G_MODULE_EXPORT const gchar * fl_dart_project_get_aot_library_path(FlDartProject *self)
Definition: fl_dart_project.cc:74
fl_dart_project_get_dart_entrypoint_arguments
G_MODULE_EXPORT gchar ** fl_dart_project_get_dart_entrypoint_arguments(FlDartProject *self)
Definition: fl_dart_project.cc:106
fl_dart_project_get_icu_data_path
G_MODULE_EXPORT const gchar * fl_dart_project_get_icu_data_path(FlDartProject *self)
Definition: fl_dart_project.cc:100
fl_dart_project_get_assets_path
G_MODULE_EXPORT const gchar * fl_dart_project_get_assets_path(FlDartProject *self)
Definition: fl_dart_project.cc:87
fl_dart_project_get_ui_thread_policy
G_MODULE_EXPORT FlUIThreadPolicy fl_dart_project_get_ui_thread_policy(FlDartProject *project)
Definition: fl_dart_project.cc:128
FL_UI_THREAD_POLICY_RUN_ON_PLATFORM_THREAD
@ FL_UI_THREAD_POLICY_RUN_ON_PLATFORM_THREAD
Definition: fl_dart_project.h:143
fl_display_monitor_start
void fl_display_monitor_start(FlDisplayMonitor *self)
Definition: fl_display_monitor.cc:103
fl_engine_gl_external_texture_frame_callback
static bool fl_engine_gl_external_texture_frame_callback(void *user_data, int64_t texture_id, size_t width, size_t height, FlutterOpenGLTexture *opengl_texture)
Definition: fl_engine.cc:407
fl_engine_runs_task_on_current_thread
static bool fl_engine_runs_task_on_current_thread(void *user_data)
Definition: fl_engine.cc:448
fl_engine_on_pre_engine_restart_cb
static void fl_engine_on_pre_engine_restart_cb(void *user_data)
Definition: fl_engine.cc:514
compositor_create_backing_store_callback
static bool compositor_create_backing_store_callback(const FlutterBackingStoreConfig *config, FlutterBackingStore *backing_store_out, void *user_data)
Definition: fl_engine.cc:331
fl_engine_gl_make_current
static bool fl_engine_gl_make_current(void *user_data)
Definition: fl_engine.cc:386
compositor_present_view_callback
static bool compositor_present_view_callback(const FlutterPresentViewInfo *info)
Definition: fl_engine.cc:362
compositor_collect_backing_store_callback
static bool compositor_collect_backing_store_callback(const FlutterBackingStore *backing_store, void *user_data)
Definition: fl_engine.cc:347
fl_engine_post_task
static void fl_engine_post_task(FlutterTask task, uint64_t target_time_nanos, void *user_data)
Definition: fl_engine.cc:454
fl_engine_gl_get_fbo
static uint32_t fl_engine_gl_get_fbo(void *user_data)
Definition: fl_engine.cc:396
fl_engine_gl_proc_resolver
static void * fl_engine_gl_proc_resolver(void *user_data, const char *name)
Definition: fl_engine.cc:382
setup_keyboard
static void setup_keyboard(FlEngine *self)
Definition: fl_engine.cc:490
setup_locales
static void setup_locales(FlEngine *self)
Definition: fl_engine.cc:200
fl_engine_update_semantics_cb
static void fl_engine_update_semantics_cb(const FlutterSemanticsUpdate2 *update, void *user_data)
Definition: fl_engine.cc:483
fl_engine_gl_make_resource_current
static bool fl_engine_gl_make_resource_current(void *user_data)
Definition: fl_engine.cc:401
fl_engine_platform_message_cb
static void fl_engine_platform_message_cb(const FlutterPlatformMessage *message, void *user_data)
Definition: fl_engine.cc:463
kPlatformTaskRunnerIdentifier
static constexpr size_t kPlatformTaskRunnerIdentifier
Definition: fl_engine.cc:32
fl_engine_gl_clear_current
static bool fl_engine_gl_clear_current(void *user_data)
Definition: fl_engine.cc:391
args
G_BEGIN_DECLS G_MODULE_EXPORT FlValue * args
Definition: fl_event_channel.h:89
fl_platform_handler_new
FlPlatformHandler * fl_platform_handler_new(FlBinaryMessenger *messenger)
Definition: fl_platform_handler.cc:254
fl_settings_new
FlSettings * fl_settings_new()
Definition: fl_settings.cc:55
fl_settings_handler_start
void fl_settings_handler_start(FlSettingsHandler *self, FlSettings *settings)
Definition: fl_settings_handler.cc:88
fl_settings_handler_new
FlSettingsHandler * fl_settings_handler_new(FlEngine *engine)
Definition: fl_settings_handler.cc:74
flutter::GetSwitchesFromEnvironment
std::vector< std::string > GetSwitchesFromEnvironment()
Definition: engine_switches.cc:14

References args, compositor_collect_backing_store_callback(), compositor_create_backing_store_callback(), compositor_present_view_callback(), error, fl_dart_project_get_aot_library_path(), fl_dart_project_get_assets_path(), fl_dart_project_get_dart_entrypoint_arguments(), fl_dart_project_get_icu_data_path(), fl_dart_project_get_ui_thread_policy(), fl_display_monitor_start(), FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), fl_engine_gl_clear_current(), fl_engine_gl_external_texture_frame_callback(), fl_engine_gl_get_fbo(), fl_engine_gl_make_current(), fl_engine_gl_make_resource_current(), fl_engine_gl_proc_resolver(), fl_engine_on_pre_engine_restart_cb(), fl_engine_platform_message_cb(), fl_engine_post_task(), fl_engine_runs_task_on_current_thread(), fl_engine_update_semantics_cb(), fl_platform_handler_new(), fl_settings_handler_new(), fl_settings_handler_start(), fl_settings_new(), FL_UI_THREAD_POLICY_RUN_ON_PLATFORM_THREAD, g_autoptr(), flutter::GetSwitchesFromEnvironment(), height, kPlatformTaskRunnerIdentifier, setup_keyboard(), setup_locales(), TRUE, and user_data.

Referenced by realize_cb(), and TEST().

## ◆ fl_engine_unregister_external_texture()

gboolean fl_engine_unregister_external_texture | ( | FlEngine * | engine,
|  | int64_t | texture_id
| ) |  |

fl_engine_unregister_external_texture: @engine: an #FlEngine. @texture_id: the identifier of the texture that is not available anymore.

Tells the Flutter engine that an existing external texture is not available anymore.

Returns: TRUE on success.

Definition at line 1440 of file fl_engine.cc.

1441 {
1442 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1443 return self->embedder_api.UnregisterExternalTexture(self->engine,
1444 texture_id) == kSuccess;
1445 }

References texture_id.

Referenced by unregister_texture().

## ◆ fl_engine_update_accessibility_features()

void fl_engine_update_accessibility_features | ( | FlEngine * | engine,
|  | int32_t | flags
| ) |  |

fl_engine_update_accessibility_features: @engine: an #FlEngine. @flags: the features to enable in the accessibility tree.

Tells the Flutter engine to update the flags on the accessibility tree.

Definition at line 1471 of file fl_engine.cc.

1471 {
1472 g_return_if_fail(FL_IS_ENGINE(self));
1473
1474 if (self->engine == nullptr) {
1475 return;
1476 }
1477
1478 if (self->embedder_api.UpdateAccessibilityFeatures(
1479 self->engine, static_cast<FlutterAccessibilityFeature>(flags)) !=
1480 kSuccess) {
1481 g_warning("Failed to update accessibility features");
1482 }
1483 }

Referenced by update_settings().