mirror of
https://github.com/DarkFlippers/unleashed-firmware
synced 2024-11-27 15:00:46 +00:00
111 lines
2.9 KiB
C
111 lines
2.9 KiB
C
/**
|
|
* @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
|