4 * Copyright 2003, 2004, 2005 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.2 2005/11/04 18:17:45 bernie
19 *#* Fix header guards and includes for new location of gfx module.
21 *#* Revision 1.1 2005/11/04 18:11:35 bernie
22 *#* Move graphics stuff from mware/ to gfx/.
24 *#* Revision 1.13 2005/11/04 16:20:02 bernie
25 *#* Fix reference to README.devlib in header.
27 *#* Revision 1.12 2005/04/11 19:10:28 bernie
28 *#* Include top-level headers from cfg/ subdir.
30 *#* Revision 1.11 2005/01/20 18:46:31 aleph
31 *#* Fix progmem includes.
33 *#* Revision 1.10 2005/01/08 09:20:12 bernie
34 *#* Really make it work on both architectures.
36 *#* Revision 1.9 2004/12/31 16:44:29 bernie
37 *#* Sanitize for non-Harvard processors.
39 *#* Revision 1.8 2004/11/16 21:16:28 bernie
40 *#* Update to new naming scheme in mware/gfx.c.
42 *#* Revision 1.7 2004/09/20 03:28:28 bernie
45 *#* Revision 1.6 2004/09/14 20:57:15 bernie
46 *#* Use debug.h instead of kdebug.h.
48 *#* Revision 1.5 2004/09/06 21:51:26 bernie
49 *#* Extend interface to allow any algorithmic style.
51 *#* Revision 1.2 2004/06/03 11:27:09 bernie
52 *#* Add dual-license information.
54 *#* Revision 1.1 2004/05/23 15:43:16 bernie
55 *#* Import mware modules.
57 *#* Revision 1.17 2004/05/15 16:57:01 aleph
58 *#* Fixes for non-DEBUG build
60 *#* Revision 1.16 2004/04/03 20:42:49 aleph
63 *#* Revision 1.15 2004/03/24 15:03:45 bernie
64 *#* Use explicit include paths; clean Doxygen comments
66 *#* Revision 1.14 2004/03/19 16:52:28 bernie
67 *#* Move printf() like functions from text.c to text_format.c and add PROGMEM versions.
69 *#* Revision 1.13 2004/03/17 18:23:32 bernie
72 *#* Revision 1.12 2004/03/17 18:03:22 bernie
73 *#* Make diagnostic message shorter
75 *#* Revision 1.11 2004/03/13 22:52:54 aleph
76 *#* documentation fixes
83 #include <cfg/debug.h>
87 * Flags degli stili algoritmici
89 * La routine di rendering del testo e' in grado di applicare
90 * delle semplici trasformazioni al font interno per generare
91 * automaticamente degli stili predefiniti (bold, italic,
92 * underline) a partire dal set di caratteri plain.
94 static uint8_t text_styles;
96 /*! ANSI escape sequences flag: true for ESC state on */
97 static bool ansi_mode = false;
101 * Move (imaginary) cursor to column and row specified.
102 * Next text write will start a that row and col.
104 void text_moveto(struct Bitmap *bm, int row, int col)
107 ASSERT(col < bm->width / FONT_WIDTH);
109 ASSERT(row < bm->height / FONT_HEIGHT);
111 bm->penX = col * FONT_WIDTH;
112 bm->penY = row * FONT_HEIGHT;
117 * Move (imaginary) cursor to coordinates specified.
119 void text_setcoord(struct Bitmap *bm, int x, int y)
127 * Render char \a c on Bitmap \a bm
129 static int text_putglyph(char c, struct Bitmap *bm)
131 const uint8_t * PROGMEM glyph; /* font is in progmem */
137 * Il carattere da stampare viene usato come indice per prelevare
138 * la prima colonna di dots del glyph all'interno del font.
140 glyph = font + (((unsigned char)c) * FONT_WIDTH);
141 glyph_width = FONT_WIDTH;
143 if (text_styles & STYLEF_CONDENSED)
146 if (text_styles & STYLEF_EXPANDED)
149 /* The y coord is rounded at multiples of 8 for simplicity */
150 bm->penY &= ~((coord_t)7);
152 /* Check if glyph to write fits in the bitmap */
153 if ((bm->penX < 0) || (bm->penX + glyph_width > bm->width) ||
154 (bm->penY < 0) || (bm->penY + FONT_HEIGHT > bm->height))
156 DB(kprintf("bad coords x=%d y=%d\n", bm->penX, bm->penY);)
160 /* Locate position where to write in the raster */
161 buf = bm->raster + bm->penY / 8 * bm->width + bm->penX;
163 bm->penX += glyph_width;
165 /* If some styles are set */
168 uint8_t prev_dots = 0, italic_prev_dots = 0, new_dots;
171 /* Per ogni colonna di dot del glyph... */
172 for (i = 0; i < glyph_width; ++i)
174 dots = PGM_READ_CHAR(glyph);
176 /* Advance to next column in glyph.
177 * Expand: advances only once every two columns
179 if (!(text_styles & STYLEF_EXPANDED) || (i & 1))
182 /* Italic: get lower 4 dots from previous column */
183 if (text_styles & STYLEF_ITALIC)
186 dots = (dots & 0xF0) | italic_prev_dots;
187 italic_prev_dots = new_dots & 0x0F;
190 /* Bold: "or" pixels with the previous column */
191 if (text_styles & STYLEF_BOLD)
195 prev_dots = new_dots;
198 /* Underlined: turn on base pixel */
199 if (text_styles & STYLEF_UNDERLINE)
202 /* Inverted: invert pixels */
203 if (text_styles & STYLEF_INVERT)
210 else /* No style: fast vanilla copy of glyph to line buffer */
211 while (glyph_width--)
212 *buf++ = PGM_READ_CHAR(glyph++);
219 * Render char \c c, with (currently) limited ANSI escapes
220 * emulation support and '\n' for newline.
222 int text_putchar(char c, struct Bitmap *bm)
224 /* Handle ANSI escape sequences */
229 case ANSI_ESC_CLEARSCREEN:
233 text_style(0, STYLEF_MASK);
236 kprintf("Unknown ANSI esc code: %x\n", c);)
240 else if (c == '\033') /* Enter ANSI ESC mode */
244 else if (c == '\n') /* Go one line down on a line-feed */
246 if (bm->penY + FONT_HEIGHT < bm->height)
248 bm->penY += FONT_HEIGHT;
254 text_putglyph(c, bm);
261 * Clear the screen and reset cursor position
263 void text_clear(struct Bitmap *bmp)
265 text_putchar('\x1b', bmp);
266 text_putchar('c', bmp);
270 void text_clearLine(struct Bitmap *bmp, int line)
272 gfx_rectClear(bmp, 0, line * FONT_HEIGHT, bmp->width, (line + 1) * FONT_HEIGHT);
277 * Set/clear algorithmic font style bits.
279 * \param flags Style flags to set
280 * \param mask Mask of flags to modify
281 * \return Old style flags
284 * Turn on bold, leave other styles alone
285 * \code prt_style(STYLEF_BOLD, STYLEF_BOLD); \endcode
287 * Turn off bold and turn on italic, leave others as they are
288 * \code prt_style(STYLEF_ITALIC, STYLEF_BOLD | STYLEF_ITALIC); \endcode
290 * Query current style without chaning it
291 * \code style = prt_style(0, 0); \endcode
293 * Reset all styles (plain text)
294 * \code prt_style(0, STYLE_MASK); \endcode
296 uint8_t text_style(uint8_t flags, uint8_t mask)
298 uint8_t old = text_styles;
299 text_styles = (text_styles & ~mask) | flags;