git.maemo.org Git - navit-package/blob - navit/graphics.h

   1 /**
   2  * Navit, a modular navigation system.
   3  * Copyright (C) 2005-2008 Navit Team
   4  *
   5  * This program is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Library General Public License
   7  * version 2 as published by the Free Software Foundation.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this program; if not, write to the
  16  * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
  17  * Boston, MA  02110-1301, USA.
  18  */
  19
  20 #ifndef NAVIT_GRAPHICS_H
  21 #define NAVIT_GRAPHICS_H
  22
  23 #ifdef __cplusplus
  24 extern "C" {
  25 #endif
  26 struct point;
  27 struct container;
  28 struct color;
  29 struct graphics;
  30 struct graphics_gc;
  31 struct graphics_font;
  32 struct graphics_image;
  33 struct transformation;
  34 struct display_list;
  35 struct mapset;
  36
  37 enum draw_mode_num {
  38         draw_mode_begin, draw_mode_begin_clear, draw_mode_end, draw_mode_cursor, draw_mode_end_lazy
  39 };
  40
  41 struct graphics_priv;
  42 struct graphics_font_priv;
  43 struct graphics_image_priv;
  44 struct graphics_gc_priv;
  45 struct graphics_font_methods;
  46 struct graphics_gc_methods;
  47 struct graphics_image_methods;
  48
  49 struct graphics_methods {
  50         void (*graphics_destroy)(struct graphics_priv *gr);
  51         void (*draw_mode)(struct graphics_priv *gr, enum draw_mode_num mode);
  52         void (*draw_lines)(struct graphics_priv *gr, struct graphics_gc_priv *gc, struct point *p, int count);
  53         void (*draw_polygon)(struct graphics_priv *gr, struct graphics_gc_priv *gc, struct point *p, int count);
  54         void (*draw_rectangle)(struct graphics_priv *gr, struct graphics_gc_priv *gc, struct point *p, int w, int h);
  55         void (*draw_circle)(struct graphics_priv *gr, struct graphics_gc_priv *gc, struct point *p, int r);
  56         void (*draw_text)(struct graphics_priv *gr, struct graphics_gc_priv *fg, struct graphics_gc_priv *bg, struct graphics_font_priv *font, char *text, struct point *p, int dx, int dy);
  57         void (*draw_image)(struct graphics_priv *gr, struct graphics_gc_priv *fg, struct point *p, struct graphics_image_priv *img);
  58         void (*draw_image_warp)(struct graphics_priv *gr, struct graphics_gc_priv *fg, struct point *p, int count, char *data);
  59         void (*draw_restore)(struct graphics_priv *gr, struct point *p, int w, int h);
  60         void (*draw_drag)(struct graphics_priv *gr, struct point *p);
  61         struct graphics_font_priv *(*font_new)(struct graphics_priv *gr, struct graphics_font_methods *meth, char *font,  int size, int flags);
  62         struct graphics_gc_priv *(*gc_new)(struct graphics_priv *gr, struct graphics_gc_methods *meth);
  63         void (*background_gc)(struct graphics_priv *gr, struct graphics_gc_priv *gc);
  64         struct graphics_priv *(*overlay_new)(struct graphics_priv *gr, struct graphics_methods *meth, struct point *p, int w, int h, int alpha, int wraparound);
  65         struct graphics_image_priv *(*image_new)(struct graphics_priv *gr, struct graphics_image_methods *meth, char *path, int *w, int *h, struct point *hot, int rotation);
  66         void *(*get_data)(struct graphics_priv *gr, char *type);
  67         void (*image_free)(struct graphics_priv *gr, struct graphics_image_priv *priv);
  68         void (*get_text_bbox)(struct graphics_priv *gr, struct graphics_font_priv *font, char *text, int dx, int dy, struct point *ret, int estimate);
  69         void (*overlay_disable)(struct graphics_priv *gr, int disable);
  70         void (*overlay_resize)(struct graphics_priv *gr, struct point *p, int w, int h, int alpha, int wraparound);
  71         int (*set_attr)(struct graphics_priv *gr, struct attr *attr);
  72 };
  73
  74
  75 struct graphics_font_methods {
  76         void (*font_destroy)(struct graphics_font_priv *font);
  77 };
  78
  79 struct graphics_font {
  80         struct graphics_font_priv *priv;
  81         struct graphics_font_methods meth;
  82 };
  83
  84 struct graphics_gc_methods {
  85         void (*gc_destroy)(struct graphics_gc_priv *gc);
  86         void (*gc_set_linewidth)(struct graphics_gc_priv *gc, int width);
  87         void (*gc_set_dashes)(struct graphics_gc_priv *gc, int width, int offset, unsigned char dash_list[], int n);
  88         void (*gc_set_foreground)(struct graphics_gc_priv *gc, struct color *c);
  89         void (*gc_set_background)(struct graphics_gc_priv *gc, struct color *c);
  90         void (*gc_set_stipple)(struct graphics_gc_priv *gc, struct graphics_image_priv *img);
  91 };
  92
  93 struct graphics_gc {
  94         struct graphics_gc_priv *priv;
  95         struct graphics_gc_methods meth;
  96 };
  97
  98 struct graphics_image_methods {
  99         void (*image_destroy)(struct graphics_image_priv *img);
 100 };
 101
 102 struct graphics_image {
 103         struct graphics_image_priv *priv;
 104         struct graphics_image_methods meth;
 105         int width;
 106         int height;
 107         struct point hot;
 108 };
 109
 110 struct graphics_data_image {
 111         void *data;
 112         int size;
 113 };
 114
 115 /* prototypes */
 116 enum attr_type;
 117 enum draw_mode_num;
 118 struct attr;
 119 struct attr_iter;
 120 struct callback;
 121 struct color;
 122 struct displayitem;
 123 struct displaylist;
 124 struct displaylist_handle;
 125 struct graphics;
 126 struct graphics_font;
 127 struct graphics_gc;
 128 struct graphics_image;
 129 struct item;
 130 struct itemgra;
 131 struct layout;
 132 struct mapset;
 133 struct point;
 134 struct point_rect;
 135 struct transformation;
 136 int graphics_set_attr(struct graphics *gra, struct attr *attr);
 137 void graphics_set_rect(struct graphics *gra, struct point_rect *pr);
 138 struct graphics *graphics_new(struct attr *parent, struct attr **attrs);
 139 int graphics_get_attr(struct graphics *this_, enum attr_type type, struct attr *attr, struct attr_iter *iter);
 140 struct graphics *graphics_overlay_new(struct graphics *parent, struct point *p, int w, int h, int alpha, int wraparound);
 141 void graphics_overlay_resize(struct graphics *this_, struct point *p, int w, int h, int alpha, int wraparound);
 142 void graphics_init(struct graphics *this_);
 143 void *graphics_get_data(struct graphics *this_, char *type);
 144 void graphics_add_callback(struct graphics *this_, struct callback *cb);
 145 void graphics_remove_callback(struct graphics *this_, struct callback *cb);
 146 struct graphics_font *graphics_font_new(struct graphics *gra, int size, int flags);
 147 void graphics_font_destroy_all(struct graphics *gra);
 148 struct graphics_gc *graphics_gc_new(struct graphics *gra);
 149 void graphics_gc_destroy(struct graphics_gc *gc);
 150 void graphics_gc_set_foreground(struct graphics_gc *gc, struct color *c);
 151 void graphics_gc_set_background(struct graphics_gc *gc, struct color *c);
 152 void graphics_gc_set_stipple(struct graphics_gc *gc, struct graphics_image *img);
 153 void graphics_gc_set_linewidth(struct graphics_gc *gc, int width);
 154 void graphics_gc_set_dashes(struct graphics_gc *gc, int width, int offset, unsigned char dash_list[], int n);
 155 struct graphics_image *graphics_image_new_scaled(struct graphics *gra, char *path, int w, int h);
 156 struct graphics_image *graphics_image_new_scaled_rotated(struct graphics *gra, char *path, int w, int h, int rotate);
 157 struct graphics_image *graphics_image_new(struct graphics *gra, char *path);
 158 void graphics_image_free(struct graphics *gra, struct graphics_image *img);
 159 void graphics_draw_restore(struct graphics *this_, struct point *p, int w, int h);
 160 void graphics_draw_mode(struct graphics *this_, enum draw_mode_num mode);
 161 void graphics_draw_lines(struct graphics *this_, struct graphics_gc *gc, struct point *p, int count);
 162 void graphics_draw_circle(struct graphics *this_, struct graphics_gc *gc, struct point *p, int r);
 163 void graphics_draw_rectangle(struct graphics *this_, struct graphics_gc *gc, struct point *p, int w, int h);
 164 void graphics_draw_rectangle_rounded(struct graphics *this_, struct graphics_gc *gc, struct point *plu, int w, int h, int r, int fill);
 165 void graphics_draw_text(struct graphics *this_, struct graphics_gc *gc1, struct graphics_gc *gc2, struct graphics_font *font, char *text, struct point *p, int dx, int dy);
 166 void graphics_get_text_bbox(struct graphics *this_, struct graphics_font *font, char *text, int dx, int dy, struct point *ret, int estimate);
 167 void graphics_overlay_disable(struct graphics *this_, int disable);
 168 void graphics_draw_image(struct graphics *this_, struct graphics_gc *gc, struct point *p, struct graphics_image *img);
 169 int graphics_draw_drag(struct graphics *this_, struct point *p);
 170 void graphics_background_gc(struct graphics *this_, struct graphics_gc *gc);
 171 char *graphics_icon_path(char *icon);
 172 void graphics_draw_itemgra(struct graphics *gra, struct itemgra *itm, struct transformation *t);
 173 void graphics_displaylist_draw(struct graphics *gra, struct displaylist *displaylist, struct transformation *trans, struct layout *l, int callback);
 174 void graphics_draw(struct graphics *gra, struct displaylist *displaylist, struct mapset *mapset, struct transformation *trans, struct layout *l, int async, struct callback *cb, int flags);
 175 int graphics_draw_cancel(struct graphics *gra, struct displaylist *displaylist);
 176 struct displaylist_handle *graphics_displaylist_open(struct displaylist *displaylist);
 177 struct displayitem *graphics_displaylist_next(struct displaylist_handle *dlh);
 178 void graphics_displaylist_close(struct displaylist_handle *dlh);
 179 struct displaylist *graphics_displaylist_new(void);
 180 struct item *graphics_displayitem_get_item(struct displayitem *di);
 181 char *graphics_displayitem_get_label(struct displayitem *di);
 182 int graphics_displayitem_within_dist(struct displaylist *displaylist, struct displayitem *di, struct point *p, int dist);
 183 void graphics_add_selection(struct graphics *gra, struct item *item, struct displaylist *dl);
 184 void graphics_remove_selection(struct graphics *gra, struct item *item, struct displaylist *dl);
 185 void graphics_clear_selection(struct graphics *gra, struct displaylist *dl);
 186 /* end of prototypes */
 187 #ifdef __cplusplus
 188 }
 189 #endif
 190
 191 #endif
 192