1
0
mirror of git://projects.qi-hardware.com/fped.git synced 2024-12-22 23:28:38 +02:00
fped/gui_over.h
werner 39690c9cb2 - to simplify communication between the various modules, renamed "ctx" to
draw_ctx, moved it to gui_util.c, and made it a global variable
- moved drawing logic for hovering and dragging into dedicated state machine
  in gui_over.c
- hovering now uses a pixmap to restore the background instead of redrawing
- moved hover drawing functions from gui_inst.c to gui_tools.c
- made hover circle thicker



git-svn-id: http://svn.openmoko.org/trunk/eda/fped@5405 99fdad57-331a-0410-800a-d7fa5415bdb3
2009-08-08 14:11:26 +00:00

80 lines
2.2 KiB
C

/*
* gui_over.h - GUI, canvas overlays
*
* Written 2009 by Werner Almesberger
* Copyright 2009 by Werner Almesberger
*
* This program 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.
*/
#ifndef GUI_OVER_H
#define GUI_OVER_H
/*
* Dynamic changes around the pointer are affected by the following events:
*
* - enter: enter a circle where we're hovering
* - leave: leave a circle where we've been hovering
* - begin: begin dragging
* - move: move with or without dragging
* - end: end dragging
* - reset: we got a redraw, just drop everything
*
* We have the following states:
*
* - NOTHING: neither hovering nor dragging
* - HOVER: we're hovering but not dragging
* - DRAG: we're dragging but not hovering, e.g., when searching for a place to
* end the drag
* - BOTH: we're dragging and hovering
*
* Both drag and hover save the area being changed and restore it after a
* change. We have to make sure the save/draw/restore operations are properly
* sequenced. We call the hover area H, the drag area D. This is the state
* machine that does the sequencing:
*
* NOTHING (saved: -)
* enter -> save H, draw H, HOVER
* begin -> save D, draw D, DRAG
* move -> NOTHING
* reset -> NOTHING
*
* HOVER: (saved: H)
* leave -> restore H, NOTHING
* begin -> save D, draw D, BOTH
* move -> HOVER
* reset -> drop H, NOTHING
*
* DRAG: (saved: D)
* end -> restore D, NOTHING
* enter -> restore D, save H, draw H, save D, draw D, BOTH
* move -> restore D, update, save D, draw D, DRAG
* reset -> drop D, NOTHING
*
* BOTH: (saved: D on top of H)
* end -> restore D, HOVER
* leave -> restore D, restore H, save D, draw D, DRAG
* move -> restore D, update, save D, draw D, BOTH
* reset -> drop D, drop H, NOTHING
*/
#include "coord.h"
#include "inst.h"
void over_enter(struct pix_buf *(*save_and_draw)(void *user), void *user);
void over_leave(void);
void over_begin(struct pix_buf *(*save_and_draw)(void *user, struct coord pos),
void *user, struct coord pos);
void over_move(struct coord pos);
void over_end(void);
void over_reset(void);
#endif /* !GUI_OVER_H */