1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227
|
/*=========================================================================
Program: Visualization Toolkit
Module: vtkHyperTreeGridNonOrientedCursor.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 Nonice for more information.
=========================================================================*/
/**
* @class vtkHyperTreeGridNonOrientedCursor
* @brief Objects for traversal a HyperTreeGrid.
*
* JB A REVOIR
* Objects that can perform depth traversal of a hyper tree grid,
* take into account more parameters (related to the grid structure) than
* the compact hyper tree cursor implemented in vtkHyperTree can.
* This is an abstract class.
* Cursors are created by the HyperTreeGrid implementation.
*
* @sa
* vtkHyperTreeCursor vtkHyperTree vtkHyperTreeGrid
*
* @par Thanks:
* This class was written by Guenole Harel and Jacques-Bernard Lekien, 2014.
* This class was re-written by Philippe Pebay, 2016.
* JB This class was re-written for more optimisation by Jacques-Bernard Lekien,
* Guenole Harel and Jerome Dubois, 2018.
* This work was supported by Commissariat a l'Energie Atomique
* CEA, DAM, DIF, F-91297 Arpajon, France.
*/
#ifndef vtkHyperTreeGridNonOrientedCursor_h
#define vtkHyperTreeGridNonOrientedCursor_h
#include "vtkCommonDataModelModule.h" // For export macro
#include "vtkObject.h"
#include <vector> // For std::vector
class vtkHyperTree;
class vtkHyperTreeGrid;
class vtkHyperTreeGridEntry;
class VTKCOMMONDATAMODEL_EXPORT vtkHyperTreeGridNonOrientedCursor : public vtkObject
{
public:
vtkTypeMacro(vtkHyperTreeGridNonOrientedCursor, vtkObject);
void PrintSelf(ostream& os, vtkIndent indent) override;
static vtkHyperTreeGridNonOrientedCursor* New();
/**
* Create a copy of `this'.
* \post results_exists:result!=0
*/
vtkHyperTreeGridNonOrientedCursor* Clone();
/**
* Initialize cursor at root of given tree index in grid.
*/
void Initialize(vtkHyperTreeGrid* grid, vtkIdType treeIndex, bool create = false);
/**
* Initialize cursor at root of given tree index in grid.
*/
void Initialize(
vtkHyperTreeGrid* grid, vtkHyperTree* tree, unsigned int level, vtkHyperTreeGridEntry& entry);
/**
* Initialize cursor at root of given tree index in grid.
*/
void Initialize(vtkHyperTreeGrid* grid, vtkHyperTree* tree, unsigned int level, vtkIdType index);
//@{
/**
* Set the hyper tree grid to which the cursor is pointing.
*/
vtkHyperTreeGrid* GetGrid();
//@}
//@{
/**
* Return if a Tree pointing exist
*/
bool HasTree() const;
//@}
//@{
/**
* Set the hyper tree to which the cursor is pointing.
*/
vtkHyperTree* GetTree() const;
//@}
/**
* Return the index of the current vertex in the tree.
*/
vtkIdType GetVertexId();
/**
* Return the global index (relative to the grid) of the
* current vertex in the tree.
*/
vtkIdType GetGlobalNodeIndex();
/**
* Return the dimension of the tree.
* \post positive_result: result>0
*/
unsigned char GetDimension();
/**
* Return the number of children for each node (non-vertex leaf) of the tree.
* \post positive_number: result>0
*/
unsigned char GetNumberOfChildren();
/**
* JB
*/
void SetGlobalIndexStart(vtkIdType index);
/**
* JB
*/
void SetGlobalIndexFromLocal(vtkIdType index);
/**
* Set the blanking mask is empty or not
* \pre not_tree: tree
*/
void SetMask(bool state);
/**
* Determine whether blanking mask is empty or not
*/
bool IsMasked();
/**
* Is the cursor pointing to a leaf?
*/
bool IsLeaf();
/**
* JB
*/
void SubdivideLeaf();
/**
* Is the cursor at tree root?
*/
bool IsRoot();
/**
* Get the level of the tree vertex pointed by the cursor.
*/
unsigned int GetLevel();
/**
* Move the cursor to child `child' of the current vertex.
* \pre not_tree: HasTree()
* \pre not_leaf: !IsLeaf()
* \pre valid_child: ichild>=0 && ichild<GetNumberOfChildren()
* \pre depth_limiter: GetLevel() <= GetDepthLimiter()
*/
void ToChild(unsigned char ichild);
/**
* Move the cursor to the root vertex.
* \pre can be root
* \post is_root: IsRoot()
*/
void ToRoot();
/**
* Move the cursor to the parent of the current vertex.
* Authorized if HasHistory return true.
* \pre Non_root: !IsRoot()
*/
void ToParent();
protected:
/**
* Constructor
*/
vtkHyperTreeGridNonOrientedCursor();
/**
* Destructor
*/
~vtkHyperTreeGridNonOrientedCursor() override;
/**
* JB Reference sur l'hyper tree grid parcouru actuellement.
*/
vtkHyperTreeGrid* Grid;
/**
* JB
*/
vtkHyperTree* Tree;
/**
* JB .
*/
unsigned int Level;
/**
* JB Le dernier noeud valid enregistre
*/
int LastValidEntry;
/**
* JB Hyper tree grid to which the cursor is attached
*/
std::vector<vtkHyperTreeGridEntry> Entries;
private:
vtkHyperTreeGridNonOrientedCursor(const vtkHyperTreeGridNonOrientedCursor&) = delete;
void operator=(const vtkHyperTreeGridNonOrientedCursor&) = delete;
};
#endif
|