source: trunk/VUT/GtpVisibilityPreprocessor/src/Preprocessor.h @ 563

Revision 563, 4.8 KB checked in by bittner, 19 years ago (diff)

rss sampling changes, preprocessor::GenerateRays?

Line 
1#ifndef _Preprocessor_H__
2#define _Preprocessor_H__
3
4#include <string>
5using namespace std;
6#include "Containers.h"
7#include "Mesh.h"
8#include "KdTree.h"
9
10#include <QObject>
11
12class RenderSimulator;
13class SceneGraph;
14class Exporter;
15class ViewCellsManager;
16class BspTree;
17class VspKdTree;
18class VspBspTree;
19class RenderSimulator;
20struct VssRayContainer;
21
22class GlRendererBuffer;
23
24/** Namespace for the external visibility preprocessor
25
26    This namespace includes all classes which are created by the VUT (Vienna University
27    of Technology) for the External Visibility Preprocessor of the GTP (GameTools Project)
28    (www.gametools.org).
29*/
30 
31  /** Main class of the visibility preprocessor. Responsible for loading and
32      saving of the input and output files. Initiates construction of the kD-tree,
33      viewcell loading/generation and the visibility computation itself.
34  */
35class Preprocessor : public QObject {
36  Q_OBJECT
37
38public:
39        /** Default constructor initialising e.g., KD tree and BSP tree.
40        */
41        Preprocessor();
42
43   virtual ~Preprocessor();
44
45  /** Load the input scene.
46      @param filename file to load
47        @return true on success
48  */
49  virtual bool LoadScene(const string filename);
50 
51  /** Export all preprocessed data in a XML format understandable by the
52      PreprocessingInterface of the GtpVisibilityPreprocessor Module. The file can be compressed depending
53      on the environement settings.
54      @return true on successful export
55  */
56  virtual bool ExportPreprocessedData(const string filename);
57 
58  /** Build the KdTree of currently loaded occluders/occludees/viewcells. The construction
59      is driven by the environment settings, which also sais which of the three types of
60      entities should be used to drive the heuristical construction (only occluders by default)
61  */
62  virtual bool BuildKdTree();
63
64  /** Compute visibility method. This method has to be reimplemented by the actual
65      Preprocessor implementation (e.g. SamplingPreprocessor, ExactPreprocessor,
66      GlobalSamplingpreprocessor)
67    */
68  virtual bool ComputeVisibility() = 0;
69 
70  /** View cells are either loaded or prepared for generation, according to the chosen environment
71      object. Important evironment options are, e.g, the view cell type.
72      Should be done after scene loading (i.e., some options are based on scene type).
73  */
74  bool PrepareViewCells();
75 
76  bool
77  Export( const string filename,
78          const bool scene,
79          const bool kdtree,
80          const bool bsptree
81          );
82 
83 
84  virtual void KdTreeStatistics(ostream &s);
85  virtual void BspTreeStatistics(ostream &s);
86
87  /** Loads samples from file.
88          @param samples returns the stored sample rays
89          @param objects needed to associate the objects ids
90          @returns true if samples were loaded successfully
91  */
92  bool LoadSamples(VssRayContainer &samples,
93                                   ObjectContainer &objects) const;
94
95  /** Exports samples to file.
96          @returns true if samples were written successfully
97  */
98  bool ExportSamples(const VssRayContainer &samples) const;
99
100  /** Get Sample rays of particular type, returns false if this
101          type of rays is not supported by the preprocessor
102  */
103  enum {
104        OBJECT_BASED_DISTRIBUTION,
105        DIRECTION_BASED_DISTRIBUTION,
106        DIRECTION_BOX_BASED_DISTRIBUTION,
107        SPATIAL_BOX_BASED_DISTRIBUTION,
108        RSS_BASED_DISTRIBUTION,
109        RSS_SILHOUETTE_BASED_DISTRIBUTION,
110        VSS_BASED_DISTRIBUTION
111  };
112 
113  virtual bool
114  GenerateRays(
115                           const int number,
116                           const int raysType,
117                           SimpleRayContainer &rays
118                           );
119 
120  /// scene graph loaded from file
121  SceneGraph *mSceneGraph;
122
123  /// raw array of objects
124  ObjectContainer mObjects;
125 
126  /// kD-tree organizing the scene graph (occluders + occludees) + viewcells
127  KdTree *mKdTree;
128 
129  /// View space partition bsp tree
130  VspBspTree *mVspBspTree;
131  /// list of all loaded occluders
132  ObjectContainer mOccluders;
133  /// list of all loaded occludees
134  ObjectContainer mOccludees;
135   
136  /// BSP tree representing the viewcells
137  BspTree *mBspTree;
138
139  ViewCellsManager *mViewCellsManager;
140
141  /** Kd tree inducing a coarse partition of view space that are the building
142          blocks for view cells.
143  */
144  VspKdTree *mVspKdTree;
145
146  bool mUseGlRenderer;
147  bool mUseGlDebugger;
148
149  bool mLoadViewCells;
150
151  string mViewCellsFilename;
152 
153  bool mDetectEmptyViewSpace;
154 
155protected:
156
157  /////////////////////////
158
159  /// samples used for construction of the BSP view cells tree.
160  int mBspConstructionSamples;
161   /// samples used for construction of the VSP KD tree.
162  int mVspKdConstructionSamples;
163  /** Simulates rendering of the scene.
164  */
165  RenderSimulator *mRenderSimulator;
166
167  GlRendererBuffer *renderer;
168 
169  signals:
170  void EvalPvsStat();
171
172};
173
174
175
176extern Preprocessor *preprocessor;
177
178#endif
Note: See TracBrowser for help on using the repository browser.