/* roadmap_canvas.h - manage the roadmap canvas that is used to draw the map. * * LICENSE: * * Copyright 2002 Pascal F. Martin * * This file is part of RoadMap. * * RoadMap is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * RoadMap is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with RoadMap; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA * * DESCRIPTION: * * This defines a toolkit-independent interface for the canvas used * to draw the map. Even while the canvas implementation is highly * toolkit-dependent, this interface is not. */ #ifndef INCLUDE__ROADMAP_CANVAS__H #define INCLUDE__ROADMAP_CANVAS__H #include "roadmap_gui.h" enum { IMAGE_NORMAL, IMAGE_SELECTED }; struct roadmap_canvas_pen; typedef struct roadmap_canvas_pen *RoadMapPen; struct roadmap_canvas_image; typedef struct roadmap_canvas_image *RoadMapImage; typedef void (*RoadMapCanvasMouseHandler) (int button, RoadMapGuiPoint *point); typedef void (*RoadMapCanvasConfigureHandler) (void); void roadmap_canvas_register_button_pressed_handler (RoadMapCanvasMouseHandler handler); void roadmap_canvas_register_button_released_handler (RoadMapCanvasMouseHandler handler); void roadmap_canvas_register_mouse_move_handler (RoadMapCanvasMouseHandler handler); void roadmap_canvas_register_mouse_scroll_handler (RoadMapCanvasMouseHandler handler); void roadmap_canvas_register_configure_handler (RoadMapCanvasConfigureHandler handler); /* This call is used to get the pixel's size of a given text (if it * was going to be drawn on the screen). * It is used to compute the positioning of things on the screen, * according to the current font. */ void roadmap_canvas_get_text_extents (const char *text, int size, int *width, int *ascent, int *descent, int *can_tilt); /* This call creates a new pen. If the pen already exists, * it should not be re-created. * The new (or existing) pen becomes selected (see below). */ RoadMapPen roadmap_canvas_create_pen (const char *name); /* This calls make the given pen the default context when drawing * on the canvas. */ RoadMapPen roadmap_canvas_select_pen (RoadMapPen pen); /* Set properties for the current pen: * This is mostly performed once for each pen (at initialization), * althrough the thickness may be changed when the zoom level changes. */ void roadmap_canvas_set_foreground (const char *color); void roadmap_canvas_set_thickness (int thickness); int roadmap_canvas_get_thickness (RoadMapPen pen); void roadmap_canvas_set_opacity (int opacity); /* The functions below draw in the selected buffer using the selected pen: */ void roadmap_canvas_erase (void); /* Draw text on the screen at a given position. * A text can be aligned in 4 different ways, defined by which text "corner" * is the position related to. * The idea here is to align text relative to any of the four corners of * the canvas: we need to align any side of the text with the canvas' * border. */ #define ROADMAP_CANVAS_LEFT 0 #define ROADMAP_CANVAS_RIGHT 1 #define ROADMAP_CANVAS_TOP 0 #define ROADMAP_CANVAS_BOTTOM 2 #define ROADMAP_CANVAS_CENTER_X 4 #define ROADMAP_CANVAS_CENTER_Y 8 #define ROADMAP_CANVAS_CENTER (ROADMAP_CANVAS_CENTER_X|ROADMAP_CANVAS_CENTER_Y) #define ROADMAP_CANVAS_CENTER_BOTTOM (ROADMAP_CANVAS_CENTER_X|ROADMAP_CANVAS_BOTTOM) #define ROADMAP_CANVAS_CENTER_TOP (ROADMAP_CANVAS_CENTER_X|ROADMAP_CANVAS_TOP) #define ROADMAP_CANVAS_TOPLEFT (ROADMAP_CANVAS_TOP|ROADMAP_CANVAS_LEFT) #define ROADMAP_CANVAS_TOPRIGHT (ROADMAP_CANVAS_TOP|ROADMAP_CANVAS_RIGHT) #define ROADMAP_CANVAS_BOTTOMRIGHT (ROADMAP_CANVAS_BOTTOM|ROADMAP_CANVAS_RIGHT) #define ROADMAP_CANVAS_BOTTOMLEFT (ROADMAP_CANVAS_BOTTOM|ROADMAP_CANVAS_LEFT) #define CANVAS_DRAW_FAST 0x1 #define CANVAS_NO_ROTATE 0x2 #define CANVAS_COPY_NORMAL 0x1 #define CANVAS_COPY_BLEND 0x2 void roadmap_canvas_draw_string (RoadMapGuiPoint *position, int corner, const char *text); void roadmap_canvas_draw_string_angle (RoadMapGuiPoint *position, RoadMapGuiPoint *center, int angle, const char *text); void roadmap_canvas_draw_multiple_points (int count, RoadMapGuiPoint *points); void roadmap_canvas_draw_multiple_lines (int count, int *lines, RoadMapGuiPoint *points, int fast_draw); void roadmap_canvas_draw_multiple_polygons (int count, int *polygons, RoadMapGuiPoint *points, int filled, int fast_draw); void roadmap_canvas_draw_multiple_circles (int count, RoadMapGuiPoint *centers, int *radius, int filled, int fast_draw); int roadmap_canvas_width (void); int roadmap_canvas_height (void); /* This primitive causes the "exposed" drawing buffer to appear on the screen. */ void roadmap_canvas_refresh (void); void roadmap_canvas_save_screenshot (const char* filename); int roadmap_canvas_image_width (const RoadMapImage image); int roadmap_canvas_image_height (const RoadMapImage image); RoadMapImage roadmap_canvas_load_image (const char *path, const char* file_name); void roadmap_canvas_draw_image (RoadMapImage image, RoadMapGuiPoint *pos, int opacity, int mode); void roadmap_canvas_copy_image (RoadMapImage dst_image, const RoadMapGuiPoint *pos, const RoadMapGuiRect *rect, RoadMapImage src_image, int mode); void roadmap_canvas_draw_image_text (RoadMapImage image, const RoadMapGuiPoint *position, int size, const char *text); #endif // INCLUDE__ROADMAP_CANVAS__H