Marble/MarbleDesigner: Difference between revisions
(add description for windows users so that marblewidget.dll must be within the path) |
Neverendingo (talk | contribs) m (Text replace - "<code>" to "<syntaxhighlight lang="text">") |
||
| Line 17: | Line 17: | ||
If your source directory is "~/marble" and your build directory is "~/marble_build" then you can enable compilation of the Qt Designer plugin via the cmake call: | If your source directory is "~/marble" and your build directory is "~/marble_build" then you can enable compilation of the Qt Designer plugin via the cmake call: | ||
< | <syntaxhighlight lang="text"> | ||
cmake -DQTONLY=OFF -DWITH_DESIGNER_PLUGIN=ON ../marble | cmake -DQTONLY=OFF -DWITH_DESIGNER_PLUGIN=ON ../marble | ||
</code> | </code> | ||
| Line 25: | Line 25: | ||
Once you have compiled Marble using "make" you can install everything using "make install". This should install the file | Once you have compiled Marble using "make" you can install everything using "make install". This should install the file | ||
< | <syntaxhighlight lang="text"> | ||
MarbleWidgetPlugin.so | MarbleWidgetPlugin.so | ||
</code> | </code> | ||
| Line 58: | Line 58: | ||
There are two ready-made examples available inside the example directory of the Marble source code: | There are two ready-made examples available inside the example directory of the Marble source code: | ||
< | <syntaxhighlight lang="text"> | ||
marble/examples/example1.ui | marble/examples/example1.ui | ||
marble/examples/example2.ui | marble/examples/example2.ui | ||
Revision as of 20:49, 29 June 2011
Editing Projects/Marble/MarbleDesigner
Languages: عربي | Asturianu | Català | Česky | Kaszëbsczi | Dansk | Deutsch | English | Esperanto | Español | Eesti | فارسی | Suomi | Français | Galego | Italiano | 日本語 | 한국어 | Norwegian | Polski | Português Brasileiro | Română | Русский | Svenska | Slovenčina | Slovenščina | српски | Türkçe | Tiếng Việt | Українська | 简体中文 | 繁體中文
| 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 Marble Widget is also offered as a Qt Designer plugin. If you compile Marble yourself you probably need to enable the compilation of the Qt Designer plugin:
If your source directory is "~/marble" and your build directory is "~/marble_build" then you can enable compilation of the Qt Designer plugin via the cmake call:
<syntaxhighlight lang="text"> cmake -DQTONLY=OFF -DWITH_DESIGNER_PLUGIN=ON ../marble
Choose "-DQTONLY=ON" as a parameter if you don't have KDE installed.
Once you have compiled Marble using "make" you can install everything using "make install". This should install the file
<syntaxhighlight lang="text"> MarbleWidgetPlugin.so
into Qt's designer plugin directory (please check this in case things don't work out). If you compile the Qt-Only version then the file name is called libMarbleWidgetPlugin.so.
Once you start Qt Designer you should spot a new "Marble Desktop Globe" category in the widget box on the left:
On Windows you must keep in mind that your MarbleWidget.dll must be in the PATH when the designer executable is called. Otherwise the marble plugins will result in a loading error.
Using the MarbleWidget Plugin
You can use this Marble Widget just like all other widgets inside Qt Designer: Once you have started Qt 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:
Alternatively we also provide other widget plugins that allow controlling the Marble Widget: e.g. the navigation widget plugin and the latitude-longitude widget plugin.
The map properties of the Marble Widget 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:
<syntaxhighlight lang="text"> 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. Inside the preview it's possible to pan and zoom the map. Of course the signal-slot connections can be tested inside the preview as well.