Projects/Marble/RunnerHOWTO - Revision history

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:49:11Z
Text replace - "<code>" to "<syntaxhighlight lang="text">"

				
				
				
				
			
			← Older revision
			Revision as of 20:49, 29 June 2011
			
Line 104:
Line 104:
  To add the runner to Marble, you would have to put the source files into the src/lib/runners directory, and add them to CMakeLists.txt, then add a part in src/lib/MarbleRunnerManager.cpp that creates the object and connects it exactly the same way as the other two, like so:   To add the runner to Marble, you would have to put the source files into the src/lib/runners directory, and add them to CMakeLists.txt, then add a part in src/lib/MarbleRunnerManager.cpp that creates the object and connects it exactly the same way as the other two, like so:
    
− <code> + <syntaxhighlight lang="text">
  Index: src/lib/MarbleRunnerManager.h                             Index: src/lib/MarbleRunnerManager.h                          
  ===================================================================   ===================================================================

`Neverendingo: Text replace - "`" to ""

2011-06-29T20:45:42Z

Text replace - "</code>" to "</syntaxhighlight>"

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:31:39Z
Text replace - "<code cppqt>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 20:31, 29 June 2011
			
Line 15:
Line 15:
    
  '''ExampleRunner.h'''   '''ExampleRunner.h'''
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
    
  #ifndef EXAMPLERUNNER_H   #ifndef EXAMPLERUNNER_H
Line 45:
Line 45:
  '''ExampleRunner.cpp'''   '''ExampleRunner.cpp'''
    
− <code cppqt> + <syntaxhighlight lang="cpp-qt">
  #include "ExampleRunner.h"   #include "ExampleRunner.h"



Earthwings: Reflect code state in trunk
2010-02-02T22:27:40Z
Reflect code state in trunk

				
				
				
				
			
			← Older revision
			Revision as of 22:27, 2 February 2010
			
Line 8:
Line 8:
  # The current text is sent to the MarbleRunnerManager   # The current text is sent to the MarbleRunnerManager
  # The MarbleRunnerManager gives the text to all of the runners   # The MarbleRunnerManager gives the text to all of the runners
− # The runners emit the runnerStarted() signal. The MarbleRunnerManager uses this to count how many runners are still active. + # The MarbleRunnerManager starts each runner thread and registers it as active
− # The runners finish by emitting the runnerFinished(QVector<GeoDataPlacemark*>) signal. Note that if the runner fails to produce results for some reason, this signal should be emitted with an empty QVector, as it's needed to keep track of which runners are still working. + # The runners finish by emitting the runnerFinished(QVector<GeoDataPlacemark*>) signal. Note that if the runner fails to produce results for some reason, this signal must be emitted with an empty QVector, as it's needed to keep track of which runners are still working.
  # The MarbleRunnerManager gives results back to the MarbleControlBox.   # The MarbleRunnerManager gives results back to the MarbleControlBox.
    
− The main work of the runner is done in the parse(const QString &input) slot; + The main work of the runner is done in the thread's run() method. It should emit runnerFinished() at any exit point. The input is provided to the base class via the parse() method which stores the input.
− it should emit runnerStarted() at the beginning and runnerFinished() at any exit point. + 
    
  '''ExampleRunner.h'''   '''ExampleRunner.h'''
Line 33:
Line 32:
       ~ExampleRunner();        ~ExampleRunner();
       GeoDataFeature::GeoDataVisualCategory category() const;        GeoDataFeature::GeoDataVisualCategory category() const;
−   +      virtual void run();
− public slots: + 
−      void parse(const QString &input); + 
  };   };
    
Line 78:
Line 75:
  }   }
    
− void ExampleRunner::parse(const QString &input) + void ExampleRunner::run()
  {   {
−     emit runnerStarted();  
       QVector<GeoDataPlacemark*> vector;        QVector<GeoDataPlacemark*> vector;
       if(input.toLower() == tr("middle of nowhere")) {        if(input.toLower() == tr("middle of nowhere")) {
           GeoDataPlacemark *placemark = new GeoDataPlacemark();            GeoDataPlacemark *placemark = new GeoDataPlacemark();
           placemark->setCoordinate( -90.1833 *DEG2RAD, 51.4666 *DEG2RAD);            placemark->setCoordinate( -90.1833 *DEG2RAD, 51.4666 *DEG2RAD);
−          placemark->setName( input ); +          placemark->setName( m_input );
           placemark->setVisualCategory( category() );            placemark->setVisualCategory( category() );
           placemark->setPopularity( 1000000000 );            placemark->setPopularity( 1000000000 );
Line 102:
Line 98:
  ExampleRunner::category() returns the visual category of the results produced by this runner; in this case we use Default because there isn't an existing category for Techbase examples.   ExampleRunner::category() returns the visual category of the results produced by this runner; in this case we use Default because there isn't an existing category for Techbase examples.
    
− runnerStarted() gets emitted at the beginning to notify the runner manager that we've started parsing; then we do a very simple case-insensitive check to see if it matches. + The input is taken doing a very simple case-insensitive check to see if it matches. Results are GeoDataPlacemarks, and it's useful to set various parameters for them: set the category to the runner's category, set the name, set the popularity / popularity index (see the documentation for GeoDataPlacemark for details), etc...
−   + 
− Results are GeoDataPlacemarks, and it's useful to set various parameters for them: set the category to the runner's category, set the name, set the popularity / popularity index (see the documentation for GeoDataPlacemark for details), etc... + 
    
  Then the pointer to the placemark is put into the results vector and the runner emits runnerFinished(), returning it to the runner manager. If it didn't match, it returns an empty vector.   Then the pointer to the placemark is put into the results vector and the runner emits runnerFinished(), returning it to the runner manager. If it didn't match, it returns an empty vector.



Hdevalence: add diff and picture
2008-11-20T04:21:22Z
add diff and picture

				
				
				
				
			
			← Older revision
			Revision as of 04:21, 20 November 2008
			
Line 108:
Line 108:
  Then the pointer to the placemark is put into the results vector and the runner emits runnerFinished(), returning it to the runner manager. If it didn't match, it returns an empty vector.   Then the pointer to the placemark is put into the results vector and the runner emits runnerFinished(), returning it to the runner manager. If it didn't match, it returns an empty vector.
    
− To add the runner to Marble, you would have to put the source files into the src/lib/runners directory, and add them to CMakeLists.txt, then add a part in src/lib/MarbleRunnerManager.cpp that creates the object and connects it exactly the same way as the other two. + To add the runner to Marble, you would have to put the source files into the src/lib/runners directory, and add them to CMakeLists.txt, then add a part in src/lib/MarbleRunnerManager.cpp that creates the object and connects it exactly the same way as the other two, like so:
  +  
  + <code>
  + Index: src/lib/MarbleRunnerManager.h                         
  + ===================================================================
  + --- src/lib/MarbleRunnerManager.h       (revision 886350)          
  + +++ src/lib/MarbleRunnerManager.h       (working copy)             
  + @@ -33,6 +33,7 @@                                                  
  +                                                                    
  +  class LatLonRunner;                                               
  +  class OnfRunner;                                                  
  + +class ExampleRunner;                                              
  +                                                                    
  +  class MarbleRunnerManager : public QObject                        
  +  {                                                                 
  + @@ -60,6 +61,7 @@                                                  
  +                                                                    
  +      LatLonRunner *m_latlonRunner;                                 
  +      OnfRunner *m_onfRunner;                                       
  + +    ExampleRunner *m_exampleRunner;                               
  +  };                                                                
  +                                                                    
  +  }                                                                 
  + Index: src/lib/MarbleRunnerManager.cpp                             
  + ===================================================================
  + --- src/lib/MarbleRunnerManager.cpp     (revision 886350)          
  + +++ src/lib/MarbleRunnerManager.cpp     (working copy)             
  + @@ -27,6 +27,7 @@                                                  
  +                                                                    
  +  #include "LatLonRunner.h"                                         
  +  #include "OnfRunner.h"                                            
  + +#include "ExampleRunner.h"                                        
  +                                                                    
  +  #include <QtCore/QObject>                                         
  +  #include <QtCore/QString>                                         
  + @@ -66,6 +67,16 @@                                                 
  +               this,        SLOT( slotRunnerFinished( QVector<GeoDataPlacemark*> ) ));
  +      connect( this,        SIGNAL( engage(QString) ),                                
  +               m_onfRunner, SLOT( parse(QString) ));                                  
  + +                                                                                    
  + +    m_exampleRunner = new ExampleRunner(0);                                         
  + +    m_exampleRunner->start();                                                       
  + +    m_exampleRunner->moveToThread(m_exampleRunner);                                 
  + +    connect( m_exampleRunner, SIGNAL( runnerStarted() ),                            
  + +             this,        SLOT( slotRunnerStarted() ));                             
  + +    connect( m_exampleRunner, SIGNAL( runnerFinished( QVector<GeoDataPlacemark*> ) ),
  + +             this,        SLOT( slotRunnerFinished( QVector<GeoDataPlacemark*> ) )); 
  + +    connect( this,        SIGNAL( engage(QString) ),                                 
  + +             m_exampleRunner, SLOT( parse(QString) ));                               
  +  }                                                                                    
  +  
  +  MarbleRunnerManager::~MarbleRunnerManager()
  + Index: src/lib/CMakeLists.txt
  + ===================================================================
  + --- src/lib/CMakeLists.txt      (revision 886350)
  + +++ src/lib/CMakeLists.txt      (working copy)
  + @@ -161,6 +161,7 @@
  +      runners/MarbleAbstractRunner.cpp
  +      runners/LatLonRunner.cpp
  +      runners/OnfRunner.cpp
  + +    runners/ExampleRunner.cpp
  +  )
  +  
  +  set (marblewidget_UI
  + </code>
  +  
  + The result of this is that when you search for "Middle of Nowhere", you get:
  + [[Image:MiddleOfNowhere.png]]



Tampakrap: add a first bit of runner stuff
2008-11-20T04:05:22Z
add a first bit of runner stuff
New page
The basic idea of the Marble Runners is borrowed from KRunner. A user search could represent a bunch of different things: a geographical coordinate, an address, a wikipedia article, directions, etc...



Because each of these searches is different in type as well as speed (e.g. a OSM Namefinder search takes much longer than parsing coordinates) each type of search is done in its own runner which is a seperate thread.



The piece that manages all the runners is the MarbleRunnerManager. It receives search text from the MarbleControlBox (where the lineedit is) and then gives it to all of the runners.



# User presses return in the line edit

# The current text is sent to the MarbleRunnerManager

# The MarbleRunnerManager gives the text to all of the runners

# The runners emit the runnerStarted() signal. The MarbleRunnerManager uses this to count how many runners are still active.

# The runners finish by emitting the runnerFinished(QVector<GeoDataPlacemark*>) signal. Note that if the runner fails to produce results for some reason, this signal should be emitted with an empty QVector, as it's needed to keep track of which runners are still working.

# The MarbleRunnerManager gives results back to the MarbleControlBox.



The main work of the runner is done in the parse(const QString &input) slot;

it should emit runnerStarted() at the beginning and runnerFinished() at any exit point.



'''ExampleRunner.h'''

<code cppqt>



#ifndef EXAMPLERUNNER_H

#define EXAMPLERUNNER_H



#include "MarbleAbstractRunner.h"



namespace Marble

{



class ExampleRunner : public MarbleAbstractRunner

{

    Q_OBJECT

public:

    ExampleRunner(QObject *parent = 0);

    ~ExampleRunner();

    GeoDataFeature::GeoDataVisualCategory category() const;



public slots:

    void parse(const QString &input);

};



}



#endif



</code>



This basically just defines the class; it doesn't do anything else.



'''ExampleRunner.cpp'''



<code cppqt>

#include "ExampleRunner.h"



#include "MarbleAbstractRunner.h"

#include "GeoDataFeature.h"

#include "GeoDataPlacemark.h"

#include "GeoDataCoordinates.h"



#include <QtCore/QDebug>

#include <QtCore/QString>

#include <QtCore/QStringList>

#include <QtCore/QVector>



namespace Marble

{



ExampleRunner::ExampleRunner(QObject *parent) : MarbleAbstractRunner(parent)

{

}





GeoDataFeature::GeoDataVisualCategory ExampleRunner::category() const

{

    return GeoDataFeature::Default;

}



ExampleRunner::~ExampleRunner()

{

}



void ExampleRunner::parse(const QString &input)

{

    emit runnerStarted();

    QVector<GeoDataPlacemark*> vector;

    if(input.toLower() == tr("middle of nowhere")) {

        GeoDataPlacemark *placemark = new GeoDataPlacemark();

        placemark->setCoordinate( -90.1833 *DEG2RAD, 51.4666 *DEG2RAD);

        placemark->setName( input );

        placemark->setVisualCategory( category() );

        placemark->setPopularity( 1000000000 );

        placemark->setPopularityIndex( 18 );

        vector.append( placemark );

    }

    emit runnerFinished(vector);

}



}



#include "ExampleRunner.moc"



</code>



ExampleRunner::category() returns the visual category of the results produced by this runner; in this case we use Default because there isn't an existing category for Techbase examples.



runnerStarted() gets emitted at the beginning to notify the runner manager that we've started parsing; then we do a very simple case-insensitive check to see if it matches.



Results are GeoDataPlacemarks, and it's useful to set various parameters for them: set the category to the runner's category, set the name, set the popularity / popularity index (see the documentation for GeoDataPlacemark for details), etc...



Then the pointer to the placemark is put into the results vector and the runner emits runnerFinished(), returning it to the runner manager. If it didn't match, it returns an empty vector.



To add the runner to Marble, you would have to put the source files into the src/lib/runners directory, and add them to CMakeLists.txt, then add a part in src/lib/MarbleRunnerManager.cpp that creates the object and connects it exactly the same way as the other two.

← Older revision		Revision as of 04:21, 20 November 2008
Line 108:		Line 108:
	Then the pointer to the placemark is put into the results vector and the runner emits runnerFinished(), returning it to the runner manager. If it didn't match, it returns an empty vector.		Then the pointer to the placemark is put into the results vector and the runner emits runnerFinished(), returning it to the runner manager. If it didn't match, it returns an empty vector.

−	To add the runner to Marble, you would have to put the source files into the src/lib/runners directory, and add them to CMakeLists.txt, then add a part in src/lib/MarbleRunnerManager.cpp that creates the object and connects it exactly the same way as the other two.	+	To add the runner to Marble, you would have to put the source files into the src/lib/runners directory, and add them to CMakeLists.txt, then add a part in src/lib/MarbleRunnerManager.cpp that creates the object and connects it exactly the same way as the other two, like so:
		+
		+	<code>
		+	Index: src/lib/MarbleRunnerManager.h
		+	===================================================================
		+	--- src/lib/MarbleRunnerManager.h (revision 886350)
		+	+++ src/lib/MarbleRunnerManager.h (working copy)
		+	@@ -33,6 +33,7 @@
		+
		+	class LatLonRunner;
		+	class OnfRunner;
		+	+class ExampleRunner;
		+
		+	class MarbleRunnerManager : public QObject
		+	{
		+	@@ -60,6 +61,7 @@
		+
		+	LatLonRunner *m_latlonRunner;
		+	OnfRunner *m_onfRunner;
		+	+ ExampleRunner *m_exampleRunner;
		+	};
		+
		+	}
		+	Index: src/lib/MarbleRunnerManager.cpp
		+	===================================================================
		+	--- src/lib/MarbleRunnerManager.cpp (revision 886350)
		+	+++ src/lib/MarbleRunnerManager.cpp (working copy)
		+	@@ -27,6 +27,7 @@
		+
		+	#include "LatLonRunner.h"
		+	#include "OnfRunner.h"
		+	+#include "ExampleRunner.h"
		+
		+	#include <QtCore/QObject>
		+	#include <QtCore/QString>
		+	@@ -66,6 +67,16 @@
		+	this, SLOT( slotRunnerFinished( QVector<GeoDataPlacemark*> ) ));
		+	connect( this, SIGNAL( engage(QString) ),
		+	m_onfRunner, SLOT( parse(QString) ));
		+	+
		+	+ m_exampleRunner = new ExampleRunner(0);
		+	+ m_exampleRunner->start();
		+	+ m_exampleRunner->moveToThread(m_exampleRunner);
		+	+ connect( m_exampleRunner, SIGNAL( runnerStarted() ),
		+	+ this, SLOT( slotRunnerStarted() ));
		+	+ connect( m_exampleRunner, SIGNAL( runnerFinished( QVector<GeoDataPlacemark*> ) ),
		+	+ this, SLOT( slotRunnerFinished( QVector<GeoDataPlacemark*> ) ));
		+	+ connect( this, SIGNAL( engage(QString) ),
		+	+ m_exampleRunner, SLOT( parse(QString) ));
		+	}
		+
		+	MarbleRunnerManager::~MarbleRunnerManager()
		+	Index: src/lib/CMakeLists.txt
		+	===================================================================
		+	--- src/lib/CMakeLists.txt (revision 886350)
		+	+++ src/lib/CMakeLists.txt (working copy)
		+	@@ -161,6 +161,7 @@
		+	runners/MarbleAbstractRunner.cpp
		+	runners/LatLonRunner.cpp
		+	runners/OnfRunner.cpp
		+	+ runners/ExampleRunner.cpp
		+	)
		+
		+	set (marblewidget_UI
		+	</code>
		+
		+	The result of this is that when you search for "Middle of Nowhere", you get:
		+	[[Image:MiddleOfNowhere.png]]

Projects/Marble/RunnerHOWTO - Revision history

Neverendingo: Text replace - "" to ""

Neverendingo: Text replace - "" to ""

Neverendingo: Text replace - "" to ""

Earthwings: Reflect code state in trunk

Hdevalence: add diff and picture

Tampakrap: add a first bit of runner stuff

Neverendingo: Text replace - "`" to ""`

`Neverendingo: Text replace - "`" to ""

Neverendingo: Text replace - "`" to ""`