Difference between revisions of "QML GUI"

From Navit's Wiki
Jump to: navigation, search
Line 11: Line 11:
 
</pre>
 
</pre>
  
At the scripts output you should have the following lines:
+
At the script output you should have the following lines:
 
<pre>
 
<pre>
 
Graphics types: yes (default)
 
Graphics types: yes (default)
   '''qt_qpainter:      yes (default)'''
+
   qt_qpainter:      yes (default)
 
GUI types:
 
GUI types:
   '''qml:              yes (configure parameter)'''
+
   qml:              yes (configure parameter)
 
</pre>
 
</pre>
  
both of them are required for gui qml
+
both of them are required for gui qml. So if those lines present, do your usual make && make install/dpkg-buildpackage/your platform specific thing.
  
 +
==Configuring==
 +
 +
Right now QML gui is compatible only with qt_qpainter graphics type. I hope there will be more graphics types in the future, but now you have to switch to qt_qpainter:
 +
 +
<pre>
 +
    <graphics type="qt_qpainter"/>
 +
</pre>
 +
 +
And enable qml gui:
 +
<pre>
 +
    <gui type="qml" enabled="yes"/>
 +
</pre>
 +
 +
All other gui modules MUST be disabled by setting
 +
 +
<pre>
 +
    enabled="no"
 +
</pre>
 +
 +
in their configuration stanzas.
 +
 +
QML gui doesn't requires any special configuration, but it could be tuned. It support the following parameters:
 +
    #fullscreen - "1"-Default is fullscreen mode,'''"0"-Default is windows mode'''
 +
    #menu_on_map_click - '''"1"-single click on map will switch to gui''',"0"-Gui could be switched only by command (not yet implemented)
 +
    #signal_on_map_click - "1"-DBus signal will be sent on single click on map,'''"0"-map click processing will be controlled bu menu_on_map_click'''
 +
    #radius - Distance in meters for searching point name. '''Default is 10'''
 +
    #pitch - Initial pitch for 3D view. '''Default is 20'''
 +
    #lazy - '''"1"-Gui should be lazy and keep it state between calls''',"0"-Gui is always reset to main page when called
 +
    #width #height - Width and height for gui window. '''Default values are 800 and 600'''
 +
    #source - Directory with qml skins. '''Default value is NAVIT_SHAREDIR/gui/qml/skins'''
 +
    #skin - Skin for gui. '''Default skin is navit'''
 +
    #icon_srv - Directory with icons for gui.'''Default value is NAVIT_SHAREDIR/xpm/
 +
 +
==Using==
 
[[Category:Gui]]
 
[[Category:Gui]]

Revision as of 10:09, 29 March 2010

QML gui is designed to be a modern and flexible replacement of internal gui. It is based on Qt's Declarative UI framework, therefore it could be run on ant Qt platform, including mobile platforms with touchscreens etc

Building

First of all - you have to install Qt 4.6 and a SNAPSHOT of a Declarative UI With snapshot mentioned above you have to use exactly Qt version 4.6.0, for other 4.6.x releases you have to manually checkout Declarative UI from git. Qt version 4.7 is unsupported yet.

When you have prepared your Qt environment, it's time to build Navit:

./configure --enable-gui-qml

At the script output you should have the following lines:

Graphics types: yes (default)
  qt_qpainter:       yes (default)
GUI types:
  qml:               yes (configure parameter)

both of them are required for gui qml. So if those lines present, do your usual make && make install/dpkg-buildpackage/your platform specific thing.

Configuring

Right now QML gui is compatible only with qt_qpainter graphics type. I hope there will be more graphics types in the future, but now you have to switch to qt_qpainter:

    <graphics type="qt_qpainter"/>

And enable qml gui:

    <gui type="qml" enabled="yes"/>

All other gui modules MUST be disabled by setting

    enabled="no"

in their configuration stanzas.

QML gui doesn't requires any special configuration, but it could be tuned. It support the following parameters:

   #fullscreen - "1"-Default is fullscreen mode,"0"-Default is windows mode
   #menu_on_map_click - "1"-single click on map will switch to gui,"0"-Gui could be switched only by command (not yet implemented)
   #signal_on_map_click - "1"-DBus signal will be sent on single click on map,"0"-map click processing will be controlled bu menu_on_map_click
   #radius - Distance in meters for searching point name. Default is 10
   #pitch - Initial pitch for 3D view. Default is 20
   #lazy - "1"-Gui should be lazy and keep it state between calls,"0"-Gui is always reset to main page when called
   #width #height - Width and height for gui window. Default values are 800 and 600
   #source - Directory with qml skins. Default value is NAVIT_SHAREDIR/gui/qml/skins
   #skin - Skin for gui. Default skin is navit
   #icon_srv - Directory with icons for gui.Default value is NAVIT_SHAREDIR/xpm/

Using