## page was renamed from qt_ros/Tutorials/Qt App Templates
## For instruction on writing tutorials
## http://www.ros.org/wiki/WritingTutorials
####################################
##FILL ME IN
####################################
## for a custom note with links:
## note =
## for the canned note of "This tutorial assumes that you have completed the previous tutorials:" just add the links 
## note.0= 
## descriptive title for the tutorial
## title = Qt App Templates
## multi-line description to be displayed in search 
## description = Speeding app development with quickstart templates via roscreate-qt-pkg.
## the next tutorial description (optional)
## next =
## links to next tutorial (optional)
## next.0.link=
## next.1.link=
## what level user is this tutorial for 
## level= BeginnerCategory
## keywords =
####################################

<<IncludeCSTemplate(TutorialCSHeaderTemplate)>>

<<Version()>>

== Goal ==

{{{#!wiki version electric fuerte
 * Generate a qt-ros application package with `roscreate-qt-pkg`.
}}}
{{{#!wiki version groovy hydro indigo jade kinetic lunar melodic
 * Generate a qt-ros application package with `catkin_create_qt_pkg`.
}}}


== Details ==

Currently the creational script generates only one template app, though this may be expanded in future. Features include:

 * a ros master chooser
 * separate ui and ros node classes
 * ros node class has connections for gui logging and a spinner

== Usage ==

{{{{#!wiki version electric fuerte
{{{
> rosrun qt_create roscreate-qt-pkg qdude
}}}
You can either build with rosbuild (native) or catkin (native/cross-compiles). Refer to the [[mingw_cross/Tutorials/Mingw Build Environment|mingw build environment]] and  the [[mingw_cross/Tutorials/Mingw Qt-Ros Packages|mingw qt-ros]] tutorials for more details.

}}}}

{{{{#!wiki version groovy
{{{
> source /path/to/my/source/workspace/devel/setup.bash
> cd /path/to/my/workspace/src
> catkin_create_qt_pkg qdude
> cd /path/to/my/workspace
> catkin_make --force-cmake
> rosrun qdude qdude
}}}
}}}}

{{{{#!wiki version hydro indigo jade kinetic lunar melodic
{{{
> source /path/to/my/source/workspace/devel/setup.bash
> cd /path/to/my/workspace/src
> catkin_create_qt_pkg qdude
> cd /path/to/my/workspace
> catkin_make --force-cmake
> rosrun qdude qdude
}}}
}}}}

{{{#!wiki version groovy hydro indigo jade kinetic lunar melodic
Simply `catkin_make` in place (native compile) to compile. We've temporarily dropped cross compiling support with the mingw cross compiler on groovy (we're not using any longer) but is possible. Feel free to ask questions if you want to get it working.
}}}

Once compiled and running, you can:

 * Affect gui changes in `main_window.ui` with qt designer
 * Modify qt code in `main_window.hpp`/`main_window.cpp` 
 * Do ros topics and services in `qnode.hpp`/`qnode.cpp`. 

For more advanced qt options (e.g. specifying qt components), see the notes in [[qt_build]] for a more detailed explanation now how to use the cmake api to configure your package.

== Screenshot ==

{{attachment:mingw_cross/Tutorials/Mingw Qt-Ros Packages/mingw_demo.png}}


## AUTOGENERATED DO NOT DELETE 
## TutorialCategory
## FILL IN THE STACK TUTORIAL CATEGORY HERE