| Flutter Linux Embedder |

Classes | Functions | Variables
fl_engine.cc File Reference
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_engine.h"`
`#include <gmodule.h>`
`#include <cstring>`
`#include <string>`
`#include <vector>`
`#include "flutter/common/constants.h"`
`#include "flutter/shell/platform/common/app_lifecycle_state.h"`
`#include "flutter/shell/platform/common/engine_switches.h"`
`#include "flutter/shell/platform/embedder/embedder.h"`
`#include "flutter/shell/platform/linux/fl_binary_messenger_private.h"`
`#include "flutter/shell/platform/linux/fl_dart_project_private.h"`
`#include "flutter/shell/platform/linux/fl_engine_private.h"`
`#include "flutter/shell/platform/linux/fl_pixel_buffer_texture_private.h"`
`#include "flutter/shell/platform/linux/fl_plugin_registrar_private.h"`
`#include "flutter/shell/platform/linux/fl_renderer.h"`
`#include "flutter/shell/platform/linux/fl_renderer_headless.h"`
`#include "flutter/shell/platform/linux/fl_settings_plugin.h"`
`#include "flutter/shell/platform/linux/fl_texture_gl_private.h"`
`#include "flutter/shell/platform/linux/fl_texture_registrar_private.h"`
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_plugin_registry.h"`
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_string_codec.h"`

Go to the source code of this file.

## Classes
struct | _FlEngine

## Functions
static void | fl_engine_plugin_registry_iface_init (FlPluginRegistryInterface *iface)
| G_DEFINE_TYPE_WITH_CODE (FlEngine, fl_engine, G_TYPE_OBJECT, G_IMPLEMENT_INTERFACE(fl_plugin_registry_get_type(), fl_engine_plugin_registry_iface_init)) enum
static void | parse_locale (const gchar *locale, gchar **language, gchar **territory, gchar **codeset, gchar **modifier)
static void | set_app_lifecycle_state (FlEngine *self, const flutter::AppLifecycleState state)
static void | setup_locales (FlEngine *self)
static bool | compositor_create_backing_store_callback (const FlutterBackingStoreConfig *config, FlutterBackingStore *backing_store_out, void *user_data)
static bool | compositor_collect_backing_store_callback (const FlutterBackingStore *renderer, void *user_data)
static bool | compositor_present_layers_callback (const FlutterLayer **layers, size_t layers_count, void *user_data)
static void * | fl_engine_gl_proc_resolver (void *user_data, const char *name)
static bool | fl_engine_gl_make_current (void *user_data)
static bool | fl_engine_gl_clear_current (void *user_data)
static uint32_t | fl_engine_gl_get_fbo (void *user_data)
static bool | fl_engine_gl_present (void *user_data)
static bool | fl_engine_gl_make_resource_current (void *user_data)
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)
static bool | fl_engine_runs_task_on_current_thread (void *user_data)
static void | fl_engine_post_task (FlutterTask task, uint64_t target_time_nanos, void *user_data)
static void | fl_engine_platform_message_cb (const FlutterPlatformMessage *message, void *user_data)
static void | fl_engine_update_semantics_node_cb (const FlutterSemanticsNode *node, void *user_data)
static void | fl_engine_on_pre_engine_restart_cb (void *user_data)
static void | fl_engine_platform_message_response_cb (const uint8_t *data, size_t data_length, void *user_data)
static FlPluginRegistrar * | fl_engine_get_registrar_for_plugin (FlPluginRegistry *registry, const gchar *name)
static void | fl_engine_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
static void | fl_engine_dispose (GObject *object)
static void | fl_engine_class_init (FlEngineClass *klass)
static void | fl_engine_init (FlEngine *self)
FlEngine * | fl_engine_new (FlDartProject *project, FlRenderer *renderer)
G_MODULE_EXPORT FlEngine * | fl_engine_new_headless (FlDartProject *project)
gboolean | fl_engine_start (FlEngine *self, GError **error)
FlutterEngineProcTable * | fl_engine_get_embedder_api (FlEngine *self)
void | fl_engine_set_platform_message_handler (FlEngine *self, FlEnginePlatformMessageHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
void | fl_engine_set_update_semantics_node_handler (FlEngine *self, FlEngineUpdateSemanticsNodeHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
void | fl_engine_set_on_pre_engine_restart_handler (FlEngine *self, FlEngineOnPreEngineRestartHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
gboolean | fl_engine_send_platform_message_response (FlEngine *self, const FlutterPlatformMessageResponseHandle *handle, GBytes *response, GError **error)
void | fl_engine_send_platform_message (FlEngine *self, const gchar *channel, GBytes *message, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
GBytes * | fl_engine_send_platform_message_finish (FlEngine *self, GAsyncResult *result, GError **error)
void | fl_engine_send_window_state_event (FlEngine *self, gboolean visible, gboolean focused)
void | fl_engine_send_window_metrics_event (FlEngine *self, size_t width, size_t height, double pixel_ratio)
void | fl_engine_send_mouse_pointer_event (FlEngine *self, FlutterPointerPhase phase, size_t timestamp, double x, double y, double scroll_delta_x, double scroll_delta_y, int64_t buttons)
void | fl_engine_send_pointer_pan_zoom_event (FlEngine *self, 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 *self, const FlutterKeyEvent *event, FlutterKeyEventCallback callback, void *user_data)
void | fl_engine_dispatch_semantics_action (FlEngine *self, uint64_t id, FlutterSemanticsAction action, GBytes *data)
gboolean | fl_engine_mark_texture_frame_available (FlEngine *self, int64_t texture_id)
gboolean | fl_engine_register_external_texture (FlEngine *self, int64_t texture_id)
gboolean | fl_engine_unregister_external_texture (FlEngine *self, int64_t texture_id)
G_MODULE_EXPORT FlBinaryMessenger * | fl_engine_get_binary_messenger (FlEngine *self)
FlTaskRunner * | fl_engine_get_task_runner (FlEngine *self)
void | fl_engine_execute_task (FlEngine *self, FlutterTask *task)
G_MODULE_EXPORT FlTextureRegistrar * | fl_engine_get_texture_registrar (FlEngine *self)
void | fl_engine_update_accessibility_features (FlEngine *self, int32_t flags)
GPtrArray * | fl_engine_get_switches (FlEngine *self)

## Variables
static constexpr size_t | kPlatformTaskRunnerIdentifier = 1
static constexpr int32_t | kMousePointerDeviceId = 0
static constexpr int32_t | kPointerPanZoomDeviceId = 1
static constexpr const char * | kFlutterLifecycleChannel = "flutter/lifecycle"

## Function Documentation

## ◆ compositor_collect_backing_store_callback()

static bool compositor_collect_backing_store_callback | ( | const FlutterBackingStore * | renderer,
|  | void * | user_data
| ) |  |
| static

Definition at line 195 of file fl_engine.cc.

197 {
198 g_return_val_if_fail(FL_IS_RENDERER(user_data), false);
199 return fl_renderer_collect_backing_store(FL_RENDERER(user_data), renderer);
200 }

References fl_renderer_collect_backing_store(), and user_data.

Referenced by fl_engine_start().

## ◆ compositor_create_backing_store_callback()

static bool compositor_create_backing_store_callback | ( | const FlutterBackingStoreConfig * | config,
|  | FlutterBackingStore * | backing_store_out,
|  | void * | user_data
| ) |  |
| static

Definition at line 185 of file fl_engine.cc.

188 {
189 g_return_val_if_fail(FL_IS_RENDERER(user_data), false);
190 return fl_renderer_create_backing_store(FL_RENDERER(user_data), config,
191 backing_store_out);
192 }

References fl_renderer_create_backing_store(), and user_data.

Referenced by fl_engine_start().

## ◆ compositor_present_layers_callback()

static bool compositor_present_layers_callback | ( | const FlutterLayer ** | layers,
|  | size_t | layers_count,
|  | void * | user_data
| ) |  |
| static

Definition at line 203 of file fl_engine.cc.

205 {
206 g_return_val_if_fail(FL_IS_RENDERER(user_data), false);
207 return fl_renderer_present_layers(FL_RENDERER(user_data), layers,
208 layers_count);
209 }

References fl_renderer_present_layers(), and user_data.

Referenced by fl_engine_start().

## ◆ fl_engine_class_init()

static void fl_engine_class_init | ( | FlEngineClass * | klass | ) |
| static

Definition at line 445 of file fl_engine.cc.

445 {
446 G_OBJECT_CLASS(klass)->dispose = fl_engine_dispose;
447 G_OBJECT_CLASS(klass)->set_property = fl_engine_set_property;
448
449 g_object_class_install_property(
450 G_OBJECT_CLASS(klass), kPropBinaryMessenger,
451 g_param_spec_object(
452 "binary-messenger", "messenger", "Binary messenger",
453 fl_binary_messenger_get_type(),
454 static_cast<GParamFlags>(G_PARAM_WRITABLE | G_PARAM_CONSTRUCT_ONLY |
455 G_PARAM_STATIC_STRINGS)));
456 }

References fl_engine_dispose(), and fl_engine_set_property().

## ◆ fl_engine_dispatch_semantics_action()

void fl_engine_dispatch_semantics_action | ( | FlEngine * | engine,
|  | uint64_t | id,
|  | FlutterSemanticsAction | action,
|  | GBytes * | data
| ) |  |

fl_engine_dispatch_semantics_action: @engine: an #FlEngine. @id: the semantics action identifier. @action: the action being dispatched. @data: (allow-none): data associated with the action.

Definition at line 860 of file fl_engine.cc.

863 {
864 g_return_if_fail(FL_IS_ENGINE(self));
865
866 if (self->engine == nullptr) {
867 return;
868 }
869
870 const uint8_t* action_data = nullptr;
871 size_t action_data_length = 0;
872 if (data != nullptr) {
873 action_data = static_cast<const uint8_t*>(
874 g_bytes_get_data(data, &action_data_length));
875 }
876
877 self->embedder_api.DispatchSemanticsAction(self->engine, id, action,
878 action_data, action_data_length);
879 }

References self.

Referenced by fl_accessible_node_perform_action_impl(), and TEST().

## ◆ fl_engine_dispose()

static void fl_engine_dispose | ( | GObject * | object | ) |
| static

Definition at line 401 of file fl_engine.cc.

401 {
402 FlEngine* self = FL_ENGINE(object);
403
404 if (self->engine != nullptr) {
405 self->embedder_api.Shutdown(self->engine);
406 self->engine = nullptr;
407 }
408
409 if (self->aot_data != nullptr) {
410 self->embedder_api.CollectAOTData(self->aot_data);
411 self->aot_data = nullptr;
412 }
413
414 g_clear_object(&self->project);
415 g_clear_object(&self->renderer);
416 g_clear_object(&self->texture_registrar);
417 g_clear_object(&self->binary_messenger);
418 g_clear_object(&self->settings_plugin);
419 g_clear_object(&self->task_runner);
420
421 if (self->platform_message_handler_destroy_notify) {
422 self->platform_message_handler_destroy_notify(
423 self->platform_message_handler_data);
424 }
425 self->platform_message_handler_data = nullptr;
426 self->platform_message_handler_destroy_notify = nullptr;
427
428 if (self->update_semantics_node_handler_destroy_notify) {
429 self->update_semantics_node_handler_destroy_notify(
430 self->update_semantics_node_handler_data);
431 }
432 self->update_semantics_node_handler_data = nullptr;
433 self->update_semantics_node_handler_destroy_notify = nullptr;
434
435 if (self->on_pre_engine_restart_handler_destroy_notify) {
436 self->on_pre_engine_restart_handler_destroy_notify(
437 self->on_pre_engine_restart_handler_data);
438 }
439 self->on_pre_engine_restart_handler_data = nullptr;
440 self->on_pre_engine_restart_handler_destroy_notify = nullptr;
441
442 G_OBJECT_CLASS(fl_engine_parent_class)->dispose(object);
443 }

References self.

Referenced by fl_engine_class_init().

## ◆ 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 913 of file fl_engine.cc.

913 {
914 g_return_if_fail(FL_IS_ENGINE(self));
915 self->embedder_api.RunTask(self->engine, task);
916 }

References self.

Referenced by fl_task_runner_process_expired_tasks_locked().

## ◆ fl_engine_get_binary_messenger()

G_MODULE_EXPORT FlBinaryMessenger* fl_engine_get_binary_messenger | ( | FlEngine * | engine | ) |

fl_engine_get_binary_messenger: @engine: an #FlEngine.

Gets the messenger to communicate with this engine.

Returns: an #FlBinaryMessenger.

Definition at line 902 of file fl_engine.cc.

903 {
904 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
905 return self->binary_messenger;
906 }

Referenced by fl_settings_plugin_new(), fl_view_constructed(), fl_view_get_registrar_for_plugin(), fl_view_keyboard_delegate_iface_init(), init_keyboard(), and set_app_lifecycle_state().

## ◆ 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 591 of file fl_engine.cc.

591 {
592 return &(self->embedder_api);
593 }

Referenced by TEST().

## ◆ fl_engine_get_registrar_for_plugin()

static FlPluginRegistrar* fl_engine_get_registrar_for_plugin | ( | FlPluginRegistry * | registry,
|  | const gchar * | name
| ) |  |
| static

Definition at line 371 of file fl_engine.cc.

373 {
374 FlEngine* self = FL_ENGINE(registry);
375
376 return fl_plugin_registrar_new(nullptr, self->binary_messenger,
377 self->texture_registrar);
378 }

References fl_plugin_registrar_new(), and self.

Referenced by fl_engine_plugin_registry_iface_init().

## ◆ fl_engine_get_switches()

GPtrArray* fl_engine_get_switches | ( | FlEngine * | engine | ) |

fl_engine_get_switches: @project: an #FlEngine.

Determines the switches that should be passed to the Flutter engine.

Returns: an array of switches to pass to the Flutter engine.

Definition at line 935 of file fl_engine.cc.

935 {
936 GPtrArray* switches = g_ptr_array_new_with_free_func(g_free);
937 for (const auto& env_switch : flutter::GetSwitchesFromEnvironment()) {
938 g_ptr_array_add(switches, g_strdup(env_switch.c_str()));
939 }
940 return switches;
941 }

References flutter::GetSwitchesFromEnvironment().

Referenced by fl_engine_start(), and TEST().

## ◆ 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 908 of file fl_engine.cc.

908 {
909 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
910 return self->task_runner;
911 }

Referenced by fl_renderer_unblock_main_thread(), and fl_renderer_wait_for_frame().

## ◆ fl_engine_get_texture_registrar()

G_MODULE_EXPORT FlTextureRegistrar* fl_engine_get_texture_registrar | ( | FlEngine * | engine | ) |

fl_engine_get_texture_registrar: @engine: an #FlEngine.

Gets the texture registrar for registering textures.

Returns: an #FlTextureRegistrar.

Definition at line 918 of file fl_engine.cc.

919 {
920 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
921 return self->texture_registrar;
922 }

Referenced by fl_view_get_registrar_for_plugin().

## ◆ fl_engine_gl_clear_current()

static bool fl_engine_gl_clear_current | ( | void * | user_data | ) |
| static

Definition at line 228 of file fl_engine.cc.

228 {
229 FlEngine* self = static_cast<FlEngine*>(user_data);
230 g_autoptr(GError) error = nullptr;
231 gboolean result = fl_renderer_clear_current(self->renderer, &error);
232 if (!result) {
233 g_warning("%s", error->message);
234 }
235 return result;
236 }

References error, fl_renderer_clear_current(), result, self, and user_data.

Referenced by fl_engine_start().

## ◆ 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
| ) |  |
| static

Definition at line 260 of file fl_engine.cc.

265 {
266 FlEngine* self = static_cast<FlEngine*>(user_data);
267 if (!self->texture_registrar) {
268 return false;
269 }
270
271 FlTexture* texture =
272 fl_texture_registrar_lookup_texture(self->texture_registrar, texture_id);
273 if (texture == nullptr) {
274 g_warning("Unable to find texture %" G_GINT64_FORMAT, texture_id);
275 return false;
276 }
277
278 gboolean result;
279 g_autoptr(GError) error = nullptr;
280 if (FL_IS_TEXTURE_GL(texture)) {
281 result = fl_texture_gl_populate(FL_TEXTURE_GL(texture), width, height,
282 opengl_texture, &error);
283 } else if (FL_IS_PIXEL_BUFFER_TEXTURE(texture)) {
284 result =
285 fl_pixel_buffer_texture_populate(FL_PIXEL_BUFFER_TEXTURE(texture),
286 width, height, opengl_texture, &error);
287 } else {
288 g_warning("Unsupported texture type %" G_GINT64_FORMAT, texture_id);
289 return false;
290 }
291
292 if (!result) {
293 g_warning("%s", error->message);
294 return false;
295 }
296
297 return true;
298 }

References error, fl_pixel_buffer_texture_populate(), fl_texture_gl_populate(), fl_texture_registrar_lookup_texture(), height, result, self, texture_id, user_data, and width.

Referenced by fl_engine_start().

## ◆ fl_engine_gl_get_fbo()

static uint32_t fl_engine_gl_get_fbo | ( | void * | user_data | ) |
| static

Definition at line 238 of file fl_engine.cc.

238 {
239 FlEngine* self = static_cast<FlEngine*>(user_data);
240 return fl_renderer_get_fbo(self->renderer);
241 }

References fl_renderer_get_fbo(), self, and user_data.

Referenced by fl_engine_start().

## ◆ fl_engine_gl_make_current()

static bool fl_engine_gl_make_current | ( | void * | user_data | ) |
| static

Definition at line 218 of file fl_engine.cc.

218 {
219 FlEngine* self = static_cast<FlEngine*>(user_data);
220 g_autoptr(GError) error = nullptr;
221 gboolean result = fl_renderer_make_current(self->renderer, &error);
222 if (!result) {
223 g_warning("%s", error->message);
224 }
225 return result;
226 }

References error, fl_renderer_make_current(), result, self, and user_data.

Referenced by fl_engine_start().

## ◆ fl_engine_gl_make_resource_current()

static bool fl_engine_gl_make_resource_current | ( | void * | user_data | ) |
| static

Definition at line 249 of file fl_engine.cc.

249 {
250 FlEngine* self = static_cast<FlEngine*>(user_data);
251 g_autoptr(GError) error = nullptr;
252 gboolean result = fl_renderer_make_resource_current(self->renderer, &error);
253 if (!result) {
254 g_warning("%s", error->message);
255 }
256 return result;
257 }

References error, fl_renderer_make_resource_current(), result, self, and user_data.

Referenced by fl_engine_start().

## ◆ fl_engine_gl_present()

static bool fl_engine_gl_present | ( | void * | user_data | ) |
| static

Definition at line 243 of file fl_engine.cc.

243 {
244 // No action required, as this is handled in
245 // compositor_present_layers_callback.
246 return true;
247 }

Referenced by fl_engine_start().

## ◆ fl_engine_gl_proc_resolver()

static void* fl_engine_gl_proc_resolver | ( | void * | user_data,
|  | const char * | name
| ) |  |
| static

Definition at line 213 of file fl_engine.cc.

213 {
214 FlEngine* self = static_cast<FlEngine*>(user_data);
215 return fl_renderer_get_proc_address(self->renderer, name);
216 }

References fl_renderer_get_proc_address(), self, and user_data.

Referenced by fl_engine_start().

## ◆ fl_engine_init()

static void fl_engine_init | ( | FlEngine * | self | ) |
| static

Definition at line 458 of file fl_engine.cc.

458 {
459 self->thread = g_thread_self();
460
461 self->embedder_api.struct_size = sizeof(FlutterEngineProcTable);
462 FlutterEngineGetProcAddresses(&self->embedder_api);
463
464 self->texture_registrar = fl_texture_registrar_new(self);
465 }

References fl_texture_registrar_new(), and self.

## ◆ 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 881 of file fl_engine.cc.

882 {
883 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
884 return self->embedder_api.MarkExternalTextureFrameAvailable(
885 self->engine, texture_id) == kSuccess;
886 }

References self, and texture_id.

Referenced by mark_texture_frame_available().

## ◆ fl_engine_new()

FlEngine* fl_engine_new | ( | FlDartProject * | project,
|  | FlRenderer * | renderer
| ) |  |

fl_engine_new: @project: an #FlDartProject. @renderer: an #FlRenderer.

Creates new Flutter engine.

Returns: a new #FlEngine.

Definition at line 467 of file fl_engine.cc.

467 {
468 g_return_val_if_fail(FL_IS_DART_PROJECT(project), nullptr);
469 g_return_val_if_fail(FL_IS_RENDERER(renderer), nullptr);
470
471 FlEngine* self = FL_ENGINE(g_object_new(fl_engine_get_type(), nullptr));
472 self->project = FL_DART_PROJECT(g_object_ref(project));
473 self->renderer = FL_RENDERER(g_object_ref(renderer));
474 self->binary_messenger = fl_binary_messenger_new(self);
475 return self;
476 }

References fl_binary_messenger_new().

Referenced by fl_engine_new_headless(), fl_view_constructed(), and make_mock_engine().

## ◆ fl_engine_new_headless()

G_MODULE_EXPORT FlEngine* fl_engine_new_headless | ( | FlDartProject * | project | ) |

FlEngine:

#FlEngine is an object that contains a running Flutter engine. fl_engine_new_headless: @project: an #FlDartProject.

Creates new Flutter engine running in headless mode.

Returns: a new #FlEngine.

Definition at line 478 of file fl_engine.cc.

478 {
479 g_autoptr(FlRendererHeadless) renderer = fl_renderer_headless_new();
480 return fl_engine_new(project, FL_RENDERER(renderer));
481 }

References fl_engine_new(), and fl_renderer_headless_new().

## ◆ fl_engine_on_pre_engine_restart_cb()

static void fl_engine_on_pre_engine_restart_cb | ( | void * | user_data | ) |
| static

Definition at line 351 of file fl_engine.cc.

351 {
352 FlEngine* self = FL_ENGINE(user_data);
353
354 if (self->on_pre_engine_restart_handler != nullptr) {
355 self->on_pre_engine_restart_handler(
356 self, self->on_pre_engine_restart_handler_data);
357 }
358 }

References self, and user_data.

Referenced by fl_engine_start().

## ◆ fl_engine_platform_message_cb()

static void fl_engine_platform_message_cb | ( | const FlutterPlatformMessage * | message,
|  | void * | user_data
| ) |  |
| static

Definition at line 316 of file fl_engine.cc.

317 {
318 FlEngine* self = FL_ENGINE(user_data);
319
320 gboolean handled = FALSE;
321 if (self->platform_message_handler != nullptr) {
322 g_autoptr(GBytes) data =
323 g_bytes_new(message->message, message->message_size);
324 handled = self->platform_message_handler(
325 self, message->channel, data, message->response_handle,
326 self->platform_message_handler_data);
327 }
328
329 if (!handled) {
330 fl_engine_send_platform_message_response(self, message->response_handle,
331 nullptr, nullptr);
332 }
333 }

References fl_engine_send_platform_message_response(), self, and user_data.

Referenced by fl_engine_start().

## ◆ 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
| ) |  |
| static

Definition at line 362 of file fl_engine.cc.

364 {
365 g_autoptr(GTask) task = G_TASK(user_data);
366 g_task_return_pointer(task, g_bytes_new(data, data_length),
367 reinterpret_cast<GDestroyNotify>(g_bytes_unref));
368 }

References user_data.

Referenced by fl_engine_send_platform_message().

## ◆ fl_engine_plugin_registry_iface_init()

static void fl_engine_plugin_registry_iface_init | ( | FlPluginRegistryInterface * | iface | ) |
| static

Definition at line 380 of file fl_engine.cc.

381 {
382 iface->get_registrar_for_plugin = fl_engine_get_registrar_for_plugin;
383 }

References fl_engine_get_registrar_for_plugin().

## ◆ fl_engine_post_task()

static void fl_engine_post_task | ( | FlutterTask | task,
|  | uint64_t | target_time_nanos,
|  | void * | user_data
| ) |  |
| static

Definition at line 307 of file fl_engine.cc.

309 {
310 FlEngine* self = static_cast<FlEngine*>(user_data);
311
312 fl_task_runner_post_task(self->task_runner, task, target_time_nanos);
313 }

References fl_task_runner_post_task(), self, and user_data.

Referenced by fl_engine_start().

## ◆ 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 888 of file fl_engine.cc.

889 {
890 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
891 return self->embedder_api.RegisterExternalTexture(self->engine, texture_id) ==
892 kSuccess;
893 }

References self, and texture_id.

Referenced by register_texture().

## ◆ fl_engine_runs_task_on_current_thread()

static bool fl_engine_runs_task_on_current_thread | ( | void * | user_data | ) |
| static

Definition at line 301 of file fl_engine.cc.

301 {
302 FlEngine* self = static_cast<FlEngine*>(user_data);
303 return self->thread == g_thread_self();
304 }

References user_data.

Referenced by fl_engine_start().

## ◆ fl_engine_send_key_event()

void fl_engine_send_key_event | ( | FlEngine * | engine,
|  | const FlutterKeyEvent * | event,
|  | FlutterKeyEventCallback | callback,
|  | void * | user_data
| ) |  |

fl_engine_send_key_event:

Definition at line 847 of file fl_engine.cc.

850 {
851 g_return_if_fail(FL_IS_ENGINE(self));
852
853 if (self->engine == nullptr) {
854 return;
855 }
856
857 self->embedder_api.SendKeyEvent(self->engine, event, callback, user_data);
858 }

References callback, event, self, and user_data.

Referenced by fl_view_keyboard_delegate_iface_init().

## ◆ fl_engine_send_mouse_pointer_event()

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

fl_engine_send_mouse_pointer_event: @engine: an #FlEngine. @phase: mouse phase. @timestamp: time when event occurred in microseconds. @x: x location of mouse cursor. @y: y location of mouse cursor. @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 778 of file fl_engine.cc.

785 {
786 g_return_if_fail(FL_IS_ENGINE(self));
787
788 if (self->engine == nullptr) {
789 return;
790 }
791
792 FlutterPointerEvent fl_event = {};
793 fl_event.struct_size = sizeof(fl_event);
794 fl_event.phase = phase;
795 fl_event.timestamp = timestamp;
796 fl_event.x = x;
797 fl_event.y = y;
798 if (scroll_delta_x != 0 || scroll_delta_y != 0) {
799 fl_event.signal_kind = kFlutterPointerSignalKindScroll;
800 }
801 fl_event.scroll_delta_x = scroll_delta_x;
802 fl_event.scroll_delta_y = scroll_delta_y;
803 fl_event.device_kind = kFlutterPointerDeviceKindMouse;
804 fl_event.buttons = buttons;
805 fl_event.device = kMousePointerDeviceId;
806 // TODO(dkwingsmt): Assign the correct view ID once the Linux embedder
807 // supports multiple views.
808 // https://github.com/flutter/flutter/issues/138178
809 fl_event.view_id = flutter::kFlutterImplicitViewId;
810 self->embedder_api.SendPointerEvent(self->engine, &fl_event, 1);
811 }

References kMousePointerDeviceId, and self.

Referenced by check_pointer_inside(), fl_view_scrolling_delegate_iface_init(), leave_notify_event_cb(), motion_notify_event_cb(), send_pointer_button_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 680 of file fl_engine.cc.

685 {
686 g_return_if_fail(FL_IS_ENGINE(self));
687
688 GTask* task = nullptr;
689 FlutterPlatformMessageResponseHandle* response_handle = nullptr;
690 if (callback != nullptr) {
691 task = g_task_new(self, cancellable, callback, user_data);
692
693 if (self->engine == nullptr) {
694 g_task_return_new_error(task, fl_engine_error_quark(),
695 FL_ENGINE_ERROR_FAILED, "No engine to send to");
696 return;
697 }
698
699 FlutterEngineResult result =
700 self->embedder_api.PlatformMessageCreateResponseHandle(
701 self->engine, fl_engine_platform_message_response_cb, task,
702 &response_handle);
703 if (result != kSuccess) {
704 g_task_return_new_error(task, fl_engine_error_quark(),
705 FL_ENGINE_ERROR_FAILED,
706 "Failed to create response handle");
707 g_object_unref(task);
708 return;
709 }
710 } else if (self->engine == nullptr) {
711 return;
712 }
713
714 FlutterPlatformMessage fl_message = {};
715 fl_message.struct_size = sizeof(fl_message);
716 fl_message.channel = channel;
717 fl_message.message =
718 message != nullptr
719 ? static_cast<const uint8_t*>(g_bytes_get_data(message, nullptr))
720 : nullptr;
721 fl_message.message_size = message != nullptr ? g_bytes_get_size(message) : 0;
722 fl_message.response_handle = response_handle;
723 FlutterEngineResult result =
724 self->embedder_api.SendPlatformMessage(self->engine, &fl_message);
725
726 if (result != kSuccess && task != nullptr) {
727 g_task_return_new_error(task, fl_engine_error_quark(),
728 FL_ENGINE_ERROR_FAILED,
729 "Failed to send platform messages");
730 g_object_unref(task);
731 }
732
733 if (response_handle != nullptr) {
734 self->embedder_api.PlatformMessageReleaseResponseHandle(self->engine,
735 response_handle);
736 }
737 }

References callback, FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), fl_engine_platform_message_response_cb(), result, self, 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 739 of file fl_engine.cc.

741 {
742 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
743 g_return_val_if_fail(g_task_is_valid(result, self), FALSE);
744
745 return static_cast<GBytes*>(g_task_propagate_pointer(G_TASK(result), error));
746 }

References error, and result.

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 648 of file fl_engine.cc.

652 {
653 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
654 g_return_val_if_fail(handle != nullptr, FALSE);
655
656 if (self->engine == nullptr) {
657 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
658 "No engine to send response to");
659 return FALSE;
660 }
661
662 gsize data_length = 0;
663 const uint8_t* data = nullptr;
664 if (response != nullptr) {
665 data =
666 static_cast<const uint8_t*>(g_bytes_get_data(response, &data_length));
667 }
668 FlutterEngineResult result = self->embedder_api.SendPlatformMessageResponse(
669 self->engine, handle, data, data_length);
670
671 if (result != kSuccess) {
672 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
673 "Failed to send platform message response");
674 return FALSE;
675 }
676
677 return TRUE;
678 }

References error, FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), result, self, 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 * | self,
|  | size_t | timestamp,
|  | double | x,
|  | double | y,
|  | FlutterPointerPhase | phase,
|  | double | pan_x,
|  | double | pan_y,
|  | double | scale,
|  | double | rotation
| ) |  |

Definition at line 813 of file fl_engine.cc.

821 {
822 g_return_if_fail(FL_IS_ENGINE(self));
823
824 if (self->engine == nullptr) {
825 return;
826 }
827
828 FlutterPointerEvent fl_event = {};
829 fl_event.struct_size = sizeof(fl_event);
830 fl_event.timestamp = timestamp;
831 fl_event.x = x;
832 fl_event.y = y;
833 fl_event.phase = phase;
834 fl_event.pan_x = pan_x;
835 fl_event.pan_y = pan_y;
836 fl_event.scale = scale;
837 fl_event.rotation = rotation;
838 fl_event.device = kPointerPanZoomDeviceId;
839 fl_event.device_kind = kFlutterPointerDeviceKindTrackpad;
840 // TODO(dkwingsmt): Assign the correct view ID once the Linux embedder
841 // supports multiple views.
842 // https://github.com/flutter/flutter/issues/138178
843 fl_event.view_id = flutter::kFlutterImplicitViewId;
844 self->embedder_api.SendPointerEvent(self->engine, &fl_event, 1);
845 }

References kPointerPanZoomDeviceId, and self.

Referenced by fl_view_scrolling_delegate_iface_init(), and TEST().

## ◆ fl_engine_send_window_metrics_event()

void fl_engine_send_window_metrics_event | ( | FlEngine * | engine,
|  | size_t | width,
|  | size_t | height,
|  | double | pixel_ratio
| ) |  |

fl_engine_send_window_metrics_event: @engine: an #FlEngine. @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 760 of file fl_engine.cc.

763 {
764 g_return_if_fail(FL_IS_ENGINE(self));
765
766 if (self->engine == nullptr) {
767 return;
768 }
769
770 FlutterWindowMetricsEvent event = {};
771 event.struct_size = sizeof(FlutterWindowMetricsEvent);
772 event.width = width;
773 event.height = height;
774 event.pixel_ratio = pixel_ratio;
775 self->embedder_api.SendWindowMetricsEvent(self->engine, &event);
776 }

References event, height, self, and width.

Referenced by handle_geometry_changed(), and TEST().

## ◆ fl_engine_send_window_state_event()

void fl_engine_send_window_state_event | ( | FlEngine * | engine,
|  | gboolean | visible,
|  | gboolean | focused
| ) |  |

fl_engine_send_window_state_event: @engine: an #FlEngine. @visible: whether the window is currently visible or not. @focused: whether the window is currently focused or not.

Sends a window state event to the engine.

Definition at line 748 of file fl_engine.cc.

750 {
751 if (visible && focused) {
752 set_app_lifecycle_state(self, flutter::AppLifecycleState::kResumed);
753 } else if (visible) {
754 set_app_lifecycle_state(self, flutter::AppLifecycleState::kInactive);
755 } else {
756 set_app_lifecycle_state(self, flutter::AppLifecycleState::kHidden);
757 }
758 }

References flutter::kHidden, flutter::kInactive, flutter::kResumed, and set_app_lifecycle_state().

Referenced by TEST(), and window_state_event_cb().

## ◆ fl_engine_set_on_pre_engine_restart_handler()

void fl_engine_set_on_pre_engine_restart_handler | ( | FlEngine * | engine,
|  | FlEngineOnPreEngineRestartHandler | handler,
|  | gpointer | user_data,
|  | GDestroyNotify | destroy_notify
| ) |  |

fl_engine_set_on_pre_engine_restart_handler: @engine: an #FlEngine. @handler: function to call when the engine is restarted. @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 right before the engine is restarted.

Definition at line 630 of file fl_engine.cc.

634 {
635 g_return_if_fail(FL_IS_ENGINE(self));
636
637 if (self->on_pre_engine_restart_handler_destroy_notify) {
638 self->on_pre_engine_restart_handler_destroy_notify(
639 self->on_pre_engine_restart_handler_data);
640 }
641
642 self->on_pre_engine_restart_handler = handler;
643 self->on_pre_engine_restart_handler_data = user_data;
644 self->on_pre_engine_restart_handler_destroy_notify = destroy_notify;
645 }

References self, and user_data.

Referenced by fl_view_constructed(), fl_view_dispose(), 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 595 of file fl_engine.cc.

599 {
600 g_return_if_fail(FL_IS_ENGINE(self));
601 g_return_if_fail(handler != nullptr);
602
603 if (self->platform_message_handler_destroy_notify) {
604 self->platform_message_handler_destroy_notify(
605 self->platform_message_handler_data);
606 }
607
608 self->platform_message_handler = handler;
609 self->platform_message_handler_data = user_data;
610 self->platform_message_handler_destroy_notify = destroy_notify;
611 }

References self, and user_data.

Referenced by fl_binary_messenger_new().

## ◆ fl_engine_set_property()

static void fl_engine_set_property | ( | GObject * | object,
|  | guint | prop_id,
|  | const GValue * | value,
|  | GParamSpec * | pspec
| ) |  |
| static

Definition at line 385 of file fl_engine.cc.

388 {
389 FlEngine* self = FL_ENGINE(object);
390 switch (prop_id) {
391 case kPropBinaryMessenger:
392 g_set_object(&self->binary_messenger,
393 FL_BINARY_MESSENGER(g_value_get_object(value)));
394 break;
395 default:
396 G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec);
397 break;
398 }
399 }

References self, and value.

Referenced by fl_engine_class_init().

## ◆ fl_engine_set_update_semantics_node_handler()

void fl_engine_set_update_semantics_node_handler | ( | FlEngine * | engine,
|  | FlEngineUpdateSemanticsNodeHandler | handler,
|  | gpointer | user_data,
|  | GDestroyNotify | destroy_notify
| ) |  |

fl_engine_set_update_semantics_node_handler: @engine: an #FlEngine. @handler: function to call when a semantics node update 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 semantics node update is reveived.

Definition at line 613 of file fl_engine.cc.

617 {
618 g_return_if_fail(FL_IS_ENGINE(self));
619
620 if (self->update_semantics_node_handler_destroy_notify) {
621 self->update_semantics_node_handler_destroy_notify(
622 self->update_semantics_node_handler_data);
623 }
624
625 self->update_semantics_node_handler = handler;
626 self->update_semantics_node_handler_data = user_data;
627 self->update_semantics_node_handler_destroy_notify = destroy_notify;
628 }

References self, and user_data.

Referenced by fl_view_constructed(), and fl_view_dispose().

## ◆ 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 483 of file fl_engine.cc.

483 {
484 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
485
486 self->task_runner = fl_task_runner_new(self);
487
488 FlutterRendererConfig config = {};
489 config.type = kOpenGL;
490 config.open_gl.struct_size = sizeof(FlutterOpenGLRendererConfig);
491 config.open_gl.gl_proc_resolver = fl_engine_gl_proc_resolver;
492 config.open_gl.make_current = fl_engine_gl_make_current;
493 config.open_gl.clear_current = fl_engine_gl_clear_current;
494 config.open_gl.fbo_callback = fl_engine_gl_get_fbo;
495 config.open_gl.present = fl_engine_gl_present;
496 config.open_gl.make_resource_current = fl_engine_gl_make_resource_current;
497 config.open_gl.gl_external_texture_frame_callback =
498 fl_engine_gl_external_texture_frame_callback;
499
500 FlutterTaskRunnerDescription platform_task_runner = {};
501 platform_task_runner.struct_size = sizeof(FlutterTaskRunnerDescription);
502 platform_task_runner.user_data = self;
503 platform_task_runner.runs_task_on_current_thread_callback =
504 fl_engine_runs_task_on_current_thread;
505 platform_task_runner.post_task_callback = fl_engine_post_task;
506 platform_task_runner.identifier = kPlatformTaskRunnerIdentifier;
507
508 FlutterCustomTaskRunners custom_task_runners = {};
509 custom_task_runners.struct_size = sizeof(FlutterCustomTaskRunners);
510 custom_task_runners.platform_task_runner = &platform_task_runner;
511 custom_task_runners.render_task_runner = &platform_task_runner;
512
513 g_autoptr(GPtrArray) command_line_args = fl_engine_get_switches(self);
514 // FlutterProjectArgs expects a full argv, so when processing it for flags
515 // the first item is treated as the executable and ignored. Add a dummy value
516 // so that all switches are used.
517 g_ptr_array_insert(command_line_args, 0, g_strdup("flutter"));
518
519 gchar** dart_entrypoint_args =
520 fl_dart_project_get_dart_entrypoint_arguments(self->project);
521
522 FlutterProjectArgs args = {};
523 args.struct_size = sizeof(FlutterProjectArgs);
524 args.assets_path = fl_dart_project_get_assets_path(self->project);
525 args.icu_data_path = fl_dart_project_get_icu_data_path(self->project);
526 args.command_line_argc = command_line_args->len;
527 args.command_line_argv =
528 reinterpret_cast<const char* const*>(command_line_args->pdata);
529 args.platform_message_callback = fl_engine_platform_message_cb;
530 args.update_semantics_node_callback = fl_engine_update_semantics_node_cb;
531 args.custom_task_runners = &custom_task_runners;
532 args.shutdown_dart_vm_when_done = true;
533 args.on_pre_engine_restart_callback = fl_engine_on_pre_engine_restart_cb;
534 args.dart_entrypoint_argc =
535 dart_entrypoint_args != nullptr ? g_strv_length(dart_entrypoint_args) : 0;
536 args.dart_entrypoint_argv =
537 reinterpret_cast<const char* const*>(dart_entrypoint_args);
538
539 FlutterCompositor compositor = {};
540 compositor.struct_size = sizeof(FlutterCompositor);
541 compositor.user_data = self->renderer;
542 compositor.create_backing_store_callback =
543 compositor_create_backing_store_callback;
544 compositor.collect_backing_store_callback =
545 compositor_collect_backing_store_callback;
546 compositor.present_layers_callback = compositor_present_layers_callback;
547 args.compositor = &compositor;
548
549 if (self->embedder_api.RunsAOTCompiledDartCode()) {
550 FlutterEngineAOTDataSource source = {};
551 source.type = kFlutterEngineAOTDataSourceTypeElfPath;
552 source.elf_path = fl_dart_project_get_aot_library_path(self->project);
553 if (self->embedder_api.CreateAOTData(&source, &self->aot_data) !=
554 kSuccess) {
555 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
556 "Failed to create AOT data");
557 return FALSE;
558 }
559 args.aot_data = self->aot_data;
560 }
561
562 FlutterEngineResult result = self->embedder_api.Initialize(
563 FLUTTER_ENGINE_VERSION, &config, &args, self, &self->engine);
564 if (result != kSuccess) {
565 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
566 "Failed to initialize Flutter engine");
567 return FALSE;
568 }
569
570 result = self->embedder_api.RunInitialized(self->engine);
571 if (result != kSuccess) {
572 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
573 "Failed to run Flutter engine");
574 return FALSE;
575 }
576
577 setup_locales(self);
578
579 g_autoptr(FlSettings) settings = fl_settings_new();
580 self->settings_plugin = fl_settings_plugin_new(self);
581 fl_settings_plugin_start(self->settings_plugin, settings);
582
583 result = self->embedder_api.UpdateSemanticsEnabled(self->engine, TRUE);
584 if (result != kSuccess) {
585 g_warning("Failed to enable accessibility features on Flutter engine");
586 }
587
588 return TRUE;
589 }

References args, compositor_collect_backing_store_callback(), compositor_create_backing_store_callback(), compositor_present_layers_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_ENGINE_ERROR_FAILED, fl_engine_error_quark(), fl_engine_get_switches(), 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_present(), 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_node_cb(), fl_settings_new(), fl_settings_plugin_new(), fl_settings_plugin_start(), fl_task_runner_new(), kPlatformTaskRunnerIdentifier, result, self, setup_locales(), and TRUE.

Referenced by make_mock_engine(), 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 895 of file fl_engine.cc.

896 {
897 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
898 return self->embedder_api.UnregisterExternalTexture(self->engine,
899 texture_id) == kSuccess;
900 }

References self, and 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 924 of file fl_engine.cc.

924 {
925 g_return_if_fail(FL_IS_ENGINE(self));
926
927 if (self->engine == nullptr) {
928 return;
929 }
930
931 self->embedder_api.UpdateAccessibilityFeatures(
932 self->engine, static_cast<FlutterAccessibilityFeature>(flags));
933 }

References flags, and self.

Referenced by update_settings().

## ◆ fl_engine_update_semantics_node_cb()

static void fl_engine_update_semantics_node_cb | ( | const FlutterSemanticsNode * | node,
|  | void * | user_data
| ) |  |
| static

Definition at line 336 of file fl_engine.cc.

337 {
338 FlEngine* self = FL_ENGINE(user_data);
339
340 if (self->update_semantics_node_handler != nullptr) {
341 self->update_semantics_node_handler(
342 self, node, self->update_semantics_node_handler_data);
343 }
344 }

References node, self, and user_data.

Referenced by fl_engine_start().

## ◆ G_DEFINE_TYPE_WITH_CODE()

G_DEFINE_TYPE_WITH_CODE | ( | FlEngine | ,
|  | fl_engine | ,
|  | G_TYPE_OBJECT | ,
|  | G_IMPLEMENT_INTERFACE(fl_plugin_registry_get_type(), fl_engine_plugin_registry_iface_init) |
| ) |  |

Definition at line 77 of file fl_engine.cc.

84 { kProp0, kPropBinaryMessenger, kPropLast };

References kProp0, and kPropLast.

## ◆ parse_locale()

static void parse_locale | ( | const gchar * | locale,
|  | gchar ** | language,
|  | gchar ** | territory,
|  | gchar ** | codeset,
|  | gchar ** | modifier
| ) |  |
| static

Definition at line 87 of file fl_engine.cc.

91 {
92 gchar* l = g_strdup(locale);
93
94 // Locales are in the form "language[_territory][.codeset][@modifier]"
95 gchar* match = strrchr(l, '@');
96 if (match != nullptr) {
97 if (modifier != nullptr) {
98 *modifier = g_strdup(match + 1);
99 }
100 *match = '\0';
101 } else if (modifier != nullptr) {
102 *modifier = nullptr;
103 }
104
105 match = strrchr(l, '.');
106 if (match != nullptr) {
107 if (codeset != nullptr) {
108 *codeset = g_strdup(match + 1);
109 }
110 *match = '\0';
111 } else if (codeset != nullptr) {
112 *codeset = nullptr;
113 }
114
115 match = strrchr(l, '_');
116 if (match != nullptr) {
117 if (territory != nullptr) {
118 *territory = g_strdup(match + 1);
119 }
120 *match = '\0';
121 } else if (territory != nullptr) {
122 *territory = nullptr;
123 }
124
125 if (language != nullptr) {
126 *language = l;
127 }
128 }

Referenced by setup_locales().

## ◆ set_app_lifecycle_state()

static void set_app_lifecycle_state | ( | FlEngine * | self,
|  | const flutter::AppLifecycleState | state
| ) |  |
| static

Definition at line 130 of file fl_engine.cc.

131 {
132 FlBinaryMessenger* binary_messenger = fl_engine_get_binary_messenger(self);
133
134 g_autoptr(FlValue) value =
135 fl_value_new_string(flutter::AppLifecycleStateToString(state));
136 g_autoptr(FlStringCodec) codec = fl_string_codec_new();
137 g_autoptr(GBytes) message =
138 fl_message_codec_encode_message(FL_MESSAGE_CODEC(codec), value, nullptr);
139
140 if (message == nullptr) {
141 return;
142 }
143
144 fl_binary_messenger_send_on_channel(binary_messenger,
145 kFlutterLifecycleChannel, message,
146 nullptr, nullptr, nullptr);
147 }

References flutter::AppLifecycleStateToString(), fl_binary_messenger_send_on_channel(), fl_engine_get_binary_messenger(), fl_message_codec_encode_message(), fl_string_codec_new(), fl_value_new_string(), kFlutterLifecycleChannel, state, and value.

Referenced by fl_engine_send_window_state_event().

## ◆ setup_locales()

static void setup_locales | ( | FlEngine * | self | ) |
| static

Definition at line 150 of file fl_engine.cc.

150 {
151 const gchar* const* languages = g_get_language_names();
152 g_autoptr(GPtrArray) locales_array = g_ptr_array_new_with_free_func(g_free);
153 // Helper array to take ownership of the strings passed to Flutter.
154 g_autoptr(GPtrArray) locale_strings = g_ptr_array_new_with_free_func(g_free);
155 for (int i = 0; languages[i] != nullptr; i++) {
156 gchar *language, *territory;
157 parse_locale(languages[i], &language, &territory, nullptr, nullptr);
158 if (language != nullptr) {
159 g_ptr_array_add(locale_strings, language);
160 }
161 if (territory != nullptr) {
162 g_ptr_array_add(locale_strings, territory);
163 }
164
165 FlutterLocale* locale =
166 static_cast<FlutterLocale*>(g_malloc0(sizeof(FlutterLocale)));
167 g_ptr_array_add(locales_array, locale);
168 locale->struct_size = sizeof(FlutterLocale);
169 locale->language_code = language;
170 locale->country_code = territory;
171 locale->script_code = nullptr;
172 locale->variant_code = nullptr;
173 }
174 FlutterLocale** locales =
175 reinterpret_cast<FlutterLocale**>(locales_array->pdata);
176 FlutterEngineResult result = self->embedder_api.UpdateLocales(
177 self->engine, const_cast<const FlutterLocale**>(locales),
178 locales_array->len);
179 if (result != kSuccess) {
180 g_warning("Failed to set up Flutter locales");
181 }
182 }

References parse_locale(), result, and self.

Referenced by fl_engine_start().

## Variable Documentation

## ◆ kFlutterLifecycleChannel

constexpr const char* kFlutterLifecycleChannel = "flutter/lifecycle"
| staticconstexpr

Definition at line 38 of file fl_engine.cc.

Referenced by set_app_lifecycle_state().

## ◆ kMousePointerDeviceId

constexpr int32_t kMousePointerDeviceId = 0
| staticconstexpr

Definition at line 35 of file fl_engine.cc.

Referenced by fl_engine_send_mouse_pointer_event().

## ◆ kPlatformTaskRunnerIdentifier

constexpr size_t kPlatformTaskRunnerIdentifier = 1
| staticconstexpr

Definition at line 31 of file fl_engine.cc.

Referenced by fl_engine_start().

## ◆ kPointerPanZoomDeviceId

constexpr int32_t kPointerPanZoomDeviceId = 1
| staticconstexpr

Definition at line 36 of file fl_engine.cc.

Referenced by fl_engine_send_pointer_pan_zoom_event().

fl_dart_project_get_aot_library_path
const G_MODULE_EXPORT gchar * fl_dart_project_get_aot_library_path(FlDartProject *self)
Definition: fl_dart_project.cc:72
event
FlKeyEvent * event
Definition: fl_key_channel_responder.cc:118
flutter::AppLifecycleState::kHidden
@ kHidden
fl_engine_update_semantics_node_cb
static void fl_engine_update_semantics_node_cb(const FlutterSemanticsNode *node, void *user_data)
Definition: fl_engine.cc:336
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:362
fl_engine_gl_get_fbo
static uint32_t fl_engine_gl_get_fbo(void *user_data)
Definition: fl_engine.cc:238
fl_engine_gl_make_resource_current
static bool fl_engine_gl_make_resource_current(void *user_data)
Definition: fl_engine.cc:249
FL_ENGINE_ERROR_FAILED
@ FL_ENGINE_ERROR_FAILED
Definition: fl_engine_private.h:25
kMousePointerDeviceId
static constexpr int32_t kMousePointerDeviceId
Definition: fl_engine.cc:35
set_app_lifecycle_state
static void set_app_lifecycle_state(FlEngine *self, const flutter::AppLifecycleState state)
Definition: fl_engine.cc:130
fl_texture_registrar_lookup_texture
FlTexture * fl_texture_registrar_lookup_texture(FlTextureRegistrar *self, int64_t texture_id)
Definition: fl_texture_registrar.cc:191
compositor_collect_backing_store_callback
static bool compositor_collect_backing_store_callback(const FlutterBackingStore *renderer, void *user_data)
Definition: fl_engine.cc:195
fl_settings_new
FlSettings * fl_settings_new()
Definition: fl_settings.cc:55
FlValue
typedefG_BEGIN_DECLS struct _FlValue FlValue
Definition: fl_value.h:40
fl_renderer_clear_current
gboolean fl_renderer_clear_current(FlRenderer *self, GError **error)
Definition: fl_renderer.cc:115
fl_engine_gl_present
static bool fl_engine_gl_present(void *user_data)
Definition: fl_engine.cc:243
flags
FlutterSemanticsFlag flags
Definition: fl_accessible_node.cc:105
fl_engine_dispose
static void fl_engine_dispose(GObject *object)
Definition: fl_engine.cc:401
user_data
FlKeyEvent uint64_t FlKeyResponderAsyncCallback gpointer user_data
Definition: fl_key_channel_responder.cc:121
fl_texture_registrar_new
FlTextureRegistrar * fl_texture_registrar_new(FlEngine *engine)
Definition: fl_texture_registrar.cc:216
fl_engine_on_pre_engine_restart_cb
static void fl_engine_on_pre_engine_restart_cb(void *user_data)
Definition: fl_engine.cc:351
fl_dart_project_get_assets_path
const G_MODULE_EXPORT gchar * fl_dart_project_get_assets_path(FlDartProject *self)
Definition: fl_dart_project.cc:85
height
G_BEGIN_DECLS int height
Definition: fl_backing_store_provider.h:37
fl_engine_get_binary_messenger
G_MODULE_EXPORT FlBinaryMessenger * fl_engine_get_binary_messenger(FlEngine *self)
Definition: fl_engine.cc:902
fl_renderer_get_proc_address
void * fl_renderer_get_proc_address(FlRenderer *self, const char *name)
Definition: fl_renderer.cc:91
state
AtkStateType state
Definition: fl_accessible_node.cc:10
fl_binary_messenger_new
FlBinaryMessenger * fl_binary_messenger_new(FlEngine *engine)
Definition: fl_binary_messenger.cc:406
fl_settings_plugin_start
void fl_settings_plugin_start(FlSettingsPlugin *self, FlSettings *settings)
Definition: fl_settings_plugin.cc:112
kPlatformTaskRunnerIdentifier
static constexpr size_t kPlatformTaskRunnerIdentifier
Definition: fl_engine.cc:31
fl_renderer_make_resource_current
gboolean fl_renderer_make_resource_current(FlRenderer *self, GError **error)
Definition: fl_renderer.cc:105
kPropLast
@ kPropLast
Definition: fl_accessible_node.cc:83
fl_engine_set_property
static void fl_engine_set_property(GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
Definition: fl_engine.cc:385
flutter::AppLifecycleState::kInactive
@ kInactive
fl_engine_new
FlEngine * fl_engine_new(FlDartProject *project, FlRenderer *renderer)
Definition: fl_engine.cc:467
fl_renderer_collect_backing_store
gboolean fl_renderer_collect_backing_store(FlRenderer *self, const FlutterBackingStore *backing_store)
Definition: fl_renderer.cc:133
fl_pixel_buffer_texture_populate
gboolean fl_pixel_buffer_texture_populate(FlPixelBufferTexture *texture, uint32_t width, uint32_t height, FlutterOpenGLTexture *opengl_texture, GError **error)
Definition: fl_pixel_buffer_texture.cc:71
fl_renderer_present_layers
gboolean fl_renderer_present_layers(FlRenderer *self, const FlutterLayer **layers, size_t layers_count)
Definition: fl_renderer.cc:157
fl_renderer_headless_new
FlRendererHeadless * fl_renderer_headless_new()
Definition: fl_renderer_headless.cc:57
fl_task_runner_post_task
void fl_task_runner_post_task(FlTaskRunner *self, FlutterTask task, uint64_t target_time_nanos)
Definition: fl_task_runner.cc:169
compositor_present_layers_callback
static bool compositor_present_layers_callback(const FlutterLayer **layers, size_t layers_count, void *user_data)
Definition: fl_engine.cc:203
kProp0
@ kProp0
Definition: fl_accessible_node.cc:83
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:260
TRUE
return TRUE
Definition: fl_pixel_buffer_texture_test.cc:53
flutter::GetSwitchesFromEnvironment
std::vector< std::string > GetSwitchesFromEnvironment()
Definition: engine_switches.cc:14
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:104
fl_engine_runs_task_on_current_thread
static bool fl_engine_runs_task_on_current_thread(void *user_data)
Definition: fl_engine.cc:301
fl_texture_gl_populate
gboolean fl_texture_gl_populate(FlTextureGL *self, uint32_t width, uint32_t height, FlutterOpenGLTexture *opengl_texture, GError **error)
Definition: fl_texture_gl.cc:50
self
GdkEvent FlView * self
Definition: fl_view.cc:100
fl_engine_get_registrar_for_plugin
static FlPluginRegistrar * fl_engine_get_registrar_for_plugin(FlPluginRegistry *registry, const gchar *name)
Definition: fl_engine.cc:371
result
GAsyncResult * result
Definition: fl_text_input_plugin.cc:106
args
G_BEGIN_DECLS G_MODULE_EXPORT FlValue * args
Definition: fl_event_channel.h:89
error
const uint8_t uint32_t uint32_t GError ** error
Definition: fl_pixel_buffer_texture_test.cc:40
flutter::AppLifecycleState::kResumed
@ kResumed
fl_engine_gl_proc_resolver
static void * fl_engine_gl_proc_resolver(void *user_data, const char *name)
Definition: fl_engine.cc:213
setup_locales
static void setup_locales(FlEngine *self)
Definition: fl_engine.cc:150
parse_locale
static void parse_locale(const gchar *locale, gchar **language, gchar **territory, gchar **codeset, gchar **modifier)
Definition: fl_engine.cc:87
fl_string_codec_new
G_MODULE_EXPORT FlStringCodec * fl_string_codec_new()
Definition: fl_string_codec.cc:53
fl_renderer_create_backing_store
gboolean fl_renderer_create_backing_store(FlRenderer *self, const FlutterBackingStoreConfig *config, FlutterBackingStore *backing_store_out)
Definition: fl_renderer.cc:125
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:185
fl_message_codec_encode_message
G_MODULE_EXPORT GBytes * fl_message_codec_encode_message(FlMessageCodec *self, FlValue *message, GError **error)
Definition: fl_message_codec.cc:17
flutter::AppLifecycleStateToString
constexpr const char * AppLifecycleStateToString(AppLifecycleState state)
Definition: app_lifecycle_state.h:72
fl_plugin_registrar_new
FlPluginRegistrar * fl_plugin_registrar_new(FlView *view, FlBinaryMessenger *messenger, FlTextureRegistrar *texture_registrar)
Definition: fl_plugin_registrar.cc:87
callback
FlKeyEvent uint64_t FlKeyResponderAsyncCallback callback
Definition: fl_key_channel_responder.cc:120
fl_renderer_make_current
gboolean fl_renderer_make_current(FlRenderer *self, GError **error)
Definition: fl_renderer.cc:95
fl_engine_error_quark
GQuark fl_engine_error_quark(void) G_GNUC_CONST
fl_dart_project_get_icu_data_path
const G_MODULE_EXPORT gchar * fl_dart_project_get_icu_data_path(FlDartProject *self)
Definition: fl_dart_project.cc:98
texture_id
int64_t texture_id
Definition: texture_registrar_unittests.cc:24
width
const uint8_t uint32_t * width
Definition: fl_pixel_buffer_texture_test.cc:38
fl_engine_gl_make_current
static bool fl_engine_gl_make_current(void *user_data)
Definition: fl_engine.cc:218
fl_engine_get_switches
GPtrArray * fl_engine_get_switches(FlEngine *self)
Definition: fl_engine.cc:935
fl_renderer_get_fbo
guint32 fl_renderer_get_fbo(FlRenderer *self)
Definition: fl_renderer.cc:120
fl_engine_post_task
static void fl_engine_post_task(FlutterTask task, uint64_t target_time_nanos, void *user_data)
Definition: fl_engine.cc:307
value
uint8_t value
Definition: fl_standard_message_codec.cc:41
fl_task_runner_new
FlTaskRunner * fl_task_runner_new(FlEngine *engine)
Definition: fl_task_runner.cc:161
fl_engine_send_platform_message_response
gboolean fl_engine_send_platform_message_response(FlEngine *self, const FlutterPlatformMessageResponseHandle *handle, GBytes *response, GError **error)
Definition: fl_engine.cc:648
node
G_BEGIN_DECLS const FlutterSemanticsNode * node
Definition: fl_view_accessible.h:40
fl_binary_messenger_send_on_channel
G_MODULE_EXPORT void fl_binary_messenger_send_on_channel(FlBinaryMessenger *self, const gchar *channel, GBytes *message, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
Definition: fl_binary_messenger.cc:451
fl_settings_plugin_new
FlSettingsPlugin * fl_settings_plugin_new(FlEngine *engine)
Definition: fl_settings_plugin.cc:94
fl_value_new_string
G_MODULE_EXPORT FlValue * fl_value_new_string(const gchar *value)
Definition: fl_value.cc:265
fl_engine_platform_message_cb
static void fl_engine_platform_message_cb(const FlutterPlatformMessage *message, void *user_data)
Definition: fl_engine.cc:316
kPointerPanZoomDeviceId
static constexpr int32_t kPointerPanZoomDeviceId
Definition: fl_engine.cc:36
kFlutterLifecycleChannel
static constexpr const char * kFlutterLifecycleChannel
Definition: fl_engine.cc:38
fl_engine_gl_clear_current
static bool fl_engine_gl_clear_current(void *user_data)
Definition: fl_engine.cc:228