Changeset 2544 for GTP/trunk/Lib/Vis/Preprocessing/src/ViewCell.h

Timestamp:

08/22/07 08:01:21 (17 years ago)

Author:

mattausch

Message:

 

File:

• GTP/trunk/Lib/Vis/Preprocessing/src/ViewCell.h (modified) (13 diffs)

GTP/trunk/Lib/Vis/Preprocessing/src/ViewCell.h

@@ -25 +25 @@
 
 
-//class ObjectPvs;
-
 
 /** Statistics for a view cell partition.
 */
-
 class ViewCellsStatistics: public StatisticsBase
 {
@@ -84 +81 @@
 
 
+/** Statistics for a view cells tree.
+*/
 class ViewCellsTreeStats
 {
@@ -142 +141 @@
 
 
-/**
-        A view cell. View cells are regions in space. The visibility informations,
-        i.e., the primitives seen by the view cell are stored in a PVs.
-        A view cell can be represented in many different ways, e.g.,
-        a mesh representation.
+/** This class represents a view cell, which is a region in view space. 
+        The objects seen by the view cell are stored in a pvs.
+        A view cell can be represented in many different ways, e.g., as a mesh.
 */
 class ViewCell: public MeshInstance
@@ -156 +153 @@
 
         ViewCell();
-
         /** Constructor taking a mesh representing the shape of the viewcell.
         */
         ViewCell(Mesh *mesh);
-
         /** Default destructor.
         */
         virtual ~ViewCell();
-        /** Returns Pvs.
+        /** Returns const reference to pvs.
         */
         const ObjectPvs &GetPvs() const;
-        /** Returns pvs.
+        /** Returns reference to pvs.
         */
         ObjectPvs &GetPvs();
@@ -222 +217 @@
         */
         bool GetValid() const;
-
         /** Returns estimated render cost of this view cell.
         */
         float GetRenderCost() const;
-
         /** set color for visiualizations.
         */
         void SetColor(const RgbColor &color);
-
         /** get color for visualuzations.
         */
     RgbColor GetColor() const;
-
         /** Adds a sample to the pvs.
                 @param sample the sample to be added
@@ -241 +232 @@
         */
         bool AddPvsSample(Intersectable *sample, const float pdf, float &contribution);
-
         /** if this is a view cell correspending to a leaf in a hierarchy.
         */
@@ -257 +247 @@
         */
         void SetMergeCost(const float mergeCost);
-
         /** Returns merge cost needed to merge this leaf from other cells.
                 @hack The function is available for leaves also to have a common interface,
@@ -391 +380 @@
 {
 public:
-        ViewCellLeaf()  {  mActiveViewCell = this; }
-        ViewCellLeaf(Mesh *mesh):
-        ViewCell(mesh) { mActiveViewCell = this; }
+        
+        ViewCellLeaf()  
+        {  
+                mActiveViewCell = this; 
+        }
+        
+        ViewCellLeaf(Mesh *mesh): ViewCell(mesh) 
+        { 
+                mActiveViewCell = this; 
+        }
 
         bool IsLeaf() const
@@ -454 +450 @@
 public:
 
+        /** Default constructor.
+        */
         ViewCellsTree();
-
         /** View cells tree constructor taking a view cell mnanager as parameter
         */
         ViewCellsTree(ViewCellsManager *vcm);
+        /** Destructor.
+        */
         ~ViewCellsTree();
-
         /** Returns number of leaves this view cell consists of.
         */
         int GetNumInitialViewCells(ViewCell *vc) const;
-
         /** Collects leaves corresponding to a view cell.
         */
         void CollectLeaves(ViewCell *vc, ViewCellContainer &leaves) const;
-
         /** Merges view cells according to some cost heuristics.
         */
         int ConstructMergeTree(const VssRayContainer &rays, const ObjectContainer &objects);
-        
         /** Refines view cells using shuffling, i.e., border leaves 
                 of two view cells are exchanged if the resulting view cells
@@ -479 +474 @@
         */
         int RefineViewCells(const VssRayContainer &rays, const ObjectContainer &objects);
-        
         /** Assign colors to the viewcells so that they can be renderered interactively without
             color flickering.  
         */
         void AssignRandomColors();
-
         /** Updates view cell stats for this particular view cell.
         */
         void UpdateViewCellsStats(ViewCell *vc, ViewCellsStatistics &vcStat);
-
         /** Get costs resulting from each merge step. 
         */
         void GetCostFunction(vector<float> &costFunction);
-        
         /** Returns storage cost resulting from each merge step.
         */
         void GetStorageFunction(vector<int> &storageCost);
-
         /** Returns optimal set of view cells for a given number of view cells.
         */
         void CollectBestViewCellSet(ViewCellContainer &viewCells, const int numViewCells);
-
         /** Root of view cells tree.
         */
         ViewCell *GetRoot() const;
-
         /** Returns pvs of view cell.
                 @note pvs is returned per reference if tree is not compressed,
@@ -510 +498 @@
         */
         void GetPvs(ViewCell *vc, ObjectPvs &pvs) const;
-
         /** Returns pvs size (i.e. the render cost of the stored objects)
         */
         float GetTrianglesInPvs(ViewCell *vc) const;
-  
         /** Returns number of entries associated with this view cell. 
 
@@ -522 +508 @@
         */
         int GetPvsEntries(ViewCell *vc) const;
-
         /** Returns the number of physically stored entries in the view cells sub tree.
                 This can vary based on the current storage method
         */
         int CountStoredPvsEntries(ViewCell *root) const;
-
         /** Returns memory cost of this view cell.
         */
         float GetMemoryCost(ViewCell *vc) const;
-
         /** Sets method of storage for view cells.
         */
         void SetViewCellsStorage(int type);
-
         /** pvs storage methods 
         */
         enum {PVS_IN_INTERIORS, COMPRESSED, PVS_IN_LEAVES};
-
         /** If view cells in this tree have compressed pvs.
         */
         int ViewCellsStorage() const;
-
         /** Returns active view cell that is in the path of this view cell.
         */
@@ -736 +716 @@
         int mMaxMergesPerPass;
         float mAvgCostMaxDeviation;
+
+        int *mPvsIds;
+        ObjectContainer mTempObjects;
 };