1 #define __SP_FLOOD_CONTEXT_C__
3 /** \file
4 * Bucket fill drawing context, works by bitmap filling an area on a rendered version of the current display and then tracing the result using potrace.
5 *
6 * Author:
7 * Lauris Kaplinski <lauris@kaplinski.com>
8 * bulia byak <buliabyak@users.sf.net>
9 * John Bintz <jcoswell@coswellproductions.org>
10 *
11 * Copyright (C) 2006 Johan Engelen <johan@shouraizou.nl>
12 * Copyright (C) 2000-2005 authors
13 * Copyright (C) 2000-2001 Ximian, Inc.
14 *
15 * Released under GNU GPL, read the file 'COPYING' for more information
16 */
18 #include "config.h"
20 #include <gdk/gdkkeysyms.h>
21 #include <queue>
22 #include <deque>
24 #include "macros.h"
25 #include "display/sp-canvas.h"
26 #include "document.h"
27 #include "sp-namedview.h"
28 #include "sp-object.h"
29 #include "sp-rect.h"
30 #include "selection.h"
31 #include "desktop-handles.h"
32 #include "desktop.h"
33 #include "desktop-style.h"
34 #include "message-stack.h"
35 #include "message-context.h"
36 #include "pixmaps/cursor-paintbucket.xpm"
37 #include "flood-context.h"
38 #include "sp-metrics.h"
39 #include <glibmm/i18n.h>
40 #include "object-edit.h"
41 #include "xml/repr.h"
42 #include "xml/node-event-vector.h"
43 #include "prefs-utils.h"
44 #include "context-fns.h"
45 #include "rubberband.h"
47 #include "display/nr-arena-item.h"
48 #include "display/nr-arena.h"
49 #include "display/nr-arena-image.h"
50 #include "display/canvas-arena.h"
51 #include "libnr/nr-pixops.h"
52 #include "libnr/nr-matrix-translate-ops.h"
53 #include "libnr/nr-scale-ops.h"
54 #include "libnr/nr-scale-translate-ops.h"
55 #include "libnr/nr-translate-matrix-ops.h"
56 #include "libnr/nr-translate-scale-ops.h"
57 #include "libnr/nr-matrix-ops.h"
58 #include "sp-item.h"
59 #include "sp-root.h"
60 #include "sp-defs.h"
61 #include "sp-path.h"
62 #include "splivarot.h"
63 #include "livarot/Path.h"
64 #include "livarot/Shape.h"
65 #include "libnr/n-art-bpath.h"
66 #include "svg/svg.h"
67 #include "color.h"
69 #include "trace/trace.h"
70 #include "trace/imagemap.h"
71 #include "trace/potrace/inkscape-potrace.h"
73 static void sp_flood_context_class_init(SPFloodContextClass *klass);
74 static void sp_flood_context_init(SPFloodContext *flood_context);
75 static void sp_flood_context_dispose(GObject *object);
77 static void sp_flood_context_setup(SPEventContext *ec);
79 static gint sp_flood_context_root_handler(SPEventContext *event_context, GdkEvent *event);
80 static gint sp_flood_context_item_handler(SPEventContext *event_context, SPItem *item, GdkEvent *event);
82 static void sp_flood_finish(SPFloodContext *rc);
84 static SPEventContextClass *parent_class;
87 GtkType sp_flood_context_get_type()
88 {
89 static GType type = 0;
90 if (!type) {
91 GTypeInfo info = {
92 sizeof(SPFloodContextClass),
93 NULL, NULL,
94 (GClassInitFunc) sp_flood_context_class_init,
95 NULL, NULL,
96 sizeof(SPFloodContext),
97 4,
98 (GInstanceInitFunc) sp_flood_context_init,
99 NULL, /* value_table */
100 };
101 type = g_type_register_static(SP_TYPE_EVENT_CONTEXT, "SPFloodContext", &info, (GTypeFlags) 0);
102 }
103 return type;
104 }
106 static void sp_flood_context_class_init(SPFloodContextClass *klass)
107 {
108 GObjectClass *object_class = (GObjectClass *) klass;
109 SPEventContextClass *event_context_class = (SPEventContextClass *) klass;
111 parent_class = (SPEventContextClass *) g_type_class_peek_parent(klass);
113 object_class->dispose = sp_flood_context_dispose;
115 event_context_class->setup = sp_flood_context_setup;
116 event_context_class->root_handler = sp_flood_context_root_handler;
117 event_context_class->item_handler = sp_flood_context_item_handler;
118 }
120 static void sp_flood_context_init(SPFloodContext *flood_context)
121 {
122 SPEventContext *event_context = SP_EVENT_CONTEXT(flood_context);
124 event_context->cursor_shape = cursor_paintbucket_xpm;
125 event_context->hot_x = 11;
126 event_context->hot_y = 30;
127 event_context->xp = 0;
128 event_context->yp = 0;
129 event_context->tolerance = 4;
130 event_context->within_tolerance = false;
131 event_context->item_to_select = NULL;
133 event_context->shape_repr = NULL;
134 event_context->shape_knot_holder = NULL;
136 flood_context->item = NULL;
138 new (&flood_context->sel_changed_connection) sigc::connection();
139 }
141 static void sp_flood_context_dispose(GObject *object)
142 {
143 SPFloodContext *rc = SP_FLOOD_CONTEXT(object);
144 SPEventContext *ec = SP_EVENT_CONTEXT(object);
146 rc->sel_changed_connection.disconnect();
147 rc->sel_changed_connection.~connection();
149 /* fixme: This is necessary because we do not grab */
150 if (rc->item) {
151 sp_flood_finish(rc);
152 }
154 if (ec->shape_repr) { // remove old listener
155 sp_repr_remove_listener_by_data(ec->shape_repr, ec);
156 Inkscape::GC::release(ec->shape_repr);
157 ec->shape_repr = 0;
158 }
160 if (rc->_message_context) {
161 delete rc->_message_context;
162 }
164 G_OBJECT_CLASS(parent_class)->dispose(object);
165 }
167 static Inkscape::XML::NodeEventVector ec_shape_repr_events = {
168 NULL, /* child_added */
169 NULL, /* child_removed */
170 ec_shape_event_attr_changed,
171 NULL, /* content_changed */
172 NULL /* order_changed */
173 };
175 /**
176 \brief Callback that processes the "changed" signal on the selection;
177 destroys old and creates new knotholder
178 */
179 void sp_flood_context_selection_changed(Inkscape::Selection *selection, gpointer data)
180 {
181 SPFloodContext *rc = SP_FLOOD_CONTEXT(data);
182 SPEventContext *ec = SP_EVENT_CONTEXT(rc);
184 if (ec->shape_repr) { // remove old listener
185 sp_repr_remove_listener_by_data(ec->shape_repr, ec);
186 Inkscape::GC::release(ec->shape_repr);
187 ec->shape_repr = 0;
188 }
190 SPItem *item = selection->singleItem();
191 if (item) {
192 Inkscape::XML::Node *shape_repr = SP_OBJECT_REPR(item);
193 if (shape_repr) {
194 ec->shape_repr = shape_repr;
195 Inkscape::GC::anchor(shape_repr);
196 sp_repr_add_listener(shape_repr, &ec_shape_repr_events, ec);
197 }
198 }
199 }
201 static void sp_flood_context_setup(SPEventContext *ec)
202 {
203 SPFloodContext *rc = SP_FLOOD_CONTEXT(ec);
205 if (((SPEventContextClass *) parent_class)->setup) {
206 ((SPEventContextClass *) parent_class)->setup(ec);
207 }
209 SPItem *item = sp_desktop_selection(ec->desktop)->singleItem();
210 if (item) {
211 Inkscape::XML::Node *shape_repr = SP_OBJECT_REPR(item);
212 if (shape_repr) {
213 ec->shape_repr = shape_repr;
214 Inkscape::GC::anchor(shape_repr);
215 sp_repr_add_listener(shape_repr, &ec_shape_repr_events, ec);
216 }
217 }
219 rc->sel_changed_connection.disconnect();
220 rc->sel_changed_connection = sp_desktop_selection(ec->desktop)->connectChanged(
221 sigc::bind(sigc::ptr_fun(&sp_flood_context_selection_changed), (gpointer)rc)
222 );
224 rc->_message_context = new Inkscape::MessageContext((ec->desktop)->messageStack());
226 if (prefs_get_int_attribute("tools.paintbucket", "selcue", 0) != 0) {
227 rc->enableSelectionCue();
228 }
229 }
231 /**
232 * \brief Merge a pixel with the background color.
233 * \param orig The pixel to merge with the background.
234 * \param bg The background color.
235 * \param base The pixel to merge the original and background into.
236 */
237 inline static void
238 merge_pixel_with_background (unsigned char *orig, unsigned char *bg,
239 unsigned char *base)
240 {
241 int precalc_bg_alpha = (255 * (255 - bg[3])) / 255;
243 for (int i = 0; i < 3; i++) {
244 base[i] = precalc_bg_alpha + (bg[i] * bg[3]) / 255;
245 base[i] = (base[i] * (255 - orig[3])) / 255 + (orig[i] * orig[3]) / 255;
246 }
247 }
249 /**
250 * \brief Get the pointer to a pixel in a pixel buffer.
251 * \param px The pixel buffer.
252 * \param x The X coordinate.
253 * \param y The Y coordinate.
254 * \param width The width of the pixel buffer.
255 */
256 inline unsigned char * get_pixel(guchar *px, int x, int y, int width) {
257 return px + (x + y * width) * 4;
258 }
260 /**
261 * \brief Generate the list of trace channel selection entries.
262 */
263 GList * flood_channels_dropdown_items_list() {
264 GList *glist = NULL;
266 glist = g_list_append (glist, _("Visible Colors"));
267 glist = g_list_append (glist, _("Red"));
268 glist = g_list_append (glist, _("Green"));
269 glist = g_list_append (glist, _("Blue"));
270 glist = g_list_append (glist, _("Hue"));
271 glist = g_list_append (glist, _("Saturation"));
272 glist = g_list_append (glist, _("Lightness"));
273 glist = g_list_append (glist, _("Alpha"));
275 return glist;
276 }
278 /**
279 * \brief Generate the list of autogap selection entries.
280 */
281 GList * flood_autogap_dropdown_items_list() {
282 GList *glist = NULL;
284 glist = g_list_append (glist, _("None"));
285 glist = g_list_append (glist, _("Small"));
286 glist = g_list_append (glist, _("Medium"));
287 glist = g_list_append (glist, _("Large"));
289 return glist;
290 }
292 /**
293 * \brief Compare a pixel in a pixel buffer with another pixel to determine if a point should be included in the fill operation.
294 * \param check The pixel in the pixel buffer to check.
295 * \param orig The original selected pixel to use as the fill target color.
296 * \param merged_orig_pixel The original pixel merged with the background.
297 * \param dtc The desktop background color.
298 * \param threshold The fill threshold.
299 * \param method The fill method to use as defined in PaintBucketChannels.
300 */
301 static bool compare_pixels(unsigned char *check, unsigned char *orig, unsigned char *merged_orig_pixel, unsigned char *dtc, int threshold, PaintBucketChannels method) {
302 int diff = 0;
303 float hsl_check[3], hsl_orig[3];
305 if ((method == FLOOD_CHANNELS_H) ||
306 (method == FLOOD_CHANNELS_S) ||
307 (method == FLOOD_CHANNELS_L)) {
308 sp_color_rgb_to_hsl_floatv(hsl_check, check[0] / 255.0, check[1] / 255.0, check[2] / 255.0);
309 sp_color_rgb_to_hsl_floatv(hsl_orig, orig[0] / 255.0, orig[1] / 255.0, orig[2] / 255.0);
310 }
312 switch (method) {
313 case FLOOD_CHANNELS_ALPHA:
314 return ((int)abs(check[3] - orig[3]) <= threshold);
315 case FLOOD_CHANNELS_R:
316 return ((int)abs(check[0] - orig[0]) <= threshold);
317 case FLOOD_CHANNELS_G:
318 return ((int)abs(check[1] - orig[1]) <= threshold);
319 case FLOOD_CHANNELS_B:
320 return ((int)abs(check[2] - orig[2]) <= threshold);
321 case FLOOD_CHANNELS_RGB:
322 unsigned char merged_check[3];
324 merge_pixel_with_background(check, dtc, merged_check);
326 for (int i = 0; i < 3; i++) {
327 diff += (int)abs(merged_check[i] - merged_orig_pixel[i]);
328 }
329 return ((diff / 3) <= ((threshold * 3) / 4));
331 case FLOOD_CHANNELS_H:
332 return ((int)(fabs(hsl_check[0] - hsl_orig[0]) * 100.0) <= threshold);
333 case FLOOD_CHANNELS_S:
334 return ((int)(fabs(hsl_check[1] - hsl_orig[1]) * 100.0) <= threshold);
335 case FLOOD_CHANNELS_L:
336 return ((int)(fabs(hsl_check[2] - hsl_orig[2]) * 100.0) <= threshold);
337 }
339 return false;
340 }
342 static inline bool is_pixel_checked(unsigned char *t) { return t[0] == 1; }
343 static inline bool is_pixel_queued(unsigned char *t) { return t[1] == 1; }
344 static inline bool is_pixel_paintability_checked(unsigned char *t) { return t[2] != 0; }
345 static inline bool is_pixel_paintable(unsigned char *t) { return t[2] == 1; }
346 static inline bool is_pixel_colored(unsigned char *t) { return t[3] == 255; }
348 static inline void mark_pixel_checked(unsigned char *t) { t[0] = 1; }
349 static inline void mark_pixel_unchecked(unsigned char *t) { t[0] = 0; }
350 static inline void mark_pixel_queued(unsigned char *t) { t[1] = 1; }
351 static inline void mark_pixel_paintable(unsigned char *t) { t[2] = 1; }
352 static inline void mark_pixel_not_paintable(unsigned char *t) { t[2] = 2; }
353 static inline void mark_pixel_colored(unsigned char *t) { t[3] = 255; }
355 static inline void clear_pixel_paintability(unsigned char *t) { t[2] = 0; }
357 struct bitmap_coords_info {
358 bool is_left;
359 unsigned int x;
360 unsigned int y;
361 int y_limit;
362 unsigned int width;
363 unsigned int height;
364 unsigned int threshold;
365 unsigned int radius;
366 PaintBucketChannels method;
367 unsigned char *dtc;
368 unsigned char *merged_orig_pixel;
369 NR::Rect bbox;
370 NR::Rect screen;
371 unsigned int max_queue_size;
372 unsigned int current_step;
373 };
375 /**
376 * \brief Check if a pixel can be included in the fill.
377 * \param px The rendered pixel buffer to check.
378 * \param trace_t The pixel in the trace pixel buffer to check or mark.
379 * \param x The X coordinate.
380 * \param y The y coordinate.
381 * \param orig_color The original selected pixel to use as the fill target color.
382 * \param bci The bitmap_coords_info structure.
383 */
384 inline static bool check_if_pixel_is_paintable(guchar *px, unsigned char *trace_t, int x, int y, unsigned char *orig_color, bitmap_coords_info bci) {
385 if (is_pixel_paintability_checked(trace_t)) {
386 return is_pixel_paintable(trace_t);
387 } else {
388 unsigned char *t = get_pixel(px, x, y, bci.width);
389 if (compare_pixels(t, orig_color, bci.merged_orig_pixel, bci.dtc, bci.threshold, bci.method)) {
390 mark_pixel_paintable(trace_t);
391 return true;
392 } else {
393 mark_pixel_not_paintable(trace_t);
394 return false;
395 }
396 }
397 }
399 /**
400 * \brief Perform the bitmap-to-vector tracing and place the traced path onto the document.
401 * \param px The trace pixel buffer to trace to SVG.
402 * \param desktop The desktop on which to place the final SVG path.
403 * \param transform The transform to apply to the final SVG path.
404 * \param union_with_selection If true, merge the final SVG path with the current selection.
405 */
406 static void do_trace(bitmap_coords_info bci, guchar *trace_px, SPDesktop *desktop, NR::Matrix transform, bool union_with_selection) {
407 SPDocument *document = sp_desktop_document(desktop);
409 unsigned char *trace_t;
411 GrayMap *gray_map = GrayMapCreate(bci.width, bci.height);
412 for (unsigned int y = 0; y < bci.height ; y++) {
413 trace_t = get_pixel(trace_px, 0, y, bci.width);
414 for (unsigned int x = 0; x < bci.width ; x++) {
415 gray_map->setPixel(gray_map, x, y, is_pixel_colored(trace_t) ? GRAYMAP_BLACK : GRAYMAP_WHITE);
416 trace_t += 4;
417 }
418 }
420 Inkscape::Trace::Potrace::PotraceTracingEngine pte;
421 std::vector<Inkscape::Trace::TracingEngineResult> results = pte.traceGrayMap(gray_map);
422 gray_map->destroy(gray_map);
424 Inkscape::XML::Node *layer_repr = SP_GROUP(desktop->currentLayer())->repr;
425 Inkscape::XML::Document *xml_doc = sp_document_repr_doc(desktop->doc());
427 long totalNodeCount = 0L;
429 double offset = prefs_get_double_attribute("tools.paintbucket", "offset", 0.0);
431 for (unsigned int i=0 ; i<results.size() ; i++) {
432 Inkscape::Trace::TracingEngineResult result = results[i];
433 totalNodeCount += result.getNodeCount();
435 Inkscape::XML::Node *pathRepr = xml_doc->createElement("svg:path");
436 /* Set style */
437 sp_desktop_apply_style_tool (desktop, pathRepr, "tools.paintbucket", false);
439 NArtBpath *bpath = sp_svg_read_path(result.getPathData().c_str());
440 Path *path = bpath_to_Path(bpath);
441 g_free(bpath);
443 if (offset != 0) {
445 Shape *path_shape = new Shape();
447 path->ConvertWithBackData(0.03);
448 path->Fill(path_shape, 0);
449 delete path;
451 Shape *expanded_path_shape = new Shape();
453 expanded_path_shape->ConvertToShape(path_shape, fill_nonZero);
454 path_shape->MakeOffset(expanded_path_shape, offset * desktop->current_zoom(), join_round, 4);
455 expanded_path_shape->ConvertToShape(path_shape, fill_positive);
457 Path *expanded_path = new Path();
459 expanded_path->Reset();
460 expanded_path_shape->ConvertToForme(expanded_path);
461 expanded_path->ConvertEvenLines(1.0);
462 expanded_path->Simplify(1.0);
464 delete path_shape;
465 delete expanded_path_shape;
467 gchar *str = expanded_path->svg_dump_path();
468 if (str && *str) {
469 pathRepr->setAttribute("d", str);
470 g_free(str);
471 } else {
472 desktop->messageStack()->flash(Inkscape::WARNING_MESSAGE, _("<b>Too much inset</b>, the result is empty."));
473 Inkscape::GC::release(pathRepr);
474 g_free(str);
475 return;
476 }
478 delete expanded_path;
480 } else {
481 gchar *str = path->svg_dump_path();
482 delete path;
483 pathRepr->setAttribute("d", str);
484 g_free(str);
485 }
487 layer_repr->addChild(pathRepr, NULL);
489 SPObject *reprobj = document->getObjectByRepr(pathRepr);
490 if (reprobj) {
491 sp_item_write_transform(SP_ITEM(reprobj), pathRepr, transform, NULL);
493 // premultiply the item transform by the accumulated parent transform in the paste layer
494 NR::Matrix local = sp_item_i2doc_affine(SP_GROUP(desktop->currentLayer()));
495 if (!local.test_identity()) {
496 gchar const *t_str = pathRepr->attribute("transform");
497 NR::Matrix item_t (NR::identity());
498 if (t_str)
499 sp_svg_transform_read(t_str, &item_t);
500 item_t *= local.inverse();
501 // (we're dealing with unattached repr, so we write to its attr instead of using sp_item_set_transform)
502 gchar *affinestr=sp_svg_transform_write(item_t);
503 pathRepr->setAttribute("transform", affinestr);
504 g_free(affinestr);
505 }
507 Inkscape::Selection *selection = sp_desktop_selection(desktop);
509 pathRepr->setPosition(-1);
511 if (union_with_selection) {
512 desktop->messageStack()->flashF(Inkscape::WARNING_MESSAGE, ngettext("Area filled, path with <b>%d</b> node created and unioned with selection.","Area filled, path with <b>%d</b> nodes created and unioned with selection.",sp_nodes_in_path(SP_PATH(reprobj))), sp_nodes_in_path(SP_PATH(reprobj)));
513 selection->add(reprobj);
514 sp_selected_path_union_skip_undo();
515 } else {
516 desktop->messageStack()->flashF(Inkscape::WARNING_MESSAGE, ngettext("Area filled, path with <b>%d</b> node created.","Area filled, path with <b>%d</b> nodes created.",sp_nodes_in_path(SP_PATH(reprobj))), sp_nodes_in_path(SP_PATH(reprobj)));
517 selection->set(reprobj);
518 }
520 }
522 Inkscape::GC::release(pathRepr);
524 }
525 }
527 /**
528 * \brief The possible return states of perform_bitmap_scanline_check()
529 */
530 enum ScanlineCheckResult {
531 SCANLINE_CHECK_OK,
532 SCANLINE_CHECK_ABORTED,
533 SCANLINE_CHECK_BOUNDARY
534 };
536 /**
537 * \brief Determine if the provided coordinates are within the pixel buffer limits.
538 * \param x The X coordinate.
539 * \param y The Y coordinate.
540 * \param bci The bitmap_coords_info structure.
541 */
542 inline static bool coords_in_range(unsigned int x, unsigned int y, bitmap_coords_info bci) {
543 return (x < bci.width) &&
544 (y < bci.height);
545 }
547 #define PAINT_DIRECTION_LEFT 1
548 #define PAINT_DIRECTION_RIGHT 2
549 #define PAINT_DIRECTION_UP 4
550 #define PAINT_DIRECTION_DOWN 8
551 #define PAINT_DIRECTION_ALL 15
553 /**
554 * \brief Paint a pixel or a square (if autogap is enabled) on the trace pixel buffer
555 * \param px The rendered pixel buffer to check.
556 * \param trace_px The trace pixel buffer.
557 * \param orig_color The original selected pixel to use as the fill target color.
558 * \param bci The bitmap_coords_info structure.
559 * \param original_point_trace_t The original pixel in the trace pixel buffer to check.
560 */
561 inline static unsigned int paint_pixel(guchar *px, guchar *trace_px, unsigned char *orig_color, bitmap_coords_info bci, unsigned char *original_point_trace_t) {
562 if (bci.radius == 0) {
563 mark_pixel_colored(original_point_trace_t);
564 return PAINT_DIRECTION_ALL;
565 } else {
566 unsigned char *trace_t;
568 bool can_paint_up = true;
569 bool can_paint_down = true;
570 bool can_paint_left = true;
571 bool can_paint_right = true;
573 for (unsigned int ty = bci.y - bci.radius; ty <= bci.y + bci.radius; ty++) {
574 for (unsigned int tx = bci.x - bci.radius; tx <= bci.x + bci.radius; tx++) {
575 if (coords_in_range(tx, ty, bci)) {
576 trace_t = get_pixel(trace_px, tx, ty, bci.width);
577 if (!is_pixel_colored(trace_t)) {
578 if (check_if_pixel_is_paintable(px, trace_t, tx, ty, orig_color, bci)) {
579 mark_pixel_colored(trace_t);
580 } else {
581 if (tx < bci.x) { can_paint_left = false; }
582 if (tx > bci.x) { can_paint_right = false; }
583 if (ty < bci.y) { can_paint_up = false; }
584 if (ty > bci.y) { can_paint_down = false; }
585 }
586 }
587 }
588 }
589 }
591 unsigned int paint_directions = 0;
592 if (can_paint_left) { paint_directions += PAINT_DIRECTION_LEFT; }
593 if (can_paint_right) { paint_directions += PAINT_DIRECTION_RIGHT; }
594 if (can_paint_up) { paint_directions += PAINT_DIRECTION_UP; }
595 if (can_paint_down) { paint_directions += PAINT_DIRECTION_DOWN; }
597 return paint_directions;
598 }
599 }
601 /**
602 * \brief Push a point to be checked onto the bottom of the rendered pixel buffer check queue.
603 * \param fill_queue The fill queue to add the point to.
604 * \param max_queue_size The maximum size of the fill queue.
605 * \param trace_t The trace pixel buffer pixel.
606 * \param x The X coordinate.
607 * \param y The Y coordinate.
608 */
609 static void push_point_onto_queue(std::deque<NR::Point> *fill_queue, unsigned int max_queue_size, unsigned char *trace_t, unsigned int x, unsigned int y) {
610 if (!is_pixel_queued(trace_t)) {
611 if ((fill_queue->size() < max_queue_size)) {
612 fill_queue->push_back(NR::Point(x, y));
613 mark_pixel_queued(trace_t);
614 }
615 }
616 }
618 /**
619 * \brief Shift a point to be checked onto the top of the rendered pixel buffer check queue.
620 * \param fill_queue The fill queue to add the point to.
621 * \param max_queue_size The maximum size of the fill queue.
622 * \param trace_t The trace pixel buffer pixel.
623 * \param x The X coordinate.
624 * \param y The Y coordinate.
625 */
626 static void shift_point_onto_queue(std::deque<NR::Point> *fill_queue, unsigned int max_queue_size, unsigned char *trace_t, unsigned int x, unsigned int y) {
627 if (!is_pixel_queued(trace_t)) {
628 if ((fill_queue->size() < max_queue_size)) {
629 fill_queue->push_front(NR::Point(x, y));
630 mark_pixel_queued(trace_t);
631 }
632 }
633 }
635 /**
636 * \brief Scan a row in the rendered pixel buffer and add points to the fill queue as necessary.
637 * \param fill_queue The fill queue to add the point to.
638 * \param px The rendered pixel buffer.
639 * \param trace_px The trace pixel buffer.
640 * \param orig_color The original selected pixel to use as the fill target color.
641 * \param bci The bitmap_coords_info structure.
642 */
643 static ScanlineCheckResult perform_bitmap_scanline_check(std::deque<NR::Point> *fill_queue, guchar *px, guchar *trace_px, unsigned char *orig_color, bitmap_coords_info bci) {
644 bool aborted = false;
645 bool reached_screen_boundary = false;
646 bool ok;
648 bool keep_tracing;
649 bool initial_paint = true;
651 unsigned char *current_trace_t = get_pixel(trace_px, bci.x, bci.y, bci.width);
652 unsigned int paint_directions;
654 bool currently_painting_top = false;
655 bool currently_painting_bottom = false;
657 unsigned int pix_width = bci.width * 4;
659 unsigned int top_ty = bci.y - 1;
660 unsigned int bottom_ty = bci.y + 1;
662 bool can_paint_top = (top_ty > 0);
663 bool can_paint_bottom = (bottom_ty < bci.height);
665 NR::Point t = fill_queue->front();
667 do {
668 ok = false;
669 if (bci.is_left) {
670 keep_tracing = (bci.x != 0);
671 } else {
672 keep_tracing = (bci.x < bci.width);
673 }
675 if (keep_tracing) {
676 if (check_if_pixel_is_paintable(px, current_trace_t, bci.x, bci.y, orig_color, bci)) {
677 paint_directions = paint_pixel(px, trace_px, orig_color, bci, current_trace_t);
678 if (bci.radius == 0) {
679 mark_pixel_checked(current_trace_t);
680 if ((t[NR::X] == bci.x) && (t[NR::Y] == bci.y)) {
681 fill_queue->pop_front(); t = fill_queue->front();
682 }
683 }
685 if (can_paint_top) {
686 if (paint_directions & PAINT_DIRECTION_UP) {
687 unsigned char *trace_t = current_trace_t - pix_width;
688 if (!is_pixel_queued(trace_t)) {
689 bool ok_to_paint = check_if_pixel_is_paintable(px, trace_t, bci.x, top_ty, orig_color, bci);
691 if (initial_paint) { currently_painting_top = !ok_to_paint; }
693 if (ok_to_paint && (!currently_painting_top)) {
694 currently_painting_top = true;
695 push_point_onto_queue(fill_queue, bci.max_queue_size, trace_t, bci.x, top_ty);
696 }
697 if ((!ok_to_paint) && currently_painting_top) {
698 currently_painting_top = false;
699 }
700 }
701 }
702 }
704 if (can_paint_bottom) {
705 if (paint_directions & PAINT_DIRECTION_DOWN) {
706 unsigned char *trace_t = current_trace_t + pix_width;
707 if (!is_pixel_queued(trace_t)) {
708 bool ok_to_paint = check_if_pixel_is_paintable(px, trace_t, bci.x, bottom_ty, orig_color, bci);
710 if (initial_paint) { currently_painting_bottom = !ok_to_paint; }
712 if (ok_to_paint && (!currently_painting_bottom)) {
713 currently_painting_bottom = true;
714 push_point_onto_queue(fill_queue, bci.max_queue_size, trace_t, bci.x, bottom_ty);
715 }
716 if ((!ok_to_paint) && currently_painting_bottom) {
717 currently_painting_bottom = false;
718 }
719 }
720 }
721 }
723 if (bci.is_left) {
724 if (paint_directions & PAINT_DIRECTION_LEFT) {
725 bci.x -= 1; current_trace_t -= 4;
726 ok = true;
727 }
728 } else {
729 if (paint_directions & PAINT_DIRECTION_RIGHT) {
730 bci.x += 1; current_trace_t += 4;
731 ok = true;
732 }
733 }
735 initial_paint = false;
736 }
737 } else {
738 if (bci.bbox.min()[NR::X] > bci.screen.min()[NR::X]) {
739 aborted = true; break;
740 } else {
741 reached_screen_boundary = true;
742 }
743 }
744 } while (ok);
746 if (aborted) { return SCANLINE_CHECK_ABORTED; }
747 if (reached_screen_boundary) { return SCANLINE_CHECK_BOUNDARY; }
748 return SCANLINE_CHECK_OK;
749 }
751 /**
752 * \brief Sort the rendered pixel buffer check queue vertically.
753 */
754 static bool sort_fill_queue_vertical(NR::Point a, NR::Point b) {
755 return a[NR::Y] > b[NR::Y];
756 }
758 /**
759 * \brief Sort the rendered pixel buffer check queue horizontally.
760 */
761 static bool sort_fill_queue_horizontal(NR::Point a, NR::Point b) {
762 return a[NR::X] > b[NR::X];
763 }
765 /**
766 * \brief Perform a flood fill operation.
767 * \param event_context The event context for this tool.
768 * \param event The details of this event.
769 * \param union_with_selection If true, union the new fill with the current selection.
770 * \param is_point_fill If false, use the Rubberband "touch selection" to get the initial points for the fill.
771 * \param is_touch_fill If true, use only the initial contact point in the Rubberband "touch selection" as the fill target color.
772 */
773 static void sp_flood_do_flood_fill(SPEventContext *event_context, GdkEvent *event, bool union_with_selection, bool is_point_fill, bool is_touch_fill) {
774 SPDesktop *desktop = event_context->desktop;
775 SPDocument *document = sp_desktop_document(desktop);
777 /* Create new arena */
778 NRArena *arena = NRArena::create();
779 unsigned dkey = sp_item_display_key_new(1);
781 sp_document_ensure_up_to_date (document);
783 SPItem *document_root = SP_ITEM(SP_DOCUMENT_ROOT(document));
784 NR::Maybe<NR::Rect> bbox = document_root->getBounds(NR::identity());
786 if (!bbox) {
787 desktop->messageStack()->flash(Inkscape::WARNING_MESSAGE, _("<b>Area is not bounded</b>, cannot fill."));
788 return;
789 }
791 double zoom_scale = desktop->current_zoom();
793 // Render 160% of the physical display to the render pixel buffer, so that available
794 // fill areas off the screen can be included in the fill.
795 double padding = 1.6;
797 NR::Rect screen = desktop->get_display_area();
799 unsigned int width = (int)ceil(screen.extent(NR::X) * zoom_scale * padding);
800 unsigned int height = (int)ceil(screen.extent(NR::Y) * zoom_scale * padding);
802 NR::Point origin(screen.min()[NR::X],
803 sp_document_height(document) - screen.extent(NR::Y) - screen.min()[NR::Y]);
805 origin[NR::X] = origin[NR::X] + (screen.extent(NR::X) * ((1 - padding) / 2));
806 origin[NR::Y] = origin[NR::Y] + (screen.extent(NR::Y) * ((1 - padding) / 2));
808 NR::scale scale(zoom_scale, zoom_scale);
809 NR::Matrix affine = scale * NR::translate(-origin * scale);
811 /* Create ArenaItems and set transform */
812 NRArenaItem *root = sp_item_invoke_show(SP_ITEM(sp_document_root(document)), arena, dkey, SP_ITEM_SHOW_DISPLAY);
813 nr_arena_item_set_transform(NR_ARENA_ITEM(root), affine);
815 NRGC gc(NULL);
816 gc.transform.set_identity();
818 NRRectL final_bbox;
819 final_bbox.x0 = 0;
820 final_bbox.y0 = 0; //row;
821 final_bbox.x1 = width;
822 final_bbox.y1 = height; //row + num_rows;
824 nr_arena_item_invoke_update(root, &final_bbox, &gc, NR_ARENA_ITEM_STATE_ALL, NR_ARENA_ITEM_STATE_NONE);
826 guchar *px = g_new(guchar, 4 * width * height);
828 NRPixBlock B;
829 nr_pixblock_setup_extern( &B, NR_PIXBLOCK_MODE_R8G8B8A8N,
830 final_bbox.x0, final_bbox.y0, final_bbox.x1, final_bbox.y1,
831 px, 4 * width, FALSE, FALSE );
833 SPNamedView *nv = sp_desktop_namedview(desktop);
834 unsigned long bgcolor = nv->pagecolor;
836 unsigned char dtc[4];
837 dtc[0] = NR_RGBA32_R(bgcolor);
838 dtc[1] = NR_RGBA32_G(bgcolor);
839 dtc[2] = NR_RGBA32_B(bgcolor);
840 dtc[3] = NR_RGBA32_A(bgcolor);
842 for (unsigned int fy = 0; fy < height; fy++) {
843 guchar *p = NR_PIXBLOCK_PX(&B) + fy * B.rs;
844 for (unsigned int fx = 0; fx < width; fx++) {
845 for (int i = 0; i < 4; i++) {
846 *p++ = dtc[i];
847 }
848 }
849 }
851 nr_arena_item_invoke_render(NULL, root, &final_bbox, &B, NR_ARENA_ITEM_RENDER_NO_CACHE );
852 nr_pixblock_release(&B);
854 // Hide items
855 sp_item_invoke_hide(SP_ITEM(sp_document_root(document)), dkey);
857 nr_arena_item_unref(root);
858 nr_object_unref((NRObject *) arena);
860 guchar *trace_px = g_new(guchar, 4 * width * height);
861 memset(trace_px, 0x00, 4 * width * height);
863 std::deque<NR::Point> fill_queue;
864 std::queue<NR::Point> color_queue;
866 std::vector<NR::Point> fill_points;
868 bool aborted = false;
869 int y_limit = height - 1;
871 PaintBucketChannels method = (PaintBucketChannels)prefs_get_int_attribute("tools.paintbucket", "channels", 0);
872 int threshold = prefs_get_int_attribute_limited("tools.paintbucket", "threshold", 1, 0, 100);
874 switch(method) {
875 case FLOOD_CHANNELS_ALPHA:
876 case FLOOD_CHANNELS_RGB:
877 case FLOOD_CHANNELS_R:
878 case FLOOD_CHANNELS_G:
879 case FLOOD_CHANNELS_B:
880 threshold = (255 * threshold) / 100;
881 break;
882 case FLOOD_CHANNELS_H:
883 case FLOOD_CHANNELS_S:
884 case FLOOD_CHANNELS_L:
885 break;
886 }
888 bitmap_coords_info bci;
890 bci.y_limit = y_limit;
891 bci.width = width;
892 bci.height = height;
893 bci.threshold = threshold;
894 bci.method = method;
895 bci.bbox = *bbox;
896 bci.screen = screen;
897 bci.dtc = dtc;
898 bci.radius = prefs_get_int_attribute_limited("tools.paintbucket", "autogap", 0, 0, 3);
899 bci.max_queue_size = (width * height) / 4;
900 bci.current_step = 0;
902 if (is_point_fill) {
903 fill_points.push_back(NR::Point(event->button.x, event->button.y));
904 } else {
905 Inkscape::Rubberband::Rubberband *r = Inkscape::Rubberband::get();
906 fill_points = r->getPoints();
907 }
909 for (unsigned int i = 0; i < fill_points.size(); i++) {
910 NR::Point pw = NR::Point(fill_points[i][NR::X] / zoom_scale, sp_document_height(document) + (fill_points[i][NR::Y] / zoom_scale)) * affine;
912 pw[NR::X] = (int)MIN(width - 1, MAX(0, pw[NR::X]));
913 pw[NR::Y] = (int)MIN(height - 1, MAX(0, pw[NR::Y]));
915 if (is_touch_fill) {
916 if (i == 0) {
917 color_queue.push(pw);
918 } else {
919 unsigned char *trace_t = get_pixel(trace_px, (int)pw[NR::X], (int)pw[NR::Y], width);
920 push_point_onto_queue(&fill_queue, bci.max_queue_size, trace_t, (int)pw[NR::X], (int)pw[NR::Y]);
921 }
922 } else {
923 color_queue.push(pw);
924 }
925 }
927 bool reached_screen_boundary = false;
929 bool first_run = true;
931 unsigned long sort_size_threshold = 5;
933 while (!color_queue.empty() && !aborted) {
934 NR::Point color_point = color_queue.front();
935 color_queue.pop();
937 int cx = (int)color_point[NR::X];
938 int cy = (int)color_point[NR::Y];
940 unsigned char *orig_px = get_pixel(px, cx, cy, width);
941 unsigned char orig_color[4];
942 for (int i = 0; i < 4; i++) { orig_color[i] = orig_px[i]; }
944 unsigned char merged_orig[3];
946 merge_pixel_with_background(orig_color, dtc, merged_orig);
948 bci.merged_orig_pixel = merged_orig;
950 unsigned char *trace_t = get_pixel(trace_px, cx, cy, width);
951 if (!is_pixel_checked(trace_t) && !is_pixel_colored(trace_t)) {
952 if (check_if_pixel_is_paintable(px, trace_px, cx, cy, orig_color, bci)) {
953 shift_point_onto_queue(&fill_queue, bci.max_queue_size, trace_t, cx, cy);
955 if (!first_run) {
956 for (unsigned int y = 0; y < height; y++) {
957 trace_t = get_pixel(trace_px, 0, y, width);
958 for (unsigned int x = 0; x < width; x++) {
959 clear_pixel_paintability(trace_t);
960 trace_t += 4;
961 }
962 }
963 }
964 first_run = false;
965 }
966 }
968 unsigned long old_fill_queue_size = fill_queue.size();
970 while (!fill_queue.empty() && !aborted) {
971 NR::Point cp = fill_queue.front();
973 if (bci.radius == 0) {
974 unsigned long new_fill_queue_size = fill_queue.size();
976 /*
977 * To reduce the number of points in the fill queue, periodically
978 * resort all of the points in the queue so that scanline checks
979 * can complete more quickly. A point cannot be checked twice
980 * in a normal scanline checks, so forcing scanline checks to start
981 * from one corner of the rendered area as often as possible
982 * will reduce the number of points that need to be checked and queued.
983 */
984 if (new_fill_queue_size > sort_size_threshold) {
985 if (new_fill_queue_size > old_fill_queue_size) {
986 std::sort(fill_queue.begin(), fill_queue.end(), sort_fill_queue_vertical);
988 std::deque<NR::Point>::iterator start_sort = fill_queue.begin();
989 std::deque<NR::Point>::iterator end_sort = fill_queue.begin();
990 unsigned int sort_y = (unsigned int)cp[NR::Y];
991 unsigned int current_y = sort_y;
993 for (std::deque<NR::Point>::iterator i = fill_queue.begin(); i != fill_queue.end(); i++) {
994 NR::Point current = *i;
995 current_y = (unsigned int)current[NR::Y];
996 if (current_y != sort_y) {
997 if (start_sort != end_sort) {
998 std::sort(start_sort, end_sort, sort_fill_queue_horizontal);
999 }
1000 sort_y = current_y;
1001 start_sort = i;
1002 }
1003 end_sort = i;
1004 }
1005 if (start_sort != end_sort) {
1006 std::sort(start_sort, end_sort, sort_fill_queue_horizontal);
1007 }
1009 cp = fill_queue.front();
1010 }
1011 }
1013 old_fill_queue_size = new_fill_queue_size;
1014 }
1016 fill_queue.pop_front();
1018 int x = (int)cp[NR::X];
1019 int y = (int)cp[NR::Y];
1021 unsigned char *trace_t = get_pixel(trace_px, x, y, width);
1022 if (!is_pixel_checked(trace_t)) {
1023 mark_pixel_checked(trace_t);
1025 if (y == 0) {
1026 if (bbox->min()[NR::Y] > screen.min()[NR::Y]) {
1027 aborted = true; break;
1028 } else {
1029 reached_screen_boundary = true;
1030 }
1031 }
1033 if (y == y_limit) {
1034 if (bbox->max()[NR::Y] < screen.max()[NR::Y]) {
1035 aborted = true; break;
1036 } else {
1037 reached_screen_boundary = true;
1038 }
1039 }
1041 bci.is_left = true;
1042 bci.x = x;
1043 bci.y = y;
1045 ScanlineCheckResult result = perform_bitmap_scanline_check(&fill_queue, px, trace_px, orig_color, bci);
1047 switch (result) {
1048 case SCANLINE_CHECK_ABORTED:
1049 aborted = true;
1050 break;
1051 case SCANLINE_CHECK_BOUNDARY:
1052 reached_screen_boundary = true;
1053 break;
1054 default:
1055 break;
1056 }
1058 if (bci.x < width) {
1059 trace_t += 4;
1060 if (!is_pixel_checked(trace_t) && !is_pixel_queued(trace_t)) {
1061 mark_pixel_checked(trace_t);
1062 bci.is_left = false;
1063 bci.x = x + 1;
1065 result = perform_bitmap_scanline_check(&fill_queue, px, trace_px, orig_color, bci);
1067 switch (result) {
1068 case SCANLINE_CHECK_ABORTED:
1069 aborted = true;
1070 break;
1071 case SCANLINE_CHECK_BOUNDARY:
1072 reached_screen_boundary = true;
1073 break;
1074 default:
1075 break;
1076 }
1077 }
1078 }
1079 }
1081 bci.current_step++;
1083 if (bci.current_step > bci.max_queue_size) {
1084 aborted = true;
1085 }
1086 }
1087 }
1089 g_free(px);
1091 if (aborted) {
1092 g_free(trace_px);
1093 desktop->messageStack()->flash(Inkscape::WARNING_MESSAGE, _("<b>Area is not bounded</b>, cannot fill."));
1094 return;
1095 }
1097 if (reached_screen_boundary) {
1098 desktop->messageStack()->flash(Inkscape::WARNING_MESSAGE, _("<b>Only the visible part of the bounded area was filled.</b> If you want to fill all of the area, undo, zoom out, and fill again."));
1099 }
1101 NR::Matrix inverted_affine = NR::Matrix(affine).inverse();
1103 do_trace(bci, trace_px, desktop, inverted_affine, union_with_selection);
1105 g_free(trace_px);
1107 sp_document_done(document, SP_VERB_CONTEXT_PAINTBUCKET, _("Fill bounded area"));
1108 }
1110 static gint sp_flood_context_item_handler(SPEventContext *event_context, SPItem *item, GdkEvent *event)
1111 {
1112 gint ret = FALSE;
1114 SPDesktop *desktop = event_context->desktop;
1116 switch (event->type) {
1117 case GDK_BUTTON_PRESS:
1118 if ((event->button.state & GDK_CONTROL_MASK) && event->button.button == 1 && !event_context->space_panning) {
1119 NR::Point const button_w(event->button.x,
1120 event->button.y);
1122 SPItem *item = sp_event_context_find_item (desktop, button_w, TRUE, TRUE);
1124 Inkscape::XML::Node *pathRepr = SP_OBJECT_REPR(item);
1125 /* Set style */
1126 sp_desktop_apply_style_tool (desktop, pathRepr, "tools.paintbucket", false);
1127 sp_document_done(sp_desktop_document(desktop), SP_VERB_CONTEXT_PAINTBUCKET, _("Set style on object"));
1128 ret = TRUE;
1129 }
1130 break;
1131 default:
1132 break;
1133 }
1135 if (((SPEventContextClass *) parent_class)->item_handler) {
1136 ret = ((SPEventContextClass *) parent_class)->item_handler(event_context, item, event);
1137 }
1139 return ret;
1140 }
1142 static gint sp_flood_context_root_handler(SPEventContext *event_context, GdkEvent *event)
1143 {
1144 static bool dragging;
1146 gint ret = FALSE;
1147 SPDesktop *desktop = event_context->desktop;
1149 switch (event->type) {
1150 case GDK_BUTTON_PRESS:
1151 if (event->button.button == 1 && !event_context->space_panning) {
1152 if (!(event->button.state & GDK_CONTROL_MASK)) {
1153 NR::Point const button_w(event->button.x,
1154 event->button.y);
1156 if (Inkscape::have_viable_layer(desktop, event_context->defaultMessageContext())) {
1157 // save drag origin
1158 event_context->xp = (gint) button_w[NR::X];
1159 event_context->yp = (gint) button_w[NR::Y];
1160 event_context->within_tolerance = true;
1162 dragging = true;
1164 NR::Point const p(desktop->w2d(button_w));
1165 Inkscape::Rubberband::get()->setMode(RUBBERBAND_MODE_TOUCHPATH);
1166 Inkscape::Rubberband::get()->start(desktop, p);
1167 }
1168 }
1169 }
1170 case GDK_MOTION_NOTIFY:
1171 if ( dragging
1172 && ( event->motion.state & GDK_BUTTON1_MASK ) && !event_context->space_panning)
1173 {
1174 if ( event_context->within_tolerance
1175 && ( abs( (gint) event->motion.x - event_context->xp ) < event_context->tolerance )
1176 && ( abs( (gint) event->motion.y - event_context->yp ) < event_context->tolerance ) ) {
1177 break; // do not drag if we're within tolerance from origin
1178 }
1180 event_context->within_tolerance = false;
1182 NR::Point const motion_pt(event->motion.x, event->motion.y);
1183 NR::Point const p(desktop->w2d(motion_pt));
1184 if (Inkscape::Rubberband::get()->is_started()) {
1185 Inkscape::Rubberband::get()->move(p);
1186 event_context->defaultMessageContext()->set(Inkscape::NORMAL_MESSAGE, _("<b>Draw over</b> areas to add to fill, hold <b>Alt</b> for touch fill"));
1187 gobble_motion_events(GDK_BUTTON1_MASK);
1188 }
1189 }
1190 break;
1192 case GDK_BUTTON_RELEASE:
1193 if (event->button.button == 1 && !event_context->space_panning) {
1194 Inkscape::Rubberband::Rubberband *r = Inkscape::Rubberband::get();
1195 if (r->is_started()) {
1196 // set "busy" cursor
1197 desktop->setWaitingCursor();
1199 if (SP_IS_EVENT_CONTEXT(event_context)) {
1200 // Since setWaitingCursor runs main loop iterations, we may have already left this tool!
1201 // So check if the tool is valid before doing anything
1202 dragging = false;
1204 bool is_point_fill = event_context->within_tolerance;
1205 bool is_touch_fill = event->button.state & GDK_MOD1_MASK;
1207 sp_flood_do_flood_fill(event_context, event, event->button.state & GDK_SHIFT_MASK, is_point_fill, is_touch_fill);
1209 desktop->clearWaitingCursor();
1210 // restore cursor when done; note that it may already be different if e.g. user
1211 // switched to another tool during interruptible tracing or drawing, in which case do nothing
1213 ret = TRUE;
1214 }
1216 r->stop();
1218 if (SP_IS_EVENT_CONTEXT(event_context)) {
1219 event_context->defaultMessageContext()->clear();
1220 }
1221 }
1222 }
1223 break;
1224 case GDK_KEY_PRESS:
1225 switch (get_group0_keyval (&event->key)) {
1226 case GDK_Up:
1227 case GDK_Down:
1228 case GDK_KP_Up:
1229 case GDK_KP_Down:
1230 // prevent the zoom field from activation
1231 if (!MOD__CTRL_ONLY)
1232 ret = TRUE;
1233 break;
1234 default:
1235 break;
1236 }
1237 break;
1238 default:
1239 break;
1240 }
1242 if (!ret) {
1243 if (((SPEventContextClass *) parent_class)->root_handler) {
1244 ret = ((SPEventContextClass *) parent_class)->root_handler(event_context, event);
1245 }
1246 }
1248 return ret;
1249 }
1252 static void sp_flood_finish(SPFloodContext *rc)
1253 {
1254 rc->_message_context->clear();
1256 if ( rc->item != NULL ) {
1257 SPDesktop * desktop;
1259 desktop = SP_EVENT_CONTEXT_DESKTOP(rc);
1261 SP_OBJECT(rc->item)->updateRepr();
1263 sp_canvas_end_forced_full_redraws(desktop->canvas);
1265 sp_desktop_selection(desktop)->set(rc->item);
1266 sp_document_done(sp_desktop_document(desktop), SP_VERB_CONTEXT_PAINTBUCKET,
1267 _("Fill bounded area"));
1269 rc->item = NULL;
1270 }
1271 }
1273 void flood_channels_set_channels( gint channels )
1274 {
1275 prefs_set_int_attribute("tools.paintbucket", "channels", channels);
1276 }
1278 /*
1279 Local Variables:
1280 mode:c++
1281 c-file-style:"stroustrup"
1282 c-file-offsets:((innamespace . 0)(inline-open . 0)(case-label . +))
1283 indent-tabs-mode:nil
1284 fill-column:99
1285 End:
1286 */
1287 // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=99 :