gfx/gfx.h

   1 /*!
   2  * \file
   3  * Copyright 2003, 2004, 2005 Develer S.r.l. (http://www.develer.com/)
   4  * Copyright 1999 Bernardo Innocenti <bernie@develer.com>
   5  * This file is part of DevLib - See README.devlib for information.
   6  *
   7  * \version $Id$
   8  *
   9  * \author Bernardo Innocenti <bernie@develer.com>
  10  * \author Stefano Fedrigo <aleph@develer.com>
  11  *
  12  * \brief General pourpose graphics routines
  13  */
  14
  15 /*#*
  16  *#* $Log$
  17  *#* Revision 1.2  2005/11/04 18:17:45  bernie
  18  *#* Fix header guards and includes for new location of gfx module.
  19  *#*
  20  *#* Revision 1.1  2005/11/04 18:11:35  bernie
  21  *#* Move graphics stuff from mware/ to gfx/.
  22  *#*
  23  *#* Revision 1.12  2005/11/04 16:20:02  bernie
  24  *#* Fix reference to README.devlib in header.
  25  *#*
  26  *#* Revision 1.11  2005/04/11 19:10:28  bernie
  27  *#* Include top-level headers from cfg/ subdir.
  28  *#*
  29  *#* Revision 1.10  2005/03/01 23:26:45  bernie
  30  *#* Use new CPU-neutral program-memory API.
  31  *#*
  32  *#* Revision 1.9  2005/01/20 18:46:31  aleph
  33  *#* Fix progmem includes.
  34  *#*/
  35
  36 #ifndef GFX_GFX_H
  37 #define GFX_GFX_H
  38
  39 #include <cfg/config.h>
  40 #include <cfg/compiler.h>
  41 #include <cfg/cpu.h>
  42
  43
  44 /*! Common type for coordinates expressed in pixel units */
  45 typedef int coord_t;
  46
  47 #if CONFIG_GFX_VCOORDS
  48 /*! Common type for coordinates expressed in logical units */
  49 typedef float vcoord_t;
  50 #endif /* CONFIG_GFX_VCOORDS */
  51
  52
  53 typedef struct Rect { coord_t xmin, ymin, xmax, ymax; } Rect;
  54
  55
  56 /*!
  57  * Control structure to draw in a bitmap
  58  */
  59 typedef struct Bitmap
  60 {
  61         uint8_t *raster;        /*!< Pointer to byte array to hold the data */
  62         coord_t width, height;  /*!< Width/Height in pixels */
  63         coord_t penX, penY;     /*!< Current pen position MoveTo()/LineTo() */
  64
  65         Rect cr;                /*!< Clip drawing inside this rectangle */
  66
  67 #if CONFIG_GFX_VCOORDS
  68         /*!
  69          * \name Logical coordinate system
  70          * \{
  71          */
  72         vcoord_t orgX, orgY;
  73         vcoord_t scaleX, scaleY;
  74         /*\}*/
  75 #endif /* CONFIG_GFX_VCOORDS */
  76
  77 } Bitmap;
  78
  79
  80 /* Function prototypes */
  81 extern void gfx_bitmapInit (Bitmap *bm, uint8_t *raster, coord_t w, coord_t h);
  82 extern void gfx_bitmapClear(Bitmap *bm);
  83 extern void gfx_line       (Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2);
  84 extern void gfx_rectDraw   (Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2);
  85 extern void gfx_rectFillC  (Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2, uint8_t color);
  86 extern void gfx_rectFill   (Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2);
  87 extern void gfx_rectClear  (Bitmap *bm, coord_t x1, coord_t y1, coord_t x2, coord_t y2);
  88 extern void gfx_moveTo     (Bitmap *bm, coord_t x,  coord_t y);
  89 extern void gfx_lineTo     (Bitmap *bm, coord_t x,  coord_t y);
  90 extern void gfx_setClipRect(Bitmap *bm, coord_t xmin, coord_t ymin, coord_t xmax, coord_t ymax);
  91
  92 #if CPU_HARVARD
  93         #include <mware/pgm.h>
  94         extern void gfx_blit_P(Bitmap *bm, const pgm_uint8_t *raster);
  95 #endif
  96
  97
  98 #if CONFIG_GFX_VCOORDS
  99 extern void gfx_setViewRect(Bitmap *bm, vcoord_t x1, vcoord_t y1, vcoord_t x2, vcoord_t y2);
 100 extern coord_t gfx_transformX(Bitmap *bm, vcoord_t x);
 101 extern coord_t gfx_transformY(Bitmap *bm, vcoord_t y);
 102 extern void gfx_vline(Bitmap *bm, vcoord_t x1, vcoord_t y1, vcoord_t x2, vcoord_t y2);
 103 #endif /* CONFIG_GFX_VCOORDS */
 104
 105 #endif /* GFX_GFX_H */