6f7bcdf9a7
* SubGhz: Fix Timer hopping * SubGhz: add display of received packages and their maximum number. redesigned interface, the maximum number of received packages increased to 50 * SubGhz: add clearing history on exit read scene, jump after saving the key into the history of received signals * SubGhz: Fix honoring the width of the icon for transmitter scene * RFID: Fix [FL-1755] freeze after key emulation * SubGhz: drop analyze scene and views * SubGhz: fix save scene * Input, GUI: new event delivery scheme that groups event for complementarity. * Gui: update View Dispatcher documentation * Gui: remove dead code, wait till all input events are delivered in ViewDispatcher in queue mode. * Gui: update comment in ViewDispatcher * FuriHal: fix incorrect clock disable invocation * FuriHal: proper include * SubGhz: properly reset history in receiver view * Gui: correct view switch order and non-complementary events discarding Co-authored-by: Aleksandr Kutuzov <alleteam@gmail.com>
132 lines
4.0 KiB
C
Executable File
132 lines
4.0 KiB
C
Executable File
#pragma once
|
|
|
|
#include "view.h"
|
|
#include "gui.h"
|
|
#include "scene_manager.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** ViewDispatcher view_port placement
|
|
*/
|
|
typedef enum {
|
|
ViewDispatcherTypeNone, /**< Special layer for internal use only */
|
|
ViewDispatcherTypeWindow, /**< Main view_port layer, status bar is shown */
|
|
ViewDispatcherTypeFullscreen /**< Fullscreen view_port layer */
|
|
} ViewDispatcherType;
|
|
|
|
typedef struct ViewDispatcher ViewDispatcher;
|
|
|
|
/** Prototype for custom event callback
|
|
*/
|
|
typedef bool (*ViewDispatcherCustomEventCallback)(void* context, uint32_t event);
|
|
|
|
/** Prototype for navigation event callback
|
|
*/
|
|
typedef bool (*ViewDispatcherNavigationEventCallback)(void* context);
|
|
|
|
/** Prototype for tick event callback
|
|
*/
|
|
typedef void (*ViewDispatcherTickEventCallback)(void* context);
|
|
|
|
/** Allocate ViewDispatcher instance
|
|
* @return pointer to ViewDispatcher instance
|
|
*/
|
|
ViewDispatcher* view_dispatcher_alloc();
|
|
|
|
/** Free ViewDispatcher instance
|
|
* @param view_dispatcher pointer to ViewDispatcher
|
|
*/
|
|
void view_dispatcher_free(ViewDispatcher* view_dispatcher);
|
|
|
|
/** Enable queue support
|
|
* If queue enabled all input and custom events will be dispatched throw internal queue
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
*/
|
|
void view_dispatcher_enable_queue(ViewDispatcher* view_dispatcher);
|
|
|
|
/** Send custom event
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
*/
|
|
void view_dispatcher_send_custom_event(ViewDispatcher* view_dispatcher, uint32_t event);
|
|
|
|
/** Set custom event handler
|
|
* Called on Custom Event, if it is not consumed by view
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
* @param callback ViewDispatcherCustomEventCallback instance
|
|
*/
|
|
void view_dispatcher_set_custom_event_callback(
|
|
ViewDispatcher* view_dispatcher,
|
|
ViewDispatcherCustomEventCallback callback);
|
|
|
|
/** Set navigation event handler
|
|
* Called on Input Short Back Event, if it is not consumed by view
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
* @param callback ViewDispatcherNavigationEventCallback instance
|
|
*/
|
|
void view_dispatcher_set_navigation_event_callback(
|
|
ViewDispatcher* view_dispatcher,
|
|
ViewDispatcherNavigationEventCallback callback);
|
|
|
|
/** Set tick event handler
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
* @param callback ViewDispatcherTickEventCallback
|
|
* @param tick_period callback call period
|
|
*/
|
|
void view_dispatcher_set_tick_event_callback(
|
|
ViewDispatcher* view_dispatcher,
|
|
ViewDispatcherTickEventCallback callback,
|
|
uint32_t tick_period);
|
|
|
|
/** Set event callback context
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
* @param context pointer to context
|
|
*/
|
|
void view_dispatcher_set_event_callback_context(ViewDispatcher* view_dispatcher, void* context);
|
|
|
|
/** Run ViewDispatcher
|
|
* Use only after queue enabled
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
*/
|
|
void view_dispatcher_run(ViewDispatcher* view_dispatcher);
|
|
|
|
/** Stop ViewDispatcher
|
|
* Use only after queue enabled
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
*/
|
|
void view_dispatcher_stop(ViewDispatcher* view_dispatcher);
|
|
|
|
/** Add view to ViewDispatcher
|
|
* @param view_dispatcher, ViewDispatcher instance
|
|
* @param view_id View id to register
|
|
* @param view View instance
|
|
*/
|
|
void view_dispatcher_add_view(ViewDispatcher* view_dispatcher, uint32_t view_id, View* view);
|
|
|
|
/** Remove view from ViewDispatcher
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
* @param view_id View id to remove
|
|
*/
|
|
void view_dispatcher_remove_view(ViewDispatcher* view_dispatcher, uint32_t view_id);
|
|
|
|
/** Switch to View
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
* @param view_id View id to register
|
|
* @warning switching may be delayed till input events complementarity reached
|
|
*/
|
|
void view_dispatcher_switch_to_view(ViewDispatcher* view_dispatcher, uint32_t view_id);
|
|
|
|
/** Attach ViewDispatcher to GUI
|
|
* @param view_dispatcher ViewDispatcher instance
|
|
* @param gui GUI instance to attach to
|
|
*/
|
|
void view_dispatcher_attach_to_gui(
|
|
ViewDispatcher* view_dispatcher,
|
|
Gui* gui,
|
|
ViewDispatcherType type);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|