1 /** \file
2 *
3 * Document properties dialog, Gtkmm-style
4 *
5 * Authors:
6 * bulia byak <buliabyak@users.sf.net>
7 * Bryce W. Harrington <bryce@bryceharrington.org>
8 * Lauris Kaplinski <lauris@kaplinski.com>
9 * Jon Phillips <jon@rejon.org>
10 * Ralf Stephan <ralf@ark.in-berlin.de> (Gtkmm)
11 *
12 * Copyright (C) 2006-2007 Johan Engelen <johan@shouraizou.nl>
13 * Copyright (C) 2000 - 2005 Authors
14 *
15 * Released under GNU GPL. Read the file 'COPYING' for more information
16 */
18 #ifdef HAVE_CONFIG_H
19 # include <config.h>
20 #endif
24 #include <gtkmm.h>
25 #include "ui/widget/color-picker.h"
26 #include "ui/widget/scalar-unit.h"
28 #include "xml/node-event-vector.h"
29 #include "helper/units.h"
30 #include "prefs-utils.h"
32 #include "inkscape.h"
33 #include "verbs.h"
34 #include "document.h"
35 #include "desktop-handles.h"
36 #include "desktop.h"
37 #include "sp-namedview.h"
39 #include "document-properties.h"
41 #include "display/canvas-grid.h"
43 using std::pair;
45 namespace Inkscape {
46 namespace UI {
47 namespace Dialog {
49 #define SPACE_SIZE_X 15
50 #define SPACE_SIZE_Y 10
52 //===================================================
54 //---------------------------------------------------
56 static DocumentProperties *_instance = 0;
58 static void on_child_added(Inkscape::XML::Node *repr, Inkscape::XML::Node *child, Inkscape::XML::Node *ref, void * data);
59 static void on_child_removed(Inkscape::XML::Node *repr, Inkscape::XML::Node *child, Inkscape::XML::Node *ref, void * data);
60 static void on_repr_attr_changed (Inkscape::XML::Node *, gchar const *, gchar const *, gchar const *, bool, gpointer);
61 static void on_doc_replaced (SPDesktop* dt, SPDocument* doc);
62 static void on_activate_desktop (Inkscape::Application *, SPDesktop* dt, void*);
63 static void on_deactivate_desktop (Inkscape::Application *, SPDesktop* dt, void*);
65 static Inkscape::XML::NodeEventVector const _repr_events = {
66 on_child_added, /* child_added */
67 on_child_removed, /* child_removed */
68 on_repr_attr_changed,
69 NULL, /* content_changed */
70 NULL /* order_changed */
71 };
74 DocumentProperties*
75 DocumentProperties::create()
76 {
77 if (_instance) return _instance;
78 _instance = new DocumentProperties;
79 _instance->init();
80 return _instance;
81 }
83 void
84 DocumentProperties::destroy()
85 {
86 if (_instance)
87 {
88 delete _instance;
89 _instance = 0;
90 }
91 }
93 DocumentProperties::DocumentProperties()
94 : Dialog ("dialogs.documentoptions", SP_VERB_DIALOG_NAMEDVIEW),
95 _page_page(1, 1), _page_guides(1, 1),
96 _page_snap(1, 1), _page_grids(1, 1),
97 _grids_button_new(_("_New"), _("Create new grid.")),
98 _grids_button_remove(_("_Remove"), _("Remove selected grid.")),
99 _prefs_path("dialogs.documentoptions")
100 {
101 set_resizable (false);
102 _tt.enable();
103 get_vbox()->set_spacing (4);
104 get_vbox()->pack_start (_notebook, true, true);
106 _notebook.append_page(_page_page, _("Page"));
107 _notebook.append_page(_page_guides, _("Guides"));
108 _notebook.append_page(_page_grids, _("Grids"));
109 _notebook.append_page(_page_snap, _("Snapping"));
111 build_page();
112 build_guides();
113 build_gridspage();
114 build_snap();
116 _grids_button_new.signal_clicked().connect(sigc::mem_fun(*this, &DocumentProperties::onNewGrid));
117 _grids_button_remove.signal_clicked().connect(sigc::mem_fun(*this, &DocumentProperties::onRemoveGrid));
118 }
120 void
121 DocumentProperties::init()
122 {
123 update();
125 Inkscape::XML::Node *repr = SP_OBJECT_REPR(sp_desktop_namedview(SP_ACTIVE_DESKTOP));
126 repr->addListener (&_repr_events, this);
127 Inkscape::XML::Node *root = SP_OBJECT_REPR(sp_desktop_document(SP_ACTIVE_DESKTOP)->root);
128 root->addListener (&_repr_events, this);
130 _doc_replaced_connection = SP_ACTIVE_DESKTOP->connectDocumentReplaced (sigc::ptr_fun (on_doc_replaced));
132 g_signal_connect(G_OBJECT(INKSCAPE), "activate_desktop",
133 G_CALLBACK(on_activate_desktop), 0);
135 g_signal_connect(G_OBJECT(INKSCAPE), "deactivate_desktop",
136 G_CALLBACK(on_deactivate_desktop), 0);
138 show_all_children();
140 present();
141 }
143 DocumentProperties::~DocumentProperties()
144 {
145 Inkscape::XML::Node *repr = SP_OBJECT_REPR(sp_desktop_namedview(SP_ACTIVE_DESKTOP));
146 repr->removeListenerByData (this);
147 Inkscape::XML::Node *root = SP_OBJECT_REPR(sp_desktop_document(SP_ACTIVE_DESKTOP)->root);
148 root->removeListenerByData (this);
149 _doc_replaced_connection.disconnect();
150 }
152 //========================================================================
154 /**
155 * Helper function that attaches widgets in a 3xn table. The widgets come in an
156 * array that has two entries per table row. The two entries code for four
157 * possible cases: (0,0) means insert space in first column; (0, non-0) means
158 * widget in columns 2-3; (non-0, 0) means label in columns 1-3; and
159 * (non-0, non-0) means two widgets in columns 2 and 3.
160 **/
161 inline void
162 attach_all(Gtk::Table &table, Gtk::Widget *const arr[], unsigned const n, int start = 0)
163 {
164 for (unsigned i = 0, r = start; i < n; i += 2)
165 {
166 if (arr[i] && arr[i+1])
167 {
168 table.attach(*arr[i], 1, 2, r, r+1,
169 Gtk::FILL|Gtk::EXPAND, (Gtk::AttachOptions)0,0,0);
170 table.attach(*arr[i+1], 2, 3, r, r+1,
171 Gtk::FILL|Gtk::EXPAND, (Gtk::AttachOptions)0,0,0);
172 }
173 else
174 {
175 if (arr[i+1])
176 table.attach(*arr[i+1], 1, 3, r, r+1,
177 Gtk::FILL|Gtk::EXPAND, (Gtk::AttachOptions)0,0,0);
178 else if (arr[i])
179 {
180 Gtk::Label& label = reinterpret_cast<Gtk::Label&>(*arr[i]);
181 label.set_alignment (0.0);
182 table.attach (label, 0, 3, r, r+1,
183 Gtk::FILL|Gtk::EXPAND, (Gtk::AttachOptions)0,0,0);
184 }
185 else
186 {
187 Gtk::HBox *space = manage (new Gtk::HBox);
188 space->set_size_request (SPACE_SIZE_X, SPACE_SIZE_Y);
189 table.attach (*space, 0, 1, r, r+1,
190 (Gtk::AttachOptions)0, (Gtk::AttachOptions)0,0,0);
191 }
192 }
193 ++r;
194 }
195 }
197 void
198 DocumentProperties::build_page()
199 {
200 _page_page.show();
202 _rcp_bg.init (_("Back_ground:"), _("Background color"), _("Color and transparency of the page background (also used for bitmap export)"),
203 "pagecolor", "inkscape:pageopacity", _wr);
204 _rcb_canb.init (_("Show page _border"), _("If set, rectangular page border is shown"), "showborder", _wr, false);
205 _rcb_bord.init (_("Border on _top of drawing"), _("If set, border is always on top of the drawing"), "borderlayer", _wr, false);
206 _rcp_bord.init (_("Border _color:"), _("Page border color"),
207 _("Color of the page border"),
208 "bordercolor", "borderopacity", _wr);
209 _rcb_shad.init (_("_Show border shadow"), _("If set, page border shows a shadow on its right and lower side"), "inkscape:showpageshadow", _wr, false);
210 _rum_deflt.init (_("Default _units:"), "inkscape:document-units", _wr);
212 Gtk::Label* label_gen = manage (new Gtk::Label);
213 label_gen->set_markup (_("<b>General</b>"));
214 Gtk::Label* label_bor = manage (new Gtk::Label);
215 label_bor->set_markup (_("<b>Border</b>"));
216 Gtk::Label *label_for = manage (new Gtk::Label);
217 label_for->set_markup (_("<b>Format</b>"));
218 _page_sizer.init (_wr);
220 Gtk::Widget *const widget_array[] =
221 {
222 label_gen, 0,
223 _rum_deflt._label, _rum_deflt._sel,
224 _rcp_bg._label, _rcp_bg._cp,
225 0, 0,
226 label_for, 0,
227 0, &_page_sizer,
228 0, 0,
229 label_bor, 0,
230 0, _rcb_canb._button,
231 0, _rcb_bord._button,
232 0, _rcb_shad._button,
233 _rcp_bord._label, _rcp_bord._cp,
234 };
236 attach_all(_page_page.table(), widget_array, G_N_ELEMENTS(widget_array));
237 }
239 void
240 DocumentProperties::build_guides()
241 {
242 _page_guides.show();
244 _rcb_sgui.init (_("Show _guides"), _("Show or hide guides"), "showguides", _wr);
245 _rcp_gui.init (_("Guide co_lor:"), _("Guideline color"),
246 _("Color of guidelines"), "guidecolor", "guideopacity", _wr);
247 _rcp_hgui.init (_("_Highlight color:"), _("Highlighted guideline color"),
248 _("Color of a guideline when it is under mouse"),
249 "guidehicolor", "guidehiopacity", _wr);
250 Gtk::Label *label_gui = manage (new Gtk::Label);
251 label_gui->set_markup (_("<b>Guides</b>"));
253 Gtk::Widget *const widget_array[] =
254 {
255 label_gui, 0,
256 0, _rcb_sgui._button,
257 _rcp_gui._label, _rcp_gui._cp,
258 _rcp_hgui._label, _rcp_hgui._cp,
259 };
261 attach_all(_page_guides.table(), widget_array, G_N_ELEMENTS(widget_array));
262 }
264 void
265 DocumentProperties::build_snap()
266 {
267 _page_snap.show();
268 //General options
269 _rcbsnbb.init (_("Bounding _box corners"),
270 _("Snap bounding box corners to grid lines, to guides, and to other bounding boxes (only applicable to the selector tool)"),
271 "inkscape:snap-bbox", _wr);
272 _rcbsnn.init (_("_Nodes"),
273 _("Snap nodes to grid lines, to guides, to paths, and to other nodes"),
274 "inkscape:snap-nodes", _wr);
275 _rcbic.init (_("Include the object's center"),
276 _("Also snap the rotation center of an object when snapping nodes"),
277 "inkscape:snap-center", _wr);
279 //Options for snapping to objects
280 _rcbsnop.init (_("Snap to _paths"),
281 _("Snap nodes to object paths"),
282 "inkscape:object-paths", _wr);
283 _rcbsnon.init (_("Snap to n_odes"),
284 _("Snap nodes to object nodes"),
285 "inkscape:object-nodes", _wr);
286 _rsu_sno.init (_("Snap _distance"), _("Snap at any dist_ance"),
287 _("Snapping distance, in screen pixels, for snapping to objects"),
288 _("If set, objects snap to the nearest object, regardless of distance"),
289 "objecttolerance", _wr);
291 //Options for snapping to grids
292 _rsu_sn.init (_("Snap d_istance"), _("Snap at any distan_ce"),
293 _("Snapping distance, in screen pixels, for snapping to grid"),
294 _("If set, objects snap to the nearest grid line, regardless of distance"),
295 "gridtolerance", _wr);
297 //Options for snapping to guides
298 _rsu_gusn.init (_("Snap di_stance"), _("Snap at any distanc_e"),
299 _("Snapping distance, in screen pixels, for snapping to guides"),
300 _("If set, objects snap to the nearest guide, regardless of distance"),
301 "guidetolerance", _wr);
303 std::list<Gtk::ToggleButton*> list;
304 list.push_back(_rcbic._button);
305 list.push_back(_rcbsnop._button);
306 list.push_back(_rcbsnon._button);
307 _rcbsnn.setSlaveButton(list);
310 Gtk::Label *label_g = manage (new Gtk::Label);
311 label_g->set_markup (_("<b>Snapping from</b>"));
312 Gtk::Label *label_o = manage (new Gtk::Label);
313 label_o->set_markup (_("<b>Snapping to objects</b>"));
314 Gtk::Label *label_gr = manage (new Gtk::Label);
315 label_gr->set_markup (_("<b>Snapping to grids</b>"));
316 Gtk::Label *label_gu = manage (new Gtk::Label);
317 label_gu->set_markup (_("<b>Snapping to guides</b>"));
319 Gtk::Widget *const array[] =
320 {
321 label_g, 0,
322 0, _rcbsnn._button,
323 0, 0, //_rcbic._button will be inserted here
324 0, _rcbsnbb._button,
325 0, 0,
326 0, 0,
327 0, 0,
328 label_o, 0,
329 0, _rcbsnop._button,
330 0, _rcbsnon._button,
331 0, _rsu_sno._vbox,
332 0, 0,
333 label_gr, 0,
334 0, _rsu_sn._vbox,
335 0, 0,
336 label_gu, 0,
337 0, _rsu_gusn._vbox,
338 };
340 attach_all(_page_snap.table(), array, G_N_ELEMENTS(array));
342 // add _rcbic manually to get some additional indenting
343 _page_snap.table().attach(*_rcbic._button, 1, 3, 2, 3, Gtk::FILL|Gtk::EXPAND, (Gtk::AttachOptions)0, 18, 0);
344 }
346 /**
347 * Called for _updating_ the dialog (e.g. when a new grid was manually added in XML)
348 */
349 void
350 DocumentProperties::update_gridspage()
351 {
352 SPDesktop *dt = SP_ACTIVE_DESKTOP;
353 SPNamedView *nv = sp_desktop_namedview(dt);
355 //remove all tabs
356 while (_grids_notebook.get_current_page() != -1) {
357 _grids_notebook.remove_page(-1);
358 }
360 //add tabs
361 for (GSList const * l = nv->grids; l != NULL; l = l->next) {
362 Inkscape::CanvasGrid * grid = (Inkscape::CanvasGrid*) l->data;
363 _grids_notebook.append_page(grid->getWidget(), grid->repr->attribute("id"));
365 }
366 _grids_notebook.show_all();
368 _page_grids.table().resize_children();
369 }
371 /**
372 * Build grid page of dialog.
373 */
374 void
375 DocumentProperties::build_gridspage()
376 {
377 _page_grids.show();
379 /// \todo FIXME: gray out snapping when grid is off.
380 /// Dissenting view: you want snapping without grid.
382 SPDesktop *dt = SP_ACTIVE_DESKTOP;
383 SPNamedView *nv = sp_desktop_namedview(dt);
385 Gtk::Label* label_crea = manage (new Gtk::Label);
386 label_crea->set_markup (_("<b>Creation</b>"));
387 Gtk::Label* label_crea_type = manage (new Gtk::Label);
388 label_crea_type->set_markup (_("Gridtype"));
390 for (gint t = 0; t <= GRID_MAXTYPENR; t++) {
391 _grids_combo_gridtype.append_text( CanvasGrid::getName( (GridType) t ) );
392 }
393 _grids_combo_gridtype.set_active_text( CanvasGrid::getName(GRID_RECTANGULAR) );
395 Gtk::Label* label_def = manage (new Gtk::Label);
396 label_def->set_markup (_("<b>Defined grids</b>"));
398 for (GSList const * l = nv->grids; l != NULL; l = l->next) {
399 Inkscape::CanvasGrid * grid = (Inkscape::CanvasGrid*) l->data;
400 _grids_notebook.append_page(grid->getWidget(), grid->repr->attribute("id"));
401 }
403 Gtk::Widget *const widget_array[] =
404 {
405 label_crea, 0,
406 label_crea_type, (Gtk::Widget*) &_grids_combo_gridtype,
407 (Gtk::Widget*) &_grids_button_new, (Gtk::Widget*) &_grids_button_remove,
408 label_def, 0
409 };
410 attach_all(_page_grids.table(), widget_array, G_N_ELEMENTS(widget_array));
411 _page_grids.table().attach(_grids_notebook, 0, 3, 4, 5,
412 Gtk::FILL|Gtk::EXPAND, (Gtk::AttachOptions)0,0,0);
413 }
417 /**
418 * Update dialog widgets from desktop. Also call updateWidget routines of the grids.
419 */
420 void
421 DocumentProperties::update()
422 {
423 if (_wr.isUpdating()) return;
425 SPDesktop *dt = SP_ACTIVE_DESKTOP;
426 SPNamedView *nv = sp_desktop_namedview(dt);
428 _wr.setUpdating (true);
429 set_sensitive (true);
431 //-----------------------------------------------------------page page
432 _rcp_bg.setRgba32 (nv->pagecolor);
433 _rcb_canb.setActive (nv->showborder);
434 _rcb_bord.setActive (nv->borderlayer == SP_BORDER_LAYER_TOP);
435 _rcp_bord.setRgba32 (nv->bordercolor);
436 _rcb_shad.setActive (nv->showpageshadow);
438 if (nv->doc_units)
439 _rum_deflt.setUnit (nv->doc_units);
441 double const doc_w_px = sp_document_width(sp_desktop_document(dt));
442 double const doc_h_px = sp_document_height(sp_desktop_document(dt));
443 _page_sizer.setDim (doc_w_px, doc_h_px);
445 //-----------------------------------------------------------guide
446 _rcb_sgui.setActive (nv->showguides);
447 _rcp_gui.setRgba32 (nv->guidecolor);
448 _rcp_hgui.setRgba32 (nv->guidehicolor);
450 //-----------------------------------------------------------snap
452 _rcbsnbb.setActive (nv->snap_manager.getSnapModeBBox());
453 _rcbsnn.setActive (nv->snap_manager.getSnapModeNode());
454 _rcbic.setActive (nv->snap_manager.getIncludeItemCenter());
455 _rcbsnop.setActive(nv->snap_manager.object.getSnapToItemPath());
456 _rcbsnon.setActive(nv->snap_manager.object.getSnapToItemNode());
457 _rsu_sno.setValue (nv->objecttolerance);
459 _rsu_sn.setValue (nv->gridtolerance);
461 _rsu_gusn.setValue (nv->guidetolerance);
463 //-----------------------------------------------------------grids page
465 update_gridspage();
467 _wr.setUpdating (false);
468 }
470 //--------------------------------------------------------------------
472 void
473 DocumentProperties::on_response (int id)
474 {
475 if (id == Gtk::RESPONSE_DELETE_EVENT || id == Gtk::RESPONSE_CLOSE)
476 {
477 _rcp_bg.closeWindow();
478 _rcp_bord.closeWindow();
479 _rcp_gui.closeWindow();
480 _rcp_hgui.closeWindow();
481 }
483 if (id == Gtk::RESPONSE_CLOSE)
484 hide();
485 }
489 static void
490 on_child_added(Inkscape::XML::Node *repr, Inkscape::XML::Node *child, Inkscape::XML::Node *ref, void * data)
491 {
492 if (!_instance)
493 return;
495 _instance->update_gridspage();
496 }
498 static void
499 on_child_removed(Inkscape::XML::Node *repr, Inkscape::XML::Node *child, Inkscape::XML::Node *ref, void * data)
500 {
501 if (!_instance)
502 return;
504 _instance->update_gridspage();
505 }
509 /**
510 * Called when XML node attribute changed; updates dialog widgets.
511 */
512 static void
513 on_repr_attr_changed (Inkscape::XML::Node *, gchar const *, gchar const *, gchar const *, bool, gpointer)
514 {
515 if (!_instance)
516 return;
518 _instance->update();
519 }
521 static void
522 on_activate_desktop (Inkscape::Application *, SPDesktop* dt, void*)
523 {
524 if (!_instance)
525 return;
527 Inkscape::XML::Node *repr = SP_OBJECT_REPR(sp_desktop_namedview(SP_ACTIVE_DESKTOP));
528 repr->addListener (&_repr_events, _instance);
529 Inkscape::XML::Node *root = SP_OBJECT_REPR(sp_desktop_document(SP_ACTIVE_DESKTOP)->root);
530 root->addListener (&_repr_events, _instance);
531 _instance->_doc_replaced_connection = SP_ACTIVE_DESKTOP->connectDocumentReplaced (sigc::ptr_fun (on_doc_replaced));
532 _instance->update();
533 }
535 static void
536 on_deactivate_desktop (Inkscape::Application *, SPDesktop* dt, void*)
537 {
538 if (!_instance)
539 return;
541 Inkscape::XML::Node *repr = SP_OBJECT_REPR(sp_desktop_namedview(SP_ACTIVE_DESKTOP));
542 repr->removeListenerByData (_instance);
543 Inkscape::XML::Node *root = SP_OBJECT_REPR(sp_desktop_document(SP_ACTIVE_DESKTOP)->root);
544 root->removeListenerByData (_instance);
545 _instance->_doc_replaced_connection.disconnect();
546 }
548 static void
549 on_doc_replaced (SPDesktop* dt, SPDocument* doc)
550 {
551 if (!_instance)
552 return;
554 Inkscape::XML::Node *repr = SP_OBJECT_REPR(sp_desktop_namedview(dt));
555 repr->addListener (&_repr_events, _instance);
556 Inkscape::XML::Node *root = SP_OBJECT_REPR(doc->root);
557 root->addListener (&_repr_events, _instance);
558 _instance->update();
559 }
564 /*########################################################################
565 # BUTTON CLICK HANDLERS (callbacks)
566 ########################################################################*/
568 void
569 DocumentProperties::onNewGrid()
570 {
571 SPDesktop *dt = SP_ACTIVE_DESKTOP;
572 Inkscape::XML::Node *repr = SP_OBJECT_REPR(sp_desktop_namedview(dt));
573 SPDocument *doc = sp_desktop_document(dt);
575 Glib::ustring typestring = _grids_combo_gridtype.get_active_text();
576 CanvasGrid::writeNewGridToRepr(repr, doc, CanvasGrid::getGridTypeFromName(typestring.c_str()));
577 }
580 void
581 DocumentProperties::onRemoveGrid()
582 {
583 gint pagenum = _grids_notebook.get_current_page();
584 if (pagenum == -1) // no pages
585 return;
587 Gtk::Widget *page = _grids_notebook.get_nth_page(pagenum);
588 if (!page) return;
590 Glib::ustring tabtext = _grids_notebook.get_tab_label_text(*page);
592 // find the grid with name tabtext (it's id) and delete that one.
593 SPDesktop *dt = SP_ACTIVE_DESKTOP;
594 SPNamedView *nv = sp_desktop_namedview(dt);
595 Inkscape::CanvasGrid * found_grid = NULL;
596 for (GSList const * l = nv->grids; l != NULL; l = l->next) {
597 Inkscape::CanvasGrid * grid = (Inkscape::CanvasGrid*) l->data;
598 gchar const *idtext = grid->repr->attribute("id");
599 if ( !strcmp(tabtext.c_str(), idtext) ) {
600 found_grid = grid;
601 break; // break out of for-loop
602 }
603 }
604 if (found_grid) {
605 // delete the grid that corresponds with the selected tab
606 // when the grid is deleted from SVG, the SPNamedview handler automatically deletes the object, so found_grid becomes an invalid pointer!
607 found_grid->repr->parent()->removeChild(found_grid->repr);
608 sp_document_done(sp_desktop_document(dt), SP_VERB_DIALOG_NAMEDVIEW, _("Remove grid"));
609 }
610 }
613 } // namespace Dialog
614 } // namespace UI
615 } // namespace Inkscape
617 /*
618 Local Variables:
619 mode:c++
620 c-file-style:"stroustrup"
621 c-file-offsets:((innamespace . 0)(inline-open . 0))
622 indent-tabs-mode:nilu
623 fill-column:99
624 End:
625 */
626 // vim: filetype=c++:expandtab:shiftwidth=4:tabstop=8:softtabstop=4 :