[FL-2627] Flipper applications: SDK, build and debug system (#1387)

* Added support for running applications from SD card (FAPs - Flipper Application Packages) * Added plugin_dist target for fbt to build FAPs * All apps of type FlipperAppType.EXTERNAL and FlipperAppType.PLUGIN are built as FAPs by default * Updated VSCode configuration for new fbt features - re-deploy stock configuration to use them * Added debugging support for FAPs with fbt debug & VSCode * Added public firmware API with automated versioning Co-authored-by: hedger <hedger@users.noreply.github.com> Co-authored-by: SG <who.just.the.doctor@gmail.com> Co-authored-by: あく <alleteam@gmail.com>
2022-09-15 02:11:38 +10:00
parent 0f6f9ad52e
commit b9a766d909
895 changed files with 8862 additions and 1465 deletions
--- a/applications/services/gui/gui.h
+++ b/applications/services/gui/gui.h
@@ -0,0 +1,111 @@
+/**
+ * @file gui.h
+ * GUI: main API
+ */
+
+#pragma once
+
+#include "view_port.h"
+#include "canvas.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** Gui layers */
+typedef enum {
+    GuiLayerDesktop, /**< Desktop layer for internal use. Like fullscreen but with status bar */
+
+    GuiLayerWindow, /**< Window layer, status bar is shown */
+
+    GuiLayerStatusBarLeft, /**< Status bar left-side layer, auto-layout */
+    GuiLayerStatusBarRight, /**< Status bar right-side layer, auto-layout */
+
+    GuiLayerFullscreen, /**< Fullscreen layer, no status bar */
+
+    GuiLayerMAX /**< Don't use or move, special value */
+} GuiLayer;
+
+/** Gui Canvas Commit Callback */
+typedef void (*GuiCanvasCommitCallback)(uint8_t* data, size_t size, void* context);
+
+#define RECORD_GUI "gui"
+
+typedef struct Gui Gui;
+
+/** Add view_port to view_port tree
+ *
+ * @remark     thread safe
+ *
+ * @param      gui        Gui instance
+ * @param      view_port  ViewPort instance
+ * @param[in]  layer      GuiLayer where to place view_port
+ */
+void gui_add_view_port(Gui* gui, ViewPort* view_port, GuiLayer layer);
+
+/** Remove view_port from rendering tree
+ *
+ * @remark     thread safe
+ *
+ * @param      gui        Gui instance
+ * @param      view_port  ViewPort instance
+ */
+void gui_remove_view_port(Gui* gui, ViewPort* view_port);
+
+/** Send ViewPort to the front
+ *
+ * Places selected ViewPort to the top of the drawing stack
+ *
+ * @param      gui        Gui instance
+ * @param      view_port  ViewPort instance
+ */
+void gui_view_port_send_to_front(Gui* gui, ViewPort* view_port);
+
+/** Send ViewPort to the back
+ *
+ * Places selected ViewPort to the bottom of the drawing stack
+ *
+ * @param      gui        Gui instance
+ * @param      view_port  ViewPort instance
+ */
+void gui_view_port_send_to_back(Gui* gui, ViewPort* view_port);
+
+/** Add gui canvas commit callback
+ *
+ * This callback will be called upon Canvas commit Callback dispatched from GUI
+ * thread and is time critical
+ *
+ * @param      gui       Gui instance
+ * @param      callback  GuiCanvasCommitCallback
+ * @param      context   GuiCanvasCommitCallback context
+ */
+void gui_add_framebuffer_callback(Gui* gui, GuiCanvasCommitCallback callback, void* context);
+
+/** Remove gui canvas commit callback
+ *
+ * @param      gui       Gui instance
+ * @param      callback  GuiCanvasCommitCallback
+ * @param      context   GuiCanvasCommitCallback context
+ */
+void gui_remove_framebuffer_callback(Gui* gui, GuiCanvasCommitCallback callback, void* context);
+
+/** Get gui canvas frame buffer size
+ * *
+ * @param      gui       Gui instance
+ * @return     size_t    size of frame buffer in bytes
+ */
+size_t gui_get_framebuffer_size(Gui* gui);
+
+/** Set lockdown mode
+ *
+ * When lockdown mode is enabled, only GuiLayerDesktop is shown.
+ * This feature prevents services from showing sensitive information when flipper is locked.
+ *
+ * @param      gui       Gui instance
+ * @param      lockdown  bool, true if enabled
+ */
+void gui_set_lockdown(Gui* gui, bool lockdown);
+
+#ifdef __cplusplus
+}
+#endif