[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
@@ -0,0 +1,107 @@
+/**
+ * @file view_port.h
+ * GUI: ViewPort API
+ */
+
+#pragma once
+
+#include <input/input.h>
+#include "canvas.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef struct ViewPort ViewPort;
+
+typedef enum {
+    ViewPortOrientationHorizontal,
+    ViewPortOrientationVertical,
+} ViewPortOrientation;
+
+/** ViewPort Draw callback
+ * @warning    called from GUI thread
+ */
+typedef void (*ViewPortDrawCallback)(Canvas* canvas, void* context);
+
+/** ViewPort Input callback
+ * @warning    called from GUI thread
+ */
+typedef void (*ViewPortInputCallback)(InputEvent* event, void* context);
+
+/** ViewPort allocator
+ *
+ * always returns view_port or stops system if not enough memory.
+ *
+ * @return     ViewPort instance
+ */
+ViewPort* view_port_alloc();
+
+/** ViewPort deallocator
+ *
+ * Ensure that view_port was unregistered in GUI system before use.
+ *
+ * @param      view_port  ViewPort instance
+ */
+void view_port_free(ViewPort* view_port);
+
+/** Set view_port width.
+ *
+ * Will be used to limit canvas drawing area and autolayout feature.
+ *
+ * @param      view_port  ViewPort instance
+ * @param      width      wanted width, 0 - auto.
+ */
+void view_port_set_width(ViewPort* view_port, uint8_t width);
+uint8_t view_port_get_width(ViewPort* view_port);
+
+/** Set view_port height.
+ *
+ * Will be used to limit canvas drawing area and autolayout feature.
+ *
+ * @param      view_port  ViewPort instance
+ * @param      height     wanted height, 0 - auto.
+ */
+void view_port_set_height(ViewPort* view_port, uint8_t height);
+uint8_t view_port_get_height(ViewPort* view_port);
+
+/** Enable or disable view_port rendering.
+ *
+ * @param      view_port  ViewPort instance
+ * @param      enabled    Indicates if enabled
+ * @warning    automatically dispatches update event
+ */
+void view_port_enabled_set(ViewPort* view_port, bool enabled);
+bool view_port_is_enabled(ViewPort* view_port);
+
+/** ViewPort event callbacks
+ *
+ * @param      view_port  ViewPort instance
+ * @param      callback   appropriate callback function
+ * @param      context    context to pass to callback
+ */
+void view_port_draw_callback_set(ViewPort* view_port, ViewPortDrawCallback callback, void* context);
+void view_port_input_callback_set(
+    ViewPort* view_port,
+    ViewPortInputCallback callback,
+    void* context);
+
+/** Emit update signal to GUI system.
+ *
+ * Rendering will happen later after GUI system process signal.
+ *
+ * @param      view_port  ViewPort instance
+ */
+void view_port_update(ViewPort* view_port);
+
+/** Set ViewPort orientation.
+ *
+ * @param      view_port    ViewPort instance
+ * @param      orientation  display orientation, horizontal or vertical.
+ */
+void view_port_set_orientation(ViewPort* view_port, ViewPortOrientation orientation);
+ViewPortOrientation view_port_get_orientation(const ViewPort* view_port);
+
+#ifdef __cplusplus
+}
+#endif