You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
132 lines
4.0 KiB
C++
132 lines
4.0 KiB
C++
/*=========================================================================
|
|
|
|
Program: Visualization Toolkit
|
|
Module: vtkGeoSource.h
|
|
|
|
Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
|
|
All rights reserved.
|
|
See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
|
|
|
|
This software is distributed WITHOUT ANY WARRANTY; without even
|
|
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
PURPOSE. See the above copyright notice for more information.
|
|
|
|
=========================================================================*/
|
|
/*-------------------------------------------------------------------------
|
|
Copyright 2008 Sandia Corporation.
|
|
Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
|
|
the U.S. Government retains certain rights in this software.
|
|
-------------------------------------------------------------------------*/
|
|
/**
|
|
* @class vtkGeoSource
|
|
* @brief A multi-resolution geographic data source
|
|
*
|
|
*
|
|
* vtkGeoSource is an abstract superclass for all multi-resolution data sources
|
|
* shown in a geographic view like vtkGeoView or vtkGeoView2D. vtkGeoSource
|
|
* subclasses need to implement the FetchRoot() method, which fills a
|
|
* vtkGeoTreeNode with the low-res data at the root, and FetchChild(), which
|
|
* produces a refinement of a parent node. Other geovis classes such as
|
|
* vtkGeoTerrain, vtkGeoTerrain2D, and vtkGeoAlignedImageSource use a
|
|
* vtkGeoSource subclass to build their geometry or image caches which are
|
|
* stored in trees. The source itself does not maintain the tree, but
|
|
* simply provides a mechanism for generating refined tree nodes.
|
|
*
|
|
* Sources are multi-threaded. Each source may have one or more worker threads
|
|
* associated with it, which this superclass manages. It is essential that the
|
|
* FetchChild() method is thread-safe, since it may be called from multiple
|
|
* workers simultaneously.
|
|
*/
|
|
|
|
#ifndef vtkGeoSource_h
|
|
#define vtkGeoSource_h
|
|
|
|
#include "vtkGeovisCoreModule.h" // For export macro
|
|
#include "vtkObject.h"
|
|
|
|
class vtkAbstractTransform;
|
|
class vtkCollection;
|
|
class vtkConditionVariable;
|
|
class vtkGeoTreeNode;
|
|
class vtkMultiThreader;
|
|
class vtkMutexLock;
|
|
|
|
class VTKGEOVISCORE_EXPORT vtkGeoSource : public vtkObject
|
|
{
|
|
public:
|
|
vtkTypeMacro(vtkGeoSource,vtkObject);
|
|
|
|
vtkGeoSource();
|
|
~vtkGeoSource();
|
|
|
|
//@{
|
|
/**
|
|
* Blocking access methods to be implemented in subclasses.
|
|
*/
|
|
virtual bool FetchRoot(vtkGeoTreeNode* root) = 0;
|
|
virtual bool FetchChild(vtkGeoTreeNode* node, int index, vtkGeoTreeNode* child) = 0;
|
|
//@}
|
|
|
|
//@{
|
|
/**
|
|
* Non-blocking methods for to use from the main application.
|
|
* After calling RequestChildren() for a certain node,
|
|
* GetRequestedNodes() will after a certain period of time return a
|
|
* non-null pointer to a collection of four vtkGeoTreeNode objects,
|
|
* which are the four children of the requested node.
|
|
* The collection is reference counted, so you need to eventually
|
|
* call Delete() on the returned collection pointer (if it is non-null).
|
|
*/
|
|
virtual void RequestChildren(vtkGeoTreeNode* node);
|
|
virtual vtkCollection* GetRequestedNodes(vtkGeoTreeNode* node);
|
|
//@}
|
|
|
|
/**
|
|
* Spawn worker threads.
|
|
*/
|
|
void Initialize(int numThreads = 1);
|
|
|
|
/**
|
|
* Shut down the source. This terminates the thread and releases memory.
|
|
*/
|
|
void ShutDown();
|
|
|
|
void WorkerThread();
|
|
|
|
/**
|
|
* Return the projection transformation used by this source.
|
|
*/
|
|
virtual vtkAbstractTransform* GetTransform() { return NULL; }
|
|
|
|
protected:
|
|
|
|
vtkCollection* InputSet;
|
|
vtkCollection* ProcessingSet;
|
|
|
|
//@{
|
|
/**
|
|
* Locks the set for reading or writing
|
|
*/
|
|
vtkMutexLock* InputSetLock;
|
|
vtkMutexLock* ProcessingSetLock;
|
|
vtkMutexLock* OutputSetLock;
|
|
//@}
|
|
|
|
vtkMutexLock* Lock;
|
|
|
|
vtkConditionVariable* Condition;
|
|
|
|
vtkMultiThreader* Threader;
|
|
bool StopThread;
|
|
bool Initialized;
|
|
|
|
class implementation;
|
|
implementation* Implementation;
|
|
|
|
private:
|
|
vtkGeoSource(const vtkGeoSource&) VTK_DELETE_FUNCTION;
|
|
void operator=(const vtkGeoSource&) VTK_DELETE_FUNCTION;
|
|
};
|
|
|
|
#endif // vtkGeoSource_h
|