Marble/MarbleDesigner

    From KDE TechBase
    Revision as of 15:29, 11 February 2009 by Tackat (talk | contribs)
    The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.


    Editing Projects/Marble/MarbleDesigner

    Look Mom, No Code!
    Tutorial Series   Marble Widget Plugin for Qt Designer
    Previous   Qt Designer
    What's Next   n/a
    Further Reading   n/a

    The Marble Widget Plugin for Qt Designer

    Compiling the MarbleWidget Plugin

    The MarbleWidget is also offered as a designer plugin. If you compile Marble yourself you probably need to enable the compilation of the designer plugin:

    If your source directory is "~/marble" and your build directory is "~/marble_build" then you can enable compilation of the designer plugin via the cmake call:

    cmake -DWITH_DESIGNER_PLUGIN=ON ../marble


    Once you have compiled marble using make you can install everything using "make install". This should install the file

    MarbleWidgetPlugin.so


    into Qt's designer plugin directory (please check this in case things don't work out).

    Once you start Qt Designer you should spot a new "Marble Desktop Globe" category in the widget box on the left.



    Using the MarbleWidget Plugin

    You can use this MarbleWidget just like all other widgets inside Designer: Once you have started Designer you can choose a new form from the ready-made templates (e.g. a QWidget). Now you can just drag and drop the Marble Widget from the widget box onto your form:



    The map properties of the MarbleWidget can be adjusted in the Property Editor on the right: all properties get assigned and displayed immediately on the map without having to press the "Preview" menu entry.



    There are two ready-made examples available inside the example directory of the Marble source code:

    marble/examples/example1.ui marble/examples/example2.ui

    The file =example2.ui= nicely demonstrate how signals and slots work with the MarbleWidget:



    You can preview the widget by choosing =Preview= from the =Form= menu.