ParaView
Public Slots | Signals | Public Member Functions | Static Public Member Functions | Protected Slots | Protected Attributes | List of all members
pqApplicationCore Class Reference

This class is the crux of the ParaView application. More...

#include <pqApplicationCore.h>

Inheritance diagram for pqApplicationCore:
Inheritance graph
[legend]
Collaboration diagram for pqApplicationCore:
Collaboration graph
[legend]

Public Slots

void prepareForQuit ()
 Applications calls this to ensure that any cleanup is performed correctly. More...
 
void quit ()
 Calls QCoreApplication::quit(). More...
 
void showOutputWindow ()
 Causes the output window to be shown. More...
 
void loadConfiguration (const QString &filename)
 Load configuration xml. More...
 
void loadConfigurationXML (const char *xmldata)
 
void render ()
 Renders all windows. More...
 

Signals

void aboutToLoadState (vtkPVXMLElement *root)
 Fired before a state xml is being loaded. More...
 
void stateLoaded (vtkPVXMLElement *root, vtkSMProxyLocator *locator)
 Fired when a state file is loaded successfully. More...
 
void stateSaved (vtkPVXMLElement *root)
 Fired to save state xml. More...
 
void undoStackChanged (pqUndoStack *)
 Fired when the undo stack is set. More...
 
void loadXML (vtkPVXMLElement *)
 Fired on loadConfiguration(). More...
 
void forceFilterMenuRefresh ()
 Fired when the filter menu state needs to be manually updated. More...
 
void updateMasterEnableState (bool)
 Fired when master changed. More...
 

Public Member Functions

 pqApplicationCore (int &argc, char **argv, pqOptions *options=0, QObject *parent=0)
 Preferred constructor. More...
 
pqOptionsgetOptions () const
 Provides access to the command line options object. More...
 
pqObjectBuildergetObjectBuilder () const
 Get the Object Builder. More...
 
void setUndoStack (pqUndoStack *stack)
 Set/Get the application's central undo stack. More...
 
pqUndoStackgetUndoStack () const
 
void registerManager (const QString &function, QObject *manager)
 Custom Applications may need use various "managers" All such manager can be registered with the pqApplicationCore so that that can be used by other components of the application. More...
 
QObject * manager (const QString &function)
 Returns a manager for a particular function, if any. More...
 
void unRegisterManager (const QString &function)
 Unregisters a manager for a particular function, if any. More...
 
void registerDocumentation (const QString &filename)
 QHelpEngine doesn't like filenames in resource space. More...
 
pqServerManagerObservergetServerManagerObserver ()
 ServerManagerObserver observer the vtkSMProxyManager for changes to the server manager and fires signals on certain actions such as registeration/unregistration of proxies etc. More...
 
pqServerManagerModelgetServerManagerModel () const
 ServerManagerModel is the representation of the ServerManager using pqServerManagerModelItem subclasses. More...
 
pq3DWidgetFactoryget3DWidgetFactory () const
 
pqInterfaceTrackerinterfaceTracker () const
 Locates the interface tracker for the application. More...
 
pqLinksModelgetLinksModel () const
 pqLinksModel is the model used to keep track of proxy/property links maintained by vtkSMProxyManager. More...
 
pqPluginManagergetPluginManager () const
 pqPluginManager manages all functionality associated with loading plugins. More...
 
pqProgressManagergetProgressManager () const
 ProgressManager is the manager that streamlines progress. More...
 
pqDisplayPolicygetDisplayPolicy () const
 Returns the display policy instance used by the application. More...
 
pqOutputWindowAdapteroutputWindowAdapter ()
 Returns the output window. More...
 
pqOutputWindowoutputWindow ()
 
void setDisplayPolicy (pqDisplayPolicy *dp)
 It is possible to change the display policy used by the application. More...
 
virtual pqTestUtility * testUtility ()
 Provides access to the test utility. More...
 
pqRecentlyUsedResourcesListrecentlyUsedResources ()
 Returns the set of recently-used resources i.e. More...
 
pqServerConfigurationCollectionserverConfigurations ()
 Returns the collection of server configurations known. More...
 
pqSettingssettings ()
 Get the application settings. More...
 
vtkPVXMLElementsaveState ()
 Save the ServerManager state. More...
 
void saveState (const QString &filename)
 
void loadState (vtkPVXMLElement *root, pqServer *server, vtkSMStateLoader *loader=NULL)
 Loads the ServerManager state. More...
 
void loadState (const char *filename, pqServer *server, vtkSMStateLoader *loader=NULL)
 Load state xml from a file. More...
 
void loadStateFromString (const char *xmlcontents, pqServer *server, vtkSMStateLoader *loader=NULL)
 Loads state from an in-memory buffer. More...
 
void loadStateIncremental (vtkPVXMLElement *root, pqServer *server, vtkSMStateLoader *loader=NULL)
 Same as loadState() except that it doesn't clear the current visualization state. More...
 
void loadStateIncremental (const QString &filename, pqServer *server, vtkSMStateLoader *loader=NULL)
 
bool isLoadingState ()
 Check to see if its in the process of loading a state Reliance on this flag is chimerical since we cannot set this ivar when state file is being loaded from python shell. More...
 
pqServergetActiveServer () const
 returns the active server is any. More...
 
void loadDistributedPlugins (const char *filename=0)
 Called to load the configuration xml bundled with the application the lists the plugins that the application is aware by default. More...
 
virtual ~pqApplicationCore ()
 Destructor. More...
 

Static Public Member Functions

static pqApplicationCoreinstance ()
 

Protected Slots

void onStateLoaded (vtkPVXMLElement *root, vtkSMProxyLocator *locator)
 
void onStateSaved (vtkPVXMLElement *root)
 

Protected Attributes

bool LoadingState
 
pqOutputWindowOutputWindow
 
pqOutputWindowAdapterOutputWindowAdapter
 
pqOptionsOptions
 
pq3DWidgetFactoryWidgetFactory
 
pqDisplayPolicyDisplayPolicy
 
pqLinksModelLinksModel
 
pqObjectBuilderObjectBuilder
 
pqInterfaceTrackerInterfaceTracker
 
pqPluginManagerPluginManager
 
pqProgressManagerProgressManager
 
pqServerManagerModelServerManagerModel
 
pqServerManagerObserverServerManagerObserver
 
pqUndoStackUndoStack
 
pqRecentlyUsedResourcesListRecentlyUsedResourcesList
 
pqServerConfigurationCollectionServerConfigurations
 
pqSettingsSettings
 
QPointer< pqTestUtility > TestUtility
 

Detailed Description

This class is the crux of the ParaView application.

It creates and manages various managers which are necessary for the ParaView-based client to work with the ServerManager. For clients based of the pqCore library, simply instantiate this pqApplicationCore after QApplication initialization and then create your main window etc. like a standard Qt application. You can then use the facilities provided by pqCore such as the pqObjectBuilder, pqUndoStack etc. in your application. After that point.

Definition at line 78 of file pqApplicationCore.h.

Constructor & Destructor Documentation

§ pqApplicationCore()

pqApplicationCore::pqApplicationCore ( int &  argc,
char **  argv,
pqOptions options = 0,
QObject *  parent = 0 
)

Preferred constructor.

Initializes the server-manager engine and sets up the core functionality. If application supports special command line options, pass an instance of pqOptions subclass to the constructor, otherwise a new instance of pqOptions with standard ParaView command line options will be created.

§ ~pqApplicationCore()

virtual pqApplicationCore::~pqApplicationCore ( )
virtual

Destructor.

Member Function Documentation

§ instance()

static pqApplicationCore* pqApplicationCore::instance ( )
static

§ getOptions()

pqOptions* pqApplicationCore::getOptions ( ) const
inline

Provides access to the command line options object.

Definition at line 99 of file pqApplicationCore.h.

§ getObjectBuilder()

pqObjectBuilder* pqApplicationCore::getObjectBuilder ( ) const
inline

Get the Object Builder.

Object Buider must be used to create complex objects such as sources, filters, readers, views, displays etc.

Definition at line 106 of file pqApplicationCore.h.

§ setUndoStack()

void pqApplicationCore::setUndoStack ( pqUndoStack stack)

Set/Get the application's central undo stack.

By default no undo stack is provided. Applications must set on up as required.

§ getUndoStack()

pqUndoStack* pqApplicationCore::getUndoStack ( ) const
inline

Definition at line 113 of file pqApplicationCore.h.

§ registerManager()

void pqApplicationCore::registerManager ( const QString &  function,
QObject *  manager 
)

Custom Applications may need use various "managers" All such manager can be registered with the pqApplicationCore so that that can be used by other components of the application.

Registering with pqApplicationCore gives easy access to these managers from the application code. Note that custom applications are not required to register managers. However certain optional components of the pqCore may expect some managers. Only one manager can be registered for a function.

§ manager()

QObject* pqApplicationCore::manager ( const QString &  function)

Returns a manager for a particular function, if any.

§ unRegisterManager()

void pqApplicationCore::unRegisterManager ( const QString &  function)

Unregisters a manager for a particular function, if any.

§ registerDocumentation()

void pqApplicationCore::registerDocumentation ( const QString &  filename)

QHelpEngine doesn't like filenames in resource space.

This method creates a temporary file for the resource and registers that with the QHelpEngine.

§ getServerManagerObserver()

pqServerManagerObserver* pqApplicationCore::getServerManagerObserver ( )
inline

ServerManagerObserver observer the vtkSMProxyManager for changes to the server manager and fires signals on certain actions such as registeration/unregistration of proxies etc.

Returns the ServerManagerObserver used by the application.

Definition at line 159 of file pqApplicationCore.h.

§ getServerManagerModel()

pqServerManagerModel* pqApplicationCore::getServerManagerModel ( ) const
inline

ServerManagerModel is the representation of the ServerManager using pqServerManagerModelItem subclasses.

It makes it possible to explore the ServerManager with ease by separating proxies based on their functionality/type.

Definition at line 167 of file pqApplicationCore.h.

§ get3DWidgetFactory()

pq3DWidgetFactory* pqApplicationCore::get3DWidgetFactory ( ) const
inline

Definition at line 169 of file pqApplicationCore.h.

§ interfaceTracker()

pqInterfaceTracker* pqApplicationCore::interfaceTracker ( ) const
inline

Locates the interface tracker for the application.

pqInterfaceTracker is used to locate all interface implementations typically loaded from plugins.

Definition at line 176 of file pqApplicationCore.h.

§ getLinksModel()

pqLinksModel* pqApplicationCore::getLinksModel ( ) const
inline

pqLinksModel is the model used to keep track of proxy/property links maintained by vtkSMProxyManager.

TODO: It may be worthwhile to investigate if we even need a global pqLinksModel. All the information is already available in vtkSMProxyManager.

Definition at line 185 of file pqApplicationCore.h.

§ getPluginManager()

pqPluginManager* pqApplicationCore::getPluginManager ( ) const
inline

pqPluginManager manages all functionality associated with loading plugins.

Definition at line 190 of file pqApplicationCore.h.

§ getProgressManager()

pqProgressManager* pqApplicationCore::getProgressManager ( ) const
inline

ProgressManager is the manager that streamlines progress.

Definition at line 195 of file pqApplicationCore.h.

§ getDisplayPolicy()

pqDisplayPolicy* pqApplicationCore::getDisplayPolicy ( ) const
inline

Returns the display policy instance used by the application.

pqDisplayPolicy defines the policy for creating representations for sources.

Definition at line 202 of file pqApplicationCore.h.

§ outputWindowAdapter()

pqOutputWindowAdapter* pqApplicationCore::outputWindowAdapter ( )
inline

Returns the output window.

Definition at line 207 of file pqApplicationCore.h.

§ outputWindow()

pqOutputWindow* pqApplicationCore::outputWindow ( )
inline

Definition at line 209 of file pqApplicationCore.h.

§ setDisplayPolicy()

void pqApplicationCore::setDisplayPolicy ( pqDisplayPolicy dp)

It is possible to change the display policy used by the application.

Used to change the active display policy. The pqApplicationCore takes over the ownership of the display policy.

§ testUtility()

virtual pqTestUtility* pqApplicationCore::testUtility ( )
virtual

Provides access to the test utility.

Reimplemented in pqPVApplicationCore.

§ recentlyUsedResources()

pqRecentlyUsedResourcesList& pqApplicationCore::recentlyUsedResources ( )

Returns the set of recently-used resources i.e.

data files and state files.

§ serverConfigurations()

pqServerConfigurationCollection& pqApplicationCore::serverConfigurations ( )

Returns the collection of server configurations known.

Server configurations have information about connecting to different servers.

§ settings()

pqSettings* pqApplicationCore::settings ( )

Get the application settings.

§ saveState() [1/2]

vtkPVXMLElement* pqApplicationCore::saveState ( )

Save the ServerManager state.

§ saveState() [2/2]

void pqApplicationCore::saveState ( const QString &  filename)

§ loadState() [1/2]

void pqApplicationCore::loadState ( vtkPVXMLElement root,
pqServer server,
vtkSMStateLoader loader = NULL 
)

Loads the ServerManager state.

Emits the signal stateLoaded() on loading state successfully.

§ loadState() [2/2]

void pqApplicationCore::loadState ( const char *  filename,
pqServer server,
vtkSMStateLoader loader = NULL 
)

Load state xml from a file.

The filename can be a Qt resource file, besides regular filesystem files (refer to QFile documentation for more information on Qt resource system).

§ loadStateFromString()

void pqApplicationCore::loadStateFromString ( const char *  xmlcontents,
pqServer server,
vtkSMStateLoader loader = NULL 
)

Loads state from an in-memory buffer.

§ loadStateIncremental() [1/2]

void pqApplicationCore::loadStateIncremental ( vtkPVXMLElement root,
pqServer server,
vtkSMStateLoader loader = NULL 
)

Same as loadState() except that it doesn't clear the current visualization state.

§ loadStateIncremental() [2/2]

void pqApplicationCore::loadStateIncremental ( const QString &  filename,
pqServer server,
vtkSMStateLoader loader = NULL 
)

§ isLoadingState()

bool pqApplicationCore::isLoadingState ( )
inline

Check to see if its in the process of loading a state Reliance on this flag is chimerical since we cannot set this ivar when state file is being loaded from python shell.

Definition at line 279 of file pqApplicationCore.h.

§ getActiveServer()

pqServer* pqApplicationCore::getActiveServer ( ) const

returns the active server is any.

§ loadDistributedPlugins()

void pqApplicationCore::loadDistributedPlugins ( const char *  filename = 0)

Called to load the configuration xml bundled with the application the lists the plugins that the application is aware by default.

If no filename is specified, {executable-path}/.plugins is loaded.

§ prepareForQuit

void pqApplicationCore::prepareForQuit ( )
slot

Applications calls this to ensure that any cleanup is performed correctly.

§ quit

void pqApplicationCore::quit ( )
slot

Calls QCoreApplication::quit().

§ showOutputWindow

void pqApplicationCore::showOutputWindow ( )
slot

Causes the output window to be shown.

§ loadConfiguration

void pqApplicationCore::loadConfiguration ( const QString &  filename)
slot

Load configuration xml.

This results in firing of the loadXML() signal which different components that support configuration catch and process to update their behavior.

§ loadConfigurationXML

void pqApplicationCore::loadConfigurationXML ( const char *  xmldata)
slot

§ render

void pqApplicationCore::render ( )
slot

Renders all windows.

§ aboutToLoadState

void pqApplicationCore::aboutToLoadState ( vtkPVXMLElement root)
signal

Fired before a state xml is being loaded.

One can add slots for this signal and modify the fired xml-element as part of pre-processing before attempting to load the state xml. Note that never attempt to connect to signal in a delayed fashion i.e using Qt::QueuedConnection etc. since the root will be destroyed.

§ stateLoaded

void pqApplicationCore::stateLoaded ( vtkPVXMLElement root,
vtkSMProxyLocator locator 
)
signal

Fired when a state file is loaded successfully.

GUI components that may have state saved in the XML state file must listen to this signal and handle process the XML to update their state.

§ stateSaved

void pqApplicationCore::stateSaved ( vtkPVXMLElement root)
signal

Fired to save state xml.

Components that need to save XML state should listen to this signal and add their XML elements to the root. DO NOT MODIFY THE ROOT besides adding new children.

§ undoStackChanged

void pqApplicationCore::undoStackChanged ( pqUndoStack )
signal

Fired when the undo stack is set.

§ loadXML

void pqApplicationCore::loadXML ( vtkPVXMLElement )
signal

§ forceFilterMenuRefresh

void pqApplicationCore::forceFilterMenuRefresh ( )
signal

Fired when the filter menu state needs to be manually updated.

§ updateMasterEnableState

void pqApplicationCore::updateMasterEnableState ( bool  )
signal

Fired when master changed.

true if current user is master, false otherwise.

§ onStateLoaded

void pqApplicationCore::onStateLoaded ( vtkPVXMLElement root,
vtkSMProxyLocator locator 
)
protectedslot

§ onStateSaved

void pqApplicationCore::onStateSaved ( vtkPVXMLElement root)
protectedslot

Member Data Documentation

§ LoadingState

bool pqApplicationCore::LoadingState
protected

Definition at line 377 of file pqApplicationCore.h.

§ OutputWindow

pqOutputWindow* pqApplicationCore::OutputWindow
protected

Definition at line 379 of file pqApplicationCore.h.

§ OutputWindowAdapter

pqOutputWindowAdapter* pqApplicationCore::OutputWindowAdapter
protected

Definition at line 380 of file pqApplicationCore.h.

§ Options

pqOptions* pqApplicationCore::Options
protected

Definition at line 381 of file pqApplicationCore.h.

§ WidgetFactory

pq3DWidgetFactory* pqApplicationCore::WidgetFactory
protected

Definition at line 383 of file pqApplicationCore.h.

§ DisplayPolicy

pqDisplayPolicy* pqApplicationCore::DisplayPolicy
protected

Definition at line 384 of file pqApplicationCore.h.

§ LinksModel

pqLinksModel* pqApplicationCore::LinksModel
protected

Definition at line 385 of file pqApplicationCore.h.

§ ObjectBuilder

pqObjectBuilder* pqApplicationCore::ObjectBuilder
protected

Definition at line 386 of file pqApplicationCore.h.

§ InterfaceTracker

pqInterfaceTracker* pqApplicationCore::InterfaceTracker
protected

Definition at line 387 of file pqApplicationCore.h.

§ PluginManager

pqPluginManager* pqApplicationCore::PluginManager
protected

Definition at line 388 of file pqApplicationCore.h.

§ ProgressManager

pqProgressManager* pqApplicationCore::ProgressManager
protected

Definition at line 389 of file pqApplicationCore.h.

§ ServerManagerModel

pqServerManagerModel* pqApplicationCore::ServerManagerModel
protected

Definition at line 390 of file pqApplicationCore.h.

§ ServerManagerObserver

pqServerManagerObserver* pqApplicationCore::ServerManagerObserver
protected

Definition at line 391 of file pqApplicationCore.h.

§ UndoStack

pqUndoStack* pqApplicationCore::UndoStack
protected

Definition at line 392 of file pqApplicationCore.h.

§ RecentlyUsedResourcesList

pqRecentlyUsedResourcesList* pqApplicationCore::RecentlyUsedResourcesList
protected

Definition at line 393 of file pqApplicationCore.h.

§ ServerConfigurations

pqServerConfigurationCollection* pqApplicationCore::ServerConfigurations
protected

Definition at line 394 of file pqApplicationCore.h.

§ Settings

pqSettings* pqApplicationCore::Settings
protected

Definition at line 395 of file pqApplicationCore.h.

§ TestUtility

QPointer<pqTestUtility> pqApplicationCore::TestUtility
protected

Definition at line 399 of file pqApplicationCore.h.


The documentation for this class was generated from the following file: