/usr/include/ganv-1/ganv/item.h is in libganv-dev 1.4.2~dfsg0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 | /* This file is part of Ganv.
* Copyright 2007-2014 David Robillard <http://drobilla.net>
*
* Ganv 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 3 of the License, or any later version.
*
* Ganv 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 details.
*
* You should have received a copy of the GNU General Public License along
* with Ganv. If not, see <http://www.gnu.org/licenses/>.
*/
/* Based on GnomeCanvas, by Federico Mena <federico@nuclecu.unam.mx>
* and Raph Levien <raph@gimp.org>
* Copyright 1997-2000 Free Software Foundation
*/
#ifndef GANV_ITEM_H
#define GANV_ITEM_H
#include <stdarg.h>
#include <cairo.h>
#include <gtk/gtk.h>
G_BEGIN_DECLS
struct _GanvCanvas;
typedef struct _GanvItem GanvItem;
typedef struct _GanvItemImpl GanvItemImpl;
typedef struct _GanvItemClass GanvItemClass;
/* Object flags for items */
enum {
GANV_ITEM_REALIZED = 1 << 1,
GANV_ITEM_MAPPED = 1 << 2,
GANV_ITEM_ALWAYS_REDRAW = 1 << 3,
GANV_ITEM_VISIBLE = 1 << 4,
GANV_ITEM_NEED_UPDATE = 1 << 5,
GANV_ITEM_NEED_VIS = 1 << 6,
};
#define GANV_TYPE_ITEM (ganv_item_get_type())
#define GANV_ITEM(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), GANV_TYPE_ITEM, GanvItem))
#define GANV_ITEM_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), GANV_TYPE_ITEM, GanvItemClass))
#define GANV_IS_ITEM(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), GANV_TYPE_ITEM))
#define GANV_IS_ITEM_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), GANV_TYPE_ITEM))
#define GANV_ITEM_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), GANV_TYPE_ITEM, GanvItemClass))
struct _GanvItem {
GtkObject object;
GanvItemImpl* impl;
};
struct _GanvItemClass {
GtkObjectClass parent_class;
/* Add a child to this item (optional). */
void (*add)(GanvItem* item, GanvItem* child);
/* Remove a child from this item (optional). */
void (*remove)(GanvItem* item, GanvItem* child);
/* Tell the item to update itself.
*
* The flags are from the update flags defined above. The item should
* update its internal state from its queued state, and recompute and
* request its repaint area. The update method also recomputes the
* bounding box of the item.
*/
void (*update)(GanvItem* item, int flags);
/* Realize an item (create GCs, etc.). */
void (*realize)(GanvItem* item);
/* Unrealize an item. */
void (*unrealize)(GanvItem* item);
/* Map an item - normally only need by items with their own GdkWindows. */
void (*map)(GanvItem* item);
/* Unmap an item */
void (*unmap)(GanvItem* item);
/* Draw an item of this type.
*
* (cx, cy) and (width, height) describe the rectangle being drawn in
* world-relative coordinates.
*/
void (*draw)(GanvItem* item,
cairo_t* cr,
double cx,
double cy,
double cw,
double ch);
/* Calculate the distance from an item to the specified point.
*
* It also returns a canvas item which is actual item the point is within,
* which may not be equal to @item if @item has children.
* (x, y) are item-relative coordinates.
*/
double (*point)(GanvItem* item,
double x,
double y,
GanvItem** actual_item);
/* Fetch the item's bounding box (need not be exactly tight).
*
* This should be in item-relative coordinates.
*/
void (*bounds)(GanvItem* item, double* x1, double* y1, double* x2, double* y2);
/* Signal: an event occurred for an item of this type.
*
* The (x, y) coordinates are in the canvas world coordinate system.
*/
gboolean (*event)(GanvItem* item, GdkEvent* event);
/* Reserved for future expansion */
gpointer spare_vmethods[4];
};
GType ganv_item_get_type(void) G_GNUC_CONST;
GanvItem* ganv_item_new(GanvItem* parent, GType type,
const gchar* first_arg_name, ...);
void ganv_item_construct(GanvItem* item, GanvItem* parent,
const gchar* first_arg_name, va_list args);
void ganv_item_set(GanvItem* item, const gchar* first_arg_name, ...);
void ganv_item_set_valist(GanvItem* item,
const gchar* first_arg_name, va_list args);
/**
* ganv_item_get_canvas:
* @item: The item.
*
* Return value: (transfer none): The canvas @item is on.
*/
struct _GanvCanvas* ganv_item_get_canvas(GanvItem* item);
/**
* ganv_item_get_parent:
* @item: The item.
*
* Return value: (transfer none): The parent of @item.
*/
GanvItem* ganv_item_get_parent(GanvItem* item);
void ganv_item_raise(GanvItem* item);
void ganv_item_lower(GanvItem* item);
void ganv_item_move(GanvItem* item, double dx, double dy);
void ganv_item_show(GanvItem* item);
void ganv_item_hide(GanvItem* item);
void ganv_item_i2w(GanvItem* item, double* x, double* y);
void ganv_item_w2i(GanvItem* item, double* x, double* y);
void ganv_item_grab_focus(GanvItem* item);
void ganv_item_get_bounds(GanvItem* item,
double* x1, double* y1, double* x2, double* y2);
void ganv_item_request_update(GanvItem* item);
G_END_DECLS
#endif /* GANV_ITEM_H */
|