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 devlib/README for information.
11 * \author Bernardo Innocenti <bernie@develer.com>
12 * \author Stefano Fedrigo <aleph@develer.com>
14 * \brief General pourpose graphics routines
19 *#* Revision 1.12 2005/03/01 23:26:45 bernie
20 *#* Use new CPU-neutral program-memory API.
22 *#* Revision 1.11 2004/12/08 08:06:16 bernie
25 *#* Revision 1.10 2004/11/01 15:14:07 bernie
26 *#* Update to current coding conventions.
28 *#* Revision 1.9 2004/10/21 10:58:33 bernie
31 *#* Revision 1.8 2004/09/20 03:29:22 bernie
34 *#* Revision 1.7 2004/09/14 21:01:08 bernie
35 *#* Rename rectangle drawing functions; Unify filled/cleared implementations.
37 *#* Revision 1.4 2004/08/24 16:53:10 bernie
38 *#* Use new-style config macros.
40 *#* Revision 1.3 2004/08/04 03:16:59 bernie
41 *#* Switch to new DevLib CONFIG_ convention.
43 *#* Revision 1.2 2004/06/03 11:27:09 bernie
44 *#* Add dual-license information.
48 #include "config.h" /* CONFIG_GFX_CLIPPING */
50 #include <cpu.h> /* CPU_HARVARD */
51 #include <macros.h> /* SWAP() */
57 * Plot a point in bitmap \a bm.
59 * \note bm is evaluated twice
61 #define BM_PLOT(bm, x, y) \
62 ( *((bm)->raster + ((y) / 8) * (bm)->width + (x)) |= 1 << ((y) % 8) )
65 * Clear a point in bitmap \a bm.
67 * \note bm is evaluated twice
69 #define BM_CLEAR(bm, x, y) \
70 ( *((bm)->raster + ((y) / 8) * (bm)->width + (x)) &= ~(1 << ((y) % 8)) )
73 * Set a point in bitmap \a bm to the specified color.
75 * \note bm is evaluated twice
76 * \note This macro is somewhat slower than BM_PLOT and BM_CLEAR.
77 * \see BM_PLOT BM_CLEAR
79 #define BM_DRAWPIXEL(bm, x, y, fg_pen) \
81 uint8_t *p = (bm)->raster + ((y) / 8) * (bm)->width + (x); \
82 uint8_t mask = 1 << ((y) % 8); \
83 *p = (*p & ~mask) | ((fg_pen) ? mask : 0); \
87 * Initialize a Bitmap structure with the provided parameters.
89 * \note The pen position is reset to the origin.
91 void gfx_bitmapInit(Bitmap *bm, uint8_t *raster, coord_t w, coord_t h)
102 * Clear the whole bitmap surface to the background color.
104 * \note This function does \b not update the current pen position
106 void gfx_bitmapClear(Bitmap *bm)
108 memset(bm->raster, 0, (bm->width * bm->height) / 8);
114 #include <avr/pgmspace.h> /* FIXME: memcpy_P() */
117 * Copy a raster picture located in program memory in the bitmap.
118 * The size of the raster to copy *must* be the same of the raster bitmap.
120 * \note This function does \b not update the current pen position
122 void gfx_blit_P(Bitmap *bm, const pgm_uint8_t *raster)
124 memcpy_P(bm->raster, raster, (bm->height / 8) * bm->width);
126 #endif /* CPU_HARVARD */
130 * Draw a line on the bitmap \a bm using the specified start and end
133 * \note This function does \b not update the current pen position.
135 * \todo Optimize for vertical and horiziontal lines.
137 void gfx_line(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2)
139 int x, y, e, len, adx, ady, signx, signy;
142 #if CONFIG_GFX_CLIPPING
147 #define XMAX (bm->width - 1)
148 #define YMAX (bm->height - 1)
153 y1 = y2 - ((x2 - XMIN) * (y2 - y1)) / (x2 - x1);
158 x1 = x2 - ((y2 - YMIN) * (x2 - x1)) / (y2 - y1);
163 y2 = y2 - ((XMIN - x1) * (y2 - y1)) / (x2 - x1);
168 x2 = x2 - ((YMIN - y1) * (x2 - x1)) / (y2 - y1);
174 y1 = ((x2 - XMAX) * (y2 - y1)) / (x2 - x1);
179 x1 = ((y2 - YMAX) * (x2 - x1)) / (y2 - y1);
184 y2 = ((XMAX - x1) * (y2 - y1)) / (x2 - x1);
189 x2 = ((YMAX - y1) * (x2 - x1)) / (y2 - y1);
198 #endif /* CONFIG_GFX_CLIPPING */
232 /* X-major line (octants 1/4/5/8) */
239 if ((x >= 0) && (x < bm->width) && (y >= 0) && (y < bm->height))
252 /* Y-major line (octants 2/3/6/7) */
259 if ((x >= 0) && (x < bm->width) && (y >= 0) && (y < bm->height))
274 * Move the current pen position to the specified coordinates.
276 void gfx_moveTo(Bitmap *bm, coord_t x, coord_t y)
283 * Draw a line from the current pen position to the new coordinates.
285 * \note This function moves the current pen position to the
288 void gfx_lineTo(Bitmap *bm, coord_t x, coord_t y)
290 gfx_line(bm, bm->penX, bm->penY, x, y);
291 gfx_moveTo(bm, x, y);
296 * Draw an the outline of an hollow rectangle.
298 * \note The bottom-right border of the rectangle is not drawn.
299 * \note This function does \b not update the current pen position
301 void gfx_rectDraw(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2)
303 /* Sort coords (needed for correct bottom-right semantics) */
304 if (x1 > x2) SWAP(x1, x2);
305 if (y1 > y2) SWAP(y1, y2);
308 gfx_line(bm, x1, y1, x2-1, y1);
309 gfx_line(bm, x2-1, y1, x2-1, y2-1);
310 gfx_line(bm, x2-1, y2-1, x1, y2-1);
311 gfx_line(bm, x1, y2-1, x1, y1);
316 * Fill a rectangular area with \a color.
318 * \note The bottom-right border of the rectangle is not drawn.
320 * \note This function does \b not update the current pen position
322 void gfx_rectFillC(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2, uint8_t color)
327 if (x1 > x2) SWAP(x1, x2);
328 if (y1 > y2) SWAP(y1, y2);
330 /* Clip rect to bitmap bounds */
333 if (x1 > bm->width) x1 = bm->width;
334 if (x2 > bm->width) x2 = bm->width;
337 if (y1 > bm->width) y1 = bm->width;
338 if (y2 > bm->width) y2 = bm->width;
342 * NOTE: Code paths are duplicated for efficiency
344 if (color) /* fill */
346 for (x = x1; x < x2; x++)
347 for (y = y1; y < y2; y++)
352 for (x = x1; x < x2; x++)
353 for (y = y1; y < y2; y++)
360 * Draw a filled rectangle.
362 * \note The bottom-right border of the rectangle is not drawn.
364 * \note This function does \b not update the current pen position
366 void gfx_rectFill(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2)
368 gfx_rectFillC(bm, x1, y1, x2, y2, 0xFF);
373 * Clear a rectangular area.
375 * \note The bottom-right border of the rectangle is not drawn.
377 * \note This function does \b not update the current pen position
379 void gfx_rectClear(Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2)
381 gfx_rectFillC(bm, x1, y1, x2, y2, 0x00);
386 * Imposta un rettangolo di clipping per il disegno nella bitmap.
388 void gfx_setClipRect(Bitmap *bm, coord_t minx, coord_t miny, coord_t maxx, coord_t maxy)
394 ASSERT(maxx <= bm->width);
395 ASSERT(maxy <= bm->height);
402 /* DB(kprintf("cr.xmin = %d, cr.ymin = %d, cr.xmax = %d, cr.ymax = %d\n",
403 bm->cr.xMin, bm->cr.ymin, bm->cr.xmax, bm->cr.ymax);)
408 #if CONFIG_GFX_VCOORDS
410 * Imposta gli estremi del sistema di coordinate cartesiane rispetto
411 * al rettangolo di clipping della bitmap.
413 void gfx_setViewRect(Bitmap *bm, vcoord_t x1, vcoord_t y1, vcoord_t x2, vcoord_t y2)
420 bm->scaleX = (vcoord_t)(bm->cr.xmax - bm->cr.xmin - 1) / (vcoord_t)(x2 - x1);
421 bm->scaleY = (vcoord_t)(bm->cr.ymax - bm->cr.ymin - 1) / (vcoord_t)(y2 - y1);
423 /* DB(kprintf("orgX = %f, orgY = %f, scaleX = %f, scaleY = %f\n",
424 bm->orgX, bm->orgY, bm->scaleX, bm->scaleY);)
430 * Transform a coordinate from the current reference system to a
431 * pixel offset within the bitmap.
433 coord_t gfx_transformX(Bitmap *bm, vcoord_t x)
435 return bm->cr.xmin + (coord_t)((x - bm->orgX) * bm->scaleX);
439 * Transform a coordinate from the current reference system to a
440 * pixel offset within the bitmap.
442 coord_t gfx_transformY(Bitmap *bm, vcoord_t y)
444 return bm->cr.ymin + (coord_t)((y - bm->orgY) * bm->scaleY);
449 * Draw a line from (x1;y1) to (x2;y2).
451 void gfx_vline(Bitmap *bm, vcoord_t x1, vcoord_t y1, vcoord_t x2, vcoord_t y2)
454 gfx_transformX(bm, x1), gfx_transformY(bm, y1),
455 gfx_transformY(bm, x2), gfx_transformY(bm, y2));
457 #endif /* CONFIG_GFX_VCOORDS */