4 * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
5 * Copyright 1999 Bernardo Innocenti <bernie@develer.com>
6 * This file is part of DevLib - See README.devlib for information.
9 * \brief Text graphic routines
12 * \author Bernardo Innocenti <bernie@develer.com>
13 * \author Stefano Fedrigo <aleph@develer.com>
18 *#* Revision 1.1 2005/11/04 18:11:35 bernie
19 *#* Move graphics stuff from mware/ to gfx/.
21 *#* Revision 1.13 2005/11/04 16:20:02 bernie
22 *#* Fix reference to README.devlib in header.
24 *#* Revision 1.12 2005/04/11 19:10:28 bernie
25 *#* Include top-level headers from cfg/ subdir.
27 *#* Revision 1.11 2005/01/20 18:46:31 aleph
28 *#* Fix progmem includes.
30 *#* Revision 1.10 2005/01/08 09:20:12 bernie
31 *#* Really make it work on both architectures.
33 *#* Revision 1.9 2004/12/31 16:44:29 bernie
34 *#* Sanitize for non-Harvard processors.
36 *#* Revision 1.8 2004/11/16 21:16:28 bernie
37 *#* Update to new naming scheme in mware/gfx.c.
39 *#* Revision 1.7 2004/09/20 03:28:28 bernie
42 *#* Revision 1.6 2004/09/14 20:57:15 bernie
43 *#* Use debug.h instead of kdebug.h.
45 *#* Revision 1.5 2004/09/06 21:51:26 bernie
46 *#* Extend interface to allow any algorithmic style.
48 *#* Revision 1.2 2004/06/03 11:27:09 bernie
49 *#* Add dual-license information.
51 *#* Revision 1.1 2004/05/23 15:43:16 bernie
52 *#* Import mware modules.
54 *#* Revision 1.17 2004/05/15 16:57:01 aleph
55 *#* Fixes for non-DEBUG build
57 *#* Revision 1.16 2004/04/03 20:42:49 aleph
60 *#* Revision 1.15 2004/03/24 15:03:45 bernie
61 *#* Use explicit include paths; clean Doxygen comments
63 *#* Revision 1.14 2004/03/19 16:52:28 bernie
64 *#* Move printf() like functions from text.c to text_format.c and add PROGMEM versions.
66 *#* Revision 1.13 2004/03/17 18:23:32 bernie
69 *#* Revision 1.12 2004/03/17 18:03:22 bernie
70 *#* Make diagnostic message shorter
72 *#* Revision 1.11 2004/03/13 22:52:54 aleph
73 *#* documentation fixes
80 #include <cfg/debug.h>
84 * Flags degli stili algoritmici
86 * La routine di rendering del testo e' in grado di applicare
87 * delle semplici trasformazioni al font interno per generare
88 * automaticamente degli stili predefiniti (bold, italic,
89 * underline) a partire dal set di caratteri plain.
91 static uint8_t text_styles;
93 /*! ANSI escape sequences flag: true for ESC state on */
94 static bool ansi_mode = false;
98 * Move (imaginary) cursor to column and row specified.
99 * Next text write will start a that row and col.
101 void text_moveto(struct Bitmap *bm, int row, int col)
104 ASSERT(col < bm->width / FONT_WIDTH);
106 ASSERT(row < bm->height / FONT_HEIGHT);
108 bm->penX = col * FONT_WIDTH;
109 bm->penY = row * FONT_HEIGHT;
114 * Move (imaginary) cursor to coordinates specified.
116 void text_setcoord(struct Bitmap *bm, int x, int y)
124 * Render char \a c on Bitmap \a bm
126 static int text_putglyph(char c, struct Bitmap *bm)
128 const uint8_t * PROGMEM glyph; /* font is in progmem */
134 * Il carattere da stampare viene usato come indice per prelevare
135 * la prima colonna di dots del glyph all'interno del font.
137 glyph = font + (((unsigned char)c) * FONT_WIDTH);
138 glyph_width = FONT_WIDTH;
140 if (text_styles & STYLEF_CONDENSED)
143 if (text_styles & STYLEF_EXPANDED)
146 /* The y coord is rounded at multiples of 8 for simplicity */
147 bm->penY &= ~((coord_t)7);
149 /* Check if glyph to write fits in the bitmap */
150 if ((bm->penX < 0) || (bm->penX + glyph_width > bm->width) ||
151 (bm->penY < 0) || (bm->penY + FONT_HEIGHT > bm->height))
153 DB(kprintf("bad coords x=%d y=%d\n", bm->penX, bm->penY);)
157 /* Locate position where to write in the raster */
158 buf = bm->raster + bm->penY / 8 * bm->width + bm->penX;
160 bm->penX += glyph_width;
162 /* If some styles are set */
165 uint8_t prev_dots = 0, italic_prev_dots = 0, new_dots;
168 /* Per ogni colonna di dot del glyph... */
169 for (i = 0; i < glyph_width; ++i)
171 dots = PGM_READ_CHAR(glyph);
173 /* Advance to next column in glyph.
174 * Expand: advances only once every two columns
176 if (!(text_styles & STYLEF_EXPANDED) || (i & 1))
179 /* Italic: get lower 4 dots from previous column */
180 if (text_styles & STYLEF_ITALIC)
183 dots = (dots & 0xF0) | italic_prev_dots;
184 italic_prev_dots = new_dots & 0x0F;
187 /* Bold: "or" pixels with the previous column */
188 if (text_styles & STYLEF_BOLD)
192 prev_dots = new_dots;
195 /* Underlined: turn on base pixel */
196 if (text_styles & STYLEF_UNDERLINE)
199 /* Inverted: invert pixels */
200 if (text_styles & STYLEF_INVERT)
207 else /* No style: fast vanilla copy of glyph to line buffer */
208 while (glyph_width--)
209 *buf++ = PGM_READ_CHAR(glyph++);
216 * Render char \c c, with (currently) limited ANSI escapes
217 * emulation support and '\n' for newline.
219 int text_putchar(char c, struct Bitmap *bm)
221 /* Handle ANSI escape sequences */
226 case ANSI_ESC_CLEARSCREEN:
230 text_style(0, STYLEF_MASK);
233 kprintf("Unknown ANSI esc code: %x\n", c);)
237 else if (c == '\033') /* Enter ANSI ESC mode */
241 else if (c == '\n') /* Go one line down on a line-feed */
243 if (bm->penY + FONT_HEIGHT < bm->height)
245 bm->penY += FONT_HEIGHT;
251 text_putglyph(c, bm);
258 * Clear the screen and reset cursor position
260 void text_clear(struct Bitmap *bmp)
262 text_putchar('\x1b', bmp);
263 text_putchar('c', bmp);
267 void text_clearLine(struct Bitmap *bmp, int line)
269 gfx_rectClear(bmp, 0, line * FONT_HEIGHT, bmp->width, (line + 1) * FONT_HEIGHT);
274 * Set/clear algorithmic font style bits.
276 * \param flags Style flags to set
277 * \param mask Mask of flags to modify
278 * \return Old style flags
281 * Turn on bold, leave other styles alone
282 * \code prt_style(STYLEF_BOLD, STYLEF_BOLD); \endcode
284 * Turn off bold and turn on italic, leave others as they are
285 * \code prt_style(STYLEF_ITALIC, STYLEF_BOLD | STYLEF_ITALIC); \endcode
287 * Query current style without chaning it
288 * \code style = prt_style(0, 0); \endcode
290 * Reset all styles (plain text)
291 * \code prt_style(0, STYLE_MASK); \endcode
293 uint8_t text_style(uint8_t flags, uint8_t mask)
295 uint8_t old = text_styles;
296 text_styles = (text_styles & ~mask) | flags;