Flutter Engine Uber Docs
Docs for the entire Flutter Engine repo.
 
Loading...
Searching...
No Matches
fl_engine.cc
Go to the documentation of this file.
1// Copyright 2013 The Flutter Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
6
7#include <epoxy/egl.h>
8#include <gmodule.h>
9
10#include <cstring>
11
29
30// Unique number associated with platform tasks.
31static constexpr size_t kPlatformTaskRunnerIdentifier = 1;
32
33// Use different device ID for mouse and pan/zoom events, since we can't
34// differentiate the actual device (mouse v.s. trackpad)
35static constexpr int32_t kMousePointerDeviceId = 0;
36static constexpr int32_t kPointerPanZoomDeviceId = 1;
37
38struct _FlEngine {
40
41 // Thread the GLib main loop is running on.
42 GThread* thread;
43
44 // The project this engine is running.
45 FlDartProject* project;
46
47 // Watches for monitors changes to update engine.
48 FlDisplayMonitor* display_monitor;
49
50 // Type of rendering performed.
52
53 // Manages OpenGL contexts.
54 FlOpenGLManager* opengl_manager;
55
56 // Messenger used to send and receive platform messages.
57 FlBinaryMessenger* binary_messenger;
58
59 // Implements the flutter/settings channel.
60 FlSettingsHandler* settings_handler;
61
62 // Implements the flutter/platform channel.
63 FlPlatformHandler* platform_handler;
64
65 // Implements the flutter/accessibility channel.
66 FlAccessibilityHandler* accessibility_handler;
67
68 // Process keyboard events.
69 FlKeyboardManager* keyboard_manager;
70
71 // Implements the flutter/textinput channel.
72 FlTextInputHandler* text_input_handler;
73
74 // Implements the flutter/keyboard channel.
75 FlKeyboardHandler* keyboard_handler;
76
77 // Implements the flutter/mousecursor channel.
78 FlMouseCursorHandler* mouse_cursor_handler;
79
80 // Manages textures rendered by native code.
81 FlTextureRegistrar* texture_registrar;
82
83 // Schedules tasks to be run on the appropriate thread.
84 FlTaskRunner* task_runner;
85
86 // Ahead of time data used to make engine run faster.
88
89 // The Flutter engine.
91
92 // Function table for engine API, used to intercept engine calls for testing
93 // purposes.
95
96 // Next ID to use for a view.
98
99 // Objects rendering the views.
101
102 // Mutex to protect access to renderables_by_view_id which is accessed by both
103 // engine threads and GTK.
105
106 // Function to call when a platform message is received.
110};
111
113
115 FlPluginRegistryInterface* iface);
116
118
120
122 FlEngine,
123 fl_engine,
124 G_TYPE_OBJECT,
125 G_IMPLEMENT_INTERFACE(fl_plugin_registry_get_type(),
127
128enum { PROP_0, PROP_BINARY_MESSENGER, PROP_LAST };
129
130// Parse a locale into its components.
131static void parse_locale(const gchar* locale,
132 gchar** language,
133 gchar** territory,
134 gchar** codeset,
135 gchar** modifier) {
136 gchar* l = g_strdup(locale);
137
138 // Locales are in the form "language[_territory][.codeset][@modifier]"
139 gchar* match = strrchr(l, '@');
140 if (match != nullptr) {
141 if (modifier != nullptr) {
142 *modifier = g_strdup(match + 1);
143 }
144 *match = '\0';
145 } else if (modifier != nullptr) {
146 *modifier = nullptr;
147 }
148
149 match = strrchr(l, '.');
150 if (match != nullptr) {
151 if (codeset != nullptr) {
152 *codeset = g_strdup(match + 1);
153 }
154 *match = '\0';
155 } else if (codeset != nullptr) {
156 *codeset = nullptr;
157 }
158
159 match = strrchr(l, '_');
160 if (match != nullptr) {
161 if (territory != nullptr) {
162 *territory = g_strdup(match + 1);
163 }
164 *match = '\0';
165 } else if (territory != nullptr) {
166 *territory = nullptr;
167 }
168
169 if (language != nullptr) {
170 *language = l;
171 }
172}
173
174/// Stores a weak reference to the renderable with the given ID.
175static void set_renderable(FlEngine* self,
176 int64_t view_id,
177 FlRenderable* renderable) {
178 g_autoptr(GMutexLocker) locker = g_mutex_locker_new(&self->renderables_mutex);
179 GWeakRef* ref = g_new(GWeakRef, 1);
180 g_weak_ref_init(ref, G_OBJECT(renderable));
181 g_hash_table_insert(self->renderables_by_view_id, GINT_TO_POINTER(view_id),
182 ref);
183}
184
185/// Returns the renderable with the given ID, or nullptr if no such view exists.
186/// Returns a reference to the renderable.
187static FlRenderable* get_renderable(FlEngine* self, int64_t view_id) {
188 g_autoptr(GMutexLocker) locker = g_mutex_locker_new(&self->renderables_mutex);
189 GWeakRef* ref = static_cast<GWeakRef*>(g_hash_table_lookup(
190 self->renderables_by_view_id, GINT_TO_POINTER(view_id)));
191 if (ref == nullptr) {
192 return nullptr;
193 }
194 return FL_RENDERABLE(g_weak_ref_get(ref));
195}
196
197/// Remove a renderable that no longer exists.
198static void remove_renderable(FlEngine* self, int64_t view_id) {
199 g_autoptr(GMutexLocker) locker = g_mutex_locker_new(&self->renderables_mutex);
200 g_hash_table_remove(self->renderables_by_view_id, GINT_TO_POINTER(view_id));
201}
202
203static void view_added_cb(const FlutterAddViewResult* result) {
204 g_autoptr(GTask) task = G_TASK(result->user_data);
205
206 if (result->added) {
207 g_task_return_boolean(task, TRUE);
208 } else {
209 g_task_return_new_error(task, fl_engine_error_quark(),
210 FL_ENGINE_ERROR_FAILED, "Failed to add view");
211 }
212}
213
214static void view_removed_cb(const FlutterRemoveViewResult* result) {
215 g_autoptr(GTask) task = G_TASK(result->user_data);
216
217 if (result->removed) {
218 g_task_return_boolean(task, TRUE);
219 } else {
220 g_task_return_new_error(task, fl_engine_error_quark(),
221 FL_ENGINE_ERROR_FAILED, "Failed to remove view");
222 }
223}
224
225static void free_locale(FlutterLocale* locale) {
226 g_free(const_cast<gchar*>(locale->language_code));
227 g_free(const_cast<gchar*>(locale->country_code));
228 g_free(locale);
229}
230
231// Passes locale information to the Flutter engine.
232static void setup_locales(FlEngine* self) {
233 const gchar* const* languages = g_get_language_names();
234 g_autoptr(GPtrArray) locales_array = g_ptr_array_new_with_free_func(
235 reinterpret_cast<GDestroyNotify>(free_locale));
236 for (int i = 0; languages[i] != nullptr; i++) {
237 g_autofree gchar* locale_string = g_strstrip(g_strdup(languages[i]));
238
239 // Ignore empty locales, caused by settings like `LANGUAGE=pt_BR:`
240 if (strcmp(locale_string, "") == 0) {
241 continue;
242 }
243
244 g_autofree gchar* language = nullptr;
245 g_autofree gchar* territory = nullptr;
246 parse_locale(locale_string, &language, &territory, nullptr, nullptr);
247
248 // Ignore duplicate locales, caused by settings like `LANGUAGE=C` (returns
249 // two "C") or `LANGUAGE=en:en`
250 gboolean has_locale = FALSE;
251 for (guint j = 0; !has_locale && j < locales_array->len; j++) {
252 FlutterLocale* locale =
253 reinterpret_cast<FlutterLocale*>(g_ptr_array_index(locales_array, j));
254 has_locale = g_strcmp0(locale->language_code, language) == 0 &&
255 g_strcmp0(locale->country_code, territory) == 0;
256 }
257 if (has_locale) {
258 continue;
259 }
260
261 FlutterLocale* locale =
262 static_cast<FlutterLocale*>(g_malloc0(sizeof(FlutterLocale)));
263 g_ptr_array_add(locales_array, locale);
264 locale->struct_size = sizeof(FlutterLocale);
265 locale->language_code =
266 reinterpret_cast<const gchar*>(g_steal_pointer(&language));
267 locale->country_code =
268 reinterpret_cast<const gchar*>(g_steal_pointer(&territory));
269 locale->script_code = nullptr;
270 locale->variant_code = nullptr;
271 }
272 FlutterLocale** locales =
273 reinterpret_cast<FlutterLocale**>(locales_array->pdata);
274 FlutterEngineResult result = self->embedder_api.UpdateLocales(
275 self->engine, const_cast<const FlutterLocale**>(locales),
276 locales_array->len);
277 if (result != kSuccess) {
278 g_warning("Failed to set up Flutter locales");
279 }
280}
281
283 FlEngine* self,
284 const FlutterBackingStoreConfig* config,
285 FlutterBackingStore* backing_store_out) {
286 if (!fl_opengl_manager_make_current(self->opengl_manager)) {
287 return false;
288 }
289
290 GLint sized_format = GL_RGBA8;
291 GLint general_format = GL_RGBA;
292 if (epoxy_has_gl_extension("GL_EXT_texture_format_BGRA8888")) {
293 sized_format = GL_BGRA8_EXT;
294 general_format = GL_BGRA_EXT;
295 }
296
297 FlFramebuffer* framebuffer = fl_framebuffer_new(
298 general_format, config->size.width, config->size.height, FALSE);
299 if (!framebuffer) {
300 g_warning("Failed to create backing store");
301 return false;
302 }
303
304 backing_store_out->type = kFlutterBackingStoreTypeOpenGL;
306 backing_store_out->open_gl.framebuffer.user_data = framebuffer;
307 backing_store_out->open_gl.framebuffer.name =
308 fl_framebuffer_get_id(framebuffer);
309 backing_store_out->open_gl.framebuffer.target = sized_format;
310 backing_store_out->open_gl.framebuffer.destruction_callback = [](void* p) {
311 // Backing store destroyed in fl_compositor_opengl_collect_backing_store(),
312 // set on FlutterCompositor.collect_backing_store_callback during engine
313 // start.
314 };
315
316 return true;
317}
318
320 FlEngine* self,
321 const FlutterBackingStore* backing_store) {
322 if (!fl_opengl_manager_make_current(self->opengl_manager)) {
323 return false;
324 }
325
326 // OpenGL context is required when destroying #FlFramebuffer.
327 g_object_unref(backing_store->open_gl.framebuffer.user_data);
328 return true;
329}
330
332 FlEngine* self,
333 const FlutterBackingStoreConfig* config,
334 FlutterBackingStore* backing_store_out) {
335 size_t allocation_length = config->size.width * config->size.height * 4;
336 uint8_t* allocation = static_cast<uint8_t*>(malloc(allocation_length));
337 if (allocation == nullptr) {
338 return false;
339 }
340
341 backing_store_out->type = kFlutterBackingStoreTypeSoftware;
342 backing_store_out->software.allocation = allocation;
343 backing_store_out->software.height = config->size.height;
344 backing_store_out->software.row_bytes = config->size.width * 4;
345 backing_store_out->software.user_data = nullptr;
346 backing_store_out->software.destruction_callback = [](void* p) {
347 // Backing store destroyed in
348 // fl_compositor_software_collect_backing_store(), set on
349 // FlutterCompositor.collect_backing_store_callback during engine start.
350 };
351
352 return true;
353}
354
356 FlEngine* self,
357 const FlutterBackingStore* backing_store) {
358 free(const_cast<void*>(backing_store->software.allocation));
359 return true;
360}
361
362// Called when engine needs a backing store for a specific #FlutterLayer.
364 const FlutterBackingStoreConfig* config,
365 FlutterBackingStore* backing_store_out,
366 void* user_data) {
367 FlEngine* self = static_cast<FlEngine*>(user_data);
368 switch (self->renderer_type) {
369 case kOpenGL:
370 return create_opengl_backing_store(self, config, backing_store_out);
371 case kSoftware:
372 return create_software_backing_store(self, config, backing_store_out);
373 default:
374 return false;
375 }
376}
377
378// Called when the backing store is to be released.
380 const FlutterBackingStore* backing_store,
381 void* user_data) {
382 FlEngine* self = static_cast<FlEngine*>(user_data);
383 switch (self->renderer_type) {
384 case kOpenGL:
385 return collect_opengl_backing_store(self, backing_store);
386 case kSoftware:
387 return collect_software_backing_store(self, backing_store);
388 default:
389 return false;
390 }
391}
392
393// Called when embedder should composite contents of each layer onto the screen.
395 const FlutterPresentViewInfo* info) {
396 FlEngine* self = static_cast<FlEngine*>(info->user_data);
397
398 g_autoptr(FlRenderable) renderable = get_renderable(self, info->view_id);
399 if (renderable == nullptr) {
400 return true;
401 }
402
404 return true;
405}
406
407// Flutter engine rendering callbacks.
408
409static void* fl_engine_gl_proc_resolver(void* user_data, const char* name) {
410 return reinterpret_cast<void*>(eglGetProcAddress(name));
411}
412
414 FlEngine* self = static_cast<FlEngine*>(user_data);
415 return fl_opengl_manager_make_current(self->opengl_manager);
416}
417
419 FlEngine* self = static_cast<FlEngine*>(user_data);
420 return fl_opengl_manager_clear_current(self->opengl_manager);
421}
422
423static uint32_t fl_engine_gl_get_fbo(void* user_data) {
424 // There is only one frame buffer object - always return that.
425 return 0;
426}
427
429 FlEngine* self = static_cast<FlEngine*>(user_data);
430 return fl_opengl_manager_make_resource_current(self->opengl_manager);
431}
432
433// Called by the engine to retrieve an external texture.
435 void* user_data,
436 int64_t texture_id,
437 size_t width,
438 size_t height,
439 FlutterOpenGLTexture* opengl_texture) {
440 FlEngine* self = static_cast<FlEngine*>(user_data);
441 if (!self->texture_registrar) {
442 return false;
443 }
444
445 FlTexture* texture =
447 if (texture == nullptr) {
448 g_warning("Unable to find texture %" G_GINT64_FORMAT, texture_id);
449 return false;
450 }
451
452 gboolean result;
453 g_autoptr(GError) error = nullptr;
454 if (FL_IS_TEXTURE_GL(texture)) {
455 result = fl_texture_gl_populate(FL_TEXTURE_GL(texture), width, height,
456 opengl_texture, &error);
457 } else if (FL_IS_PIXEL_BUFFER_TEXTURE(texture)) {
458 result =
459 fl_pixel_buffer_texture_populate(FL_PIXEL_BUFFER_TEXTURE(texture),
460 width, height, opengl_texture, &error);
461 } else {
462 g_warning("Unsupported texture type %" G_GINT64_FORMAT, texture_id);
463 return false;
464 }
465
466 if (!result) {
467 g_warning("%s", error->message);
468 return false;
469 }
470
471 return true;
472}
473
474// Called by the engine to determine if it is on the GTK thread.
476 FlEngine* self = static_cast<FlEngine*>(user_data);
477 return self->thread == g_thread_self();
478}
479
480// Called when the engine has a task to perform in the GTK thread.
482 uint64_t target_time_nanos,
483 void* user_data) {
484 FlEngine* self = static_cast<FlEngine*>(user_data);
485
486 fl_task_runner_post_flutter_task(self->task_runner, task, target_time_nanos);
487}
488
489// Called when a platform message is received from the engine.
491 void* user_data) {
492 FlEngine* self = FL_ENGINE(user_data);
493
494 gboolean handled = FALSE;
495 if (self->platform_message_handler != nullptr) {
496 g_autoptr(GBytes) data =
497 g_bytes_new(message->message, message->message_size);
498 handled = self->platform_message_handler(
499 self, message->channel, data, message->response_handle,
500 self->platform_message_handler_data);
501 }
502
503 if (!handled) {
505 nullptr, nullptr);
506 }
507}
508
509// Called when a semantic node update is received from the engine.
511 void* user_data) {
512 FlEngine* self = FL_ENGINE(user_data);
513
514 g_signal_emit(self, fl_engine_signals[SIGNAL_UPDATE_SEMANTICS], 0, update);
515}
516
517static void setup_keyboard(FlEngine* self) {
518 g_clear_object(&self->keyboard_manager);
519 self->keyboard_manager = fl_keyboard_manager_new(self);
520
521 g_clear_object(&self->keyboard_handler);
522 self->keyboard_handler =
523 fl_keyboard_handler_new(self->binary_messenger, self->keyboard_manager);
524
525 GtkWidget* widget =
526 self->text_input_handler != nullptr
527 ? fl_text_input_handler_get_widget(self->text_input_handler)
528 : nullptr;
529 g_clear_object(&self->text_input_handler);
530 self->text_input_handler = fl_text_input_handler_new(self->binary_messenger);
531 if (widget != nullptr) {
532 fl_text_input_handler_set_widget(self->text_input_handler, widget);
533 }
534}
535
536// Called right before the engine is restarted.
537//
538// This method should reset states to as if the engine has just been started,
539// which usually indicates the user has requested a hot restart (Shift-R in the
540// Flutter CLI.)
542 FlEngine* self = FL_ENGINE(user_data);
543
545
547}
548
549// Called when a response to a sent platform message is received from the
550// engine.
551static void fl_engine_platform_message_response_cb(const uint8_t* data,
552 size_t data_length,
553 void* user_data) {
554 g_autoptr(GTask) task = G_TASK(user_data);
555 g_task_return_pointer(task, g_bytes_new(data, data_length),
556 reinterpret_cast<GDestroyNotify>(g_bytes_unref));
557}
558
559// Implements FlPluginRegistry::get_registrar_for_plugin.
560static FlPluginRegistrar* fl_engine_get_registrar_for_plugin(
561 FlPluginRegistry* registry,
562 const gchar* name) {
563 FlEngine* self = FL_ENGINE(registry);
564
565 return fl_plugin_registrar_new(nullptr, self->binary_messenger,
566 self->texture_registrar);
567}
568
570 FlPluginRegistryInterface* iface) {
571 iface->get_registrar_for_plugin = fl_engine_get_registrar_for_plugin;
572}
573
574static void fl_engine_set_property(GObject* object,
575 guint prop_id,
576 const GValue* value,
577 GParamSpec* pspec) {
578 FlEngine* self = FL_ENGINE(object);
579 switch (prop_id) {
580 case PROP_BINARY_MESSENGER:
581 g_set_object(&self->binary_messenger,
582 FL_BINARY_MESSENGER(g_value_get_object(value)));
583 break;
584 default:
585 G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec);
586 break;
587 }
588}
589
590static void fl_engine_dispose(GObject* object) {
591 FlEngine* self = FL_ENGINE(object);
592
593 if (self->engine != nullptr) {
594 if (self->embedder_api.Shutdown(self->engine) != kSuccess) {
595 g_warning("Failed to shutdown Flutter engine");
596 }
597 self->engine = nullptr;
598 }
599
600 if (self->aot_data != nullptr) {
601 if (self->embedder_api.CollectAOTData(self->aot_data) != kSuccess) {
602 g_warning("Failed to send collect AOT data");
603 }
604 self->aot_data = nullptr;
605 }
606
607 fl_binary_messenger_shutdown(self->binary_messenger);
608 fl_texture_registrar_shutdown(self->texture_registrar);
609
610 g_clear_object(&self->project);
611 g_clear_object(&self->display_monitor);
612 g_clear_object(&self->opengl_manager);
613 g_clear_object(&self->texture_registrar);
614 g_clear_object(&self->binary_messenger);
615 g_clear_object(&self->settings_handler);
616 g_clear_object(&self->platform_handler);
617 g_clear_object(&self->accessibility_handler);
618 g_clear_object(&self->keyboard_manager);
619 g_clear_object(&self->text_input_handler);
620 g_clear_object(&self->keyboard_handler);
621 g_clear_object(&self->mouse_cursor_handler);
622 g_clear_object(&self->task_runner);
623 {
624 g_autoptr(GMutexLocker) locker =
625 g_mutex_locker_new(&self->renderables_mutex);
626 g_clear_pointer(&self->renderables_by_view_id, g_hash_table_unref);
627 }
628 g_mutex_clear(&self->renderables_mutex);
629
630 if (self->platform_message_handler_destroy_notify) {
631 self->platform_message_handler_destroy_notify(
632 self->platform_message_handler_data);
633 }
634 self->platform_message_handler_data = nullptr;
635 self->platform_message_handler_destroy_notify = nullptr;
636
637 G_OBJECT_CLASS(fl_engine_parent_class)->dispose(object);
638}
639
640static void fl_engine_class_init(FlEngineClass* klass) {
641 G_OBJECT_CLASS(klass)->dispose = fl_engine_dispose;
642 G_OBJECT_CLASS(klass)->set_property = fl_engine_set_property;
643
644 g_object_class_install_property(
645 G_OBJECT_CLASS(klass), PROP_BINARY_MESSENGER,
646 g_param_spec_object(
647 "binary-messenger", "messenger", "Binary messenger",
648 fl_binary_messenger_get_type(),
649 static_cast<GParamFlags>(G_PARAM_WRITABLE | G_PARAM_CONSTRUCT_ONLY |
650 G_PARAM_STATIC_STRINGS)));
651
653 "on-pre-engine-restart", fl_engine_get_type(), G_SIGNAL_RUN_LAST, 0,
654 nullptr, nullptr, nullptr, G_TYPE_NONE, 0);
656 "update-semantics", fl_engine_get_type(), G_SIGNAL_RUN_LAST, 0, nullptr,
657 nullptr, nullptr, G_TYPE_NONE, 1, G_TYPE_POINTER);
658}
659
660static void fl_engine_init(FlEngine* self) {
661 self->thread = g_thread_self();
662
663 self->embedder_api.struct_size = sizeof(FlutterEngineProcTable);
664 if (FlutterEngineGetProcAddresses(&self->embedder_api) != kSuccess) {
665 g_warning("Failed get get engine function pointers");
666 }
667
668 self->opengl_manager = fl_opengl_manager_new();
669
670 self->display_monitor =
672 self->task_runner = fl_task_runner_new(self);
673
674 // Implicit view is 0, so start at 1.
675 self->next_view_id = 1;
676 g_mutex_init(&self->renderables_mutex);
677 self->renderables_by_view_id = g_hash_table_new_full(
678 g_direct_hash, g_direct_equal, nullptr, [](gpointer value) {
679 GWeakRef* ref = static_cast<GWeakRef*>(value);
680 g_weak_ref_clear(ref);
681 free(ref);
682 });
683
684 self->texture_registrar = fl_texture_registrar_new(self);
685}
686
687static FlEngine* fl_engine_new_full(FlDartProject* project,
688 FlBinaryMessenger* binary_messenger) {
689 g_return_val_if_fail(FL_IS_DART_PROJECT(project), nullptr);
690
691 FlEngine* self = FL_ENGINE(g_object_new(fl_engine_get_type(), nullptr));
692
693 self->project = FL_DART_PROJECT(g_object_ref(project));
694 const gchar* renderer = g_getenv("FLUTTER_LINUX_RENDERER");
695 if (g_strcmp0(renderer, "software") == 0) {
696 self->renderer_type = kSoftware;
697 g_warning(
698 "Using the software renderer. Not all features are supported. This is "
699 "not recommended.\n"
700 "\n"
701 "To switch back to the default renderer, unset the "
702 "FLUTTER_LINUX_RENDERER environment variable.");
703 } else {
704 if (renderer != nullptr && strcmp(renderer, "opengl") != 0) {
705 g_warning("Unknown renderer type '%s', defaulting to opengl", renderer);
706 }
707 self->renderer_type = kOpenGL;
708 }
709
710 if (binary_messenger != nullptr) {
711 self->binary_messenger =
712 FL_BINARY_MESSENGER(g_object_ref(binary_messenger));
713 } else {
714 self->binary_messenger = fl_binary_messenger_new(self);
715 }
716 self->keyboard_manager = fl_keyboard_manager_new(self);
717 self->mouse_cursor_handler =
718 fl_mouse_cursor_handler_new(self->binary_messenger);
719 self->accessibility_handler = fl_accessibility_handler_new(self);
720
721 return self;
722}
723
724FlEngine* fl_engine_for_id(int64_t id) {
725 void* engine = reinterpret_cast<void*>(id);
726 g_return_val_if_fail(FL_IS_ENGINE(engine), nullptr);
727 return FL_ENGINE(engine);
728}
729
730G_MODULE_EXPORT FlEngine* fl_engine_new(FlDartProject* project) {
731 return fl_engine_new_full(project, nullptr);
732}
733
735 FlBinaryMessenger* binary_messenger) {
736 g_autoptr(FlDartProject) project = fl_dart_project_new();
737 return fl_engine_new_full(project, binary_messenger);
738}
739
740G_MODULE_EXPORT FlEngine* fl_engine_new_headless(FlDartProject* project) {
741 return fl_engine_new(project);
742}
743
745 g_return_val_if_fail(FL_IS_ENGINE(self), static_cast<FlutterRendererType>(0));
746 return self->renderer_type;
747}
748
749FlOpenGLManager* fl_engine_get_opengl_manager(FlEngine* self) {
750 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
751 return self->opengl_manager;
752}
753
754FlDisplayMonitor* fl_engine_get_display_monitor(FlEngine* self) {
755 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
756 return self->display_monitor;
757}
758
759gboolean fl_engine_start(FlEngine* self, GError** error) {
760 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
761
762 FlutterRendererConfig config = {};
763 config.type = self->renderer_type;
764 switch (config.type) {
765 case kSoftware:
767 // No action required, as this is handled in
768 // compositor_present_view_callback.
770 [](void* user_data, const void* allocation, size_t row_bytes,
771 size_t height) { return true; };
772 break;
773 case kOpenGL:
779 // No action required, as this is handled in
780 // compositor_present_view_callback.
781 config.open_gl.present = [](void* user_data) { return true; };
785 break;
786 case kMetal:
787 case kVulkan:
788 default:
790 "Unsupported renderer type");
791 return FALSE;
792 }
793
794 FlutterTaskRunnerDescription platform_task_runner = {};
795 platform_task_runner.struct_size = sizeof(FlutterTaskRunnerDescription);
796 platform_task_runner.user_data = self;
797 platform_task_runner.runs_task_on_current_thread_callback =
799 platform_task_runner.post_task_callback = fl_engine_post_task;
800 platform_task_runner.identifier = kPlatformTaskRunnerIdentifier;
801
802 FlutterCustomTaskRunners custom_task_runners = {};
803 custom_task_runners.struct_size = sizeof(FlutterCustomTaskRunners);
804 custom_task_runners.platform_task_runner = &platform_task_runner;
805
806 switch (fl_dart_project_get_ui_thread_policy(self->project)) {
808 break;
811 custom_task_runners.ui_task_runner = &platform_task_runner;
812 break;
813 }
814
815 gboolean enable_impeller = fl_dart_project_get_enable_impeller(self->project);
816 gboolean has_enable_impeller = FALSE;
817 for (const auto& env_switch : flutter::GetSwitchesFromEnvironment()) {
818 if (env_switch == "--enable-impeller" ||
819 env_switch == "--enable-impeller=true") {
820 enable_impeller = TRUE;
821 has_enable_impeller = TRUE;
822 } else if (env_switch == "--enable-impeller=false") {
823 enable_impeller = FALSE;
824 has_enable_impeller = TRUE;
825 }
826 }
827
828 g_autoptr(GPtrArray) command_line_args =
829 g_ptr_array_new_with_free_func(g_free);
830 g_ptr_array_insert(command_line_args, 0, g_strdup("flutter"));
831 for (const auto& env_switch : flutter::GetSwitchesFromEnvironment()) {
832 g_ptr_array_add(command_line_args, g_strdup(env_switch.c_str()));
833 }
834 // Linux (and other desktop platforms) always uses SDFs.
835 g_ptr_array_add(command_line_args, g_strdup("--impeller-use-sdfs"));
836
837 if (enable_impeller && !has_enable_impeller) {
838 g_ptr_array_add(command_line_args, g_strdup("--enable-impeller"));
839 }
840
841 gchar** dart_entrypoint_args =
843
846 args.assets_path = fl_dart_project_get_assets_path(self->project);
847 args.icu_data_path = fl_dart_project_get_icu_data_path(self->project);
848 args.command_line_argc = command_line_args->len;
849 args.command_line_argv =
850 reinterpret_cast<const char* const*>(command_line_args->pdata);
851 args.platform_message_callback = fl_engine_platform_message_cb;
852 args.update_semantics_callback2 = fl_engine_update_semantics_cb;
853 args.custom_task_runners = &custom_task_runners;
854 args.shutdown_dart_vm_when_done = true;
855 args.on_pre_engine_restart_callback = fl_engine_on_pre_engine_restart_cb;
856 args.dart_entrypoint_argc =
857 dart_entrypoint_args != nullptr ? g_strv_length(dart_entrypoint_args) : 0;
858 args.dart_entrypoint_argv =
859 reinterpret_cast<const char* const*>(dart_entrypoint_args);
860 args.engine_id = reinterpret_cast<int64_t>(self);
861
862 FlutterCompositor compositor = {};
863 compositor.struct_size = sizeof(FlutterCompositor);
864 compositor.user_data = self;
870 args.compositor = &compositor;
871
872 if (self->embedder_api.RunsAOTCompiledDartCode()) {
873 FlutterEngineAOTDataSource source = {};
876 if (self->embedder_api.CreateAOTData(&source, &self->aot_data) !=
877 kSuccess) {
879 "Failed to create AOT data");
880 return FALSE;
881 }
882 args.aot_data = self->aot_data;
883 }
884
885 FlutterEngineResult result = self->embedder_api.Initialize(
886 FLUTTER_ENGINE_VERSION, &config, &args, self, &self->engine);
887 if (result != kSuccess) {
889 "Failed to initialize Flutter engine");
890 return FALSE;
891 }
892
893 result = self->embedder_api.RunInitialized(self->engine);
894 if (result != kSuccess) {
896 "Failed to run Flutter engine");
897 return FALSE;
898 }
899
901
902 g_autoptr(FlSettings) settings = fl_settings_new();
903 self->settings_handler = fl_settings_handler_new(self);
904 fl_settings_handler_start(self->settings_handler, settings);
905
906 self->platform_handler = fl_platform_handler_new(self->binary_messenger);
907
909
910 result = self->embedder_api.UpdateSemanticsEnabled(self->engine, TRUE);
911 if (result != kSuccess) {
912 g_warning("Failed to enable accessibility features on Flutter engine");
913 }
914
915 fl_display_monitor_start(self->display_monitor);
916
917 return TRUE;
918}
919
921 return &(self->embedder_api);
922}
923
926 size_t displays_length) {
927 g_return_if_fail(FL_IS_ENGINE(self));
928
929 FlutterEngineResult result = self->embedder_api.NotifyDisplayUpdate(
931 displays_length);
932 if (result != kSuccess) {
933 g_warning("Failed to notify display update to Flutter engine: %d", result);
934 }
935}
936
940
942 FlRenderable* renderable,
943 size_t min_width,
944 size_t min_height,
945 size_t max_width,
946 size_t max_height,
947 double pixel_ratio,
948 GCancellable* cancellable,
949 GAsyncReadyCallback callback,
950 gpointer user_data) {
951 g_return_val_if_fail(FL_IS_ENGINE(self), -1);
952
953 g_autoptr(GTask) task = g_task_new(self, cancellable, callback, user_data);
954
955 FlutterViewId view_id = self->next_view_id;
956 self->next_view_id++;
957
959
960 // We don't know which display this view will open on, so set to zero and this
961 // will be updated in a following FlutterWindowMetricsEvent
962 FlutterEngineDisplayId display_id = 0;
963
964 FlutterWindowMetricsEvent metrics = {};
965 metrics.struct_size = sizeof(FlutterWindowMetricsEvent);
966 metrics.width = min_width;
967 metrics.height = min_height;
968 metrics.pixel_ratio = pixel_ratio;
969 metrics.display_id = display_id;
970 metrics.view_id = view_id;
971 metrics.has_constraints = true;
972 metrics.min_width_constraint = min_width;
973 metrics.min_height_constraint = min_height;
974 metrics.max_width_constraint = max_width;
975 metrics.max_height_constraint = max_height;
977 info.struct_size = sizeof(FlutterAddViewInfo);
978 info.view_id = view_id;
979 info.view_metrics = &metrics;
980 info.user_data = g_object_ref(task);
982 FlutterEngineResult result = self->embedder_api.AddView(self->engine, &info);
983 if (result != kSuccess) {
984 g_task_return_new_error(task, fl_engine_error_quark(),
985 FL_ENGINE_ERROR_FAILED, "AddView returned %d",
986 result);
987 // This would have been done in the callback, but that won't occur now.
988 g_object_unref(task);
989 }
990
991 return view_id;
992}
993
995 GAsyncResult* result,
996 GError** error) {
997 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
998 return g_task_propagate_boolean(G_TASK(result), error);
999}
1000
1002 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1003
1004 return get_renderable(self, view_id);
1005}
1006
1009 GCancellable* cancellable,
1010 GAsyncReadyCallback callback,
1011 gpointer user_data) {
1012 g_return_if_fail(FL_IS_ENGINE(self));
1013
1015
1016 g_autoptr(GTask) task = g_task_new(self, cancellable, callback, user_data);
1017
1019 info.struct_size = sizeof(FlutterRemoveViewInfo);
1020 info.view_id = view_id;
1021 info.user_data = g_object_ref(task);
1023 FlutterEngineResult result =
1024 self->embedder_api.RemoveView(self->engine, &info);
1025 if (result != kSuccess) {
1026 g_task_return_new_error(task, fl_engine_error_quark(),
1027 FL_ENGINE_ERROR_FAILED, "RemoveView returned %d",
1028 result);
1029 // This would have been done in the callback, but that won't occur now.
1030 g_object_unref(task);
1031 }
1032}
1033
1035 GAsyncResult* result,
1036 GError** error) {
1037 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1038 return g_task_propagate_boolean(G_TASK(result), error);
1039}
1040
1042 FlEngine* self,
1044 gpointer user_data,
1045 GDestroyNotify destroy_notify) {
1046 g_return_if_fail(FL_IS_ENGINE(self));
1047 g_return_if_fail(handler != nullptr);
1048
1049 if (self->platform_message_handler_destroy_notify) {
1050 self->platform_message_handler_destroy_notify(
1051 self->platform_message_handler_data);
1052 }
1053
1054 self->platform_message_handler = handler;
1055 self->platform_message_handler_data = user_data;
1056 self->platform_message_handler_destroy_notify = destroy_notify;
1057}
1058
1059// Note: This function can be called from any thread.
1061 FlEngine* self,
1063 GBytes* response,
1064 GError** error) {
1065 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1066 g_return_val_if_fail(handle != nullptr, FALSE);
1067
1068 if (self->engine == nullptr) {
1070 "No engine to send response to");
1071 return FALSE;
1072 }
1073
1074 gsize data_length = 0;
1075 const uint8_t* data = nullptr;
1076 if (response != nullptr) {
1077 data =
1078 static_cast<const uint8_t*>(g_bytes_get_data(response, &data_length));
1079 }
1080 FlutterEngineResult result = self->embedder_api.SendPlatformMessageResponse(
1081 self->engine, handle, data, data_length);
1082
1083 if (result != kSuccess) {
1085 "Failed to send platform message response");
1086 return FALSE;
1087 }
1088
1089 return TRUE;
1090}
1091
1093 const gchar* channel,
1094 GBytes* message,
1095 GCancellable* cancellable,
1096 GAsyncReadyCallback callback,
1097 gpointer user_data) {
1098 g_return_if_fail(FL_IS_ENGINE(self));
1099
1100 GTask* task = nullptr;
1101 FlutterPlatformMessageResponseHandle* response_handle = nullptr;
1102 if (callback != nullptr) {
1103 task = g_task_new(self, cancellable, callback, user_data);
1104
1105 if (self->engine == nullptr) {
1106 g_task_return_new_error(task, fl_engine_error_quark(),
1107 FL_ENGINE_ERROR_FAILED, "No engine to send to");
1108 g_object_unref(task);
1109 return;
1110 }
1111
1112 FlutterEngineResult result =
1113 self->embedder_api.PlatformMessageCreateResponseHandle(
1115 &response_handle);
1116 if (result != kSuccess) {
1117 g_task_return_new_error(task, fl_engine_error_quark(),
1119 "Failed to create response handle");
1120 g_object_unref(task);
1121 return;
1122 }
1123 } else if (self->engine == nullptr) {
1124 return;
1125 }
1126
1127 FlutterPlatformMessage fl_message = {};
1128 fl_message.struct_size = sizeof(fl_message);
1129 fl_message.channel = channel;
1130 fl_message.message =
1131 message != nullptr
1132 ? static_cast<const uint8_t*>(g_bytes_get_data(message, nullptr))
1133 : nullptr;
1134 fl_message.message_size = message != nullptr ? g_bytes_get_size(message) : 0;
1135 fl_message.response_handle = response_handle;
1136 FlutterEngineResult result =
1137 self->embedder_api.SendPlatformMessage(self->engine, &fl_message);
1138
1139 if (result != kSuccess && task != nullptr) {
1140 g_task_return_new_error(task, fl_engine_error_quark(),
1142 "Failed to send platform messages");
1143 g_object_unref(task);
1144 }
1145
1146 if (response_handle != nullptr) {
1147 if (self->embedder_api.PlatformMessageReleaseResponseHandle(
1148 self->engine, response_handle) != kSuccess) {
1149 g_warning("Failed to release response handle");
1150 }
1151 }
1152}
1153
1155 GAsyncResult* result,
1156 GError** error) {
1157 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1158 g_return_val_if_fail(g_task_is_valid(result, self), FALSE);
1159
1160 return static_cast<GBytes*>(g_task_propagate_pointer(G_TASK(result), error));
1161}
1162
1164 FlutterEngineDisplayId display_id,
1166 size_t min_width,
1167 size_t min_height,
1168 size_t max_width,
1169 size_t max_height,
1170 double pixel_ratio) {
1171 g_return_if_fail(FL_IS_ENGINE(self));
1172
1173 if (self->engine == nullptr) {
1174 return;
1175 }
1176
1177 FlutterWindowMetricsEvent event = {};
1178 event.struct_size = sizeof(FlutterWindowMetricsEvent);
1179 event.width = min_width;
1180 event.height = min_height;
1181 event.pixel_ratio = pixel_ratio;
1182 event.display_id = display_id;
1183 event.view_id = view_id;
1184 event.has_constraints = true;
1185 event.min_width_constraint = min_width;
1186 event.min_height_constraint = min_height;
1187 event.max_width_constraint = max_width;
1188 event.max_height_constraint = max_height;
1189 if (self->embedder_api.SendWindowMetricsEvent(self->engine, &event) !=
1190 kSuccess) {
1191 g_warning("Failed to send window metrics");
1192 }
1193}
1194
1197 FlutterPointerPhase phase,
1198 size_t timestamp,
1199 double x,
1200 double y,
1201 FlutterPointerDeviceKind device_kind,
1202 double scroll_delta_x,
1203 double scroll_delta_y,
1204 int64_t buttons) {
1205 g_return_if_fail(FL_IS_ENGINE(self));
1206
1207 if (self->engine == nullptr) {
1208 return;
1209 }
1210
1211 FlutterPointerEvent fl_event = {};
1212 fl_event.struct_size = sizeof(fl_event);
1213 fl_event.phase = phase;
1214 fl_event.timestamp = timestamp;
1215 fl_event.x = x;
1216 fl_event.y = y;
1217 if (scroll_delta_x != 0 || scroll_delta_y != 0) {
1219 }
1220 fl_event.scroll_delta_x = scroll_delta_x;
1221 fl_event.scroll_delta_y = scroll_delta_y;
1222 fl_event.device_kind = device_kind;
1223 fl_event.buttons = buttons;
1224 fl_event.device = kMousePointerDeviceId;
1225 fl_event.view_id = view_id;
1226 if (self->embedder_api.SendPointerEvent(self->engine, &fl_event, 1) !=
1227 kSuccess) {
1228 g_warning("Failed to send pointer event");
1229 }
1230}
1231
1234 size_t timestamp,
1235 double x,
1236 double y,
1237 int32_t device) {
1238 g_return_if_fail(FL_IS_ENGINE(self));
1239
1240 if (self->engine == nullptr) {
1241 return;
1242 }
1243
1244 FlutterPointerEvent event;
1245 event.timestamp = timestamp;
1246 event.x = x;
1247 event.y = y;
1248 event.device_kind = kFlutterPointerDeviceKindTouch;
1249 event.device = device;
1250 event.buttons = 0;
1251 event.view_id = view_id;
1252 event.phase = FlutterPointerPhase::kUp;
1253 event.struct_size = sizeof(event);
1254
1255 if (self->embedder_api.SendPointerEvent(self->engine, &event, 1) !=
1256 kSuccess) {
1257 g_warning("Failed to send pointer event");
1258 }
1259}
1260
1263 size_t timestamp,
1264 double x,
1265 double y,
1266 int32_t device) {
1267 g_return_if_fail(FL_IS_ENGINE(self));
1268
1269 if (self->engine == nullptr) {
1270 return;
1271 }
1272
1273 FlutterPointerEvent event;
1274 event.timestamp = timestamp;
1275 event.x = x;
1276 event.y = y;
1277 event.device_kind = kFlutterPointerDeviceKindTouch;
1278 event.device = device;
1280 event.view_id = view_id;
1281 event.phase = FlutterPointerPhase::kDown;
1282 event.struct_size = sizeof(event);
1283
1284 if (self->embedder_api.SendPointerEvent(self->engine, &event, 1) !=
1285 kSuccess) {
1286 g_warning("Failed to send pointer event");
1287 }
1288}
1289
1292 size_t timestamp,
1293 double x,
1294 double y,
1295 int32_t device) {
1296 g_return_if_fail(FL_IS_ENGINE(self));
1297
1298 if (self->engine == nullptr) {
1299 return;
1300 }
1301
1302 FlutterPointerEvent event;
1303 event.timestamp = timestamp;
1304 event.x = x;
1305 event.y = y;
1306 event.device_kind = kFlutterPointerDeviceKindTouch;
1307 event.device = device;
1309 event.view_id = view_id;
1310 event.phase = FlutterPointerPhase::kMove;
1311 event.struct_size = sizeof(event);
1312
1313 if (self->embedder_api.SendPointerEvent(self->engine, &event, 1) !=
1314 kSuccess) {
1315 g_warning("Failed to send pointer event");
1316 }
1317}
1318
1321 size_t timestamp,
1322 double x,
1323 double y,
1324 int32_t device) {
1325 g_return_if_fail(FL_IS_ENGINE(self));
1326
1327 if (self->engine == nullptr) {
1328 return;
1329 }
1330
1331 FlutterPointerEvent event;
1332 event.timestamp = timestamp;
1333 event.x = x;
1334 event.y = y;
1335 event.device_kind = kFlutterPointerDeviceKindTouch;
1336 event.device = device;
1337 event.buttons = 0;
1338 event.view_id = view_id;
1339 event.phase = FlutterPointerPhase::kAdd;
1340 event.struct_size = sizeof(event);
1341
1342 if (self->embedder_api.SendPointerEvent(self->engine, &event, 1) !=
1343 kSuccess) {
1344 g_warning("Failed to send pointer event");
1345 }
1346}
1347
1350 size_t timestamp,
1351 double x,
1352 double y,
1353 int32_t device) {
1354 g_return_if_fail(FL_IS_ENGINE(self));
1355
1356 if (self->engine == nullptr) {
1357 return;
1358 }
1359
1360 FlutterPointerEvent event;
1361 event.timestamp = timestamp;
1362 event.x = x;
1363 event.y = y;
1364 event.device_kind = kFlutterPointerDeviceKindTouch;
1365 event.device = device;
1366 event.buttons = 0;
1367 event.view_id = view_id;
1368 event.phase = FlutterPointerPhase::kRemove;
1369 event.struct_size = sizeof(event);
1370
1371 if (self->embedder_api.SendPointerEvent(self->engine, &event, 1) !=
1372 kSuccess) {
1373 g_warning("Failed to send pointer event");
1374 }
1375}
1376
1379 size_t timestamp,
1380 double x,
1381 double y,
1382 FlutterPointerPhase phase,
1383 double pan_x,
1384 double pan_y,
1385 double scale,
1386 double rotation) {
1387 g_return_if_fail(FL_IS_ENGINE(self));
1388
1389 if (self->engine == nullptr) {
1390 return;
1391 }
1392
1393 FlutterPointerEvent fl_event = {};
1394 fl_event.struct_size = sizeof(fl_event);
1395 fl_event.timestamp = timestamp;
1396 fl_event.x = x;
1397 fl_event.y = y;
1398 fl_event.phase = phase;
1399 fl_event.pan_x = pan_x;
1400 fl_event.pan_y = pan_y;
1401 fl_event.scale = scale;
1402 fl_event.rotation = rotation;
1405 fl_event.view_id = view_id;
1406 if (self->embedder_api.SendPointerEvent(self->engine, &fl_event, 1) !=
1407 kSuccess) {
1408 g_warning("Failed to send pointer event");
1409 }
1410}
1411
1412static void send_key_event_cb(bool handled, void* user_data) {
1413 g_autoptr(GTask) task = G_TASK(user_data);
1414 gboolean* return_value = g_new0(gboolean, 1);
1415 *return_value = handled;
1416 g_task_return_pointer(task, return_value, g_free);
1417}
1418
1420 const FlutterKeyEvent* event,
1421 GCancellable* cancellable,
1422 GAsyncReadyCallback callback,
1423 gpointer user_data) {
1424 g_return_if_fail(FL_IS_ENGINE(self));
1425
1426 g_autoptr(GTask) task = g_task_new(self, cancellable, callback, user_data);
1427
1428 if (self->engine == nullptr) {
1429 g_task_return_new_error(task, fl_engine_error_quark(),
1430 FL_ENGINE_ERROR_FAILED, "No engine");
1431 return;
1432 }
1433
1434 if (self->embedder_api.SendKeyEvent(self->engine, event, send_key_event_cb,
1435 g_object_ref(task)) != kSuccess) {
1436 g_task_return_new_error(task, fl_engine_error_quark(),
1437 FL_ENGINE_ERROR_FAILED, "Failed to send key event");
1438 g_object_unref(task);
1439 }
1440}
1441
1443 GAsyncResult* result,
1444 gboolean* handled,
1445 GError** error) {
1446 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1447 g_return_val_if_fail(g_task_is_valid(result, self), FALSE);
1448
1449 g_autofree gboolean* return_value =
1450 static_cast<gboolean*>(g_task_propagate_pointer(G_TASK(result), error));
1451 if (return_value == nullptr) {
1452 return FALSE;
1453 }
1454
1455 *handled = *return_value;
1456 return TRUE;
1457}
1458
1461 uint64_t node_id,
1463 GBytes* data) {
1464 g_return_if_fail(FL_IS_ENGINE(self));
1465
1466 if (self->engine == nullptr) {
1467 return;
1468 }
1469
1470 const uint8_t* action_data = nullptr;
1471 size_t action_data_length = 0;
1472 if (data != nullptr) {
1473 action_data = static_cast<const uint8_t*>(
1474 g_bytes_get_data(data, &action_data_length));
1475 }
1476
1479 info.view_id = view_id;
1480 info.node_id = node_id;
1481 info.action = action;
1482 info.data = action_data;
1483 info.data_length = action_data_length;
1484 if (self->embedder_api.SendSemanticsAction(self->engine, &info) != kSuccess) {
1485 g_warning("Failed to send semantics action");
1486 }
1487}
1488
1490 int64_t texture_id) {
1491 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1492 return self->embedder_api.MarkExternalTextureFrameAvailable(
1493 self->engine, texture_id) == kSuccess;
1494}
1495
1497 int64_t texture_id) {
1498 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1499 return self->embedder_api.RegisterExternalTexture(self->engine, texture_id) ==
1500 kSuccess;
1501}
1502
1504 int64_t texture_id) {
1505 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
1506 return self->embedder_api.UnregisterExternalTexture(self->engine,
1507 texture_id) == kSuccess;
1508}
1509
1510G_MODULE_EXPORT FlBinaryMessenger* fl_engine_get_binary_messenger(
1511 FlEngine* self) {
1512 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1513 return self->binary_messenger;
1514}
1515
1516FlTaskRunner* fl_engine_get_task_runner(FlEngine* self) {
1517 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1518 return self->task_runner;
1519}
1520
1522 g_return_if_fail(FL_IS_ENGINE(self));
1523 if (self->embedder_api.RunTask(self->engine, task) != kSuccess) {
1524 g_warning("Failed to run task");
1525 }
1526}
1527
1528G_MODULE_EXPORT FlTextureRegistrar* fl_engine_get_texture_registrar(
1529 FlEngine* self) {
1530 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1531 return self->texture_registrar;
1532}
1533
1534void fl_engine_update_accessibility_features(FlEngine* self, int32_t flags) {
1535 g_return_if_fail(FL_IS_ENGINE(self));
1536
1537 if (self->engine == nullptr) {
1538 return;
1539 }
1540
1541 if (self->embedder_api.UpdateAccessibilityFeatures(
1542 self->engine, static_cast<FlutterAccessibilityFeature>(flags)) !=
1543 kSuccess) {
1544 g_warning("Failed to update accessibility features");
1545 }
1546}
1547
1549 g_return_if_fail(FL_IS_ENGINE(self));
1550 fl_platform_handler_request_app_exit(self->platform_handler);
1551}
1552
1553FlKeyboardManager* fl_engine_get_keyboard_manager(FlEngine* self) {
1554 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1555 return self->keyboard_manager;
1556}
1557
1558FlTextInputHandler* fl_engine_get_text_input_handler(FlEngine* self) {
1559 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1560 return self->text_input_handler;
1561}
1562
1563FlMouseCursorHandler* fl_engine_get_mouse_cursor_handler(FlEngine* self) {
1564 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
1565 return self->mouse_cursor_handler;
1566}
int32_t value
int32_t x
FlutterEngineResult FlutterEngineGetProcAddresses(FlutterEngineProcTable *table)
Gets the table of engine function pointers.
Definition embedder.cc:3741
uint64_t FlutterEngineDisplayId
Definition embedder.h:1050
@ kFlutterEngineAOTDataSourceTypeElfPath
Definition embedder.h:2483
FlutterRendererType
Definition embedder.h:79
@ kVulkan
Definition embedder.h:86
@ kOpenGL
Definition embedder.h:80
@ kMetal
Definition embedder.h:85
@ kSoftware
Definition embedder.h:81
FlutterPointerPhase
The phase of the pointer event.
Definition embedder.h:1267
@ kUp
Definition embedder.h:1275
@ kRemove
Definition embedder.h:1297
@ kDown
Definition embedder.h:1282
@ kAdd
Definition embedder.h:1292
@ kMove
Definition embedder.h:1287
@ kFlutterPointerButtonMousePrimary
Definition embedder.h:1320
FlutterAccessibilityFeature
Definition embedder.h:91
FlutterEngineResult
Definition embedder.h:72
@ kSuccess
Definition embedder.h:73
@ kFlutterPointerSignalKindScroll
Definition embedder.h:1347
@ kFlutterEngineDisplaysUpdateTypeStartup
Definition embedder.h:2379
FlutterSemanticsAction
Definition embedder.h:122
int64_t FlutterViewId
Definition embedder.h:393
@ kFlutterOpenGLTargetTypeFramebuffer
Definition embedder.h:424
@ kFlutterBackingStoreTypeSoftware
Specified an software allocation for Flutter to render into using the CPU.
Definition embedder.h:2108
@ kFlutterBackingStoreTypeOpenGL
Definition embedder.h:2106
#define FLUTTER_ENGINE_VERSION
Definition embedder.h:70
FlutterPointerDeviceKind
The device type that created a pointer event.
Definition embedder.h:1309
@ kFlutterPointerDeviceKindTouch
Definition embedder.h:1311
@ kFlutterPointerDeviceKindTrackpad
Definition embedder.h:1313
VkDevice device
Definition main.cc:69
FlutterEngine engine
Definition main.cc:84
FlAccessibilityHandler * fl_accessibility_handler_new(FlEngine *engine)
const char * message
g_autoptr(FlEngine) engine
FlRenderable * renderable
@ PROP_LAST
G_DEFINE_QUARK(fl_binary_messenger_codec_error_quark, fl_binary_messenger_codec_error) G_DECLARE_FINAL_TYPE(FlBinaryMessengerImpl
FlBinaryMessenger * fl_binary_messenger_new(FlEngine *engine)
void fl_binary_messenger_shutdown(FlBinaryMessenger *self)
return TRUE
G_MODULE_EXPORT const gchar * fl_dart_project_get_assets_path(FlDartProject *self)
G_MODULE_EXPORT gboolean fl_dart_project_get_enable_impeller(FlDartProject *project)
G_MODULE_EXPORT const gchar * fl_dart_project_get_aot_library_path(FlDartProject *self)
G_MODULE_EXPORT const gchar * fl_dart_project_get_icu_data_path(FlDartProject *self)
G_MODULE_EXPORT gchar ** fl_dart_project_get_dart_entrypoint_arguments(FlDartProject *self)
G_MODULE_EXPORT FlDartProject * fl_dart_project_new()
G_MODULE_EXPORT FlUIThreadPolicy fl_dart_project_get_ui_thread_policy(FlDartProject *project)
@ FL_UI_THREAD_POLICY_RUN_ON_PLATFORM_THREAD
@ FL_UI_THREAD_POLICY_RUN_ON_SEPARATE_THREAD
@ FL_UI_THREAD_POLICY_DEFAULT
void fl_display_monitor_start(FlDisplayMonitor *self)
FlDisplayMonitor * fl_display_monitor_new(FlEngine *engine, GdkDisplay *display)
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:434
static bool fl_engine_runs_task_on_current_thread(void *user_data)
Definition fl_engine.cc:475
FlTaskRunner * fl_engine_get_task_runner(FlEngine *self)
static void fl_engine_on_pre_engine_restart_cb(void *user_data)
Definition fl_engine.cc:541
void fl_engine_send_mouse_pointer_event(FlEngine *self, 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_set_platform_message_handler(FlEngine *self, FlEnginePlatformMessageHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
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
Definition fl_engine.cc:121
static void view_added_cb(const FlutterAddViewResult *result)
Definition fl_engine.cc:203
static bool compositor_create_backing_store_callback(const FlutterBackingStoreConfig *config, FlutterBackingStore *backing_store_out, void *user_data)
Definition fl_engine.cc:363
static bool fl_engine_gl_make_current(void *user_data)
Definition fl_engine.cc:413
gboolean fl_engine_send_key_event_finish(FlEngine *self, GAsyncResult *result, gboolean *handled, GError **error)
void fl_engine_dispatch_semantics_action(FlEngine *self, FlutterViewId view_id, uint64_t node_id, FlutterSemanticsAction action, GBytes *data)
static void parse_locale(const gchar *locale, gchar **language, gchar **territory, gchar **codeset, gchar **modifier)
Definition fl_engine.cc:131
static void * fl_engine_gl_proc_resolver(void *user_data, const char *name)
Definition fl_engine.cc:409
static void set_renderable(FlEngine *self, int64_t view_id, FlRenderable *renderable)
Stores a weak reference to the renderable with the given ID.
Definition fl_engine.cc:175
void fl_engine_send_touch_up_event(FlEngine *self, FlutterViewId view_id, size_t timestamp, double x, double y, int32_t device)
static FlEngine * fl_engine_new_full(FlDartProject *project, FlBinaryMessenger *binary_messenger)
Definition fl_engine.cc:687
FlEngine * fl_engine_new_with_binary_messenger(FlBinaryMessenger *binary_messenger)
Definition fl_engine.cc:734
void fl_engine_send_window_metrics_event(FlEngine *self, FlutterEngineDisplayId display_id, FlutterViewId view_id, size_t min_width, size_t min_height, size_t max_width, size_t max_height, double pixel_ratio)
void fl_engine_notify_display_update(FlEngine *self, const FlutterEngineDisplay *displays, size_t displays_length)
Definition fl_engine.cc:924
static bool collect_opengl_backing_store(FlEngine *self, const FlutterBackingStore *backing_store)
Definition fl_engine.cc:319
static bool compositor_present_view_callback(const FlutterPresentViewInfo *info)
Definition fl_engine.cc:394
static bool compositor_collect_backing_store_callback(const FlutterBackingStore *backing_store, void *user_data)
Definition fl_engine.cc:379
FlOpenGLManager * fl_engine_get_opengl_manager(FlEngine *self)
Definition fl_engine.cc:749
FlutterRendererType fl_engine_get_renderer_type(FlEngine *self)
Definition fl_engine.cc:744
FlMouseCursorHandler * fl_engine_get_mouse_cursor_handler(FlEngine *self)
static void remove_renderable(FlEngine *self, int64_t view_id)
Remove a renderable that no longer exists.
Definition fl_engine.cc:198
static void fl_engine_dispose(GObject *object)
Definition fl_engine.cc:590
gboolean fl_engine_mark_texture_frame_available(FlEngine *self, int64_t texture_id)
static bool create_opengl_backing_store(FlEngine *self, const FlutterBackingStoreConfig *config, FlutterBackingStore *backing_store_out)
Definition fl_engine.cc:282
gboolean fl_engine_remove_view_finish(FlEngine *self, GAsyncResult *result, GError **error)
FlDisplayMonitor * fl_engine_get_display_monitor(FlEngine *self)
Definition fl_engine.cc:754
static FlPluginRegistrar * fl_engine_get_registrar_for_plugin(FlPluginRegistry *registry, const gchar *name)
Definition fl_engine.cc:560
static guint fl_engine_signals[LAST_SIGNAL]
Definition fl_engine.cc:119
static void fl_engine_platform_message_response_cb(const uint8_t *data, size_t data_length, void *user_data)
Definition fl_engine.cc:551
gboolean fl_engine_send_platform_message_response(FlEngine *self, const FlutterPlatformMessageResponseHandle *handle, GBytes *response, GError **error)
static void fl_engine_init(FlEngine *self)
Definition fl_engine.cc:660
static void fl_engine_post_task(FlutterTask task, uint64_t target_time_nanos, void *user_data)
Definition fl_engine.cc:481
void fl_engine_set_implicit_view(FlEngine *self, FlRenderable *renderable)
Definition fl_engine.cc:937
static uint32_t fl_engine_gl_get_fbo(void *user_data)
Definition fl_engine.cc:423
FlutterViewId fl_engine_add_view(FlEngine *self, FlRenderable *renderable, size_t min_width, size_t min_height, size_t max_width, size_t max_height, double pixel_ratio, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
Definition fl_engine.cc:941
static void view_removed_cb(const FlutterRemoveViewResult *result)
Definition fl_engine.cc:214
gboolean fl_engine_unregister_external_texture(FlEngine *self, int64_t texture_id)
@ LAST_SIGNAL
Definition fl_engine.cc:117
@ SIGNAL_UPDATE_SEMANTICS
Definition fl_engine.cc:117
@ SIGNAL_ON_PRE_ENGINE_RESTART
Definition fl_engine.cc:117
void fl_engine_send_platform_message(FlEngine *self, const gchar *channel, GBytes *message, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
gboolean fl_engine_register_external_texture(FlEngine *self, int64_t texture_id)
G_MODULE_EXPORT FlEngine * fl_engine_new(FlDartProject *project)
Definition fl_engine.cc:730
FlEngine * fl_engine_for_id(int64_t id)
Definition fl_engine.cc:724
void fl_engine_send_touch_move_event(FlEngine *self, FlutterViewId view_id, size_t timestamp, double x, double y, int32_t device)
G_MODULE_EXPORT FlEngine * fl_engine_new_headless(FlDartProject *project)
Definition fl_engine.cc:740
static void fl_engine_set_property(GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
Definition fl_engine.cc:574
G_MODULE_EXPORT FlTextureRegistrar * fl_engine_get_texture_registrar(FlEngine *self)
void fl_engine_send_touch_add_event(FlEngine *self, FlutterViewId view_id, size_t timestamp, double x, double y, int32_t device)
void fl_engine_remove_view(FlEngine *self, FlutterViewId view_id, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
gboolean fl_engine_add_view_finish(FlEngine *self, GAsyncResult *result, GError **error)
Definition fl_engine.cc:994
static FlRenderable * get_renderable(FlEngine *self, int64_t view_id)
Definition fl_engine.cc:187
void fl_engine_send_key_event(FlEngine *self, const FlutterKeyEvent *event, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
static void setup_keyboard(FlEngine *self)
Definition fl_engine.cc:517
static void free_locale(FlutterLocale *locale)
Definition fl_engine.cc:225
void fl_engine_request_app_exit(FlEngine *self)
static void setup_locales(FlEngine *self)
Definition fl_engine.cc:232
FlRenderable * fl_engine_get_renderable(FlEngine *self, FlutterViewId view_id)
void fl_engine_send_pointer_pan_zoom_event(FlEngine *self, FlutterViewId view_id, size_t timestamp, double x, double y, FlutterPointerPhase phase, double pan_x, double pan_y, double scale, double rotation)
static void fl_engine_update_semantics_cb(const FlutterSemanticsUpdate2 *update, void *user_data)
Definition fl_engine.cc:510
static bool fl_engine_gl_make_resource_current(void *user_data)
Definition fl_engine.cc:428
FlutterEngineProcTable * fl_engine_get_embedder_api(FlEngine *self)
Definition fl_engine.cc:920
void fl_engine_update_accessibility_features(FlEngine *self, int32_t flags)
static void fl_engine_platform_message_cb(const FlutterPlatformMessage *message, void *user_data)
Definition fl_engine.cc:490
FlKeyboardManager * fl_engine_get_keyboard_manager(FlEngine *self)
void fl_engine_send_touch_remove_event(FlEngine *self, FlutterViewId view_id, size_t timestamp, double x, double y, int32_t device)
void fl_engine_execute_task(FlEngine *self, FlutterTask *task)
void fl_engine_send_touch_down_event(FlEngine *self, FlutterViewId view_id, size_t timestamp, double x, double y, int32_t device)
G_MODULE_EXPORT FlBinaryMessenger * fl_engine_get_binary_messenger(FlEngine *self)
gboolean fl_engine_start(FlEngine *self, GError **error)
Definition fl_engine.cc:759
static void send_key_event_cb(bool handled, void *user_data)
FlTextInputHandler * fl_engine_get_text_input_handler(FlEngine *self)
static bool collect_software_backing_store(FlEngine *self, const FlutterBackingStore *backing_store)
Definition fl_engine.cc:355
static constexpr size_t kPlatformTaskRunnerIdentifier
Definition fl_engine.cc:31
static constexpr int32_t kPointerPanZoomDeviceId
Definition fl_engine.cc:36
static constexpr int32_t kMousePointerDeviceId
Definition fl_engine.cc:35
static void fl_engine_class_init(FlEngineClass *klass)
Definition fl_engine.cc:640
static bool fl_engine_gl_clear_current(void *user_data)
Definition fl_engine.cc:418
static void fl_engine_plugin_registry_iface_init(FlPluginRegistryInterface *iface)
Definition fl_engine.cc:569
static bool create_software_backing_store(FlEngine *self, const FlutterBackingStoreConfig *config, FlutterBackingStore *backing_store_out)
Definition fl_engine.cc:331
GBytes * fl_engine_send_platform_message_finish(FlEngine *self, GAsyncResult *result, GError **error)
GQuark fl_engine_error_quark(void) G_GNUC_CONST
@ FL_ENGINE_ERROR_FAILED
gboolean(* FlEnginePlatformMessageHandler)(FlEngine *engine, const gchar *channel, GBytes *message, const FlutterPlatformMessageResponseHandle *response_handle, gpointer user_data)
G_BEGIN_DECLS G_MODULE_EXPORT FlValue * args
FlFramebuffer * fl_framebuffer_new(GLint format, size_t width, size_t height, gboolean shareable)
GLuint fl_framebuffer_get_id(FlFramebuffer *self)
FlKeyboardHandler * fl_keyboard_handler_new(FlBinaryMessenger *messenger, FlKeyboardManager *keyboard_manager)
FlKeyboardManager * fl_keyboard_manager_new(FlEngine *engine)
const gchar * channel
g_hash_table_insert(self->handlers, g_strdup(channel), handler_new(handler, user_data, destroy_notify))
const gchar FlBinaryMessengerMessageHandler gpointer GDestroyNotify destroy_notify
const gchar FlBinaryMessengerMessageHandler handler
FlMouseCursorHandler * fl_mouse_cursor_handler_new(FlBinaryMessenger *messenger)
gboolean fl_opengl_manager_make_resource_current(FlOpenGLManager *self)
FlOpenGLManager * fl_opengl_manager_new()
gboolean fl_opengl_manager_clear_current(FlOpenGLManager *self)
gboolean fl_opengl_manager_make_current(FlOpenGLManager *self)
gboolean fl_pixel_buffer_texture_populate(FlPixelBufferTexture *texture, uint32_t width, uint32_t height, FlutterOpenGLTexture *opengl_texture, GError **error)
const uint8_t uint32_t uint32_t GError ** error
FlPlatformHandler * fl_platform_handler_new(FlBinaryMessenger *messenger)
void fl_platform_handler_request_app_exit(FlPlatformHandler *self)
FlPluginRegistrar * fl_plugin_registrar_new(FlView *view, FlBinaryMessenger *messenger, FlTextureRegistrar *texture_registrar)
void fl_renderable_present_layers(FlRenderable *self, const FlutterLayer **layers, size_t layers_count)
FlSettings * fl_settings_new()
void fl_settings_handler_start(FlSettingsHandler *self, FlSettings *settings)
FlSettingsHandler * fl_settings_handler_new(FlEngine *engine)
guint const GValue GParamSpec * pspec
FlTaskRunner * fl_task_runner_new(FlEngine *engine)
void fl_task_runner_post_flutter_task(FlTaskRunner *self, FlutterTask task, uint64_t target_time_nanos)
FlTextInputHandler * fl_text_input_handler_new(FlBinaryMessenger *messenger)
void fl_text_input_handler_set_widget(FlTextInputHandler *self, GtkWidget *widget)
GtkWidget * fl_text_input_handler_get_widget(FlTextInputHandler *self)
gboolean fl_texture_gl_populate(FlTextureGL *self, uint32_t width, uint32_t height, FlutterOpenGLTexture *opengl_texture, GError **error)
void fl_texture_registrar_shutdown(FlTextureRegistrar *self)
FlTexture * fl_texture_registrar_lookup_texture(FlTextureRegistrar *self, int64_t texture_id)
FlTextureRegistrar * fl_texture_registrar_new(FlEngine *engine)
G_BEGIN_DECLS FlutterViewId view_id
FlutterDesktopBinaryReply callback
const char * name
Definition fuchsia.cc:50
bool epoxy_has_gl_extension(const char *extension)
GdkDisplay * gdk_display_get_default()
Definition mock_gtk.cc:66
FlTexture * texture
double y
constexpr int64_t kFlutterImplicitViewId
Definition constants.h:35
std::vector< std::string > GetSwitchesFromEnvironment()
std::vector< FlutterEngineDisplay > * displays
int32_t height
int32_t width
FlTaskRunner * task_runner
Definition fl_engine.cc:84
FlEnginePlatformMessageHandler platform_message_handler
Definition fl_engine.cc:107
FlMouseCursorHandler * mouse_cursor_handler
Definition fl_engine.cc:78
GDestroyNotify platform_message_handler_destroy_notify
Definition fl_engine.cc:109
FlutterViewId next_view_id
Definition fl_engine.cc:97
FlAccessibilityHandler * accessibility_handler
Definition fl_engine.cc:66
FlSettingsHandler * settings_handler
Definition fl_engine.cc:60
gpointer platform_message_handler_data
Definition fl_engine.cc:108
FlOpenGLManager * opengl_manager
Definition fl_engine.cc:54
GThread * thread
Definition fl_engine.cc:42
FlPlatformHandler * platform_handler
Definition fl_engine.cc:63
FLUTTER_API_SYMBOL(FlutterEngine) engine
FlutterRendererType renderer_type
Definition fl_engine.cc:51
FlBinaryMessenger * binary_messenger
Definition fl_engine.cc:57
FlDisplayMonitor * display_monitor
Definition fl_engine.cc:48
GHashTable * renderables_by_view_id
Definition fl_engine.cc:100
FlDartProject * project
Definition fl_engine.cc:45
FlKeyboardManager * keyboard_manager
Definition fl_engine.cc:69
GMutex renderables_mutex
Definition fl_engine.cc:104
GObject parent_instance
Definition fl_engine.cc:39
FlTextureRegistrar * texture_registrar
Definition fl_engine.cc:81
FlutterEngineAOTData aot_data
Definition fl_engine.cc:87
FlutterEngineProcTable embedder_api
Definition fl_engine.cc:94
FlTextInputHandler * text_input_handler
Definition fl_engine.cc:72
FlKeyboardHandler * keyboard_handler
Definition fl_engine.cc:75
FlutterAddViewCallback add_view_callback
Definition embedder.h:1147
FlutterViewId view_id
The identifier for the view to add. This must be unique.
Definition embedder.h:1127
const FlutterWindowMetricsEvent * view_metrics
Definition embedder.h:1132
void * user_data
The |FlutterAddViewInfo.user_data|.
Definition embedder.h:1111
bool added
True if the add view operation succeeded.
Definition embedder.h:1108
FlutterSize size
The size of the render target the engine expects to render into.
Definition embedder.h:2148
FlutterBackingStoreType type
Specifies the type of backing store.
Definition embedder.h:2126
FlutterOpenGLBackingStore open_gl
The description of the OpenGL backing store.
Definition embedder.h:2132
FlutterSoftwareBackingStore software
The description of the software backing store.
Definition embedder.h:2134
FlutterBackingStoreCreateCallback create_backing_store_callback
Definition embedder.h:2268
size_t struct_size
This size of this struct. Must be sizeof(FlutterCompositor).
Definition embedder.h:2252
FlutterPresentViewCallback present_view_callback
Definition embedder.h:2305
FlutterBackingStoreCollectCallback collect_backing_store_callback
Definition embedder.h:2273
const FlutterTaskRunnerDescription * ui_task_runner
Definition embedder.h:1963
const FlutterTaskRunnerDescription * platform_task_runner
Definition embedder.h:1951
size_t struct_size
The size of this struct. Must be sizeof(FlutterCustomTaskRunners).
Definition embedder.h:1946
FlutterEngineAOTDataSourceType type
Definition embedder.h:2489
const char * elf_path
Absolute path to an ELF library file.
Definition embedder.h:2492
Function-pointer-based versions of the APIs above.
Definition embedder.h:3763
const char * language_code
Definition embedder.h:2314
size_t struct_size
This size of this struct. Must be sizeof(FlutterLocale).
Definition embedder.h:2310
const char * script_code
Definition embedder.h:2324
const char * country_code
Definition embedder.h:2319
const char * variant_code
Definition embedder.h:2329
FlutterOpenGLTargetType type
Definition embedder.h:1969
FlutterOpenGLFramebuffer framebuffer
Definition embedder.h:1975
uint32_t name
The name of the framebuffer.
Definition embedder.h:551
VoidCallback destruction_callback
Definition embedder.h:558
void * user_data
User data to be returned on the invocation of the destruction callback.
Definition embedder.h:554
ProcResolver gl_proc_resolver
Definition embedder.h:765
size_t struct_size
The size of this struct. Must be sizeof(FlutterOpenGLRendererConfig).
Definition embedder.h:726
TextureFrameCallback gl_external_texture_frame_callback
Definition embedder.h:770
BoolCallback make_resource_current
Definition embedder.h:748
size_t struct_size
The size of this struct. Must be sizeof(FlutterPlatformMessage).
Definition embedder.h:1491
const FlutterPlatformMessageResponseHandle * response_handle
Definition embedder.h:1501
const char * channel
Definition embedder.h:1492
const uint8_t * message
Definition embedder.h:1493
double scroll_delta_y
The y offset of the scroll in physical pixels.
Definition embedder.h:1371
size_t struct_size
The size of this struct. Must be sizeof(FlutterPointerEvent).
Definition embedder.h:1354
double scale
The scale of the pan/zoom, where 1.0 is the initial scale.
Definition embedder.h:1386
FlutterViewId view_id
The identifier of the view that received the pointer event.
Definition embedder.h:1390
FlutterPointerSignalKind signal_kind
Definition embedder.h:1367
double rotation
The rotation of the pan/zoom in radians, where 0.0 is the initial angle.
Definition embedder.h:1388
double scroll_delta_x
The x offset of the scroll in physical pixels.
Definition embedder.h:1369
double y
The y coordinate of the pointer event in physical pixels.
Definition embedder.h:1363
double x
The x coordinate of the pointer event in physical pixels.
Definition embedder.h:1361
FlutterPointerDeviceKind device_kind
Definition embedder.h:1377
double pan_x
The x offset of the pan/zoom in physical pixels.
Definition embedder.h:1382
FlutterPointerPhase phase
Definition embedder.h:1355
double pan_y
The y offset of the pan/zoom in physical pixels.
Definition embedder.h:1384
size_t layers_count
The count of layers.
Definition embedder.h:2225
void * user_data
The |FlutterCompositor.user_data|.
Definition embedder.h:2228
FlutterViewId view_id
The identifier of the target view.
Definition embedder.h:2219
const FlutterLayer ** layers
The layers that should be composited onto the view.
Definition embedder.h:2222
size_t struct_size
The size of this struct. Must be sizeof(FlutterProjectArgs).
Definition embedder.h:2513
FlutterRemoveViewCallback remove_view_callback
Definition embedder.h:1195
FlutterViewId view_id
Definition embedder.h:1178
void * user_data
The |FlutterRemoveViewInfo.user_data|.
Definition embedder.h:1159
bool removed
True if the remove view operation succeeded.
Definition embedder.h:1156
FlutterSoftwareRendererConfig software
Definition embedder.h:1041
FlutterOpenGLRendererConfig open_gl
Definition embedder.h:1040
FlutterRendererType type
Definition embedder.h:1038
A batch of updates to semantics nodes and custom actions.
Definition embedder.h:1851
FlutterViewId view_id
The ID of the view that includes the node.
Definition embedder.h:2833
FlutterSemanticsAction action
The semantics action.
Definition embedder.h:2839
size_t data_length
The data length.
Definition embedder.h:2845
uint64_t node_id
The semantics node identifier.
Definition embedder.h:2836
const uint8_t * data
Data associated with the action.
Definition embedder.h:2842
double height
Definition embedder.h:636
double width
Definition embedder.h:635
VoidCallback destruction_callback
Definition embedder.h:1996
size_t row_bytes
The number of bytes in a single row of the allocation.
Definition embedder.h:1987
size_t height
The number of rows in the allocation.
Definition embedder.h:1989
size_t struct_size
The size of this struct. Must be sizeof(FlutterSoftwareRendererConfig).
Definition embedder.h:1029
SoftwareSurfacePresentCallback surface_present_callback
Definition embedder.h:1034
size_t struct_size
The size of this struct. Must be sizeof(FlutterTaskRunnerDescription).
Definition embedder.h:1919
BoolCallback runs_task_on_current_thread_callback
Definition embedder.h:1925
FlutterTaskRunnerPostTaskCallback post_task_callback
Definition embedder.h:1936
FlutterEngineDisplayId display_id
The identifier of the display the view is rendering on.
Definition embedder.h:1074
size_t struct_size
The size of this struct. Must be sizeof(FlutterWindowMetricsEvent).
Definition embedder.h:1054
size_t height
Physical height of the window.
Definition embedder.h:1058
int64_t view_id
The view that this event is describing.
Definition embedder.h:1076
double pixel_ratio
Scale factor for the physical screen.
Definition embedder.h:1060
size_t width
Physical width of the window.
Definition embedder.h:1056
int64_t texture_id
const uintptr_t id