mirror of
https://github.com/DarkFlippers/unleashed-firmware
synced 2025-01-10 11:48:54 +00:00
ecab4d53d2
* Add doxygen and doxygen-awesome css, cleanup docs files * Ignore more libraries and remove leftover local variables * Create an actual intro page * .md files linting * Add doxygen action * Fix Doxygen path * Fix doxyfile path * Try to upload * Change docs branch * Add submudules checkout * Disable doxygen on PR * Mention the firmware docs in the readme * More dev docs mentions in the readme * Fix runner group, add tags * Test dev in PR * Disable running on PR * Fix a typo in the doxyfile * Try upload to S3 * Fix local path * Fix S3 ACL * Add delete flag, unifying dev and tags * Update ignored directories * More ignored directories * Even more ignored directories * Fix submodule * Change S3 uploader * Change S3 uploader version * Fix aws sync flags * Fix ACL * Disable ACL * Improve ignores, add WiFi devboard docs * TEMP: generate dev docs * TEMP: generate 0.89.0 docs * Disabling PR trigger * Enable submodules and test build * Enable test build * Disable test build * Change docs directory structure * Fix accidentally committed submodule * Fix submodules * Update links to the developer documentation * Markdown linting * Update workflow, enable test build * Fix doxygen dir path * Update Doxyfile-awesome.cfg * Change paths * Fix upload docs path * Disable pull_request debug trigger * Disable tags building * Remove autolinks and namespaces * Establish basic documentation structure * Add missing changes * Improve stylesheet, move some files * Improve examples * Improve the main page * Improve application dev docs * Improve system programming docs * Improve development tools docs * Improve other docs * Improve application examples * Fix formatting * Fix PVS-studio warnings * Improve visuals * Fix doxygen syntax warnings * Fix broken links * Update doxygen action Co-authored-by: DrunkBatya <drunkbatya.js@gmail.com> Co-authored-by: あく <alleteam@gmail.com> Co-authored-by: Georgii Surkov <georgii.surkov@outlook.com> Co-authored-by: Georgii Surkov <37121527+gsurkov@users.noreply.github.com>
150 lines
3.3 KiB
C
150 lines
3.3 KiB
C
/**
|
|
* @file canvas_i.h
|
|
* GUI: internal Canvas API
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "canvas.h"
|
|
#include <u8g2.h>
|
|
#include <toolbox/compress.h>
|
|
#include <m-array.h>
|
|
#include <m-algo.h>
|
|
#include <furi.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef void (*CanvasCommitCallback)(
|
|
uint8_t* data,
|
|
size_t size,
|
|
CanvasOrientation orientation,
|
|
void* context);
|
|
|
|
typedef struct {
|
|
CanvasCommitCallback callback;
|
|
void* context;
|
|
} CanvasCallbackPair;
|
|
|
|
ARRAY_DEF(CanvasCallbackPairArray, CanvasCallbackPair, M_POD_OPLIST);
|
|
|
|
#define M_OPL_CanvasCallbackPairArray_t() ARRAY_OPLIST(CanvasCallbackPairArray, M_POD_OPLIST)
|
|
|
|
ALGO_DEF(CanvasCallbackPairArray, CanvasCallbackPairArray_t);
|
|
|
|
/** Canvas structure
|
|
*/
|
|
struct Canvas {
|
|
u8g2_t fb;
|
|
CanvasOrientation orientation;
|
|
uint8_t offset_x;
|
|
uint8_t offset_y;
|
|
uint8_t width;
|
|
uint8_t height;
|
|
CompressIcon* compress_icon;
|
|
CanvasCallbackPairArray_t canvas_callback_pair;
|
|
FuriMutex* mutex;
|
|
};
|
|
|
|
/** Allocate memory and initialize canvas
|
|
*
|
|
* @return Canvas instance
|
|
*/
|
|
Canvas* canvas_init();
|
|
|
|
/** Free canvas memory
|
|
*
|
|
* @param canvas Canvas instance
|
|
*/
|
|
void canvas_free(Canvas* canvas);
|
|
|
|
/** Get canvas buffer.
|
|
*
|
|
* @param canvas Canvas instance
|
|
*
|
|
* @return pointer to buffer
|
|
*/
|
|
uint8_t* canvas_get_buffer(Canvas* canvas);
|
|
|
|
/** Get canvas buffer size.
|
|
*
|
|
* @param canvas Canvas instance
|
|
*
|
|
* @return size of canvas in bytes
|
|
*/
|
|
size_t canvas_get_buffer_size(const Canvas* canvas);
|
|
|
|
/** Set drawing region relative to real screen buffer
|
|
*
|
|
* @param canvas Canvas instance
|
|
* @param offset_x x coordinate offset
|
|
* @param offset_y y coordinate offset
|
|
* @param width width
|
|
* @param height height
|
|
*/
|
|
void canvas_frame_set(
|
|
Canvas* canvas,
|
|
uint8_t offset_x,
|
|
uint8_t offset_y,
|
|
uint8_t width,
|
|
uint8_t height);
|
|
|
|
/** Set canvas orientation
|
|
*
|
|
* @param canvas Canvas instance
|
|
* @param orientation CanvasOrientation
|
|
*/
|
|
void canvas_set_orientation(Canvas* canvas, CanvasOrientation orientation);
|
|
|
|
/** Get canvas orientation
|
|
*
|
|
* @param canvas Canvas instance
|
|
*
|
|
* @return CanvasOrientation
|
|
*/
|
|
CanvasOrientation canvas_get_orientation(const Canvas* canvas);
|
|
|
|
/** Draw a u8g2 bitmap
|
|
*
|
|
* @param u8g2 u8g2 instance
|
|
* @param x x coordinate
|
|
* @param y y coordinate
|
|
* @param width width
|
|
* @param height height
|
|
* @param bitmap bitmap
|
|
* @param rotation rotation
|
|
*/
|
|
void canvas_draw_u8g2_bitmap(
|
|
u8g2_t* u8g2,
|
|
uint8_t x,
|
|
uint8_t y,
|
|
uint8_t width,
|
|
uint8_t height,
|
|
const uint8_t* bitmap,
|
|
IconRotation rotation);
|
|
|
|
/** Add canvas commit callback.
|
|
*
|
|
* This callback will be called upon Canvas commit.
|
|
*
|
|
* @param canvas Canvas instance
|
|
* @param callback CanvasCommitCallback
|
|
* @param context CanvasCommitCallback context
|
|
*/
|
|
void canvas_add_framebuffer_callback(Canvas* canvas, CanvasCommitCallback callback, void* context);
|
|
|
|
/** Remove canvas commit callback.
|
|
*
|
|
* @param canvas Canvas instance
|
|
* @param callback CanvasCommitCallback
|
|
* @param context CanvasCommitCallback context
|
|
*/
|
|
void canvas_remove_framebuffer_callback(
|
|
Canvas* canvas,
|
|
CanvasCommitCallback callback,
|
|
void* context);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|