Fast and reasonably complete (framebuffer) terminal emulator (Zig fork)
1/* Copyright (C) 2022-2023 mintsuki and contributors.
2 *
3 * Redistribution and use in source and binary forms, with or without
4 * modification, are permitted provided that the following conditions are met:
5 *
6 * 1. Redistributions of source code must retain the above copyright notice,
7 * this list of conditions and the following disclaimer.
8 *
9 * 2. Redistributions in binary form must reproduce the above copyright notice,
10 * this list of conditions and the following disclaimer in the documentation
11 * and/or other materials provided with the distribution.
12 *
13 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
14 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
17 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
18 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
19 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
20 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
21 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
22 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
23 * POSSIBILITY OF SUCH DAMAGE.
24 */
25
26#ifndef _FLANTERM_FR_H
27#define _FLANTERM_FB_H 1
28
29#ifdef __cplusplus
30extern "C" {
31#endif
32
33#include <stdint.h>
34#include <stddef.h>
35#include <stdbool.h>
36
37#include "../flanterm.h"
38
39#define FLANTERM_FB_FONT_GLYPHS 256
40
41struct flanterm_fb_char {
42 uint32_t c;
43 uint32_t fg;
44 uint32_t bg;
45};
46
47struct flanterm_fb_queue_item {
48 size_t x, y;
49 struct flanterm_fb_char c;
50};
51
52struct flanterm_fb_context {
53 struct flanterm_context term;
54
55 size_t font_width;
56 size_t font_height;
57 size_t glyph_width;
58 size_t glyph_height;
59
60 size_t font_scale_x;
61 size_t font_scale_y;
62
63 size_t offset_x, offset_y;
64
65 volatile uint32_t *framebuffer;
66 size_t pitch;
67 size_t width;
68 size_t height;
69 size_t bpp;
70
71 size_t font_bits_size;
72 uint8_t *font_bits;
73 size_t font_bool_size;
74 bool *font_bool;
75
76 uint32_t ansi_colours[8];
77 uint32_t ansi_bright_colours[8];
78 uint32_t default_fg, default_bg;
79 uint32_t default_fg_bright, default_bg_bright;
80
81#ifndef FLANTERM_FB_DISABLE_CANVAS
82 size_t canvas_size;
83 uint32_t *canvas;
84#endif
85
86 size_t grid_size;
87 size_t queue_size;
88 size_t map_size;
89
90 struct flanterm_fb_char *grid;
91
92 struct flanterm_fb_queue_item *queue;
93 size_t queue_i;
94
95 struct flanterm_fb_queue_item **map;
96
97 uint32_t text_fg;
98 uint32_t text_bg;
99 size_t cursor_x;
100 size_t cursor_y;
101
102 uint32_t saved_state_text_fg;
103 uint32_t saved_state_text_bg;
104 size_t saved_state_cursor_x;
105 size_t saved_state_cursor_y;
106
107 size_t old_cursor_x;
108 size_t old_cursor_y;
109};
110
111struct flanterm_context *flanterm_fb_init(
112 void *(*_malloc)(size_t),
113 void (*_free)(void *, size_t),
114 uint32_t *framebuffer, size_t width, size_t height, size_t pitch,
115#ifndef FLANTERM_FB_DISABLE_CANVAS
116 uint32_t *canvas,
117#endif
118 uint32_t *ansi_colours, uint32_t *ansi_bright_colours,
119 uint32_t *default_bg, uint32_t *default_fg,
120 uint32_t *default_bg_bright, uint32_t *default_fg_bright,
121 void *font, size_t font_width, size_t font_height, size_t font_spacing,
122 size_t font_scale_x, size_t font_scale_y,
123 size_t margin
124);
125
126#ifdef __cplusplus
127}
128#endif
129
130#endif