src/display/nr-arena-item.h

   1 #ifndef __NR_ARENA_ITEM_H__
   2 #define __NR_ARENA_ITEM_H__
   3
   4 /*
   5  * RGBA display list system for inkscape
   6  *
   7  * Author:
   8  *   Lauris Kaplinski <lauris@kaplinski.com>
   9  *
  10  * Copyright (C) 2001-2002 Lauris Kaplinski
  11  * Copyright (C) 2001 Ximian, Inc.
  12  *
  13  * Released under GNU GPL, read the file 'COPYING' for more information
  14  */
  15
  16 #define NR_TYPE_ARENA_ITEM (nr_arena_item_get_type ())
  17 #define NR_ARENA_ITEM(o) (NR_CHECK_INSTANCE_CAST ((o), NR_TYPE_ARENA_ITEM, NRArenaItem))
  18 #define NR_IS_ARENA_ITEM(o) (NR_CHECK_INSTANCE_TYPE ((o), NR_TYPE_ARENA_ITEM))
  19
  20 #define NR_ARENA_ITEM_VIRTUAL(i,m) (((NRArenaItemClass *) NR_OBJECT_GET_CLASS (i))->m)
  21
  22 /*
  23  * NRArenaItem state flags
  24  */
  25
  26 /*
  27  * NR_ARENA_ITEM_STATE_INVALID
  28  *
  29  * If set or retuned indicates, that given object is in error.
  30  * Calling method has to return immediately, with appropriate
  31  * error flag.
  32  */
  33
  34 #define NR_ARENA_ITEM_STATE_INVALID  (1 << 0)
  35
  36
  37 #define NR_ARENA_ITEM_STATE_BBOX     (1 << 1)
  38 #define NR_ARENA_ITEM_STATE_COVERAGE (1 << 2)
  39 #define NR_ARENA_ITEM_STATE_DRAFT    (1 << 3)
  40 #define NR_ARENA_ITEM_STATE_RENDER   (1 << 4)
  41 #define NR_ARENA_ITEM_STATE_CLIP     (1 << 5)
  42 #define NR_ARENA_ITEM_STATE_MASK     (1 << 6)
  43 #define NR_ARENA_ITEM_STATE_PICK     (1 << 7)
  44 #define NR_ARENA_ITEM_STATE_IMAGE    (1 << 8)
  45
  46 #define NR_ARENA_ITEM_STATE_NONE  0x0000
  47 #define NR_ARENA_ITEM_STATE_ALL   0x01fe
  48
  49 #define NR_ARENA_ITEM_STATE(i,s) (NR_ARENA_ITEM (i)->state & (s))
  50 #define NR_ARENA_ITEM_SET_STATE(i,s) (NR_ARENA_ITEM (i)->state |= (s))
  51 #define NR_ARENA_ITEM_UNSET_STATE(i,s) (NR_ARENA_ITEM (i)->state &= ~(s))
  52
  53 #define NR_ARENA_ITEM_RENDER_NO_CACHE (1 << 0)
  54
  55 #include <2geom/matrix.h>
  56 #include <libnr/nr-rect-l.h>
  57 #include <libnr/nr-pixblock.h>
  58 #include <libnr/nr-object.h>
  59 #include "gc-soft-ptr.h"
  60 #include "nr-arena-forward.h"
  61 #include "display/nr-filter.h"
  62 #include <cairo.h>
  63
  64 struct NRGC {
  65     NRGC(NRGC const *p) : parent(p) {}
  66     NRGC const *parent;
  67     Geom::Matrix transform;
  68 };
  69
  70 struct NRArenaItem : public NRObject {
  71
  72     NRArena *arena;
  73     Inkscape::GC::soft_ptr<NRArenaItem> parent;
  74     NRArenaItem *next;
  75     Inkscape::GC::soft_ptr<NRArenaItem> prev;
  76
  77     /* Item state */
  78     unsigned int state : 16;
  79     unsigned int propagate : 1;
  80     unsigned int sensitive : 1;
  81     unsigned int visible : 1;
  82     /* Whether items renders opacity itself */
  83     unsigned int render_opacity : 1;
  84     /* Opacity itself */
  85     unsigned int opacity : 8;
  86
  87     /* Key for secondary rendering */
  88     unsigned int key;
  89
  90     /* BBox in grid coordinates */
  91     NRRectL bbox;
  92     /* Redraw area in grid coordinates = bbox filter-enlarged and clipped/masked */
  93     NRRectL drawbox;
  94     /* BBox in item coordinates - this should be a bounding box as
  95      * specified in SVG standard. Required by filters. */
  96     Geom::OptRect item_bbox;
  97     /* Our affine */
  98     Geom::Matrix *transform;
  99     /* Clip item */
 100     NRArenaItem *clip;
 101     /* Mask item */
 102     NRArenaItem *mask;
 103     /* Filter to be applied after rendering this object, NULL if none */
 104     Inkscape::Filters::Filter *filter;
 105     /* Rendered buffer */
 106     unsigned char *px;
 107
 108     /* Single data member */
 109     void *data;
 110
 111     /* Current Transformation Matrix */
 112     Geom::Matrix ctm;
 113
 114     /* These hold background buffer state for filter rendering */
 115     NRPixBlock *background_pb;
 116     bool background_new;
 117
 118     void init(NRArena *arena) {
 119         this->arena = arena;
 120     }
 121 };
 122
 123 struct NRArenaItemClass : public NRObjectClass {
 124     NRArenaItem * (* children) (NRArenaItem *item);
 125     NRArenaItem * (* last_child) (NRArenaItem *item);
 126     void (* add_child) (NRArenaItem *item, NRArenaItem *child, NRArenaItem *ref);
 127     void (* remove_child) (NRArenaItem *item, NRArenaItem *child);
 128     void (* set_child_position) (NRArenaItem *item, NRArenaItem *child, NRArenaItem *ref);
 129
 130     unsigned int (* update) (NRArenaItem *item, NRRectL *area, NRGC *gc, unsigned int state, unsigned int reset);
 131     unsigned int (* render) (cairo_t *ct, NRArenaItem *item, NRRectL *area, NRPixBlock *pb, unsigned int flags);
 132     unsigned int (* clip) (NRArenaItem *item, NRRectL *area, NRPixBlock *pb);
 133     NRArenaItem * (* pick) (NRArenaItem *item, Geom::Point p, double delta, unsigned int sticky);
 134 };
 135
 136 #define NR_ARENA_ITEM_ARENA(ai) (((NRArenaItem *) (ai))->arena)
 137
 138 NRType nr_arena_item_get_type (void);
 139
 140 NRArenaItem *nr_arena_item_ref (NRArenaItem *item);
 141 NRArenaItem *nr_arena_item_unref (NRArenaItem *item);
 142
 143 NRArenaItem *nr_arena_item_children (NRArenaItem *item);
 144 NRArenaItem *nr_arena_item_last_child (NRArenaItem *item);
 145 void nr_arena_item_add_child (NRArenaItem *item, NRArenaItem *child, NRArenaItem *ref);
 146 void nr_arena_item_remove_child (NRArenaItem *item, NRArenaItem *child);
 147 void nr_arena_item_set_child_position (NRArenaItem *item, NRArenaItem *child, NRArenaItem *ref);
 148
 149 /*
 150  * Invoke update to given state, if item is inside area
 151  *
 152  * area == NULL is infinite
 153  * gc is PARENT gc for invoke, CHILD gc in corresponding virtual method
 154  * state - requested to state (bitwise or of requested flags)
 155  * reset - reset to state (bitwise or of flags to reset)
 156  */
 157
 158 unsigned int nr_arena_item_invoke_update (NRArenaItem *item, NRRectL *area, NRGC *gc, unsigned int state, unsigned int reset);
 159
 160 unsigned int nr_arena_item_invoke_render(cairo_t *ct, NRArenaItem *item, NRRectL const *area, NRPixBlock *pb, unsigned int flags);
 161
 162 unsigned int nr_arena_item_invoke_clip (NRArenaItem *item, NRRectL *area, NRPixBlock *pb);
 163 NRArenaItem *nr_arena_item_invoke_pick (NRArenaItem *item, Geom::Point p, double delta, unsigned int sticky);
 164
 165 void nr_arena_item_request_update (NRArenaItem *item, unsigned int reset, unsigned int propagate);
 166 void nr_arena_item_request_render (NRArenaItem *item);
 167
 168 /* Public */
 169
 170 NRArenaItem *nr_arena_item_unparent (NRArenaItem *item);
 171
 172 void nr_arena_item_append_child (NRArenaItem *parent, NRArenaItem *child);
 173
 174 void nr_arena_item_set_transform(NRArenaItem *item, Geom::Matrix const &transform);
 175 void nr_arena_item_set_transform(NRArenaItem *item, Geom::Matrix const *transform);
 176 void nr_arena_item_set_opacity (NRArenaItem *item, double opacity);
 177 void nr_arena_item_set_sensitive (NRArenaItem *item, unsigned int sensitive);
 178 void nr_arena_item_set_visible (NRArenaItem *item, unsigned int visible);
 179 void nr_arena_item_set_clip (NRArenaItem *item, NRArenaItem *clip);
 180 void nr_arena_item_set_mask (NRArenaItem *item, NRArenaItem *mask);
 181 void nr_arena_item_set_order (NRArenaItem *item, int order);
 182 void nr_arena_item_set_item_bbox (NRArenaItem *item, Geom::OptRect &bbox);
 183
 184 NRPixBlock *nr_arena_item_get_background (NRArenaItem const *item);
 185
 186 /* Helpers */
 187
 188 NRArenaItem *nr_arena_item_attach (NRArenaItem *parent, NRArenaItem *child, NRArenaItem *prev, NRArenaItem *next);
 189 NRArenaItem *nr_arena_item_detach (NRArenaItem *parent, NRArenaItem *child);
 190
 191 #define NR_ARENA_ITEM_SET_DATA(i,v) (((NRArenaItem *) (i))->data = (v))
 192 #define NR_ARENA_ITEM_GET_DATA(i) (((NRArenaItem *) (i))->data)
 193
 194 #define NR_ARENA_ITEM_SET_KEY(i,k) (((NRArenaItem *) (i))->key = (k))
 195 #define NR_ARENA_ITEM_GET_KEY(i) (((NRArenaItem *) (i))->key)
 196
 197
 198 #endif /* !__NR_ARENA_ITEM_H__ */
 199
 200 /*
 201   Local Variables:
 202   mode:c++
 203   c-file-style:"stroustrup"
 204   c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
 205   indent-tabs-mode:nil
 206   fill-column:99
 207   End:
 208 */
 209 // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:fileencoding=utf-8:textwidth=99 :