vtkSelectionSource.h 4.88 KB
Newer Older
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
/*=========================================================================

  Program:   Visualization Toolkit
  Module:    vtkSelectionSource.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.

=========================================================================*/
// .NAME vtkSelectionSource - Generate selection from given set of ids
// vtkSelectionSource generates a vtkSelection from a set of 
// (piece id, cell id) pairs. It will only generate the selection values
// that match UPDATE_PIECE_NUMBER (i.e. piece == UPDATE_PIECE_NUMBER).

#ifndef __vtkSelectionSource_h
#define __vtkSelectionSource_h

#include "vtkSelectionAlgorithm.h"

//BTX
26
class vtkSelectionSourceInternals;
27 28
//ETX

29
class VTK_GRAPHICS_EXPORT vtkSelectionSource : public vtkSelectionAlgorithm
30 31 32
{
public:
  static vtkSelectionSource *New();
33
  vtkTypeMacro(vtkSelectionSource,vtkSelectionAlgorithm);
34 35 36 37 38
  void PrintSelf(ostream& os, vtkIndent indent);
  
  // Description:
  // Add a (piece, id) to the selection set. The source will generate
  // only the ids for which piece == UPDATE_PIECE_NUMBER.
39
  // If piece == -1, the id applies to all pieces.
40
  void AddID(vtkIdType piece, vtkIdType id);
41
  void AddStringID(vtkIdType piece, const char* id);
42

43 44 45 46
  // Description:
  // Add a point in world space to probe at.
  void AddLocation(double x, double y, double z);

47 48 49 50 51 52 53 54
  // Description:
  // Add a value range to threshold within.
  void AddThreshold(double min, double max);

  // Description:
  // Set a frustum to choose within.
  void SetFrustum(double *vertices);

55 56 57 58
  // Description:
  // Add the flat-index/composite index for a block.
  void AddBlock(vtkIdType blockno);

59 60 61
  // Description:
  // Removes all IDs.
  void RemoveAllIDs();
62
  void RemoveAllStringIDs();
63 64 65 66 67 68 69 70 71

  // Description:
  // Remove all thresholds added with AddThreshold.
  void RemoveAllThresholds();

  // Description:
  // Remove all locations added with AddLocation.
  void RemoveAllLocations();

72 73 74 75
  // Description:
  // Remove all blocks added with AddBlock.
  void RemoveAllBlocks();

76 77 78 79
  // Description:
  // Set the content type for the generated selection.
  // Possible values are as defined by 
  // vtkSelection::SelectionContent.
80
  vtkSetMacro(ContentType, int);
81 82 83 84 85 86 87 88 89
  vtkGetMacro(ContentType, int);

  // Description:
  // Set the field type for the generated selection.
  // Possible values are as defined by
  // vtkSelection::SelectionField.
  vtkSetMacro(FieldType, int);
  vtkGetMacro(FieldType, int);

90 91 92 93 94 95 96
  // Description:
  // When extracting by points, extract the cells that contain the 
  // passing points.
  vtkSetMacro(ContainingCells, int);
  vtkGetMacro(ContainingCells, int);

  // Description:
97 98
  // Determines whether the selection describes what to include or exclude. 
  // Default is 0, meaning include.
99 100 101 102
  vtkSetMacro(Inverse, int);
  vtkGetMacro(Inverse, int);

  // Description:
103
  // Access to the name of the selection's subset description array.
104 105
  vtkSetStringMacro(ArrayName);
  vtkGetStringMacro(ArrayName);
106 107 108 109 110 111

  // Description:
  // Access to the component number for the array specified by ArrayName.
  // Default is component 0. Use -1 for magnitude.
  vtkSetMacro(ArrayComponent, int);
  vtkGetMacro(ArrayComponent, int);
112 113
  
  // Description:
114 115 116
  // If CompositeIndex < 0 then COMPOSITE_INDEX() is not added to the output.
  vtkSetMacro(CompositeIndex, int);
  vtkGetMacro(CompositeIndex, int);
117

118 119 120 121 122 123 124
  // Description:
  // If HierarchicalLevel or HierarchicalIndex < 0 , then HIERARCHICAL_LEVEL()
  // and HIERARCHICAL_INDEX() keys are not added to the output.
  vtkSetMacro(HierarchicalLevel, int);
  vtkGetMacro(HierarchicalLevel, int);
  vtkSetMacro(HierarchicalIndex, int);
  vtkGetMacro(HierarchicalIndex, int);
125 126 127 128 129 130

  // Description:
  // Set/Get the query expression string.
  vtkSetStringMacro(QueryString);
  vtkGetStringMacro(QueryString);

131 132 133 134 135 136 137 138 139 140 141 142 143 144
protected:
  vtkSelectionSource();
  ~vtkSelectionSource();

  virtual int RequestInformation(vtkInformation* request,
                                 vtkInformationVector** inputVector,
                                 vtkInformationVector* outputVector);

  virtual int RequestData(vtkInformation* request,
                          vtkInformationVector** inputVector,
                          vtkInformationVector* outputVector);

  vtkSelectionSourceInternals* Internal;

145 146
  int ContentType;
  int FieldType;
147 148 149
  int ContainingCells;
  int PreserveTopology;
  int Inverse;
150 151 152
  int CompositeIndex;
  int HierarchicalLevel;
  int HierarchicalIndex;
153
  char *ArrayName;
154
  int ArrayComponent;
155
  char *QueryString;
156

157 158 159 160 161 162
private:
  vtkSelectionSource(const vtkSelectionSource&);  // Not implemented.
  void operator=(const vtkSelectionSource&);  // Not implemented.
};

#endif